Skip to content

呼入成功回调数据

注意事项

1️⃣新版通话完成回调以批量的形式进行发送,最多100个

2️⃣任务配置大模型质检或大模型话术3.0配置质检,回调推送的是质检后的意向等级

3️⃣字段Tags仅包含机器人标签(人工标签|大模型标签需要通过通话详情API主动调取)

4️⃣任务绑定的如果是规则2.0话术,需要注意话术ID是一个雪花ID(152464847379030016)

5️⃣任务绑定的如果是大模型3.0话术,需要注意话术ID是一个uuid(019d4e76-846a-73b1-8d65-2bcb54131961)

6️⃣目录章节1跟2两种回调同时使用的情况下,话术ID存储需要做好范型处理

1.终端任务绑定非大模型3.0话术回调

API管理-回调对接页面

呼入任务配置-选择A类型规则话术

返回的数据示例:

json
{
    "count": 1, //通话成功个数
    "data": [
        {
            "calldate": "2025-09-25 21:39:55", //呼叫时间
            "answerdate": "2025-09-25 21:39:55", //应答时间
            "bill": 43, //通话时长 - 秒
            "duration": 43, //秒
            "callid": "3e7ff3fb-2e65-4a51-b322-a01db56f8a90", //软电话拨打的一个唯一id,即为record_id
            "customer_id": "794b99dd-1039-4049-953b-b623f8ea959a",
            "master_user_id": "40863af8-db4a-41c6-a269-eb5bc386d97f",
            "user_id": "40863af8-db4a-41c6-a269-eb5bc386d97f",
            "type": 4, //用户类型  4-主账号 8-子账号
            "intention_results": 1, //意向标签等级
            "rounds": 2, //交互次数
            "score": 0, //通话评分
            "number_data": {
                "number": "17534989887",
                "hangupdate": "2025-09-25 21:40:38",
                "province": "山西",
                "city": "晋中",
                "operator": "联通"
            },
            "group": {
                "id": 11032, //话术id
                "name": "cky测试" //话术组名称
            },
            "task": {
                "id": "cb4a91c2-09c0-4c71-8e67-3887f593bd4d", //外呼任务id
                "name": "cky呼入任务测试"
            },
            "user": {
                "id": "40863af8-db4a-41c6-a269-eb5bc386d97f", //账号id
                "name": "官方系统测试账号"  //账号昵称
            },
            "level": {
                "level_id": "7049b435-3781-4f01-9c42-325bb12f743c", //评分id
                "level_name": "评分中"  //评分名称
            },
            "tags": [
                {
                    "tag_id": "db97dd4e-d7d7-4f7d-bc1c-f347dacc146b",
                    "name": "打出来的是什么号码"
                }
            ],
            "customer_data": {
                "name": "未知", //昵称
                "email": null, //邮箱
                "company": null, //公司
                "extra": null //呼入号码该客户公海额外字段值一般为null
            },
            "voice_url": "hw.test-saas.our.top/api/agent-api/download-voice?key=Um5tQ1dGWXdlVGJYVUF1TDB" //通话录音地址
        }
    ]
}

2.终端任务绑定大模型3.0话术回调

API管理-终端任务绑定大模型3.0话术回调

呼入任务配置-大模型3.0呼叫

json
{
    "count": 1, //通话成功个数
    "data": [
        {
            "calldate": "2024-01-17 15:41:45", //呼叫时间
            "answerdate": "2024-01-17 15:41:46", //应答时间
            "bill": 13, //通话时长 - 秒
            "duration": 14, //秒
            "callid": "93993948-a71c-4d86-a5fb-2474ee99c1b1", //软电话拨打的一个唯一id,即为record_id
            "customer_id": "85f835cd-04a9-417d-9bea-63e411f89ba1",
            "master_user_id": "073d8501-b6a3-4869-a87e-71807bfd4fb8",
            "user_id": "073d8501-b6a3-4869-a87e-71807bfd4fb8",
            "type": 4, //用户类型  4-主账号 8-子账号
            "intention_results": 1, //意向标签等级
            "rounds": 1, //交互次数
            "score": 100, //通话评分
            "number_data": {
                "number": "13667679151",
                "hangupdate": "2024-01-17 15:41:59",
                "province": "重庆",
                "city": "重庆",
                "operator": "移动"
            },
            "group": {
                "id": "019d4e76-846a-73b1-8d65-2bcb54131961", //话术id
                "name": "Echo助手2.0" //话术组名称
            },
            "task": {
                "id": "cb4a91c2-09c0-4c71-8e67-3887f593bd4d", //外呼任务id
                "name": "cky"
            },
            "user": {
                "id": "40863af8-db4a-41c6-a269-eb5bc386d97f", //账号id
                "name": "官方系统测试账号"  //账号昵称
            },
            "level": {
                "level_id": "7049b435-3781-4f01-9c42-325bb12f743c", //评分id
                "level_name": "评分中"  //评分名称
            },
            "tags": [
                {
                    "tag_id": "db97dd4e-d7d7-4f7d-bc1c-f347dacc146b",
                    "name": "打出来的是什么号码"
                }
            ],
            "customer_data": {
                "name": "ai_2410478", //昵称
                "email": null, //邮箱
                "company": null, //公司
                "extra": null //添加号码时的选填extra字段,可用于匹配您自己的CRM等客资系统,如果没有传输则为null
            },
            "voice_url": "hw.test-saas.our.top/api/agent-api/download-voice?key=Um5tQ1dGWXdlVGJYVUF1TDB" //通话录音地址
        }
    ]
}

基于 MIT 许可发布