首頁 > API中心 > IVR群呼 > 文檔指引

快速入門-管理端

呼叫中心

支持群呼轉坐席、比例式外呼、自動呼叫等功能，實現呼叫效率及客戶體驗的雙向提升。

呼叫中心對接流程

前期準備

取得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次