首页 > API中心 > IVR群呼 > 文档指引
https://api.laaffic.com/v3/voice/group/call/send/agent
| 参数 | 说明 | 是否必填 | 类型 |
|---|---|---|---|
| appId | 应用id | 是 | String |
| displayNum | 显示号码,0-20位数字,允许为空 | 否 | String |
| taskName | 任务名,长度2-64,不可重复 | 是 | String |
| numberInfoList | 被叫号码,最大20w个手机号,多个手机号以逗号隔开,每个手机号为:国码+手机号组成的6-18位数字。 | 是 | List<Object> |
| calleeNumber | 被叫号码,国码+手机号组成的6-18位数字 | 是 | String |
| callInformation | 被叫信息:自定义字段名的被叫信息,key为业务字段名(如roduct_brand_name) 传参key见下面 表格 | 否(仅IG营销场景使用) | Map<String, String> |
| text1 | 被叫信息:Text1。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text2 | 被叫信息:Text2。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text3 | 被叫信息:text3。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text4 | 被叫信息:Text4。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text5 | 被叫信息:Text5。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text6 | 被叫信息:Text6。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text7 | 被叫信息:Text7。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text8 | 被叫信息:Text8。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text9 | 被叫信息:Text9。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| text10 | 被叫信息:Text10。可用于替换文本变量模板中的变量NULL,如果文本变量模板中有NULL时该参数传值不能为null,字段长度不超过30字符串否则将截取 | 否 | String |
| sendTime | 定时呼叫时间(立即呼叫则传null) | 否 | LocalDateTime |
| maxCalls | 最长通话时长,接通后n秒强制挂断,最大999秒, 默认300s | 否 | Integer |
| allowSendTime | 可发送时间段最多添加3个 | 否 | List |
| strTime | 开始时间 HH:MM | 否 | String |
| endTime | 结束时间 HH:MM | 否 | String |
| maxRingingTime | 最大响铃时长,默认60,可输入10-120秒 | 否 | Integer |
| agentId | 智能体ID | 是 | Integer |
| enableRecording | 是否开启录音,0-否,1-是,不填默认“是” | 否 | Integer |
| deadline | 任务最晚执行时间 yyyy-MM-dd HH:mm:ss | 否 | LocalDateTime |
| recallFlow | 重呼流程 | 否 | Object |
| recallType | 重呼类型: 0全部重发 1失败重发 3意图重呼 | 否(recallFlow 传入时必填) | Integer |
| recallInterval | 重呼间隔 | 否(recallFlow 传入时必填) | Integer |
| recallIntent | 重呼-意图 传编码,详情请见编码对应表 | 否 | List<String> |
| recallNum | 重呼次数 | 否(recallFlow 传入时必填) | Integer |
| nodeList | 流程节点 | Object | List<String> |
| agentId | 智能体ID | 否(nodeList传入时必填) | Integer |
Request URL:
https://api.laaffic.com/v3/voice/group/call/send/agent
Request Method:
POST
Request Headers:
Content-Type: application/json;charset=UTF-8
Sign: 05d7a50893e22a5c4bb3216ae3396c7c
Timestamp: 1630468800
Api-Key: bDqJFiq9
Request Body:
{
"appId": "2Xql9RBI",
"taskName": "我要测试智能体API-16",
"displayNum": "1008122211",
"maxCalls": 300,
"maxRingingTime": 60,
"agentId": 41,
"enableRecording": 1,
"calloutRate": 1,
"allowSendTime": [
{
"strTime": "18:28",
"endTime": "19:28"
}
],
"numberInfoList": [
{
"calleeNumber": "8613200000007",
"callInformation": {
"name": "张三",
"borrow_total_money": "5000",
"due_date":"2026-02-02"
}
}
],
"recallFlow": {
"recallType": 3,
"recallInterval": 1,
"recallNum": 5,
"nodeList": [
{
"agentId": "41"
},
{
"agentId": "41"
},{
"agentId": "41"
},{
"agentId": "41"
},{
"agentId": "41"
}
],
"recallIntent": [
"99998",
"99999"
]
}
}| 参数 | 说明 | 类型 |
|---|---|---|
| code | 状态码,0成功,其他失败参见响应状态码说明 | String |
| msg | 失败原因说明 | String |
| data | 该方法返回 keyId | Integer |
{
"code":"0",
"msg":"success",
"data":123123
}| 接口使用的参数名 | 变量 | 底层 | 是否必填 |
|---|---|---|---|
| product_brand_name | Text1 | 产品/品牌名称 | 否 |
| / | Text2 | / | 否 |
| / | Text3 | / | 否 |
| / | Text4 | / | 否 |
| / | Text5 | / | 否 |
| / | Text6 | / | 否 |
| / | Text7 | / | 否 |
| / | Text8 | / | 否 |
| / | Text9 | / | 否 |
| / | Text10 | / | 否 |
| code | 状态说明 |
|---|---|
| 0 | 成功 |
| -1 | 账号认证异常 |
| -2 | ip限制 |
| -10 | 余额不足 |
| -16 | 时间戳过期 |
| -18 | 系统异常 |
| -20 | 数据已存在 |
| -21 | 数据校验异常 |
| -22 | 参数异常 |
| -23 | 数据上限 |
| -24 | 数据不存在 |
| -26 | 获取费率失败 |
| -35 | 没有被叫号码 |
| -37 | 您提交的群呼任务超过最大并发任务限制,请完成任务后再提交! |
| -38 | 转换文本和语言类型必填 |
| -39 | 获取文本语言类型失败 |
| -41 | 任务名称已经存在 |
| -46 | 长文本转语音每天最大5次,您已使用完,请联系商务处理 |
| -53 | 挂机短信触发条件必须有一个 |
| -60 | AI话术模板不存在 |
| -68 | AI智能体行业意图与重呼意图不匹配 |
对接有疑问?联络我们的技术支援
LAAFFIC API 专属 TG 技术对接频道,即时回应您的需求
点击此处开启人工服务