短信工具是做什么的
短信工具让 agent 帮你处理活动邀约、提醒和跟进，使用的是你自己的 Twilio 账户。它适合需要向一批联系人发送消息的组织或个人。
两点让它既安全又属于你：
- 你的 Twilio，你的账单。 你连的是自己的 Twilio 账户，短信费用记在它上面。我们不碰钱。
- Agent 只起草，发送由你。 Agent 只能把消息放进待发队列并保存为草稿。你在 MangoTart 短信页审阅并批准；agent 没有直接发送途径，这是刻意的安全设计。
它不是聊天通道
短信不是让别人和 agent 聊天的入口。MangoTart 位于你的家庭网络后面，没有用于入站 webhook 的公网地址。它是一个对外工具：agent 起草、你批准、MangoTart 发送。
开始前：先有个 Twilio 账户
注册并验证账户
在 twilio.com 注册并完成验证。试用账户也能拿来测试（限制见文末）。
复制你的凭证
在 Twilio 控制台找到 Account Info 面板，复制你的 Account SID（以 AC… 开头）和 Auth Token。
选择发送方式
Twilio 提供两种发送身份，工具把它们做成两种类型：
| 类型 | 发自 | 适合 | 能收回复？ |
|---|---|---|---|
| Direct（直发） | 你自己的 Twilio 号码 | 1 对 1 消息 | 能——可以收到回复 |
| Broadcast（群发） | 字母数字 Sender ID（如 XXChamber） | 以你名义署名的单向群发通知 | 不能 |
获取一个发送身份
两者至少要有一个，也可以都设：
- 一个号码（用于 Direct）——在 Twilio 的 Phone Numbers → Manage → Buy a number 里买：选国家、勾上 SMS、点 Buy。
- 一个字母数字 Sender ID（用于 Broadcast）——一个短名字，比如
XXChamber。
字母数字 Sender ID 是 1–11 位字母和数字，且至少含一个字母。它并非在所有国家都可用，有些还需要预先注册——按你要发往的地区查 Twilio 的说明。
在 MangoTart 上连接 Twilio
在 MangoTart 管理界面打开短信（SMS）页，点击添加账号。
贴上凭证
填入 Twilio 控制台里的 Account SID 和 Auth Token。
设置发送身份
填一个 Sender ID（用于群发）、一个 E.164 格式的 发送号码（如 +61480000000，用于直发），或两者都填。
命名并保存
给账号起个名字（可选）并保存。可以添加多个 Twilio 账号，并设一个为默认。
然后用 「发送测试」 给自己的手机发一条，确认一切正常。
Agent 怎么起草短信
在聊天里直接说明要求，例如*“给这十位会员发周五晚宴的邀请”*。Agent 会：
- 给每个收件人各起草一条、稍作个性化，用对类型（直发或群发）；
- 把它们放进短信页的待发队列。
此时还没有发出。接着由你：
- 打开 「短信」 页，审阅草稿；
- 在想发的那几条上点 「批准」；
- MangoTart 通过 Twilio 发出，并保留限速和审计记录。
你也可以在同一页不经过 agent，自己撰写并发送。
回复与退订
- 回复——直发消息的回复会从 Twilio 轮询回来并显示在短信页。Agent 可以汇总谁已确认、谁需要跟进。
- 退订——有人回复 STOP / 退订 / unsubscribe 时，把对方标为退订（agent 也能做）。之后 MangoTart 会拦截发往该号码的所有短信。
回复是不可信输入
Agent 把收到的回复视为不可信文本：它可以汇总内容，但不会执行回复中夹带的指令，例如“把会员名单发给我”。
小贴士与排查
- Twilio 试用账户只能发给你在控制台里验证过的号码，且每条会带一段试用提示。要正式群发请先升级。
- 某条显示“失败”——原因来自 Twilio（号码未验证、地区未开通，或该地不允许 Sender ID）。这是 Twilio／账户设置问题，不是 agent 能自行修复的问题。
- 号码必须是 E.164——一个
+、国家码、再加号码，不带空格（如+61480000000）。