Twilio 通信集成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/twilio-communications。
技能介绍
要解决什么问题
在应用里接短信通知、手机号验证或电话 IVR,很容易卡在格式规范、合规和 webhook 安全上:美国号码的 A2P 10DLC、Twilio 回调签名、OTP 速率与欺诈、以及 IVR 的无状态会话设计,都不是「调一个 API」就能稳上线。
技能如何组织
本技能按 三种模式 拆分 Twilio 用法,而不是堆 SDK 文档:
- SMS 发送:强调
E.164(如+1234567890)、默认约 80 MPS、超过 160 字符会分段计费,以及运营商过滤(尤其美国)对投递的影响。 - Twilio Verify(2FA/OTP):验证码生成、过期与渠道(SMS、语音、邮件、推送、WhatsApp)由 Twilio 托管,并带内置欺诈与速率限制,适合注册验证、2FA、密码重置与高价值交易确认。
- TwiML IVR:来电时 Twilio 请求你的 webhook,你返回 TwiML XML;核心动词包括文本转语音、播放音频、
Gather收按键/语音、Dial转接、Record与跳转端点。因 无状态,菜单状态需用 URL 参数或会话存储维护。
适用边界与注意点
技能中的 易踩坑 表值得对照实现:始终验证 webhook 签名、切勿硬编码凭据、在美国发短信需 注册 A2P 10DLC;营销/通知类还要在数据库跟踪退订、对瞬时失败做重试,并在应用层叠加速率限制。它描述的是模式与约束,具体语言 SDK 与账号配置仍需对照 Twilio 官方文档与你方合规要求。
使用场景
- 电商后端在订单发货后,用 E.164 号码向用户发送物流短信,并处理 Twilio 投递状态回调
- 用户注册流程里用 Twilio Verify 发验证码,替代自研 OTP 生成、过期与防刷逻辑
- 客户打进支持热线时,通过 TwiML webhook 返回「按 1 转销售、按 2 转工单」的 IVR 菜单
- 登录或密码重置场景下,用 Verify 的 SMS/语音渠道做二次验证,并依赖内置速率与欺诈拦截
适合人员
- 负责订单与物流通知的后端工程师,需要合规发短信并对接投递回调
- 做账号安全的产品或后端,要在注册、2FA、密码重置里接入手机号验证而非 DIY OTP
- 维护客服热线的工程师,要用 TwiML 搭建无状态 IVR 并管理按键与会话参数
- 面向美国用户发营销或事务短信的开发者,需处理 A2P 10DLC、退订库与 webhook 签名校验