ToShop文档Telegram
把 Telegram Bot 接到 Agent —— 私信、群组、白名单控制、多账号。
Telegram 是 ToShop 两大头等连接之一。配好后，路由到 Bot 的消息按"与绑定 Agent 的聊天"处理 —— 同样的技能、同样的 Memory、同样的授权门。
配置
拿 Bot Token
在 Telegram 找 @BotFather → /newbot → 复制 Token。格式 123456789:ABC-DEF...。
在 ToShop 添加连接
打开页面左边栏的 连接 入口 → Add Connection，选 Telegram，按提示把 Bot 接上 —— 凭证存进系统钥匙串。
选谁能和它说话
开放（任何人 DM）或白名单（指定 Telegram 用户 ID）。
凭证与策略
- Bot Token —— 从 BotFather 拿到。存在系统钥匙串。
- Allowed User IDs —— 逗号分隔的 Telegram User ID，或
*全开。默认仅你自己。 - DM 策略 —— 开放（任何人可 DM Bot）或白名单（仅指定用户）。群消息一律必须 @-mention。
消息路由
私信 Bot
与绑定 Agent 的 1:1 会话（遵守 DM 策略）。
群组里 @ 它
仅被 @-mention 时回应；同一线程的后续回复保留上下文。
回复
Telegram 线程 = 任务上下文。在同一线程内回复 = 继续同一会话。
一个 Agent 多个 Telegram 账号
可以把多个 Telegram Bot 接到同一个 Agent（例如：一个用于个人私信，一个用于团队频道）。每个 Bot 是独立凭证，但都喂给同一个 Agent 的会话。
也可以把不同 Bot 接到不同 Agent —— 一个路由到店铺 Agent，另一个到个人 Agent。
怎样保持在线
ToShop 会用 Telegram 在你的网络环境下允许的方式让 Bot 保持在线 —— 推送、实时连接、或兜底轮询。大多数用户不用操心；要强制选一种，去这条连接的 高级 设置（连接 入口下）里改。
Bot 能处理什么
文本和语音
文本、图片、语音（先转写再给 Agent 读）。
文件附件
.pdf、.txt、.csv、常见图片格式。
斜杠命令
你配过的 /commands。
Markdown 回复
Telegram 渲染 Markdown 格式。
状态指示
- Connected（已连接） —— 在线接收消息。
- Standby（待命） —— 另一台实例持有租约（你在第二台设备登录）。
- Degraded（降级） —— 接收中，但有延迟或错误。
- Disconnected（断开） —— 配错 / Token 失效 —— 需要处理。
常见模式
移动端分流
"总结一下未读邮件最新 10 封。"
路上 Shopify 运营
"SKU X 当前库存？" / "退订单 #1234"。
Routine 投递
把 Telegram Bot 和 routine 配对，每日摘要直接到你 DM。