高级对接

概述

高级对接可以自定义更多的内容，除了跟快速集成一样能够自定义弹屏的信息页面外，还可以自定义收到不同系统消息推送时（比如振铃消息、接听消息、挂断消息等）的操作。

具体请参考高级接口文档说明及 Demo 源码。Demo 源码请到 callcentersdk_v1.zip 下载。

高级接口函数

1. 初始化及登录

函数说明

参数说明

名称	类型	注释
`username`	string	帮我吧的客服账号
`pwd`	string	客服账号对应的密码
`onConnection`	回调函数	用来接收系统消息推送。如果该参数为空，则执行系统默认消息处理。具体消息参见 Demo
`onError`	回调函数	用来接收系统错误消息。具体请参考返回值格式

说明：仅需在程序开始的时候调用一次。

2. 外呼

函数说明

参数说明

名称	类型	注释
`number`	string	拨打的电话号码。支持手机和座机，如果对方是座机，则拨号为 `01063701717`

3. 通话挂断

函数说明

4. 呼叫弹屏

函数说明

参数说明

名称	类型	注释
`url`	string	弹屏里面要显示的第三方系统的信息页面。该页面默认宽度为 593px，高度为 362px
`type`	bool	为 `true` 时，表示要弹屏；为 `false` 时，表示要关闭弹屏。默认为 `false`

说明：如果您想自定义弹屏样式，请直接修改函数里面的 CSS 样式。

5. 获取来电号码

6. 获取 callid

7. 开启 debug 模式

转接功能接口

接口地址

GET /api/v1/callCenter.json

请求参数

名称	类型	必传	注释
`action`	string	是	操作类型：`serviceList`-客服列表、`groupList`-客服组列表、`transferService`-转客服、`transferGroup`-转客服组
`callId`	string	是（转给具体客服、客服组时）	函数中获取的 callId
`transferId`	string	两个参数至少写一个（转给客服时）	有呼叫中心权限的客服可以指定 ID 转接
`mobile`	string	两个参数至少写一个（转给客服时）	没有呼叫中心的客服只能通过具体的号码转接
`groupId`	string	是（转给客服组时）	客服组 ID

1. 转接客服列表

获取有呼叫中心权限的在线空闲客服列表，以及没有呼叫中心的客服列表。

调用示例

返回参数

名称	类型	注释
`call_data`	array	有呼叫中心权限的在线空闲的客服列表
`except_call_data`	object	没有呼叫中心的客服列表
`active_tab`	string	默认打开的 tab，`kfgroup`-客服组，`kf`-客服

返回示例

{
    "call_data": [],
    "except_call_data": {
        "189106": {
            "sId": "189106",
            "realName": "cctest002",
            "mobile": "18770918874",
            "sNum": "002"
        },
        "189109": {
            "sId": "189109",
            "realName": "cctest003勿动舞动舞动舞动",
            "mobile": "17773896237",
            "sNum": "003"
        }
    },
    "active_tab": "kfgroup"
}

2. 转接客服组列表

调用示例

返回参数

名称	类型	注释
`group`	object	客服组列表
`active_tab`	string	默认打开的 tab，`kfgroup`-客服组，`kf`-客服

返回示例

{
    "group": {
        "7339": {
            "groupId": "7339",
            "groupName": "流云"
        },
        "8957": {
            "groupId": "8957",
            "groupName": "标签测试组"
        }
    },
    "active_tab": "kfgroup"
}

3. 转接（客服）操作

调用示例

返回结果

status=200：转接成功

其他：转接失败

返回示例

{
    "status": "7",
    "message": "{\"msg\":\"Failed to connect to 47.104.61.120 port 1858: Connection refused\",\"data\":{\"action\":\"<?xml version='1.0' encoding='UTF-8'?><Response userdata='-189106-17600208764--2323232-transfer--'><Play_1 async='false' stop_on_input='true' global_sound_file='true'>transfering.wav<\\/Play_1><Play_2 async='true' stop_on_input='true' global_sound_file='true'>background.wav<\\/Play_2><Dial onActionCallback='call_busy' onEndCallback='transfer_end' onAccept='bridge' onAcceptCallback='' record='true' recordingStatusCallback='voice_record' timeout='30'><Number url='agent_transfer' statusCallback='agent_state' StatusCallbackEvent='' LineNumber='' DisplayNumber=''>17600208764<\\/Number><\\/Dial><Hangup><\\/Hangup><\\/Response>\"},\"uri\":\"https:\\/\\/47.104.61.120:1858\\/v1\\/accounts\\/9afb90c41a0bbfc6\\/apps\\/a02d35242988c233\\/calls\"}"
}

4. 转接（客服组）操作

调用示例

返回结果

status=200：转接成功

其他：转接失败

返回示例

{
    "status": "404",
    "message": "group member is empty"
}

通用说明

认证方式: HTTP Basic Auth（Authorization: Basic {base64}）

基础URL: 根据部署环境不同，使用对应的 API 地址

数据格式: JSON

概述#

高级接口函数#

1. 初始化及登录#

2. 外呼#

3. 通话挂断#

4. 呼叫弹屏#

5. 获取来电号码#

6. 获取 callid#

7. 开启 debug 模式#

转接功能接口#

接口地址#

请求参数#

1. 转接客服列表#

2. 转接客服组列表#

3. 转接（客服）操作#

4. 转接（客服组）操作#

通用说明#

概述

高级接口函数

1. 初始化及登录

2. 外呼

3. 通话挂断

4. 呼叫弹屏

5. 获取来电号码

6. 获取 callid

7. 开启 debug 模式

转接功能接口

接口地址

请求参数

1. 转接客服列表

2. 转接客服组列表

3. 转接（客服）操作

4. 转接（客服组）操作

通用说明