この記事を使って、1つ以上のTelegramボットをIntercomのワークスペースに接続し、接続後に何が起こるかを理解し、切断が必要な場合の対処法を知りましょう。設定後、Telegramの会話は他のすべてのチャネルと共にInboxに表示され、Finが自動で処理し、Workflowsが完全に適用されます。
接続前に必要なもの
Telegramチャネルを接続または切断するには、Intercomのワークスペースで管理者アクセス権が必要です。
接続前に、Telegramボットとbot token（Intercomがボットの代理でメッセージの送受信を許可する認証情報）が必要です。@BotFather（ボット作成・管理用の公式Telegramボット）を使ってボットを作成してください。詳細はTelegramのドキュメントを参照してください。
注意：bot tokenはボットの完全な制御権を与えます。安全に保管し、Intercom接続に必要な範囲を超えて共有しないでください。
Telegramの接続方法
開始前に@BotFatherからbot tokenを用意してください。
設定 > チャネル > Telegramに移動します。
bot tokenをBot token欄に貼り付けます。
接続をクリックします。
接続後の流れ：
Intercomがbot tokenを検証します。
webhook（Telegramからのメッセージを受信する接続エンドポイント）が登録され、TelegramボットがInboxにリンクされます。
インストールはTeammate Activity Log（設定 > セキュリティ > Teammate Activity）に記録されます。
設定完了後、Telegramチャネルは設定 > チャネル > Telegramでアクティブとして表示されます。接続確認のため、Telegramボットにテストメッセージを送信してください。数秒以内にIntercomのInboxに新しい会話として表示されます。
複数のTelegramボットの接続
1つのワークスペースに複数のTelegramボットを接続できます。ブランド、地域、製品ラインごとに別々のボットを運用する場合に便利です。追加した各ボットは設定 > チャネル > Telegramのリストに@usernameと接続状態と共に表示されます。別のボットを追加するには、新しいボットのtokenで上記の接続手順を繰り返してください。
Telegramボットにブランドを割り当てる
ワークスペースがマルチブランドプランの場合、接続された各Telegramボットにブランドを割り当てられます。これにより、Finが返信時に使うペルソナや、Finが回答するhelp centerのコンテンツが制御されます。各ボットは独立して異なるブランドを指すことができます。
ブランドを割り当てるには：
設定 > チャネル > Telegramに移動します。
ボットのカードでBrandピッカーを開きます。
そのボットに使いたいブランドを選択します。
ボットが開始した会話にはブランドが標準の会話属性としてタグ付けされ、ブランド別のビュー、レポート、workflow条件で正しくセグメントされます。
注意：Brandピッカーをクリアするとボットはワークスペースのデフォルトに戻ります。ブランド割り当てはマルチブランドプランのみ利用可能です。
Telegramの切断方法
Telegramボットを切断するには、設定 > チャネル > Telegramに行き、切断をクリックします。
切断してもInboxの既存の会話には影響なく、引き続きチームメンバーが管理可能です。ただし、ボットが再接続されるまで顧客は新しいメッセージを送信できません。
重要：ボットを切断すると、そのbot tokenとwebhook secret（webhook接続に紐づくセキュリティ認証情報）がIntercomから永久に削除されます。これらの認証情報は復元できません。再接続するには、@BotFatherでbot tokenを再生成し、再度設定を完了する必要があります。
Telegramのブロードキャスト
複数のTelegramボットが接続されている場合、ブロードキャスト送信時にFrom botセレクターが表示されます。どのボットから送信するか選択してください。チャネルリストは自動的にそのボットのチャネルに絞り込まれます。ボットが1つだけの場合は、従来通り追加の操作なしでブロードキャストが機能します。
Telegramの顧客にホストされたticketフォームを送信する
Discord、Slack、WhatsAppと同様に、Telegramの顧客から構造化情報を収集するためにホストされたticketフォームを送信できます。顧客はTelegramの組み込みログインでワンタップで本人確認し、チャットを離れずにフォームに記入・送信します。
BotFatherでボットのdomainを設定する
Telegramのログインウィジェットは、ボットに登録されたdomainでのみ機能します。ボットごとに1回設定が必要で、domainはワークスペースのホスティング地域によって異なります。
地域 | 設定するDomain |
アメリカ合衆国 | app.intercom.com |
ヨーロッパ | app.eu.intercom.com |
オーストラリア | app.au.intercom.com |
Telegramで@BotFatherとのチャットを開きます。
/setdomainを送信します。ボットを選択します。
上記の表から地域のdomainを送信します。
注意：ワークスペースの地域が不明な場合は、Intercomにログインする際のURLを確認してください。上記のdomainのいずれかと一致します。誤った地域のdomainを設定するとログインウィジェットが表示されません。
Telegramの顧客にフォームを送信する
InboxでTelegramの会話を開きます。
返信作成画面（または
⌘K/Ctrl+K操作）でホストされたticketフォームを送信するオプションを選びます。フォームを選択して送信します。顧客はTelegramチャットでリンクを受け取ります。
顧客が見るもの
顧客はチャットからリンクを開きます。
Telegramでログインボタンで本人確認を求められます。
ワンタップ後、フォームが開き、記入して送信します。
送信されたticketは他のホストされたticketフォームと同様に会話に表示されます。
トラブルシューティング
ログインボタンが表示されない — ボットのdomainが設定されていないか、誤った地域のdomainが使われています。正しい地域のdomainでBotFatherで
/setdomainを再実行してください。ログイン後に「Verification failed」 — 会話を処理した特定のボットが、domainを設定したボットと一致しているか確認してください。複数ボット接続時は、各ボットごとにBotFatherでdomainを設定する必要があります。
接続に失敗しました — 各Telegramボットは同時に1つのIntercomワークスペースにしか接続できません。すでに他のワークスペースで使用中のボットを接続しようとすると接続に失敗します。