1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | twilio-whatsapp-send-message-twilio-ai |
| 作者/维护者 | Twilio（官方） |
| 来源链接 | https://github.com/twilio/ai/tree/main/skills/twilio/twilio-whatsapp-send-message |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars / Forks | 28 / 7（数据来自 GitHub API；数字为 twilio/ai 整个技能合集仓库的热度，合集下含 57 个技能，不代表本技能自身热度） |
| 最新版本 | 无独立版本号——技能随合集仓库持续更新，未发布 release/tag |
| 安装方式 | Claude Code 插件市场 / 直接复制技能目录 |
2. 功能介绍与亮点
这是 Twilio 官方为 AI coding agent 编写的 WhatsApp 消息发送深度参考，聚焦“把 WhatsApp 消息真正发出去”这一件事，而不是泛泛的产品介绍：
- 两种发送模式讲透：清楚区分“自由格式”（用户 24 小时内有过互动才能用）与“模板消息”（任何时候都能发，但需 Meta 审批），并指出自由格式消息超窗发送会静默失败——这是开发者最容易踩的坑。
- Python / Node.js 双语言可复制代码：账号搭建、沙箱测试、正式发送、带模板变量发送、带媒体发送均有完整示例。
- 专门的错误码对照表：列出 63003、63018、63020 等常见错误码的含义与修复方法。
- CANNOT 清单：明确写出发送速率上限（每发送方 80 消息/秒）、消息排队上限（4 小时）、沙箱限流、必须获得用户 opt-in 等硬约束，减少 agent 凭空杜撰限制或误判。
- 与同合集内账号搭建、鉴权、发送方管理、模板构建等多个技能相互引用，构成一条完整的 WhatsApp 落地路径。
3. 适用场景
所属分类：集成与工作流自动化
适合任何需要让 AI coding agent 帮忙把 WhatsApp 消息发送功能接入应用的开发者——无论是电商订单确认、物流通知，还是客服系统的双向消息。尤其适合两类人群：第一次对接 Twilio WhatsApp、需要一次搞懂 API 与 Meta 合规要求的初级开发者；以及消息发送出现“发不出去/静默失败”等问题、需要照着错误码表排查的开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。官方提供插件市场安装（
/plugin marketplace add twilio/ai+/plugin install twilio-developer-kit@twilio），技能可按需自动加载或用/twilio-...直接调用。 - Codex（OpenAI）：✅ 官方支持。技能目录内含
agents/openai.yaml元数据文件，README 给出git clone+ 复制到~/.agents/skills/的安装方法。 - OpenClaw：❓ 未验证。官方文档未点名提及，技能遵循开放的 Agent Skills 标准（SKILL.md 格式），理论上可手动复制安装，但缺乏官方确认。
- Hermes Agent：❓ 未验证。同上，官方未点名，未见相关材料。
5. 推荐理由
WhatsApp 是很多面向国际用户产品的核心触达渠道，但它的规则（24 小时窗口、模板审批、沙箱限流）比普通 SMS 复杂，AI agent 容易在细节上出错。这份技能由 Twilio 官方维护，把最容易踩坑的规则、错误码、硬约束写成了结构化参考。它也是同合集内被其他技能引用最多的一份——账号设置、鉴权、消息总览、模板构建、发送方管理等多份技能都会指向它，处于整套 Twilio 消息体系里较核心的位置。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Twilio 是 WhatsApp 消息发送这一能力的第一方所有者，官方身份本身是信誉背书；所在仓库 28 星由 57 个技能共享，不构成本技能自身的独立热度证据 |
| 可用性 | 8 | Python/Node 双语言 quickstart 可直接复制运行，但需先配置 TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN 并完成 WhatsApp 发送方注册；技能内容近期有更新维护 |
| 安全性 | 9 | 纯参考文档类技能，不含可执行脚本，不主动联网外发数据；凭据统一通过环境变量传入，未见明文存储；License 明确、作者为 Twilio 官方 |
安全检查清单：
① 不执行 shell 命令，仅提供开发者自行运行的 SDK 代码示例
② 技能本身不联网，网络调用由开发者自己的代码发起，目标是文档化的 Twilio API
③ 要求 TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN，明确要求以环境变量存储，未见硬编码或明文示例
④ SKILL.md 全文未见可疑指令或隐蔽外发
⑤ 作者为 Twilio 官方账号，无造假迹象
⑥ License 为 MIT，明确
⑦ 技能内容近三个月内有更新，仓库本身持续活跃、未被归档
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| twilio-sms-send-message（同合集内） | Twilio SMS 通道发送参考 | 面向短信通道，无 24 小时窗口/模板审批这类 WhatsApp 特有规则 |
| wassengerhq/whatsapp-skills | 第三方 WhatsApp Business API 服务商 Wassenger 出品的 22 个技能集合 | 面向 Wassenger 自家 BSP 平台，覆盖群发、活动等运营功能更广，但绑定其专有账号体系，不是 Twilio 生态的原生选项 |
8. 用户评价
日本技术社区 Classmethod DevelopersIO 的作者越井琢巳（2026-06-06）实测了 Twilio 面向 Claude Code 的 Skills 与 MCP，评价其为“官方推荐开发流程的模板”，并特别指出 SMS、Voice、WhatsApp、Verify、SendGrid、Compliance 是 Skills 覆盖较完整的方向；同时提醒 Skills 推荐的具体操作步骤仍需自行核实是否在当前环境可用，不宜盲目信任。
9. 其他补充
技能正文标注为 Twilio Skills 体系里的 “Product” 类型（教如何正确使用某一个 Twilio 产品），与同合集内 “Planner”（选型顾问）、“Setup”（账号搭建）、“Guardrail”（运维防护）三类技能互为补充。
10. 安装使用方式
Claude Code：
/plugin marketplace add twilio/ai
/plugin install twilio-developer-kit@twilio安装后技能会在提示词匹配到 WhatsApp 发送场景时自动加载，也可用 /twilio-whatsapp-send-message 手动调用。
Codex（OpenAI）：
git clone https://github.com/twilio/ai.git
cp -r ai/skills/ ~/.agents/skills/通用方式： 直接将 skills/twilio/twilio-whatsapp-send-message 目录复制进目标 agent 的 skills 目录即可，无需重启，遵循标准 SKILL.md 格式。
11. 注意事项
- 生产环境发送前需先在 Twilio Console 注册并通过 WhatsApp Business 发送方审核，未注册前只能使用每日 50 条、3 天过期的沙箱环境测试。
- 自由格式消息只能在用户最近一次主动发消息后的 24 小时内发送，超时发送会静默失败而非报错，需格外注意窗口判断逻辑。
- WhatsApp Groups API 已于 2020 年 4 月弃用，需要群组功能应改用 Twilio Conversations API。
- 该技能仍随 Twilio Public Beta 阶段的 Skills/MCP 项目一同标注为公测状态，接口细节可能变化，且不受 Twilio 官方 Support Terms/SLA 覆盖。