Back to Documentation
API & Integrations

Webhook & CRM V2 Integration: 动态上下文同步与自动化

基于 Liquid 模板语法,动态推送上下文诊断到 Salesforce 或 Zendesk。

CXMind V2 的 Webhook 策略实现了从“被动数据同步”到“主动事件驱动的自动化”的跨越。通过内置的 Liquid 断言语法 (Liquid Assertion Syntax),用户可以根据 Salesforce、Zendesk 等第三方 CRM 的严格数据结构要求,动态定制推送报文,实现无缝的自动化闭环。

核心事件触发字典 (Core Event Trigger Dictionary)

call_create (建立连接)
  • 触发时机: 在 SIP 信令 200 OK 确认通话建立时瞬时触发。
  • 业务用途: 触发 CRM 侧的“弹屏 (Screen Pop)”,自动拉取客户历史记录、未关闭工单以及其在 CXMind 中的个性化画像。
call_outcome (意图与情绪捕获)
  • 触发时机: 当 AI 引擎检测到关键的情绪转折点(如客户变得愤怒)或明确的销售意向(如询问报价)时即刻推送。
  • 业务用途: 实时通知主管介入或触发高价值销售线索的自动化跟进流。
call_summary (摘要发射)
  • 触发时机: 通话结束且后处理线程(Post-processing)生成的 AI 摘要完成后发射。
  • 数据深度: 包含通话标签、关键动作项 (Action Items) 以及结构化的业务结论。
quality_score (质检结果广播)
  • 触发时机: 质检逻辑模块完成评分后触发。
  • 业务用途: 将最终得分推送到外部 BI 报表系统或内部激励系统,用于透明化绩效考核。

结构适配与 Liquid 转换引擎

面对具有严格校验规则的“古老”或非标准 CRM 环境,CXMind 使用 Liquid 模板引擎提供极致的映射灵活性。

高级模板示例:

您可以直接在推送配置中编写逻辑判断,例如针对不同的质检得分触发不同的工单状态:

{
  "ticket_id": "{{ call.externalId }}",
  "resolution": "{{ ai.summary }}",
  "qa_status": "{% if qi.score > 85 %}Pass{% else %}Review{% endif %}"
}

高可用与重试机制 (Reliability & Delivery)

为了确保每一条关键指令都能送达 CRM,CXMind 引入了企业级的 Webhook 队列管理:

  • 指数退避重试 (Exponential Backoff):如果目标服务器返回 5xx 错误或超时,CXMind 会在接下来的 24 小时内进行多轮自动重试。
  • Websocket 实时回退:在 Webhook 接收失败的极端情况下,前端 Copilot 面板可通过已建立的 WebSocket 链路进行紧急上下文备份。
  • 签名校验 (HMAC-SHA256):每一个推送报文均包含 X-CXMind-Signature 头部,防止 CRM 端遭受伪造请求攻击。

Need more help or have a specific architecture question?

Contact Engineering Support