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

Brand

消息

语音

 

AI Agent群呼任务创建

POST

https://api.itniotech.com/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为业务字段名（如name、borrow_total_money） 传参key见下面 表格 否（仅金融催收场景、金融催收-紧急联系人转达场景使用） Map<String, String>
text1 被叫信息：Text1。可用于替换文本变量模板中的变量${text1}，如果文本变量模板中有${text1}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text2 被叫信息：Text2。可用于替换文本变量模板中的变量${text2}，如果文本变量模板中有${text2}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text3 被叫信息：text3。可用于替换文本变量模板中的变量${text3}，如果文本变量模板中有${text3}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text4 被叫信息：Text4。可用于替换文本变量模板中的变量${text4}，如果文本变量模板中有${text4}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text5 被叫信息：Text5。可用于替换文本变量模板中的变量${text5}，如果文本变量模板中有${text5}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text6 被叫信息：Text6。可用于替换文本变量模板中的变量${text6}，如果文本变量模板中有${text6}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text7 被叫信息：Text7。可用于替换文本变量模板中的变量${text7}，如果文本变量模板中有${text7}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text8 被叫信息：Text8。可用于替换文本变量模板中的变量${text8}，如果文本变量模板中有${text8}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text9 被叫信息：Text9。可用于替换文本变量模板中的变量${text9}，如果文本变量模板中有${text9}时该参数传值不能为null，字段长度不超过30字符串否则将截取 否 String
text10 被叫信息：Text10。可用于替换文本变量模板中的变量${text10}，如果文本变量模板中有${text10}时该参数传值不能为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
 
callInformation字段传参key（适用于金融催收场景、金融催收-紧急联系人转达场景）
接口使用的参数名 变量 底层 【金融催收】场景智能体：是否必填 【金融催收-紧急联系人转达】场景智能体：是否必填
name Text1 还款人 是 是
borrow_total_money Text2 当前应还款总金额 是 否
due_date Text3 应还款日期 是 是
due_days Text4 已逾期天数 否 否
platform Text5 贷款类型/产品 否 否
gender Text6 性别 否 否
loan_date Text7 贷款日期 否 否
loan_total_money Text8 贷款总金额 否 否
overdue_fee Text9 当前逾期费 否 否
emergency_contact_name Text10 紧急联系人姓名 否 是
/ Text11 / 否 否
 
请求示例
Request URL:
    https://api.itniotech.com/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
}
 
响应状态码
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智能体行业意图与重呼意图不匹配
通话录音文件地址获取
队列剔除呼叫号码

此页面的内容有帮助吗？

对接有疑问？联系我们的技术支持

ITNIO TECH API 专属 TG 技术对接频道，即时响应您的需求

前往Telegram联系

Telegram

微信扫码

立即咨询

客户服务热线

400-999-8488