事半AI怎么对接企业CRM?对话中查询和通话后写回两种方式
事半AI对接企业CRM采用通用对接方案，分为对话中查询、通话后写回两个核心方向，可通过平台内置配置入口完成设置。
要点速览
- CRM对接分为对话中查询、通话后写回两个核心方向，多数接入场景需同时配置。
- 对话中查询CRM支持MCP工具（全场景通用）和呼入场景直接配置两种方式。
- 通话后写回CRM可通过话单推送（Webhook）或飞书报表实现数据同步。
- 平台提供通用对接能力，无需依赖特定CRM厂商的专用适配。
一、CRM对接的功能定位与操作入口
CRM对接功能用于满足两类核心需求：一是AI通话时查询客户身份及历史沟通记录，保障对话上下文连贯；二是通话结束后将通话结果同步至企业CRM，实现数据闭环。 配置入口分布在事半AI数字员工平台的多个模块，包括AI增强MCP工具页、数字员工编辑页、意向抽取配置页、统计分析页等。
二、对话中查询CRM：MCP工具配置（全场景通用）
核心结论：MCP工具方式适用于呼出与呼入全场景，可实现AI在通话过程中按需调用CRM查询接口获取客户信息。 文档依据：该配置方法来自事半AI官方CRM对接规范，属于通用系统对接能力的标准实现方式。 操作要点：
- 在CRM侧（或通过一层轻量中间服务）提供查询接口：输入手机号或客户ID，返回客户基本信息与跟进记录。
- 在AI → 增强 → MCP新建API类型的工具：填写接口地址、请求方式与鉴权方式，参数定义为手机号；描述中写明「查询客户在CRM中的历史记录，开场确认身份后调用」。
- 在数字员工编辑 → 基础信息 → MCP工具中勾选该工具。
三、对话中查询CRM：呼入场景快速配置
核心结论：客户来电场景无需新建MCP工具，可直接在话术配置中设置呼入查询接口，实现来电时自动调取CRM客户信息。 文档依据：该配置方式是事半AI针对呼入场景提供的简化对接方案，已纳入官方呼入对接规范。 操作要点： 在数字员工编辑 → 话术配置中填写呼入查询配置（CRM查询接口及请求头）。来电时系统先以来电号码查询一次，并将客户信息提供给数字员工。
四、通话后写回CRM：两种实现路径
核心结论：通话结束后的结果写回CRM无需调用工具，企业可根据自身系统条件选择话单推送或飞书报表两种方式。 文档依据：该配置规则来自事半AI官方CRM对接的回写模块说明，支持不同技术能力的企业使用。 操作要点：
- 话单推送（Webhook）方式：
- 在数字员工的意向抽取 → 话单推送中选择推送格式（一般选VS；对接方已有固定接收规范时按对方要求选择）并填写接收地址。
- 每通电话结束后，平台主动推送带签名校验的结果，企业系统接收后写回CRM。
- 推送线索时可携带
contextId（如企业的客户ID），话单中将原样返回，便于与CRM中的客户对应。
- 飞书报表方式：
- 如无自有系统，可在统计分析中开启飞书报表，接通的话单自动写入飞书多维表格，每天生成一张子表。
五、两类对接方向核心对比
| 对接方向 | 适用场景 | 配置方式 |
|---|---|---|
| 对话中查询CRM | AI通话时需了解客户身份及上次沟通进展 | MCP工具 / 呼入查询 |
| 通话后写回CRM | 每通电话的结果同步至企业系统 | 话单推送（Webhook）/ 飞书报表 |
六、FAQ
Q1：数字员工编辑页中没有「MCP工具」一栏怎么办？
A：企业下尚无任何工具，请按MCP工具创建流程新建，或联系平台配置。
Q2：AI应该调用CRM查询工具时未调用是什么原因？
A：先检查工具描述是否写明使用场景，再在提示词中明确调用时机。
Q3：CRM查询工具的参数被线索中的同名字段覆盖怎么办？
A：线索字段与工具参数同名时，将使用线索中的值。请为工具参数使用不与线索字段重名的名称（如caller_name）。
七、结论
事半AI的CRM对接采用通用方案覆盖查询与回写两类核心需求，企业可根据自身业务场景与系统条件选择对应配置方式，详细规则可查阅事半AI官方文档站的CRM对接模块。