このトピックでは、Telegram ボットをチャンネルに接続し、API トークンを設定し、Webhook をセットアップする方法について説明します。また、Chat App Message Service コンソールでメッセージを送信し、返信を受信し、複数の Telegram ボットを一元管理する方法についても説明します。
前提条件
Telegram ボットを作成済みであること。手順については、「Telegram ボットの作成方法」をご参照ください。
Telegram チャンネルを作成済みであること。手順については、「Telegram チャンネルの作成と管理」をご参照ください。
操作手順
以下の手順に従ってボットを接続します。
Chat App Message Service コンソールにログインします。
左側のナビゲーションウィンドウで、Channel Management をクリックします。
管理したい Telegram チャンネルの Channel ID をクリックします。
チャンネルの操作ページで、Chatbot Management タブに移動し、Create Bot または Connect Existing Bot を選択します。
Telegram ボットトークンを入力します。
Connect をクリックします。
ボットの作成
ボットは Telegram クライアントで作成する必要があります。ボットを作成した後、その API トークンをコピーし、入力フィールドに貼り付けて [接続] をクリックします。
既存ボットの接続
API トークンを入力フィールドに貼り付け、[接続] をクリックします。接続に成功すると、ボットの情報がページに表示されます。
1 つの Telegram チャンネルは 1 つのボットしかサポートしません。複数のボットを管理するには、ボットごとに個別の Telegram チャンネルを作成し、それぞれを接続する必要があります。
トークンの更新
ボットの API トークンが漏洩した場合や有効期限が切れた場合は、コンソールで更新できます。
トークンを更新すると、既存のトークンが置き換えられます。このプロセスにより、一時的に接続が切断され、メッセージの配信に影響がでる可能性があります。この操作は、オフピーク時間に行うことを推奨します。
Telegram クライアントで BotFather を開き、ボットの新しい API トークンを生成します。
Chatbot Management ページで、Update Token をクリックします。
表示されたダイアログボックスに、新しい API トークンを貼り付けます。
OK をクリックします。
メッセージワークベンチの設定
メッセージワークベンチを使用すると、ボットに送信された受信メッセージを一元的に表示および管理できます。
Chatbot Management ページで、[メッセージワークベンチ設定] をクリックします。
設定の詳細：
モード
説明
シナリオ
Enable Message Workbench
メッセージワークベンチにすべての受信メッセージが表示されます。
すべての受信メッセージを表示する場合に最適です。
Triggered by Keyword
設定されたキーワードに一致するメッセージのみがメッセージワークベンチに表示されます。
価値の低いメッセージをフィルタリングして、重要なコンテンツに集中する場合に最適です。
ボットの削除
ボットを削除すると、そのボットを介してメッセージを送信できなくなります。この操作により、同期されているすべてのグループ情報とチャンネル情報も削除され、回復することはできません。
Chatbot Management ページで、Delete をクリックします。
表示された確認ダイアログボックスで、OK をクリックします。
Webhook の設定
Chatbot Management ページで、Configure Webhook をクリックします。
Webhook を使用すると、メッセージの配信状況や既読ステータスのコールバックなど、受信通知を受け取ることができます。設定手順については、「受信メッセージの概要と設定」をご参照ください。
次のステップ
ボットを接続した後、次の操作を実行できます：