ToShop文档Telegram
把 Telegram Bot 接到 Agent —— 私信、群组、白名单控制、多账号。
Telegram 是 ToShop 两大头等渠道之一。配好后，路由到 Bot 的消息按"与绑定 Agent 的聊天"处理 —— 同样的技能、同样的 Memory、同样的授权门。
配置
拿 Bot Token
在 Telegram 找 @BotFather → /newbot → 复制 Token。格式 123456789:ABC-DEF...。
在 ToShop 添加渠道
设置 → Channels → Add Telegram，粘贴 Token。
选谁能和它说话
开放（任何人 DM）或白名单（指定 Telegram 用户 ID）。
凭证与策略
botToken—— 从 BotFather 拿到。存在系统钥匙串。allowedUsers—— 逗号分隔的 Telegram User ID，或 * 全开。默认仅你自己。dmPolicy—— open（任何人）或 allowlist（仅列表内）。群消息一律必须 @-mention。
消息路由
私信 Bot
与绑定 Agent 的 1:1 会话（遵守 DM 策略）。
群组里 @ 它
仅被 @-mention 时回应；同一线程的后续回复保留上下文。
回复
Telegram 线程 = 任务上下文。在同一线程内回复 = 继续同一会话。
一个 Agent 多个 Telegram 账号
可以把多个 Telegram Bot 接到同一个 Agent（例如：一个用于个人私信，一个用于团队频道）。每个 Bot 是独立凭证，但都喂给同一个 Agent 的会话。
也可以把不同 Bot 接到不同 Agent —— 一个路由到店铺 Agent，另一个到个人 Agent。
传输模式
延迟最低 —— Telegram 直接推事件给 ToShop。
WebSocket 兜底 —— Webhook 不可达环境的长连。
最后兜底 —— 普通 HTTP 长轮询。
ToShop 自动选最优；可在 设置 → Channels → [Telegram bot] → Transport 强制指定。
Bot 能处理什么
文本和语音
文本、图片、语音（先转写再给 Agent 读）。
文件附件
.pdf、.txt、.csv、常见图片格式。
斜杠命令
你配过的 /commands。
Markdown 回复
Telegram 渲染 Markdown 格式。
状态指示
ok—— 已连接、正在接收。standby—— 另一台实例持有租约（你在第二台设备登录）。degraded—— 接收中，但有延迟或错误。fatal—— 配错 / Token 失效 —— 需要处理。
网络安全
白名单保护精心构造的远程 Prompt
Telegram 触发的任务在网络白名单约束下运行。该流程下出站到私网 IP 默认拦截，除非你显式放行。
常见模式
移动端分流
"总结一下未读邮件最新 10 封。"
路上 Shopify 运营
"SKU X 当前库存？" / "退订单 #1234"。
Autopilot 投递
把 Telegram Bot 和 Autopilot 任务配对，每日摘要直接到你 DM。