Telegram AIボットの作り方

Telegram AIボットの作り方は次のとおりです。Webhookエンドポイントを登録し、WebhookのJSONをTelegram Update Parserへ接続して、解析したメッセージをワークフローロジックまたはAIのステップへ渡します。2026年9月29日公開のこのガイドでは、6つの手順を説明します。Telegramへの返信には、別途Bot APIリクエストが必要です。その送信経路は個別にテストしてください。

執筆:Ai Flowi · 技術レビュー: Janice Lee、Ai Flowi テクニカルサポート。

公開日: · 更新日:

Telegramのボットトークンはどこで取得できますか?

TelegramのBotFatherの手順で、Telegramのボットトークンを取得します。公開HTTPSエンドポイントを指定してTelegram Webhook Setupを実行する際に必要です。公開する例にはトークンを含めず、別途送信するBot APIリクエストを設定する場合は、ご自身のデプロイ環境が対応する認証情報の管理方法を使ってください。

関連情報:UChat連携:AI Flowi Workflow。

  • AI Flowi Workflowエディターへのアクセスと、TelegramのBotFatherの手順で取得したTelegramのボットトークン。
  • 組み込みのWebhookコンポーネントが提供する公開HTTPSエンドポイント。
  • 使用するAIモデルや送信APIリクエストの認証情報。公開する例には、トークンを含めないでください。

Telegramで自分のボットを作れますか?

はい。TelegramのBotFatherの手順でボットトークンを取得し、以下の6つのワークフロー手順に沿って進めてください。公開HTTPS Webhookエンドポイントを登録し、受信した更新データを解析して、ワークフローロジックまたはAIのステップを接続します。返信が必要な場合は、別途Bot APIリクエストを設定してテストしてください。

  1. まず、 Webhook を追加し、エンドポイントをコピーします。WebhookはTelegramの更新データを受信し、JSONを出力します。
  2. 次に、 Telegram Webhook Setup にボットトークンとWebhookエンドポイントを指定して実行します。Flowi API Keyは任意項目です。デプロイ環境で必要な場合にのみ追加してください。登録結果を確認します。 Webhookの設定をご覧ください。
  3. 続いて、 Telegram Update Parser を追加し、 Webhook.JSON を Telegram Update Parser.Telegram Updateに接続します。文書に記載されたフィールドには、 chat_id、 user_id、 username、 text、 commandがあります。
  4. 解析したメッセージに適したワークフローのステップを接続します。元のページには、ルールにはIf-Else、応答にはAIモデルを使うと記載されています。ご自身の環境でポートと型を確認してください。
  5. Telegramへの返信が必要な場合は、別途 API Request を設定し、Telegram Bot APIの sendMessage メソッドを、 chat_id と応答の textを指定して呼び出します。ボットトークンは、ご自身のデプロイ環境が対応する認証情報の管理方法で保持してください。
  6. Telegramのメッセージを送信します。WebhookのJSON、パーサーの値、ワークフローの出力、送信APIの応答の順に確認してください。

期待する結果

受信したTelegramの更新データがWebhookに届き、パーサーが次のステップに必要な、文書に記載されたフィールドを提供します。その後、設定済みの送信用API Requestで返信できます。受信側の接続は文書に記載されていますが、パーサーの正確な出力型と、送信リクエストへの秘密情報の埋め込み方法は環境によって異なるため、最後の接続を作る前に確認してください。

よくあるエラー

  • 受信JSONがない: 登録済みのエンドポイント、公開HTTPSアクセス、Webhook認証を再確認してください。
  • パーサーの値がない: 後続のロジックを変更する前に、受信した更新データを確認してください。
  • 返信がない: まず、 chat_id、応答の text、認証情報の扱い、Telegram APIの応答を確認してください。 Telegramのトラブルシューティングをご覧ください。

Telegram連携 · Telegramの更新データを解析するパーサー · Webhookのトラブルシューティング