首页 > API中心 > IVR群呼 > 文档指引

 

AI Agent群呼任务创建

POST

https://api.laaffic.com/v3/voice/group/call/send/agent

AI 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
}
 
callInformation字段传参key(仅IG行销场景使用)
接口使用的参数名 变量 底层 是否必填
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 技术对接频道,即时回应您的需求

前往Telegram联系

Telegram
WhatsApp
咨询

点击此处开启人工服务