🤖 Telegram 多模态消息处理机器人

通过 n8n 工作流接收 Telegram 文本/语音/图像消息，经 AI 分类或分析后自动回复

给谁

已部署 n8n、拥有 Telegram Bot 与 OpenAI API 凭证的搭建者

你会得到

机器人自动识别消息类型（文本/语音/图像），完成 AI 分类或内容分析，并向用户返回处理结果

你需要

n8n · telegram

步骤

1. 配置 Telegram Webhook

   在 n8n 中配置 Telegram Bot 的 Webhook 地址，使机器人能够实时接收消息。需设置测试环境与生产环境两套端点，并验证 Webhook 状态。

   搭建指导 · 来源原文。n8n 工作流中 Sticky Note1 节点内容；用于指导 Webhook 配置

   复制提示词

   # How to set up a Telegram Bot WebHook
   
   ## WebHook Setup Process
   
   **Basic Concept**
   A WebHook allows your Telegram bot to automatically receive updates instead of manually polling the Bot API.
   
   **Setup Method**
   To set a WebHook, make a GET request using this URL format:
   ```
   https://api.telegram.org/bot{my_bot_token}/setWebhook?url={url_to_send_updates_to}
   ```
   Where:
   - `my_bot_token`: Your bot token from BotFather
   - `url_to_send_updates_to`: Your HTTPS endpoint that handles bot updates
   
   
   **Verification**
   To verify the WebHook setup, use:
   ```
   https://api.telegram.org/bot{my_bot_token}/getWebhookInfo
   ```
   
   A successful response looks like:
   ```json
   {
    "ok": true,
    "result": {
      "url": "https://www.example.com/my-telegram-bot/",
      "has_custom_certificate": false,
      "pending_update_count": 0,
      "max_connections": 40
    }
   }
   ```
   
   
   This method provides a simple and efficient way to handle Telegram bot updates automatically through webhooks rather than manual polling.

2. 接收消息并验证用户

   通过 Webhook 节点接收 Telegram 消息，然后使用 Set 节点定义允许的用户信息（名字、姓氏、用户 ID），再由 IF 节点比对发送者身份。未通过验证的用户将收到错误提示。

3. 路由消息类型

   使用 Switch 节点根据消息内容自动分流：检测到 voice 字段走语音分支，检测到 text 字段走文本分支，检测到 photo 字段走图像分支，其余进入错误处理。

4. 处理文本消息

   提取消息文本后，由 Text Classifier 节点（连接 GPT-4o-mini）判断消息是否为创建任务/todo。分类为 task 时回复「Task message: <内容>」，否则回复「Other message: <内容>」。

   运行提示词 · 来源原文。Text Classifier 节点 categories[0].description

   复制提示词

   If the message is about about creating a task/todo

   运行提示词 · 来源原文。Text Classifier 节点 categories[1].description

   复制提示词

   If the message is not about creating a task/todo

5. 处理语音消息

   从 Telegram 下载语音文件，使用 OpenAI 节点的 audio/transcribe 功能将语音转为文本。随后通过 Text Classifier Audio 节点（连接 GPT-4o-mini）分类为 task 或 other，并发送对应格式的回复。

   运行提示词 · 来源原文。Text Classifier Audio 节点 categories[0].description

   复制提示词

   If the message is about about creating a task/todo

   运行提示词 · 来源原文。Text Classifier Audio 节点 categories[1].description

   复制提示词

   If the message is not about creating a task/todo

6. 处理图像消息

   提取图像 file_id 与 caption，从 Telegram 下载图像后转为 base64，再使用 OpenAI 节点的 image/analyze 功能（模型 GPT-4O-MINI）分析图像内容，最后将分析结果回复给用户。

请根据以下 n8n 模板搭建 Telegram 多模态消息处理机器人。先确认你已拥有：1）可公开访问的 n8n 实例；2）Telegram Bot Token；3）OpenAI API Key。按步骤配置 Webhook、用户验证字段、消息路由与 AI 节点凭证。搭建完成后，先在测试 Webhook 下发送文本消息验证流程。