快速入门-AI Agent群呼
AI Agent
AI驱动，多模型协同的端到端智能对话系统，打造真人级语音外呼体验。
AI Agent群呼对接流程
前期准备
获取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创建AI Agent群呼任务
根据需求，可参考特色功能，调用AI Agent群呼任务接口进行相关参数传递
特色功能
| 功能 | 参数 | 参数值 | 备注 |
|---|---|---|---|
| 挂机短信 | 无 | 无 | 任务维度不支持挂机短信，该功能需配置在智能体维度，前期请向颂量人员说明需求 |
| 定时呼叫功能 | sendTime | 定时呼叫时间（立即呼叫则传null） | |
| 任务重呼，可选择全部重呼、失败重呼或意图重呼 | recallFlow | 是否重呼，需要重呼时设置，recallFlow为空时则不开启重呼 | 需在请求中配置重呼相关细节 |
curl --location --request POST 'https://api.laaffic.com/v3/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 技术对接频道，即时回应您的需求
