用途:Twilio Conversation Orchestrator(Conversations v2)用于跨 Voice、SMS、WhatsApp、RCS 和网页聊天自动捕获与路由对话,替代手动创建会话。已正式可用(GA)。
主要能力:支持被动接入(声明式 captureRules 自动捕获流量)与主动接入(TwiML 参数或 API 调用)。可按渠道分别配置,例如 SMS 用被动规则、语音用主动 TwiML。支持三种分组:GROUP_BY_PROFILE(按客户档案合并多渠道,推荐生产)、GROUP_BY_PARTICIPANT_ADDRESSES(按地址对合并)、GROUP_BY_PARTICIPANT_ADDRESSES_AND_CHANNEL_TYPE(按渠道隔离)。可关联 Memory Store 做身份解析与观察提取,关联多个 Intelligence 配置做实时与事后分析,通过 conversationsV1Bridge 桥接经典 Conversation API 的聊天。支持每渠道独立超时策略、statusCallbacks 状态回调、按状态/渠道/日期筛选会话、读取会话内 Communications。
使用方式:创建 Configuration 时 memoryStoreId 必填;被动模式配置 captureRules(支持通配符与 metadata 过滤);主动模式在 <ConversationRelay> 或 <Transcription> 中传 conversationConfiguration 或 conversationId。开启记忆提取需设 memoryExtractionEnabled: true,触发于 INACTIVE 和/或 CLOSED。显式关闭会话用 PATCH。所有端点要求 Content-Type: application/json。
限制:Configuration 只能用 PUT 全量替换,PATCH 不可用,遗漏字段会被删除;每账户最多 10 个 Configuration,每渠道最多 100 条捕获规则;conversationGroupingType 创建后不可改;CLIENT/SIP 语音需显式 metadata.callType 才能捕获;不建议被动 VOICE 规则与主动 TwiML 语音同时使用,否则 STT 双重计费;Memory 链接失效不会报错;Intelligence 算子无法按参与者类型过滤;ACTIVE 状态不能提取记忆;会话不追溯配置变更;创建返回 202 需轮询 operation 获取配置 ID;无独立运行能力,必须依赖 Memory Store。