用途:在应用中集成 Twilio 通信能力,包括短信/彩信收发、语音通话与 TwiML、电话号码搜索购买与配置、Webhook 实时事件与投递通知、双向短信会话、批量发送、消息定时、生产部署,以及美国 A2P 10DLC 品牌与活动注册;也支持构建兼容多短信供应商(Twilio 与 Telnyx)的架构。
主要能力:通过 Node.js SDK 或直接 HTTP 调用发送短信;使用 E.164 格式校验与规范化号码;用 TwiML(如 <Message>、<Redirect>、<Dial>、<Say>、<Play>)响应 Webhook;处理 MessageSid、From、To、Body、MessageStatus、NumMedia 等字段;跟踪 queued、sending、sent、delivered、undelivered、failed 状态;用 HMAC-SHA1 或 SDK 校验 X-Twilio-Signature;错误分类与指数退避重试;批量发送限速;幂等处理与超时保护。
使用方式:认证采用 HTTP Basic,用户名为 Account SID、密码为 Auth Token,请求头为 Authorization: Basic base64(ACCOUNT_SID:AUTH_TOKEN),基础地址 https://api.twilio.com/2010-04-01。凭证通过环境变量 TWILIO_ACCOUNT_SID、TWILIO_AUTH_TOKEN、TWILIO_PHONE_NUMBER 配置。Webhook 需保留原始请求体以校验签名,并返回 text/xml 的 TwiML。
适用场景:短信通知系统、语音 IVR、双向短信交互、批量营销或提醒、多供应商短信网关。
限制:资料未提供具体收费与价格信息;速率限制为短信约 200 条/秒(企业级)、语音默认 100 并发、API 默认每小时 10000 次请求,实际以账户为准;美国 A2P 10DLC 注册审批约 5-7 个工作日;长短信按 GSM-7 或 UCS-2 分段,最多 10 段。