呼叫中心接口介绍
发布日期:
2020-08-03

深圳市深海捷科技有限公司研发的企业级呼叫中心系统具有完善的第三方开发接口,第三方信息系统开发/集成商可以通过很小的工作量集成深海捷呼叫中心功能,比如来电/去电弹屏、点击拨号等。

本文主要描述深海捷呼叫中心系统第三方开发接口及规范,主要阅读人员为第三方CRM、ERP、信息管理系统等开发商以及具备二次开发能力的客户。

本文所描述的第三方开发接口适用于B/S架构及C/S架构的程序开发商,读者可以选择自己感兴趣的部分进行阅读。

1. 接口介绍

1.1 服务基地址

呼叫中心提供的 API 请求服务地址称之为服务基地址(下文中使用变量{BaseUrl}表示),{BaseUrl}为系统的登录地址, 可以是域名或者ip, 根据实际情况, 可能还需要加上目录. 如: http://120.1.1.1/admin/

实际提供的接口服务请求地址为'http://{BaseUrl}+[接口服务名]'。

1.2 接入认证

业务提供的 API 均采用加密认证方式。

此种认证方式下,将根据私有的 AppSecret 生成加密码进行鉴权。鉴权通过后,语音平台处理该请求消息。

说明:

AppKey 和 AppSecret可以在管理后台进行配置

1.3 加密规则

1.  获取所有的需要传递的参数,作为一个数组

2.  将加密数组中所有的 key 转换成小写

3.  排除参数列表中的 sign 和值为空的数据,即 sign 的值和空数据不参与加密

4.  对参数数组进行排序,按照 key 的名称升序排列

5.  遍历参数数组,将值进行拼接

6.  在拼接后的字符串后面再连接私有的秘钥,拼接后的字符串表示为$string

7.  采用 sha1 进行加密,规则 sha1($string . sha1($secret)), $string 代表拼接后的字符串,$secret 代表私有秘钥

8.  将生成的 sign 转换为小写