替代散落在各资源上的 statusCallback URL
不能替代 inbound 消息 webhook(仍要在 phone number 配置 SmsUrl)
POST /Sinks 创建 webhook 接收端,POST /Subscriptions 订阅事件类型并绑定 sink。Twilio 会异步把匹配事件 POST 到你的 URL。
可用率 · 30 天窗口
关于这个 API
Events API 是 Twilio 2021 年引入的事件总线,目的是替代散落在各产品里的 statusCallback 配置(每个 phone number、每个 Conversation、每个 Studio Flow 都要单独配 webhook URL,运维很痛苦)。用 Events,你只要在账户级别创建 Sink(指向你的 webhook URL),订阅感兴趣的事件类型(message.delivered、call.completed、limits.usage_threshold 等),Twilio 就会统一把事件流推过来。还支持把 Sink 类型设为 Segment 或 AWS Kinesis 做直接灌入。对监控、合规审计、和 CRM 集成都是必备。
你可以做什么
- 1统一接收所有 Twilio 事件做监控/告警
- 2把事件流灌入 Kafka 做下游分析
- 3消息送达状态同步到 CRM
- 4配额接近时收到提前告警
优劣对比
优点
- 替代散落在各资源上的 statusCallback URL
- 订阅维度细——可以只订阅 message.delivered 不订阅 message.sent
- 支持事件重放(最多 4 小时)
注意事项
- 不能替代 inbound 消息 webhook(仍要在 phone number 配置 SmsUrl)
- Sink 一旦失败超过重试次数事件会丢失
示例请求
curl https://support.twilio.com/<endpoint>快速开始
POST /Sinks 创建 webhook 接收端,POST /Subscriptions 订阅事件类型并绑定 sink。Twilio 会异步把匹配事件 POST 到你的 URL。
常见问题
Events 能完全替代 statusCallback 吗?+
inbound 还需要 statusCallback。outbound 状态(sent/delivered/failed)可以完全交给 Events。
事件丢失了能补发吗?+
4 小时内可以用 Replay API 重新拉取。超出窗口需要从 Twilio Insights 或 Bulk Exports 重建。
推送频率有上限吗?+
Twilio 对每个 sink 限速 100 events/s。超出会降级到 4 小时 replay 队列。
技术细节
- 认证方式
- unknown
- 计费
- unknown
- 协议
- REST, Webhook
- SDK
- python, javascript, java, ruby, php, csharp, go
- 响应时间
- 177 ms
- 上次巡检
- 2026/5/12 07:38:32
更多来自 Twilio 的 API
管理 Twilio 主账户和子账户的凭证与设置:创建子账户、轮换认证令牌、查询账户层级。
Twilio 主 API,覆盖语音通话、SMS、Voice、Verify 等通讯能力,按用量计费。
Twilio Autopilot 是已停服的对话式 AI 平台,原本用于构建 IVR 机器人和 NLU 任务(目前推荐迁移到 Voice Intelligence / 第三方 LLM)。
批量导出 Twilio 历史使用数据(Messages / Calls)为压缩 JSON 文件,按天打包,用于审计、计费对账、或灌入数据仓库。
Twilio Chat v1 是已停服的实时聊天 SDK 后端(已被 Conversations 取代);存量项目仍可调用,新项目应直接用 Conversations API。
Twilio Content API 集中管理跨渠道(WhatsApp/SMS/Messenger)的消息模板,含 WhatsApp 模板审批流和动态变量绑定。
Twilio Conversations 是统一跨通道(SMS/MMS/WhatsApp/Chat/Email)的「对话」抽象,支持多参与者、消息持久化、和 read-receipt。
Twilio Flex 是面向呼叫中心的可编程 contact center 平台,提供 agent 工作台、IVR/ACD 路由、和与 Twilio 全栈通信的深度集成。