この記事を使って、1つ以上のTelegramボットをIntercomのワークスペースに接続し、接続後に何が起こるかを理解し、切断が必要な場合の対処法を知りましょう。設定後、Telegramの会話は他のすべてのチャネルと共にInboxに表示され、Finが自動的に処理し、Workflowsが完全に適用されます。
接続前に必要なもの
Telegramチャネルを接続または切断するには、Intercomのワークスペースで管理者アクセス権が必要です。
接続前に、Telegramボットとボットトークン（Intercomがボットの代理でメッセージを送受信する権限を与える認証情報）が必要です。@BotFather（ボット作成・管理用のTelegram公式ボット）を使ってボットを作成してください。詳細はTelegramのドキュメントをご覧ください。
注意：ボットトークンはボットの完全な制御権を与えます。安全に保管し、Intercom接続に必要な範囲を超えて共有しないでください。
Telegramの接続方法
開始前に@BotFatherからボットトークンを用意してください。
設定 > チャネル > Telegramに移動します。
ボットトークンをBot token欄に貼り付けます。
接続をクリックします。
接続後の流れ：
Intercomがボットトークンを検証します。
webhook（Telegramからのメッセージを受信する接続エンドポイント）が登録され、TelegramボットがInboxにリンクされます。
インストールはTeammate Activity Log（設定 > セキュリティ > Teammate Activity）に記録されます。
設定完了後、Telegramチャネルは設定 > チャネル > Telegramでアクティブとして表示されます。接続確認のため、Telegramボットにテストメッセージを送信してください。数秒以内にIntercomのInboxに新しい会話として表示されます。
複数のTelegramボットの接続
1つのワークスペースに複数のTelegramボットを接続できます。ブランド、地域、製品ラインごとに別々のボットを運用する場合に便利です。追加した各ボットは設定 > チャネル > Telegramのリストに@usernameと接続状態と共に表示されます。別のボットを追加するには、新しいボットのトークンで上記の接続手順を繰り返してください。
Telegramボットにブランドを割り当てる
ワークスペースがマルチブランドプランの場合、接続された各Telegramボットにブランドを割り当てられます。これにより、Finが返信時に使用するペルソナや、Finが回答するhelp centerのコンテンツが制御されます。各ボットは独立して異なるブランドを指し示せます。
ブランドを割り当てるには：
設定 > チャネル > Telegramに移動します。
ボットのカードでBrandピッカーを開きます。
そのボットに使用させたいブランドを選択します。
ボットが開始した会話にはブランドが標準の会話属性としてタグ付けされ、ブランドベースのビュー、レポート、workflow条件で正しくセグメントされます。
注意：ブランドピッカーをクリアするとボットはワークスペースのデフォルトに戻ります。ブランド割り当てはマルチブランドプランのみ利用可能です。
ボットごとに会話をルーティングする
ワークスペースに複数のTelegramボットが接続されている場合、専用の会話属性を使って各ボットの会話を独立してルーティングできます。
Telegramボット属性
Telegram経由で届く各会話には、どのボットから来たかを記録する読み取り専用のTelegram bot属性が自動的に付与され、そのボットのTelegramユーザー名（例：support_acme_bot）で表示されます。この属性は以下で利用可能です：
割り当てルール
Workflowの条件分岐
Inboxのサイドバー
レポート
ルーティングを設定するには、Telegram botに条件を設定した割り当てルールまたはworkflowを作成し、ドロップダウンからボットを選択し、そのボットを所有するチームにルーティングします。ボットごとに繰り返してください。 Telegramボットが1つだけ接続されているワークスペースでは、属性は単一のオプションで表示されます。属性は存在しますが、ボット間でルーティングするものはありません。
制限事項
履歴なし。2026年8月12日以降に作成された会話のみが属性を持ちます。それ以前に開かれた会話は永久に空白のままで、遡って属性を付与することはありません。属性で分岐するルールは古い会話には適用されません。
読み取り専用。属性は会話作成時に自動設定されます。チームメンバーや管理者は手動で設定や修正ができず、サイドバーでも同様です。
パブリックAPIには非対応。属性はREST APIで公開されておらず、外部連携で読み取りやフィルタリングができません。
同時に1つのworkflowのみ。会話は同時に1つのチームメンバーが見えるworkflowのみを実行します。既に別のworkflowが会話を処理している場合、Telegram botで分岐するworkflowは実行されません。これはルーティングルールが機能しない最も一般的な原因です。まず他のworkflowが動作中か確認してください。
2つのボットがいるグループチャット。2つのボットが同じTelegramグループにいる場合、それぞれがそのグループ用に独自のIntercom会話を開くため、同じメッセージが2回表示され、両方のボットが返信できます。これはこの機能固有の動作ではなく、既存の挙動です。
切断されたボット
後でボットが切断されても、属性ピッカーのアーカイブオプションとして利用可能なままです。既存のルールや古い会話で参照されている場合も正しく解決され続けます。
Telegramの切断方法
Telegramボットを切断するには、設定 > チャネル > Telegramに移動し、切断をクリックします。
切断してもInbox内の既存の会話には影響なく、引き続きチームメンバーが管理可能です。ただし、再接続されるまで顧客はボットに新しいメッセージを送信できません。
重要：ボットを切断すると、そのボットトークンとwebhookシークレット（webhook接続に紐づくセキュリティ認証情報）がIntercomから永久に削除されます。これらの認証情報は復元できません。再接続するには、@BotFatherでボットトークンを再生成し、再度設定を完了する必要があります。
Telegramのブロードキャスト
複数のTelegramボットが接続されている場合、ブロードキャスト送信時にFrom botセレクターが表示されます。どのボットから送信するか選択してください。チャネルリストは自動的にそのボットのチャネルに絞り込まれます。ボットが1つだけの場合は、従来通り追加の操作なしでブロードキャストが機能します。
Telegramの顧客にホストされたチケットフォームを送信する
Discord、Slack、WhatsAppと同様に、Telegramの顧客から構造化情報を収集するためにホストされたチケットフォームを送信できます。顧客は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操作）でホストされたチケットフォームを送信するオプションを選択します。フォームを選択して送信します。顧客はTelegramチャットでリンクを受け取ります。
顧客が見るもの
チャットからリンクを開きます。
Log in with Telegramボタンで本人確認を求められます。
ワンタップ後、フォームが開き、記入して送信します。
送信されたチケットは他のホストされたチケットフォームと同様に会話に表示されます。
トラブルシューティング
ログインボタンが表示されない — ボットのdomainが設定されていないか、誤った地域のdomainが使われています。正しい地域のdomainでBotFatherで
/setdomainを再実行してください。ログイン後に「Verification failed」 — 会話を処理した特定のボットが、domainを設定したボットと一致しているか確認してください。複数ボットが接続されている場合、各ボットごとにBotFatherでdomainを設定する必要があります。
接続に失敗しました — 各Telegramボットは同時に1つのIntercomワークスペースにしか接続できません。すでに他のワークスペースで使用中のボットを接続しようとすると接続に失敗します。