提达艾勒艾欧工程师实战助手

要解决的问题

把语音、短信、WhatsApp 塞进一个业务系统时，真正的坑不在 SDK 调用，而在调用之前：选错渠道会让长文本挤进 160 字符的 SMS；没做 A2P 10DLC 注册，消息会被运营商直接过滤；webhook 没校验 Twilio-Signature，攻击者可以伪造来电或回调。等上线后才发现成本失控、合规缺材料，返工成本远高于早期设计。

技能如何工作

这个技能以 Twilio 工程师的视角介入，在写代码之前先跑一遍五道关卡：

• 渠道适配（Channel Fit）：按紧急度、复杂度、地域匹配 SMS / Voice / Email / WhatsApp，避免用 SMS 承载长内容。
• 合规就绪（Compliance Readiness）：检查 A2P 10DLC 注册、opt-in 记录、GDPR/CCPA/HIPAA/PCI 适用性；不通过就暂停实现。
• 扩展设计（Scalability Design）：以 Super Network 抽象、队列、限流、监控为基线，确保 10x 增长不用重做架构。
• 成本模型（Cost Optimization）：区分 short code / long code / toll-free，估算按量计费与承诺用量折扣。
• 集成架构（Integration Architecture）：验证 webhook 安全、规划 Segment 数据打通、设计失败回退。

在实现层，技能覆盖六条主线：多渠道通信流程设计、SMS 基础设施（10DLC、短码、全球合规）、语音应用（IVR、点击呼叫、TwiML/Studio 工作流）、Segment 统一画像与旅程编排、安全合规（Verify API、TCPA/GDPR/HIPAA、webhook 签名校验）、以及 Super Network 路由与投递率优化。交流风格偏开发者：多语言代码优先（Node.js、Python、Java、C#、Ruby、PHP）、指向具体端点与参数、始终讨论错误处理、重试、幂等与回退。

适用边界

技能把风险写在前面，但不做决策替代：

• 美国 A2P 短信必须注册 10DLC，未注册流量面临过滤与更高费用；TCPA 违规每条短信可能产生 $500–$1,500 法定赔偿。
• 国际消息需遵守当地法规（欧盟 GDPR、加拿大 CASL、澳大利亚 Spam Act），注册与文案要求各不相同。
• 深度依赖 Twilio 专有 API（TwiML、TaskRouter）会带来迁移成本，建议在业务侧抽象一层 provider-agnostic 接口。
• 按量计费模式下流量尖峰、循环重试或滥用会导致账单超预期，需要配合限流与预算告警。
• SKILL.md 中部分数据表存在缺失或占位（如 API 响应时间指标、号码策略步骤未完整给出），使用时需自行补全。

它适合作为架构评审与实现参考，而不是替你签字确认合规结论。