接上文AI电销机器人-智能AI机器人源码，电话机器人源码和系统部署运行环境freeswitch_ai电销机器人源码

21）话术的启用

功能说明：

通过此接口实现对话术的启用。

更新说明： --

请求：

URL：http://{ip}/ai/ai2words/start

请求方法：POST

请求头：必须带上登录时返回的Token

Auth: {登录时返回的Token}

响应：

JSON请求实例：

{

"wordsId":20,

}

JSON响应实例：

{

"errorCode": 0,

"description": "启用成功",

"data": ""

}

22）指定话单修改意向等级

功能说明：

通过此接口实现对指定话单修改意向等级。

更新说明： --

请求：

URL：http://{ip}/ai/touchphone/updateGrade

请求方法：POST

请求头：必须带上登录时返回的Token

Auth: {登录时返回的Token}

响应：

JSON请求实例：

{

    "id": 1,

    "grade": 21

}

JSON响应实例：

{

"errorCode": 0,

"description": "操作成功",

"data": ""

}

4、系统级回调消息

1）创建用户成功后回调

功能说明：

通过此接口可以实现创建用户成功后，主动推送用户信息到其他系统。

更新说明： --

请求方法：

POST

请求参数:

响应：

入参JSON实例：

{

    "action" : "NEW_USER_NOTIFY",

"username" : "admin",

"password" : "admin",

"userId" : 100,

"level" : 0

}

JSON响应实例：

{

    "errorCode": 0,

    "description": "操作成功."

}

2）删除用户成功后回调

功能说明：

通过此接口可以实现删除用户成功后，主动推送被删除的用户信息到其他系统。

更新说明： --

请求方法：

POST

请求参数:

响应：

入参JSON实例：

{

    "action" : "NEW_USER_NOTIFY",

"username" : "admin",

"userId" : 100

}

JSON响应实例：

{

    "errorCode": 0,

    "description": "操作成功."

}

3）语音验证码拨打电话完成主动回调（语音验证码功能联系管理员授权）

功能说明：

通过此接口可以实现拨打电话播放语音验证码完成后的回调。

更新说明： --

请求：

URL：用户配置的回调地址 

请求方法：

POST

请求参数:

响应：

入参JSON实例：

{

"action" : "DAIL_FINISH_NOTIFY",    

"targetPhone" : "13900001111",

"sourcePhone" : "13022221111",

"busiId" : "1000",

"UUID" : "AAAA-BBBB-CCCC-DDDD",

"touchPhoneId" : 3,

"conversationTime" : 39

}

a

JSON响应实例：

{

    "errorCode": 0,

    "description": "操作成功."

}

5、用户级回调消息

1）电话拨打完成后的回调

功能说明：

通过此接口可以实现机器人和用户通话完成后，主动推送拨打详情给第三方系统。

更新说明： --

请求方法：

POST

请求参数:

响应：

入参JSON实例：

{

    "action" : "USER_PHONE_FINISH_NOTIFY",

"phone" : "13699998888",

"name" : "张三",

中间省略 

"userId" : 100,

"taskId" : 23,

"chatList" : [{

"id": 15676,

"inserttime": 1544436127000,

"khcontent": "喂,您好！（停顿两秒）您好,这边是可以大量外呼的销售机器人,您有兴趣了解下吗？",

"khtype": 0,

"khvoicepath": "RDovdm9pY2VGaWxlL0FJMnFpdGFjaGFucGludHVpZ3VhbmctamlxaXJlbnppeGlhby0xODkyOF8yMDE4MTExMjE0MTMwM181NDkvdXBsb2FkLTIwMTgwOTI5MTQyMzA0XzQ0Ni53YXY=",

"phone": "900113668161682",

"touchphoneid": 4744,

"uuid": "058f1e0f-bc4c-4ee7-8256-377ce02f03d1"

}, {

"id": 15677,

"inserttime": 1544436131000,

"khcontent": "啊",

"khtype": 1,

"khvoicepath": "RDovcmVjb3JkLzIwMTgtMTItMTAvOTAwMTEzNjY4MTYxNjgyXzA1OGYxZTBmLWJjNGMtNGVlNy04MjU2LTM3N2NlMDJmMDNkMV8xLndhdg==",

"phone": "900113668161682",

"touchphoneid": 4744,

"uuid": "058f1e0f-bc4c-4ee7-8256-377ce02f03d1"

}]

}

JSON响应实例：

{

    "errorCode": 0,

    "description": "操作成功."

}

2）任务自动拨打完成后的回调

功能说明：

通过此接口可以实现机器人的任务自动拨打完成后，主动推送拨打详情给第三方系统。

更新说明： --

请求方法：

POST

请求参数:

响应：

入参JSON实例：

{

    "action" : " USER_TASK_FINISH_NOTIFY",

"taskId" : 1,

"taskName" : "快捷外呼",

"userId" : 100,

"taskId" : 23

}

JSON响应实例：

{

    "errorCode": 0,

    "description": "操作成功."

}

6、测试工具PostMan

1）登录测试

请求模式选择：POST

Body标签页下面输入请求内容，见上图。

登录成功，返回：

1）语音验证码播放测试

请求头输入认证KEY和VALUE，见上图

7、FAQ

1、此文档是系统所有接口的全部么？

答：不是的，整套系统都是采用的RESTful调用，也就是任何功能都有RESTful接口，但提供商没有将所有接口文档化。没有文档化的接口，根据对接端客户的需求再进行二次文档化。客户购买系统后，也可以通过谷歌浏览器按F12进入调式模式的方式查询每个功能的RESTful的接口详情。