Telegram ボットを作成し、その API トークンを取得し、Chat App Message Service と連携するためにグループとチャネルの管理者権限を設定します。
ユースケース
Chat App Message Service は Telegram を通じて全世界のユーザーにリーチします。ボットを作成し、認証情報としてその API トークンを取得し、グループとチャネルで管理者権限を設定して、メッセージのブロードキャストやコミュニティの管理を行います。
概要
このプロセスには、以下のステップが含まれます。
-
BotFather を使用して新しいボットを作成します。
-
ボットの表示名とユーザー名を設定します。
-
API トークンを取得して保存します。
-
ボットのプロフィールを完成させます (任意)。
-
グループとチャネルの管理者権限を設定します。
BotFather は Telegram の公式ボット管理ツールです。すべての作成と設定は、BotFather とのチャットで行われます。
ステップ 1: BotFather でのボット作成
お使いの Telegram クライアント (モバイル、デスクトップ、または Web) で BotFather を開きます。
-
検索: Telegram の検索バーに
BotFatherと入力し、公式認証バッジが付いたアカウントを選択します。 -
リンク: https://t.me/BotFather に直接アクセスします。
[Start] をクリックし、次に /newbot を送信します。BotFather がボットの表示名とユーザー名の設定を案内します。
お使いのネットワークが Telegram にアクセスできることを確認してください。モバイルまたはデスクトップクライアントを使用すると、より安定して利用できます。
ステップ 2: ボットの表示名の設定
最初に、BotFather は表示名を尋ねてきます。この名前はエンドユーザーに表示され、任意の言語を使用できます。例:
-
Support Assistant -
My Shop Assistant -
Order Service Bot
ステップ 3: ボットのユーザー名の設定
次に、BotFather はユーザー名を尋ねてきます。ユーザー名は、以下の要件を満たす必要があります。
-
英字、数字、アンダースコアのみ使用できます。
-
末尾は
botである必要があります。
例: my_demo_bot または MyShopHelperBot
以下のユーザー名は無効であり、使用できません。
|
無効なユーザー名 |
理由 |
|
|
スペースが含まれています。 |
|
|
|
|
|
ハイフンが含まれており、 |
|
|
短すぎるか、すでに使用されています。 |
ユーザー名がすでに使用されている場合は、数字やアンダースコアを追加してみてください: my_shop_bot または service_01_bot
ステップ 4: API トークンの取得と保存
成功すると、BotFather は次のような API トークンを返します: 123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx
API トークンは、Telegram Bot API の呼び出しや、ボットを Chat App Message Service に接続するための認証情報です。以下を記録してください。
|
項目 |
例 |
|
ボットの表示名 |
Customer Service Bot |
|
ボットのユーザー名 |
my_demo_bot |
|
API トークン |
123456789:AAExxxxxxxxxxxxxxxxx |
API トークンはボットのパスワードです。このトークンを持つ誰もがボットを制御できてしまいます。グループチャットで共有したり、スクリーンショットを投稿したり、パブリックなコードリポジトリにコミットしたりしないでください。トークンが漏洩した疑いがある場合は、直ちに BotFather でトークンを失効させ、Chat App Message Service コンソールでトークンを更新してください。
ステップ 5: ボットプロフィールの完成 (任意)
BotFather で、以下の任意の設定を行い、ボットのプロフィールを充実させることができます。
|
コマンド |
機能 |
|
|
ボットの説明を設定します。 |
|
|
ユーザーがボットを開いたときに表示される短い紹介文を設定します。 |
|
|
ボットのプロフィール画像をアップロードします。 |
ステップ 6: ボット権限の設定
グループまたはチャネルでボットを使用するには、BotFather で必要な権限を有効にする必要があります。
グループアクセスの有効化
ボットをグループに追加するために必要です。
パス: /mybots > 対象のボットを選択 > [Bot Settings] > [Allow Groups] > [Turn groups on]
グループプライバシーの無効化
デフォルトでは、ボットは@メンションされたメッセージまたはボットへの返信のみ受信します。グループプライバシーを無効にすると、ボットはすべてのグループメッセージを受信できるようになります。
パス: /mybots > 対象のボットを選択 > [Bot Settings] > [Group Privacy] > [Turn off]
グループ管理者権限の設定
パス: /mybots > 対象のボットを選択 > [Bot Settings] > [Group Admin Rights] > 必要な権限を選択
ニーズに基づいてグループ管理者権限を設定します。
推奨事項は、Telegram の公式ドキュメントに基づいていますが、現在の機能とは異なる場合があります。実際の要件に基づいて権限を選択してください。
|
権限 |
説明 |
推奨 |
|
グループ名、写真などの変更 |
グループの名前、写真、説明を変更します。 |
推奨 |
|
メッセージの削除 |
グループメンバーが送信した任意のメッセージを削除します。 |
必須 |
|
メンバーの制限、追放、追放解除 |
メンバーを追放、追放解除、または制限します。 |
必須 |
|
新規ユーザーの招待 |
招待リンクを生成するか、ユーザーを直接グループに追加します。 |
推奨 |
|
メッセージのピン留め |
グループチャットの先頭にメッセージをピン留めします。 |
任意 |
|
新しい管理者の追加 |
他のメンバーを管理者として任命します。 |
任意 |
|
ボイスチャットの管理 |
グループ内でボイスチャットまたはビデオチャットを開始、停止、または管理します。 |
任意 |
|
匿名管理者の昇格 |
管理者がグループを代表して匿名で投稿できるようにします。 |
任意 |
|
トピックの管理 |
トピックが有効になっているスーパーグループでトピックを管理します。 |
任意 |
|
ストーリーの投稿 |
グループを代表して Telegram Stories にストーリーを投稿します。Telegram Premium が必要です。 |
非推奨 |
|
ストーリーの編集 |
グループが投稿したストーリーを編集します。Telegram Premium が必要です。 |
非推奨 |
|
ストーリーの削除 |
グループが投稿したストーリーを削除します。Telegram Premium が必要です。 |
非推奨 |
|
チャットの管理 |
低速モードやデフォルトのメンバー権限など、グループの詳細設定を変更します。 |
必須 |
チャネル管理者権限の設定
パス: /mybots > 対象のボットを選択 > [Bot Settings] > [Channel Admin Rights] > 必要な権限を選択
ニーズに基づいてチャネル管理者権限を設定します。
推奨事項は、Telegram の公式ドキュメントに基づいていますが、現在の機能とは異なる場合があります。実際の要件に基づいて権限を選択してください。
|
権限 |
説明 |
推奨 |
|
チャット名、写真などの変更 |
チャネルの名前、写真、説明を変更します。 |
推奨 |
|
チャネルへの投稿 |
チャネルとして直接メッセージを送信します。 |
必須 |
|
他のユーザーのメッセージの編集、メッセージのピン留め |
他の管理者が投稿したメッセージを編集したり、メッセージをピン留めしたりします。 |
推奨 |
|
メッセージの削除 |
チャネルに投稿された任意のメッセージを削除します。 |
推奨 |
|
参加者の削除 |
チャネル内の購読者を削除またはミュートします。 |
推奨 |
|
新しい管理者の追加 |
他のメンバーをチャネル管理者として任命します。 |
任意 |
|
リンクによる招待 |
チャネルの招待リンクを作成、管理、失効させます。 |
推奨 |
|
ビデオチャット/ライブストリームの管理 |
チャネル内でボイスまたはビデオのライブストリームを開始、停止、または管理します。 |
非推奨 |
|
ダイレクトメッセージの管理 |
チャネルに送信されたダイレクトメッセージを受信し、返信します。Telegram Premium が必要です。 |
非推奨 |
|
ストーリーの投稿 |
チャネルを代表して Telegram Stories にストーリーを投稿します。Telegram Premium が必要です。 |
非推奨 |
|
ストーリーの編集 |
チャネルが投稿したストーリーを編集します。Telegram Premium が必要です。 |
非推奨 |
|
ストーリーの削除 |
チャネルが投稿したストーリーを削除します。Telegram Premium が必要です。 |
非推奨 |
|
チャネルの管理 |
チャネルの詳細設定を変更し、チャネルの監査ログを表示します。 |
必須 |
ボットの検証
設定後、ボットが動作するか確認します。
-
ボットのユーザー名 (例:
my_demo_bot) を検索し、結果に表示されるか確認します。 -
ボットのプロフィールを開き、[Start] をクリックして、応答するか確認します。
-
https://t.me/<your_bot_username>にアクセスし、リンクが正しく開くか確認します。 -
ボットをテスト用のグループまたはチャネルに追加して、その権限が機能するか確認します。
次のステップ
Chat App Message Service コンソール で Telegram チャネルを作成し、ボットの API トークンをバインドしてメッセージの送信を開始します。
よくある質問
BotFather が見つからない場合
以下を確認してください。
-
大文字と小文字を区別して、正確な用語
BotFatherを検索していること。 -
公式認証バッジが付いたアカウントを選択していること。
-
ネットワーク接続が Telegram へのアクセスを許可していること。
https://t.me/BotFather に直接アクセスすることもできます。
ユーザー名が利用できない場合
そのユーザー名はすでに使用されています。以下の調整を試してください。
-
名前に異なるキーワードを使用する。
-
数字の接尾辞を追加する。
-
区切り文字としてアンダースコアを使用する。
調整後のユーザー名も、末尾は bot である必要があります。例: my_shop_bot、myshophelper1_bot、または service_01_bot
API トークンを紛失した場合
BotFather に /mybots を送信し、対象のボットを選択して API トークンを表示または再生成できます。