外呼平台接入SCRM自检说明文档

📋 文档说明

文档用途：本文档用于帮助第三方呼叫平台技术人员快速判断自身系统是否符合尘锋SCRM呼叫中心的接入要求。

适用对象：第三方呼叫平台的技术负责人、架构师、开发工程师。

重要提示：

✅ 本文档为自检清单，用于初步判断接入可行性

✅ 自检通过后，尘锋技术人员会根据资料进行二次核对与确认

❌ 不支持软电话条方式接入；

🎯 接入流程概述

尘锋SCRM呼叫中心的外呼流程已固定，第三方平台需支持以下标准流程：

1. 鉴权认证（如需） → 2. 发起外呼 → 3. 事件回调 → 4. 录音获取

交互流程：

尘锋调用三方系统鉴权接口获取token（如果需要）

尘锋调用第三方外呼接口

第三方系统在通话结束之后一次性将通话数据（包含录音地址）回调给尘锋系统；

核心原则：

所有接口均为 HTTP/HTTPS 协议

外呼发起采用 同步调用 方式

通话数据采用 异步回调（Webhook） 方式

录音文件可以通过 公网URL直接访问 方式获取

token必须是全局可用；

外呼和回调接口入参都单次只支持单条数据（不支持数组），不支持单次批量外呼和批量回调；

✅ 自检清单

📌 维度一：鉴权机制与接口安全（如需）

1.1 鉴权方式支持

要求：支持以下任一鉴权方式

鉴权方式	说明	示例
✅ 静态API Key	在HTTP Header/body中携带固定Key	`Authorization: api_key xxxxxxxx`
✅ Bearer Token	在HTTP Header/body中携带Token	`Authorization: Bearer xxxxxxxx`
✅ 参数签名	基于MD5的签名	`signature=md5(params+secret)`

❌ 不支持的鉴权方式：

非标准的动态加密算法

复杂的多重鉴权机制

token非全局可用，每次外呼都需要进行token接口请求；

📌 维度二：发起外呼接口参数要求

2.1 必填参数完整性

要求：发起外呼接口必须支持以下核心参数

参数名称	参数说明	是否必填	备注
被叫	客户手机号	✅ 必填	如：`callee`、`phone_number`
主叫	员工号码或唯一id	✅ 必填	如：`caller`、`display_number`

⚠️ 关键要求：

字段名可以不同，但语义必须具备

自检问题：

你们的发起外呼接口支持哪些参数？

该ID是否会在后续回调中返回？

2.2 接口调用方式

要求：

请求方式：HTTP POST

请求格式：JSON 或 Form Data

响应格式：JSON

自检问题：

接口是否支持POST请求？

请求和响应格式是什么？

📌 维度三：事件回调与录音获取

3.1 异步回调支持（Webhook）

要求：必须支持Webhook机制，在通话结束时主动推送通话结果，必须包含录音地址（外网可以访问）

回调时机：

通话结束（必须）

回调方式：

请求方式：HTTP POST

请求格式：JSON

回调URL：由尘锋SCRM提供

自检问题：

你们的系统是否支持Webhook回调？

回调时机是否支持？

是否满足回调方式要求？

3.2 回调参数的关联性

要求：回调数据中必须包含与外呼接口一致的主叫与被叫信息

必填回调参数：

**主叫ID（**与发起外呼时传入的主叫ID一致）

被叫ID（与发起外呼时传入的被叫ID一致）

通话状态

通话开始时间

通话结束时间

**录音地址

⚠️ 关键要求：

回调中必须包含尘锋SCRM传入的主被叫ID

录音地址必须是可以通过URL可以直接公网访问的地址

自检问题：

回调数据中包含哪些参数，是否满足要求？

回调中的主被叫ID是否与外呼接口入参传入的主被叫ID一致？

录音地址是否支持公网访问？

3.3 录音文件获取方式

要求：回调数据中必须包含录音文件的URL

录音URL要求：

必须是公网HTTP/HTTPS链接

可直接在浏览器中播放或下载

可支持简单的URL签名或固定的Header Token

❌ 不支持需要额外调用接口下载二进制流的方式

❌ 不支持需要复杂解密的方式

自检问题：

回调数据中是否包含录音URL？

录音URL是否可直接访问？

是否需要特殊的鉴权或解密？

3.4 回调参数结构

要求：回调参数必须是单条记录，不支持批处理

❌ 不支持的回调结构：

{
  "records": [
    {"call_id": "1", "status": "completed"},
    {"call_id": "2", "status": "completed"}
  ]
}

✅ 支持的回调结构：

{
  "call_id": "1",
  "status": "completed",
  "task_id": "123456",
  "record_url": "https://example.com/recording/1.mp3"
}

自检问题：

回调数据结构是单条还是多条？

是否单条数据回调（包含录音）？

📊 判断标准

✅ 可接入（初步判断）

满足以下所有条件：

鉴权方式符合要求（静态API Key / Bearer Token / 参数签名）

发起外呼接口支持业务关联ID

支持Webhook异步回调

回调中包含发起外呼时候的主被叫ID

回调中包含公网可直接访问的录音URL

外呼和回调中的参数结构为单条记录

❌ 无法接入

满足以下任一条件：

不支持Webhook回调

录音无法通过公网URL直接获取

回调结构为批处理且无法转换

🔍 常见问题

Q1：录音URL需要签名验证，是否可以？

A：不支持。

Q2：我们的回调是批量推送的，是否可以接入？

A：当前系统不支持批量回调，需要第三方平台改为单条推送。

文档版本：v1.0
更新日期：2026-04-15
维护方：尘锋技术团队

外呼平台接入SCRM自检说明文档

📋 文档说明#

🎯 接入流程概述#

✅ 自检清单#

📌 维度一：鉴权机制与接口安全（如需）#

1.1 鉴权方式支持#

📌 维度二：发起外呼接口参数要求#

2.1 必填参数完整性#

2.2 接口调用方式#

📌 维度三：事件回调与录音获取#

3.1 异步回调支持（Webhook）#

3.2 回调参数的关联性#

3.3 录音文件获取方式#

3.4 回调参数结构#

📊 判断标准#

✅ 可接入（初步判断）#

❌ 无法接入#

🔍 常见问题#

Q1：录音URL需要签名验证，是否可以？#

Q2：我们的回调是批量推送的，是否可以接入？#

📋 文档说明

🎯 接入流程概述

✅ 自检清单

📌 维度一：鉴权机制与接口安全（如需）

1.1 鉴权方式支持

📌 维度二：发起外呼接口参数要求

2.1 必填参数完整性

2.2 接口调用方式

📌 维度三：事件回调与录音获取

3.1 异步回调支持（Webhook）

3.2 回调参数的关联性

3.3 录音文件获取方式

3.4 回调参数结构

📊 判断标准

✅ 可接入（初步判断）

❌ 无法接入

🔍 常见问题

Q1：录音URL需要签名验证，是否可以？

Q2：我们的回调是批量推送的，是否可以接入？