快速入门-管理端
呼叫中心
支持群呼转坐席、比例式外呼、自动呼叫等功能，实现呼叫效率及客户体验的双向提升。
呼叫中心对接流程
前期准备
获取API Key、API Secret和appld的值。
需登陆客户端获取, 具体位图如下图所示：
Sign签名规则
使用API Key + API Secret + Timestamp当前系统时间戳（秒），生成MD5-32位字符串(不区分大小写)作为签名。
示例：
API Key：bDqJFiq9
API Secret：7bz1lzh9
Timestamp当前系统时间戳（秒）：1630468800
MD5(bDqJFiq97bz1lzh91630468800)：05d7a50893e22a5c4bb3216ae3396c7c
API对接流程
01新增坐席组
在语音应用下 “新增坐席组”。
curl --location --request POST 'https://api.laaffic.com/v3/cc/seatGroup/addGroup'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: a090b2d5fafa44c3cb46418fc47b35ee'
--header 'Timestamp: 1766149876'
--header 'Api-Key: SQLHdsQFe0Gk8ckwJZqcwxfaYRm0Qu0o'
--data-raw '{
"groupName":"test-1",
"appId":"HsiT9A6d"
}'02批量创建坐席
在坐席组下“批量创建坐席”。
curl --location --request POST 'https://api.laaffic.com/v3/cc/seat/addSeatList'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 9f897c6bb4ca9b1ff43c70f17c5c79c8'
--header 'Timestamp: 1766157823'
--header 'Api-Key: SQLHdsQFe0Gk8ckwJZqcwxfUYRc0Qu0o'
--data-raw '{
"voiceGroupId":5005421,
"size":2,
"displayNum":"1234",
"ccode":"91"
}'03上传呼叫号码EXCEL
将号码文件转为base64编码，并调用接口“上传号码文件”。
curl --location --request POST 'https://api.laaffic.com/v3/cc/preview/upload'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 79112c4cc45d3e41d6e3a9bb2358ef38'
--header 'Timestamp: 1766044959'
--header 'Api-Key: SQLHdsQFe0Gk8ckwJZqcwxfUYtm0Qu0o'
--data-raw '{
"fileName":"Template_voice_numFiles_cn.xls",
"file":"base64编码的文件内容"
}'04创建任务（号码去重）
可选择自动呼叫还是群呼转坐席，去“创建任务”。
curl --location --request POST 'https://api.laaffic.com/v3/cc/preview/submitTask'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: a090b2d5fafa44c3cb46418fc47b35ee'
--header 'Timestamp: 1766149876'
--header 'Api-Key: SQLHdsQFe0Gk8ckwJZqcxxfUYRm0Qu0o'
--data-raw ' {
"filePath": "/mnt/cc/upload/execl/202509121719054_Jenny_.xls",
"voiceGroupId": [
5000531
],
"appId": "HsiT9A6d",
"calloutRate": 1,
"type": 1,
"fileName": "Template_voice_numFiles_cn.xls",
"remark":"群呼转坐席"
}'状态报告推送
1、“通话记录主动推送示例”
当用户在“账户设置-语音应用”管理页面，配置了cc-http推送地址后，平台会将呼叫中心生成的通话记录，主动推送给用户配置地址。
注意： 我方推送失败后，会隔30分钟再次进行推送，最多推送3次
可 登录 客户端设置，具体位置如图所示：
2、“坐席振铃事件主动推送示例”
当用户在“坐席振铃时会主动推送信息给用户配置地址，振铃事件应当是对时效性敏感的推送，建议用户接收到我方请求后立即向我方响应HTTP CODE 200，并且异步处理业务逻辑。
注意： 如果我方推送失败后，会立即重试，最多推送3次
可 登录 客户端设置，具体位置如图所示：
常见错误码速查
以下是几个常见错误码原因和处理方式，全局可看 全局状态码
| Status | Reason | Description |
|---|---|---|
| -1 | Authentication error | 检查API Key、API Secret和appId的参数值 |
| -18 | Port program unusual | 检查请求格式，请求body是否是json格式 |
此页面的内容有帮助吗？
对接有疑问？联络我们的技术支援
LAAFFIC API 专属 TG 技术对接频道，即时回应您的需求
