快速入門-AI Agent群呼
AI Agent
AI驅動，多模型協同的端到端智能對話系統，打造真人級語音外呼體驗。
AI Agent群呼對接流程
前期準備
獲取API Key、API Secret和appId的值。
需登錄客戶端獲取, 具體位圖如下圖所示：
Sign簽名規則
使用API Key + API Secret + Timestamp當前系統時間戳（秒），生成MD5-32位字符串(不區分大小寫)作為簽名。
示例：
API Key：bDqJFiq9
API Secret：7bz1lzh9
Timestamp當前系統時間戳（秒）：1630468800
MD5(bDqJFiq97bz1lzh91630468800)：05d7a50893e22a5c4bb3216ae3396c7c
API對接流程
01創建AI Agent群呼任務
根據需求，可參考特色功能，調用AI Agent群呼任務接口進行相關參數傳遞
特色功能
| 功能 | 參數 | 參數值 | 備註 |
|---|---|---|---|
| 掛機短信 | 無 | 無 | 任務維度不支持掛機短信，該功能需配置在智能體維度，前期請向頌量人員說明需求 |
| 定時呼叫功能 | sendTime | 定時呼叫時間（立即呼叫則傳null） | |
| 任務重呼，可選擇全部重呼、失敗重呼或意圖重呼 | recallFlow | 是否重呼，需要重呼時設置，recallFlow為空時則不開啟重呼 | 需在請求中配置重呼相關細節 |
curl --location --request POST 'https://api.laaffic.com/voice/group/call/send/agent'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: a2d04f937f87aac9928d596bd033c8bf'
--header 'Timestamp: 1775014268'
--header 'Api-Key: SQLHdsQFe0Gk8ckwJZqcwxfUYRm0Qu0o'
--data-raw '{
"appId": "Jgd8oFei",//AI語音應用ID
"taskName": "test",//任務名
"displayNum": "123456",//顯示號碼
"maxCalls": 300, //最長通話時長300s
"maxRingingTime": 60, //最大響鈴時長60s
"agentId": 110, //智能體ID
"enableRecording": 1, //開啟錄音
"sendTime": "2026-04-01 00:00:00", //設置定時發送
"calloutRate": 1, //外呼倍率設置為1
"numberInfoList": [
{
"calleeNumber": "919777654321", //被叫號碼
"text1":"David", //被叫信息（還款人，催收場景必傳參數，支持作為變量插入掛機短信）
"text2":"5000", //被叫信息（應還金額，催收場景必傳參數，支持作為變量插入掛機短信）
"text3":"2026-04-10" //被叫信息（還款日期，催收場景必傳參數，支持作為變量插入掛機短信）
},
{
"calleeNumber": "919771234567",
"text1":"Oliver", //被叫信息（還款人，催收場景必傳參數，支持作為變量插入掛機短信）
"text2":"1000", //被叫信息（應還金額，催收場景必傳參數，支持作為變量插入掛機短信）
"text3":"2026-04-10" //被叫信息（還款日期，催收場景必傳參數，支持作為變量插入掛機短信）
}
],
"recallFlow": {
"recallType": 3, //按照意圖重呼
"recallInterval": 1, //重呼間隔設置為1分鐘
"recallNum": 2, //重呼2次
"nodeList": [
{
"agentId": "110"
},
{
"agentId": "110"
}
],
"recallIntent": [
"99999" //重呼意圖設置已呼叫未接通
]
}
} '
註釋：numberInfoList中寫入所有被叫號碼及被叫信息，calleeNumber代表被叫號碼、text1/text2/text3代表被叫信息，可作為金融催收場景、金融催收-緊急聯繫人轉達場景的接口傳參，也可作為變量插入掛機短信內容中。
02狀態報告推送
當用戶在賬戶設置-語音應用管理頁面，配置了http推送地址後，平台會將http-api接入的語音，狀態報告主動推送給用戶配置地址。可登錄客戶端設置，具體位置如圖所示
參考信息
常見錯誤碼速查
以下是幾個常見錯誤碼原因和處理方式，全局可看 全局狀態碼
| Status | Reason | Description |
|---|---|---|
| -1 | Authentication error | 檢查API Key、API Secret和appId的參數值 |
| -18 | Port program unusual | 檢查請求格式，請求body是否是json格式 |
| -22 | The length of the nodeList parameter is incorrect | 重撥次數recallNum與nodeList的節點數量不匹配，請您將兩者調整為一致 |
| -67 | The AI agent industry's intent does not match the callback intent | 檢查recallIntent參數值 |
此頁面的內容有幫助嗎？
對接有疑問？聯絡我們的技術支援
LAAFFIC API 專屬 TG 技術對接頻道，即時回應您的需求
