呼叫中心customer_token查询API

Udesk 呼叫中心支持在电话呼叫开始时,查询客户第三方接口,获取该号码在第三方的唯一token,标记用户。

基本用法

第一步:配置推送的字段

登陆Udesk客服系统管理员账号,在 管理中心 -> 呼叫中心 -> 其他设置 -> 客户customer_token查询API,打开推送开关,并填写推送地址。

第二步:通话事件推送的使用

设置查询接口地址,呼叫开始时查询接口获取customer_token,更新客户open_api_token。

接口开发规范

第三方系统需要按照以下规范开发接口

请求方法

接口必须支持 POST 方法,Udesk 请求接口时,会将请求参数以 JSON 形式放在 request body 中,请求的 Content-Typeapplication/json;charset=utf8

请求地址

用户自定义,但协议必须是 HTTPS 或 HTTP (即接口地址必须以 http:// 或 http:// 开头),如 https://api.udesk.cn/callcenter

请求参数说明

request body 的格式固定如下

timestamp:
number:

各参数说明:

参数名称 参数含义 参数类型
timestamp UNIX 时间戳 Integer
number 客户电话 String

请求示例

POST https://api.udesk.cn/callcenter

Content-Type: application/json;charset=utf8
Content-Length: 190

{
  "timestamp": 1501124998,
  "number": 18888888888
}

响应格式

接口返回的HTTP响应应当为 JSON 格式。

  customer_token: "xxxx-1234-5511"

各参数说明:

参数名称 参数含义 参数类型
customer_token 客户唯一标识 String

响应示例

{
  customer_token: "xxxx-1234-5511"
}

接口开发注意事项

  1. 接口响应时间必须小于500ms。
  2. 接口返回值customer_token 必须为客户的唯一token。