1.平台客服接入

平台客服接入和普通saas账号的接入方式一致,请参考:一洽客服系统渠道接入

2.子账号客服接入

我防止子账号客服系统用作他用以及企业子账号列表被恶意遍历请求,子账号接入客服时需提供平台的签名,其他参数和平台账号一致见:对话参数列表。

获取子账号的客服接入链接:

进入平台公司-更多配置-网页接入:

获取PC/手机对话窗口地址,此文档已手机端接入为例

chatWindowLink=${chatServer}/visitor/mobile/chat.html?companyId=${companyId}

1)将token、appId、subAccountId三个参数进行字典序排序

2)将三个参数字符串拼接成一个字符串进行sha1加密

3)一洽按照如上方法对字符串加密后与参数中的platformSign对比,如果一致则认为是合法的请求

检验platformSign的JAVA示例代码:

public boolean verifyUrl(String msgSignature, String appId, String subAccountId)
            throws AesException {
        String signature = SHA1.getSHA1(token, appId, subAccountId);

        if (!signature.equals(msgSignature)) {
            throw new AesException(AesException.ValidateSignatureError);
        }

        return true;
    }

一洽的签名生成方式和微信一致。

C# C++ Java PHP Python 微信代码示例下载:示例代码

3.消息中心接入

针对平台企业,一洽提供了平台消息中心模块,方便平台快速集成多账号客服中心。
示例:

支持参数列表:

参数名 类型 长度限制 描述
companyId int   平台账号ID,必传
platformSign String 255 平台签名。(平台账号ID、appId、token自然排序后的sha签名)
echatTitleBar int 1 是否显示消息中心的标题栏 0:不显示 其他:显示
lan String 30 打开对话窗口的语言,比如:en、zh、ja、de等
metaData String 2048 会员对接中的会员加密身份信息,具体参见:业务系统集成
myData String 500 业务系统对接中传递的自定义业务数据,具体参见:业务系统集成
visEvt String 2048 图文消息,可对话开始前发送本次咨询的商品信息或者订单信息或者其他信息给客服。此属性的值为图文消息的json字符串,详细介绍请参见JS API文档

4.消息通知接入

4.1 web页面

_echat("on", {
        newEvent: function (eventData) {
            if (eventData && eventData.eventAction && eventData.eventAction == "platformNewMsg") {
                if(eventData.eventLabel){
                    var newMsgInfo = eval(eventData.eventLabel);
                    console.log("new msg:" + newMsgInfo.msgContent);
                    console.log("unreadMsgCount:" + newMsgInfo.unreadMsgCount);
                }
            }
        }
})

4.2 APP

4.3 server端

4.3.1 实时接收

4.3.2 主动查询

一洽支持企业开发者在需要的时候调用客服系统的对外接口来获取某个访客的未读消息数量,企业获取到该数量后通过企业有的渠道通知给客户。

详见获取访客未读消息数量接口文档