Telegram Webhook設定の方法
Telegram Webhook設定では、組み込みのWebhookコンポーネントを追加し、Telegram Webhook Setupを使って、その公開HTTPSエンドポイントをTelegram Bot APIに登録します。この設定では、messageとcallback_queryの2種類の更新データを要求します。エンドポイントの登録時または変更時に実行してください。その後、受信する更新データは、設定処理とは別に、WebhookとTelegram Update Parserを通って処理されます。
執筆：Ai Flowi · 技術レビュー：Janice Lee、Ai Flowi テクニカルサポート。
公開日 · 更新日
自分のWebhookを作成する方法
組み込みのWebhookコンポーネントを追加し、その公開HTTPSエンドポイントをコピーします。Telegram Webhook SetupのFlowi Webhook URLに、このエンドポイントを指定します。設定にはボットトークンも必要です。Flowi API Keyは、デプロイ先でWebhookの認証が必要な場合にのみ追加してください。
- Telegramのボットトークン。シークレット入力フィールドに保存し、共有するテキストには含めないでください。
- Webhookコンポーネントの公開HTTPSエンドポイント。
- FlowiのAPIキー。Webhookのデプロイ先で必要な場合にのみ用意します。
入力項目
| 入力 | 必須 | 目的 |
|---|---|---|
| Telegram Bot Token | はい | Telegramでボットを認証します。シークレットフィールドを使ってください。 |
| Flowi Webhook URL | はい | 登録する公開HTTPSエンドポイント。 |
| Flowi API Key | いいえ | Webhookのデプロイ先で必要な場合の認証に使います。シークレットフィールドを使ってください。 |
| Drop Old Pending Messages | いいえ | 有効にすると、登録時にキュー内の更新データを破棄するようTelegramに要求します。 |
Webhookを有効にする方法
ボットトークンと公開HTTPSのWebhook URLを指定して、Telegram Webhook Setupを実行します。Flowi API Keyは必要な場合にのみ追加します。Webhook Setup Resultで登録結果を確認してください。その後、Webhook.JSONをTelegram Update Parser.Telegram Updateに接続し、受信する更新データが実行時の処理経路を通るようにします。
- Webhookを追加し、その公開HTTPSエンドポイントをコピーします。
- Telegram Webhook Setupを追加し、ボットトークンとエンドポイントをそれぞれ対応するフィールドに入力します。
- Webhookのデプロイ先で必要な場合は、Flowi API Keyを追加します。キュー内の更新データを破棄するかどうかも選択します。
- 設定コンポーネントを実行し、Webhook Setup Resultを確認します。
Webhook.JSONをTelegram Update Parser.Telegram Updateに接続して、実行時の処理経路を構築します。
期待される結果
Webhook Setup Resultは、登録内容とTelegramの応答を示すDataの結果を返します。ドキュメントに記載された設定処理は、setWebhookを呼び出し、getWebhookInfoで登録を確認します。要求する更新データは、messageとcallback_queryです。結果のURLに認証情報が含まれる場合は、その結果を非公開にしてください。
よくあるエラー
- トークンがありません： Telegram Bot Tokenのシークレットフィールドを確認してください。
- URLが拒否されました： エンドポイントが公開され、HTTPSを使っていることを確認してください。
- 登録は成功したが更新データが届きません： 登録されたエンドポイントが現在のWebhookエンドポイントと一致し、認証の要件が設定内容と一致していることを確認してください。Telegramのトラブルシューティングもご覧ください。