一个 Conversation 跨多通道——客户在 SMS 发消息,agent 在 WhatsApp 回,依然在同一对话里
Email 通道有特殊限制(仅 SendGrid,且需要单独配置)
POST /Conversations 创建对话,POST /Conversations/{Sid}/Participants 添加参与者(指定通道地址),POST /Conversations/{Sid}/Messages 发送消息。
可用率 · 30 天窗口
关于这个 API
Conversations 是 Twilio 2020 年推出的下一代 messaging API,是 Chat v1 的演进。它的关键设计是把「通道」抽象化——一个 Conversation 不绑定特定通道,参与者可以从 SMS 加入、可以从 WhatsApp 加入、可以从浏览器 chat SDK 加入,所有人看到同一个消息线程。这特别适合做客服系统:客户从 WhatsApp 发问题,agent 在内部 chat 工具回复,对话历史完整保留。同时它支持丰富的 webhook 钩子,方便接入 LLM 做自动回复、做路由分流、做合规审计。对于 2020 年后的新项目,Conversations 是默认选择,不再用 Chat v1。
你可以做什么
- 1客服 agent 与客户跨 SMS+WhatsApp 同一线程对话
- 2群组聊天,参与者跨多通道
- 3消息历史持久化和搜索
- 4把 Chat v1 应用迁移过来
优劣对比
优点
- 一个 Conversation 跨多通道——客户在 SMS 发消息,agent 在 WhatsApp 回,依然在同一对话里
- 原生支持 webhook 钩子做 bot/路由
- 持久化消息历史,支持搜索
注意事项
- Email 通道有特殊限制(仅 SendGrid,且需要单独配置)
- 群组容量上限 100 个参与者
示例请求
curl https://support.twilio.com/<endpoint>快速开始
POST /Conversations 创建对话,POST /Conversations/{Sid}/Participants 添加参与者(指定通道地址),POST /Conversations/{Sid}/Messages 发送消息。
常见问题
同一手机号能在多个 Conversation 里出现吗?+
可以。Participants 是按 (conversation_id, channel_address) 索引,同一号码可以在不同对话里独立存在。
Conversations 怎么和 Studio Flow 集成?+
在 Studio 里用 Conversations widget 把入站消息路由进 Flow。Flow 处理完可以回写消息到原 Conversation。
消息历史保留多久?+
默认无限期。可以在 Service 级别设置 TTL(消息和 conversation 都可单独设)。
技术细节
- 认证方式
- unknown
- 计费
- unknown
- 协议
- REST, WebSocket
- SDK
- python, javascript, java, ruby, php, csharp, go
- 响应时间
- 166 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 Events 把 Twilio 平台事件(消息送达、通话状态变化、配额告警)以统一 webhook 流式推送,避免单 endpoint 散落配置。
Twilio Flex 是面向呼叫中心的可编程 contact center 平台,提供 agent 工作台、IVR/ACD 路由、和与 Twilio 全栈通信的深度集成。