この記事を使って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つのIntercomワークスペースにしか接続できません。すでに他のワークスペースで使用中のボットを接続しようとすると、接続は失敗します。
Telegramの切断方法
切断するには、設定 > チャネル > Telegramに移動し、切断をクリックします。
切断してもInboxの既存の会話には影響ありません。会話はアクセス可能で、チームメンバーが管理できます。ただし、ボットが再接続されるまで顧客は新しいメッセージを送信できません。
重要：切断すると、bot tokenとwebhook secret（webhook接続に関連するセキュリティ認証情報）がIntercomから永久に削除されます。これらの認証情報は復元できません。再接続するには、@BotFatherでbot tokenを再生成し、再度設定を完了する必要があります。
Telegramの顧客にホストされたticketフォームを送信する
Discord、Slack、WhatsAppと同様に、Telegramの顧客にホストされたticketフォームを送信して構造化情報を収集できます。顧客はTelegramの組み込みログインでワンタップで本人確認し、チャットを離れずにフォームに記入・送信します。
注意: Telegramの顧客にホストされたticketフォームを送信する機能は現在ベータ版です。
BotFatherでボットのdomainを設定する
Telegramのログインウィジェットは、ボットに登録されたdomainでのみ機能します。domainはワークスペースのホスティング地域によって異なり、ボットごとに1回設定が必要です。
地域 | 設定するdomain |
アメリカ合衆国 | app.intercom.com |
ヨーロッパ | app.eu.intercom.com |
オーストラリア | app.au.intercom.com |
Telegramで@BotFatherとのチャットを開きます。
/setdomainを送信します。ボットを選択します。
上記の表から地域のdomainを送信します。
注意：ワークスペースの地域が不明な場合は、Intercomにログインする際のURLを確認してください。URLは上記のdomainのいずれかと一致します。誤った地域のdomainを設定すると、ログインウィジェットが表示されません。
Telegramの顧客にフォームを送信する
InboxでTelegramの会話を開きます。
返信作成画面（または
⌘K/Ctrl+K操作）でホストされたticketフォームを送信するを選択します。フォームを選択して送信します。顧客はTelegramチャットでリンクを受け取ります。
顧客が見るもの
チャットからリンクを開きます。
Telegramでログインボタンで本人確認を求められます。
ワンタップ後、フォームが開き、記入して送信します。
送信されたticketは他のホストされたticketフォームと同様に会話に表示されます。
トラブルシューティング
ログインボタンが表示されない — ボットのdomainが設定されていないか、誤った地域のdomainが使われています。正しい地域のdomainでBotFatherで
/setdomainを再実行してください。ログイン後に「Verification failed」エラーが出る — Telegram連携に接続されているボットが、domainを設定したボットと一致しているか確認してください。