Telegram Bot¶

Bot は Telegram アプリ内で動作する小規模なアプリケーションです。ユーザーは柔軟なインターフェースを通じて Bot とやり取りでき、あらゆる種類のタスクやサービスに対応できます。このドキュメントでは、Guance で Telegram Bot の通知先を作成し、アラートメッセージを Telegram の個人チャット、グループ、またはチャンネルに直接プッシュする方法について説明します。

Bot の詳細については、こちらをご覧ください。

注意

この通知先は、国際版請求センターアカウントに紐づいた国際サイトのワークスペースでのみご利用いただけます。

設定前の準備¶

Guance で設定する前に、Telegram 側で以下の準備を行ってください。

ステップ 1：Bot を作成しトークンを取得する¶

Telegram で @BotFather を検索して起動します。
/newbot コマンドを送信して新しい Bot を作成します。
プロンプトに従って Bot の名前とユーザー名を設定します（ユーザー名は bot で終わる必要があります）。
作成が完了したら、返された Bot Token を安全に保管してください（形式例：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）。

注意

Bot Token は Telegram API を呼び出すための認証情報です。厳重に管理し、決して漏洩しないようにしてください。

ステップ 2：Chat ID を取得する¶

Bot を対象のグループに追加するか、個人チャットを作成し、チャット内で @userinfobot にメッセージを送信してリンクをクリックし、Chat ID を取得します。

Chat ID は以下の形式に対応しています。

受信シナリオ	Chat ID の形式	例
個人チャット	ユーザー ID（数字のみ）	`123456789`
グループ	グループ ID（負数）	`-1001234567890`
チャンネル	チャンネルユーザー名	`@my_channel`

ステップ 2：Topic ID を取得する（オプション）¶

フォーラムグループ（Forum Supergroup）を対象とし、特定のトピックに送信する場合にのみ必要です。

対象のトピックにメッセージを 1 件送信します。
https://api.telegram.org/bot<YourBOTToken>/getUpdates にアクセスします。
返却されたデータから message_thread_id フィールドの値を確認します。

Telegram Bot 設定ページに戻る¶

現在の通知先の名前を入力します（通知先一覧で識別するために使用します）。
@BotFather から取得した Bot Token を入力します。
Chat ID を入力します。
フォーラムグループに送信する場合は、Message Thread ID を入力します。
必要に応じて通知の送信をテストします（❗️ システムがテストメッセージを 1 件送信します。該当する通知先でテストメッセージが正常に送信されたか確認してください）。
操作権限を設定します。
確認します。