〇、先搞懂几个词（小白必读）
-
工作流：你在画布里搭的那套自动流程。
-
BotFather：Telegram 官方的「机器人管理员」机器人，所有 TG 机器人都通过它创建。
-
Bot Token：机器人的唯一钥匙，形如
123456789:AAE...。创建机器人时 BotFather 会给你。保密。 -
Webhook：一个网址。用户给机器人发消息时，Telegram 把消息推送到这个网址（推给我们的服务器），从而触发工作流。
-
setWebhook：把上面那个网址「注册」给 Telegram 的动作——告诉 TG「以后消息往这个网址推」。本文教你用浏览器一键完成。
一、你将得到什么
接好之后：
-
在 Telegram 里给机器人发一句话或一张图，它就会触发你的工作流自动运行。
-
工作流跑完，结果（文字 / 图片）自动回到 TG，并引用你的原消息。
-
处理时机器人会显示「正在输入…」状态。
说明：TG 接入做的是自动模式完整闭环（发消息 → 跑完 → 回结果）。飞书那套「确认卡片按钮」「失败诊断打字机」是飞书专属能力，TG 这边失败时直接回一条文字说明。这是两个平台本身能力不同，不影响核心使用。
二、开始前的准备
-
一个 Telegram 账号（手机装好 Telegram App）。
-
一个已经搭好、且全部是后台节点的工作流：
-
开始节点必须是「Webhook 开始」节点（不是普通「开始」节点）。
-
工作流里不能有要在浏览器操作的节点（如「文本输入」「文件上传」）。用「Webhook 开始」节点接收 TG 的文字和图片即可。
三、第一步：找 BotFather 创建机器人，拿到 Bot Token
-
在 Telegram 里搜索 @BotFather（带蓝色官方认证勾的那个），点开对话。
-
发送命令
/newbot。 -
按提示给机器人起：
-
一个显示名称（随便起，如「我的工作流助手」）。
-
一个用户名（必须以
bot结尾，如my_workflow_bot，全局唯一）。
- 创建成功后，BotFather 会回你一段 Bot Token，长这样：
123456789:AAExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
这串 Token 就是机器人的钥匙，妥善保管，别泄露给别人。 后面要填到工作流里。
界面位置：在 Telegram 里搜索
@BotFather（认准带蓝色认证勾的官方账号）并打开对话，发送/newbot，按它的提问依次回复「显示名称」和「以 bot 结尾的用户名」。创建成功后，BotFather 会在对话里直接回一条包含 Bot Token 的消息，Token 就是那串数字:字母组合，长按可复制。
四、第二步：在工作流画布里填 Token + 拿到 Webhook 地址
-
打开你的工作流画布，点中「Webhook 开始」节点。
-
在右侧配置里：
-
触发平台：选「Telegram」。
-
Telegram Bot Token：填第一步拿到的 Token。
-
Webhook Secret Token（可选）：可以自己编一串随机字符串（如
mysecret_8a7d6f），填进去能加一层防伪造保护。不想搞就留空。 -
交互模式：选「自动」（推荐，收到消息直接跑完回结果）。
-
保存工作流。保存后这个工作流会有一个 ID（一长串 uuid，形如
0aeda01a-0f09-46e5-...）。 -
你的 Webhook 地址就是：
https://api.openai.run/v1/workflow/webhook/telegram/你的工作流ID
把末尾「你的工作流ID」换成真实 ID。下一步要把它注册给 Telegram。
五、第三步：把 Webhook 地址注册给 Telegram
最省事的办法（推荐）：在「工作流管理 → 我的工作流」里，把这个 TG 工作流启用 webhook 触发后，它的 webhook 地址下方会出现一个蓝色「一键注册到 Telegram」按钮。点它，系统会用你填的 Bot Token 自动拼好注册链接并在新标签打开——看到
{"ok":true}就完成了，完全不用手动拼网址。
下面的手动方法仅当你不想用按钮时备用。
Telegram 不像飞书有可视化后台，注册 Webhook 要发一个网址请求。手动办法：把下面的网址拼好，直接粘贴到浏览器地址栏打开即可（这是 TG 官方接口，浏览器打开就算调用成功）。
不设 Secret Token（简单版）
把下面这串里的两个占位换成你的真实值，粘到浏览器打开：
https://api.telegram.org/bot【你的BotToken】/setWebhook?url=https://api.openai.run/v1/workflow/webhook/telegram/【你的工作流ID】
举例（假设 Token 是 123:ABC，工作流 ID 是 0aeda01a-...）：
https://api.telegram.org/bot123:ABC/setWebhook?url=https://api.openai.run/v1/workflow/webhook/telegram/0aeda01a-...
设了 Secret Token（推荐，安全版）
如果你在第二步填了 Secret Token，注册时也要带上它（两边必须一致）：
https://api.telegram.org/bot【你的BotToken】/setWebhook?url=https://api.openai.run/v1/workflow/webhook/telegram/【你的工作流ID】&secret_token=【你填的SecretToken】
怎么算成功
浏览器打开后，页面显示这样的 JSON 就成功了：
{"ok":true,"result":true,"description":"Webhook was set"}
如果 "ok":false，看 description 的提示——通常是 Token 填错或地址有空格。
提示：注册一次就够了，除非你换了工作流 ID 或 Token，否则不用再注册。
六、第四步：在画布里启用工作流
回到工作流画布：
-
把触发方式设为 webhook。
-
启用该工作流。
只有「已启用 + webhook 触发」的工作流才会被 TG 消息触发。忘了启用的话，机器人会回你「该工作流尚未启用 webhook 触发」。
七、测试
-
在 Telegram 里搜索你刚创建的机器人用户名（如
@my_workflow_bot），点开。 -
点「开始 / Start」，然后给它发一句话（你工作流期望的输入）。
-
正常情况下：机器人显示「正在输入…」→ 几秒到几十秒后引用你的消息回复结果（文字或图片）。
八、常见问题
Q：发消息给机器人没反应？
-
先确认第三步的 setWebhook 返回了
"ok":true。没成功就重新拼地址打开一次。 -
确认工作流已「启用 + webhook 触发」。
-
确认 Bot Token 在画布里填对了，并且保存了工作流。
Q：setWebhook 打开显示 ok:false？
-
检查 Bot Token 有没有复制全（含中间的冒号）。
-
检查地址里有没有多余空格或换行。
-
工作流 ID 要和画布里保存后的一致。
Q：发图片给它，它报错或没正确处理？
- 取决于你的工作流有没有处理图片的节点。如果工作流只接文字处理（如纯对话），发纯图片可能因为没有文字输入而失败。请确认工作流节点能消费图片输入。
Q：想换机器人 / 换工作流？
- 在画布更新「Webhook 开始」节点的 Token 并重新保存，然后用新的工作流 ID 重新执行第三步的 setWebhook。
Q：怎么取消 / 停掉 webhook？
- 浏览器打开：
https://api.telegram.org/bot【你的BotToken】/deleteWebhook，看到"ok":true即取消。
九、速查表（一页纸）
1. @BotFather 发 /newbot → 拿 Bot Token
2. 画布「Webhook 开始」节点：平台选 Telegram，填 Bot Token（可选填 Secret Token）→ 保存
3. 浏览器打开注册 webhook：
https://api.telegram.org/bot<Token>/setWebhook?url=https://api.openai.run/v1/workflow/webhook/telegram/<工作流ID>
（设了 secret 就加 &secret_token=<你的Secret>）
→ 看到 {"ok":true} 即成功
4. 画布把工作流设为 webhook 触发并启用
5. 在 TG 里私聊机器人发消息测试
飞书与 Telegram 可以分别接到不同工作流，互不影响——每个工作流的「Webhook 开始」节点各自选自己的平台和凭据即可。