对话接口 | 知识中心

所有文章

API文档

完整版

客户端

API文档

升级日志

合作伙伴

基础知识

对话接口

最后更新于 2024/08/14 阅读数 61

需要先开通

请求域名
域名与其他有区别是对应的客户端域名

对应的客户端域名
ai.telrobot.top

请求地址 /saas/api/customer_service/tenant/{tenant_id}
请求方式： POST
请求参数： Content-Type:application/json
请求参数：X-Requested-With:XMLHttpRequest
HTTP头信息，需要在每次调用的时候在您的Headers里面带上生成的Token，参数例如
获取Token查看 AI客户联络->开发指引->查看认证token

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjkyOTdkYTdhYmVkNTVkMDIyNzhhMmRhYmVhMWY1OTY3OTNlN2Y4ZDNkYjBhOTU5OGQ1NjFiZTkzYzhlNjRkMWYw

plaintext

Bearer + 空格 + Token

请求示例

字段名	类型	示例	解释	必填
talk_id	string	bCdeffd6-C84D-dB14-11De-3afA7f738159	对话id（随机生成保证同一个对话不变即可）	是
user_id	string	bCdeffd6-C84D-dB14-11De-3afA7f738159	用户id	是
message	string	测试	内容	是
notify	string	enter	类型 enter 开始 message 中间阶段 leave 结束	是
group_id	integer	1	话术id	是
directive	string	""	invalid 杂音 no_answer 无回应填写时message为""即可

{
    "talk_id": "bCdeffd6-C84D-dB14-11De-3afA7f738159", 
    "user_id": "bCdeffd6-C84D-dB14-11De-3afA7f738159",
    "message": "测试",
    "notify": "enter",
    "directive": "",
    "group_id": 1
}

1
2
3
4
5
6
7
8

plaintext

返回示例

{
    "code": 200,
    "status": "success",
    "message": "成功",
    "data": {
            	"label_id": "93d91274-2e3d-45ba-bf71-d7c20944dfe7", //话术id
            	"label_name": "测试", //话术名
            	"group_id": 9322, //话术组id
            	"wait": 5000, //话术配置等待时间
            	"score": 5,//话术配置分数
            	"after_action": {
            	    "outbound_label_id": "93d91274-2e3d-45ba-bf71-d7c20944dfe7",
            	    "block": 1, //使用话术块
            	    "action": 1,// 话术后动作   1播放后等待应答  3播放后挂断 
            	    "value": null,
            	    "created_at": "2023-02-06 14:58:43",
            	    "updated_at": "2023-08-24 17:58:07"
            	},
            	"after_action_str": "播放后等待应答",
            	"group": {
            	    "wait_broadcast": 1 //话术组配置的回复触发 
            	},
            	"contents": [ 回复具体内容
            	    {
            	        "translate_text": "测试测试测试测试测试测试测试测试测试测试" //回复文本内容
            	    },
            	    {
            	        "translate_text": "33", // 回复文本内容
            	        "digital_human_contents": [
            	            {
            	                "file_url": "https://telrobot.obs.cn-southwest-2.myhuaweicloud.com:443/customer-service/label/92b1517d	-a00d-456a-9ba4-bbd674391a2a/2308/%E6%96%B9%E5%A4%A7%E5%90%8C-%E5%90%AC%28%E6%A0%87%E6%B8%85%29Part001	~1.mp4?AWSAccessKeyId=EWFUEKMADNJGBAOPAO1N&amp;Expires=1692871702&amp;Signature=PuDnlsY9xGni7%2BQP%2Bz71vnZdSp	8%3D",
            	                "file_type": 1// 1.视频 2.音频 3.图片 4.附件
            	            },
            	            {
            	                "file_url": "https://telrobot.obs.cn-southwest-2.myhuaweicloud.com:443/customer-service/label/92b1517d	-a00d-456a-9ba4-bbd674391a2a/2308/%E6%96%B9%E5%A4%A7%E5%90%8C-%E5%90%AC%28%E6%A0%87%E6%B8%85%29Part016	.mp4?AWSAccessKeyId=EWFUEKMADNJGBAOPAO1N&amp;Expires=1692871702&amp;Signature=qcFb/8fyoLWd3lV4Mx/G7Ou7TXA%3D",
            	                "file_type": 1
            	            },
            	            {
            	                "file_url": "https://telrobot.obs.cn-southwest-2.myhuaweicloud.com:443/customer-service/label/92b1517d	-a00d-456a-9ba4-bbd674391a2a/2308/%E6%96%B9%E5%A4%A7%E5%90%8C-%E5%90%AC%28%E6%A0%87%E6%B8%85%29Part019	.mp4?AWSAccessKeyId=EWFUEKMADNJGBAOPAO1N&amp;Expires=1692871702&amp;Signature=L7gk3Ak7SeR4UOExv8Nsbfgyo28%3D",
            	                "file_type": 1
            	            }
            	        ]
            	    },
            	    {
            	        "translate_text": "2",
            	        "digital_human_contents": [
            	            {
            	                "file_url": "https://telrobot.obs.cn-southwest-2.myhuaweicloud.com:443/customer-service/label/92b1517d	-a00d-456a-9ba4-bbd674391a2a/2308/%E6%96%B9%E5%A4%A7%E5%90%8C-%E5%90%AC%28%E6%A0%87%E6%B8%85%29Part010	.mp4?AWSAccessKeyId=EWFUEKMADNJGBAOPAO1N&amp;Expires=1692871702&amp;Signature=9na/mckGH2WwbvkhATHJ1yNPQr8%3D",
            	                "file_type": 1
            	            }
            	        ]
            	    },
            	    {
            	        "translate_text": "3",
            	        "digital_human_contents": [
            	            {
            	                "file_url": "https://telrobot.obs.cn-southwest-2.myhuaweicloud.com:443/customer-service/label/92b1517d	-a00d-456a-9ba4-bbd674391a2a/2308/%E6%96%B9%E5%A4%A7%E5%90%8C-%E5%90%AC%28%E6%A0%87%E6%B8%85%29Part005	.mp4?AWSAccessKeyId=EWFUEKMADNJGBAOPAO1N&amp;Expires=1692871702&amp;Signature=3nUXMwAOylC5At85OFVljfqVnOA%3D",
            	                "file_type": 1
            	            }
            	        ]
            	    }
            	],
            	"children_name": [ //子话术标题
            	    "测试子话术"
            	]
            }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

plaintext

不勾选循环的话术结束时

{
    "code": 200,
    "status": "success",
    "message": "成功",
    "data": [
        {
            "data": {
                "end": true
            }
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12

plaintext

{tenant_id} 获取

释放回调黑名单

获取已配置的评分等级

评价这篇文档

有帮助

没帮助

未能解决您的问题？请联系

在线客服