1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | twilio-content-template-builder-twilio-ai |
| 作者/维护者 | Twilio(官方) |
| 来源链接 | https://github.com/twilio/ai/tree/main/skills/twilio/twilio-content-template-builder |
| 许可证 | MIT(数据来自 GitHub API) |
| GitHub Stars / Forks | 28 / 7(数据来自 GitHub API;数字为 twilio/ai 整个技能合集仓库的热度,合集下含 57 个技能,不代表本技能自身热度) |
| 最新版本 | 无独立版本号——技能随合集仓库持续更新,未发布 release/tag |
| 安装方式 | Claude Code 插件市场 / 直接复制技能目录 |
2. 功能介绍与亮点
这份技能教 AI coding agent 使用 Twilio Content API 创建、管理、发送跨渠道消息模板:
- 一套模板打通四个渠道:模板用
ContentSid(HX...)标识,创建一次即可在 WhatsApp、SMS、RCS、MMS 之间复用,不必为每个渠道单独写内容。 - Console 与 API 双路径:最简单的方式是在 Console 的 Content Template Builder 里点几下创建模板;需要程序化批量管理时,也给出了完整的 Python/Node.js API 代码(创建、提交审批、查询状态、列出、删除)。
- WhatsApp 审批流程讲清楚:区分
UTILITY/MARKETING/AUTHENTICATION三种模板分类,说明提审后 Meta 审批通常 1 小时内出结果,并给出被拒后必须换名重新提交等硬规则。 - 富媒体类型对照表:图文、快捷回复按钮、行动按钮、列表选择器、卡片、轮播图分别对应哪个渠道支持,一张表说明白。
- CANNOT 清单:明确写出模板变量数量上限(100 个)、变量与非变量文本的比例下限、AUTHENTICATION 模板不能自定义变量等边界,减少 agent 凭空杜撰。
- 与同合集内账号搭建、鉴权、WhatsApp 发送方管理等技能相互引用,是消息发送体系的一环。
3. 适用场景
所属分类:集成与工作流自动化
适合需要在应用里发送预审批、格式统一的结构化消息的开发者——例如电商的订单确认与到货提醒、医疗与教育行业的预约提醒、金融类的验证码与账单通知。尤其适合两类人群:需要同时覆盖 WhatsApp 与 SMS/RCS 多渠道、想用一套模板逻辑维护的开发者;以及第一次接触 WhatsApp Business 模板审批流程、不清楚 Meta 审核规则的初级开发者。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持。官方提供插件市场安装(
/plugin marketplace add twilio/ai+/plugin install twilio-developer-kit@twilio),技能可按需自动加载或直接调用。 - Codex(OpenAI):✅ 官方支持。技能目录内含
agents/openai.yaml元数据文件,可通过git clone后复制到~/.agents/skills/安装。 - OpenClaw:❓ 未验证。官方文档未点名提及,技能遵循开放的 Agent Skills 标准(SKILL.md 格式),理论上可手动复制安装,但缺乏官方确认。
- Hermes Agent:❓ 未验证。同上,官方未点名,未见相关材料。
5. 推荐理由
多数开发者第一次做 WhatsApp/RCS 富媒体消息时,容易卡在“模板要不要审批”“不同渠道格式怎么统一”这类细节上。这份技能把 Content API 的模板创建、提审、状态查询整套流程写成了带双语言代码的操作手册,并且明确标出了变量规则与审批硬约束,能直接减少 AI agent 在这类任务上编造步骤或漏掉审批环节的概率。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Twilio 是 Content API 这一能力的第一方所有者,官方身份本身是信誉背书;所在仓库 28 星由 57 个技能共享,不构成本技能自身的独立热度证据 |
| 可用性 | 8 | Console 端可视化创建即可拿到 ContentSid 直接使用,API 路径也有 Python/Node 双语言完整示例;仅需配置账号凭据,WhatsApp 场景下模板审批另需等待 |
| 安全性 | 9 | 纯参考文档类技能,不含可执行脚本,不主动联网外发数据;凭据统一通过环境变量传入,未见明文存储;License 明确、作者为 Twilio 官方 |
安全检查清单:
① 不执行 shell 命令,仅提供开发者自行运行的 SDK 代码示例
② 技能本身不联网,网络调用由开发者自己的代码发起,目标是文档化的 Twilio Content API
③ 要求 TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN,明确要求以环境变量存储,未见硬编码或明文示例
④ SKILL.md 全文未见可疑指令或隐蔽外发
⑤ 作者为 Twilio 官方账号,无造假迹象
⑥ License 为 MIT,明确
⑦ 技能内容维护于 2026 年 5 月,仓库本身持续活跃(最近一次推送 2026-07-29)、未被归档
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| twilio-whatsapp-send-message(同合集内) | WhatsApp 自由格式/模板消息发送参考 | 聚焦“把消息发出去”这一步(含 24 小时窗口规则),不涉及模板本身如何创建、提审、跨渠道复用 |
| wassengerhq/whatsapp-skills | 第三方 WhatsApp Business API 服务商 Wassenger 出品的技能集合 | 专注 WhatsApp 单一渠道,模板管理绑定其专有 BSP 账号体系,不像本技能可用同一套模板覆盖 WhatsApp/SMS/RCS/MMS 多渠道 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
技能正文标注为 Twilio Skills 体系里的 “Product” 类型(教如何正确使用某一个 Twilio 产品),与同合集内 “Planner”(选型顾问)、“Setup”(账号搭建)、“Guardrail”(运维防护)三类技能互为补充。
10. 安装使用方式
Claude Code:
/plugin marketplace add twilio/ai
/plugin install twilio-developer-kit@twilio
安装后技能会在提示词匹配到模板创建/发送场景时自动加载,也可手动指定调用。
Codex(OpenAI):
git clone https://github.com/twilio/ai.git
cp -r ai/skills/ ~/.agents/skills/
通用方式: 直接将 skills/twilio/twilio-content-template-builder 目录复制进目标 agent 的 skills 目录即可,无需重启,遵循标准 SKILL.md 格式。
11. 注意事项
- WhatsApp 模板必须经 Meta 审批才能在 24 小时服务窗口外使用,计划审批时间通常在 1 小时内,但仍需预留缓冲;被拒绝的模板不能用同一名称重新提交。
- 变量与非变量文本的比例有下限要求(至少
(2x+1):x),纯变量堆砌的模板会被拒绝。 - 面向 RCS 富媒体模板(卡片、轮播图、快捷回复)发送时,若配置了 SMS 兜底,需额外提供
twilio/text纯文本版本,否则非 RCS 设备的用户收不到可读消息。 - 该技能仍随 Twilio Public Beta 阶段的 Skills/MCP 项目一同标注为公测状态,接口细节可能变化,且不受 Twilio 官方 Support Terms/SLA 覆盖。