Udesk 呼叫中心支持在电话呼叫开始时,查询客户第三方接口,获取该号码在第三方的唯一token,标记用户。
基本用法
第一步:配置推送的字段
登陆Udesk客服系统管理员账号,在 管理中心 -> 呼叫中心 -> 其他设置 -> 客户customer_token查询API,打开推送开关,并填写推送地址。
第二步:通话事件推送的使用
设置查询接口地址,呼叫开始时查询接口获取customer_token,更新客户open_api_token。
接口开发规范
第三方系统需要按照以下规范开发接口
请求方法
接口必须支持 POST
方法,Udesk 请求接口时,会将请求参数以 JSON 形式放在 request body 中,请求的 Content-Type
为 application/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"
}
接口开发注意事项
- 接口响应时间必须小于500ms。
- 接口返回值customer_token 必须为客户的唯一token。