Hi客服logo
API概述与加密流程
加密在线调试
1.引用js文件设置样式与标题
2.初始化及打开与关闭
不使用加密的样例
php/.net/asp sdk下载

API概述与加密流程

Hi客服是一款集成在网页端的JS代码,兼容PC、H5、APP、小程序等主流应用,能够结合API的调用,让客户方便的与客服人员发起会话,是企业获客、售后服务的好帮手。

Hi客服的特点是能够显示客户在自己网站注册的身份id,方便企业有效沟通,便于售后管理与维护。

API主要运用了MD5加密把客户的身份信息通过一系列加密方式传送给本站服务器,用于验证身份是否真实,对于企业这边就需要配合Hi客服把客户的id、昵称、头像等信息加密后传送给本站,利用的是php、.net、asp、jsp等网页后台语言代码计算得出的结果。

加密流程说明

加密流程sdk里都已集成,如果您的应用语言本站已有对应sdk,请直接下载sdk

名称 类型 必填 说明
sid string Hi客服服务的sid 查询
id string 客户在自己网站上的id,支持字母数字邮箱,如为访客请设空白字符串
nick string 客户昵称,需使用URLEncode UTF-8进行编码,编码后还需替换"+"为"%20",可设空白字符串。
face string 客户头像URL,需使用URLEncode UTF-8进行编码,编码后还需替换"+"为"%20",可设空白字符串。
date string 当前日期格式为24时双字符制,中间分隔必须为“-”。如:2008-08-08
key string Hi客服服务的密钥key 查询

(以下为php代码)把上述参数通过字符串拼接方式利用md5算法计算结果,获得token。

复制
$token = md5("sid=" . $sid . "&id=" . $id . "&nick=" . str_replace("+","%20",urlencode($nick)) . "&face=" . str_replace("+","%20",urlencode($face)) . "&date=" . $date . "&key=" . $key);

(以下为JS代码)仅用以表示加密流程,并非流程可以写到js代码里,这样您的key会泄露,切记!!

复制
var token = $.md5("sid=" + sid + "&id=" + id + "&nick=" + encodeURIComponent(nick).replaceAll("+","%20") + "&face=" + encodeURIComponent(face).replaceAll("+","%20") + "&date=" + date + "&key=" + key);
您还可以进行 加密在线调试