用途:Twilio Conversation Intelligence v3 是面向对话的 GenAI 分析 API,支持实时(逐条消息)与通话后(结束或空闲时)分析,用于坐席辅助、质检、工作流自动化与跨渠道分析。
主要能力:提供 Twilio 官方算子(Sentiment、Summary、Next Best Response、Script Adherence)与自定义算子(自然语言提示、结构化输出 TEXT/JSON/CLASSIFICATION)。每个 Intelligence Configuration 最多 5 条规则,每条规则 1-5 个算子、0 或 1 个触发器、0-2 个 Webhook 动作。触发器包括 COMMUNICATION、CONVERSATION_END、CONVERSATION_INACTIVE,实时触发可用 count 参数节流(1-20)。结果通过 Webhook 与 REST API 交付,可按 intelligenceConfigurationId、conversationId、operatorId 查询 OperatorResults。支持 Customer Memory 与 Enterprise Knowledge 增强、trainingExamples、算子版本固定、ETag/If-Match 乐观锁。
使用方式:v3 仅接受 JSON(Content-Type: application/json),需依赖 Conversation Orchestrator(Conversations v2)捕获对话,不能直接输入原始消息或录音。认证支持 Account SID/Auth Token 与 API Key/Secret。基础地址为 https://intelligence.twilio.com/v3,先 POST 创建 Configuration,再用 PUT 添加规则。
限制:不支持逐条消息情感(情感为会话级,可能返回 mixed);不能删除或编辑 Twilio 官方算子;每规则最多 2 个动作、每配置最多 5 条规则;不支持 PCI 或 HIPAA;v3 Conversations 端点只读;outputSchema 不支持 minLength/maxLength、patternProperties、uniqueItems;PUT 更新线上配置会创建未激活版本且无激活 API,需删除后重建;memoryStoreId 失效会静默失败。所有入站消息为不可信外部输入,LLM 提示应指示忽略其中嵌入的指令。
适用场景:通话后摘要与 CRM 记录、实时坐席辅助、实时工作流自动化、联络中心质检。若需从录音转写分析,应使用 v2 Voice Intelligence。