1.多商户管理
1.平台业务系统集成
平台业务系统接入和普通saas账号的接入方式一致,请参考:业务系统集成
2.子账号业务系统集成
子账号业务系统区别于平台业务系统,单独进行设置,设置后的业务系统对所有子账号生效。
设置业务系统:商户-商户API-业务系统接口
- 会员接入
子账号的会员信息接入以及会员体系和平台方一致,在接入子账号对话时将metaData传递给子账号对话即可实现子账号对平台会员身份的识别,即统一会员身份信息的metaData可适用于平台和所有的子账号。
平台、子账号1、子账号2会员信息示例:
1.会员“王宝强”的metaData值为${metaData} 2.平台接入链接为:${chatServer}/visitor/mobile/chat.html?companyId=1130&metaData=${metaData} 3.子账号“专卖店1”的接入链接为:${chatServer}/visitor/mobile/chat.html?companyId=1330&metaData=${metaData} 4.子账号“专卖店2”的接入链接为:${chatServer}/visitor/mobile/chat.html?companyId=1331&metaData=${metaData}
平台客服和“专卖店1”“专卖店2”客服看到的访客信息如下:
- 子账号业务系统集成
商户API中配置的业务系统,会在子账号的客服工作台集成,集成方式和参数传递规则和普通saas账号一致。
为避免子账号之间相互数据泄露,业务系统打开时的签名参数,调整生成规则:
客服端在加载已配置的业务系统时会将签名信息通过GET的方式传递给开发者的URL,双方通过签名来验证请求的合法性。
签名参数
参数 | 描述 |
---|---|
signature | 一洽加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数、companyId参数。 |
timestamp | 时间戳 |
nonce | 随机数 |
companyId | 子账号ID |
3.平台业务数据接收
开发者可通过API接入来实现一洽对话业务数据的实时接收,接入规范平台账号和普通saas账号的接入规则和流程一致。详细接入过程和数据接口定义见文档:业务数据接收
4.子账号业务数据接收
子账号和平台方接入逻辑和流程一致,在一洽向开发者URL post业务数据时签名规则如下:
签名参数
参数 | 描述 |
---|---|
signature | 一洽加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数、companyId参数。 |
timestamp | 时间戳 |
nonce | 随机数 |
companyId | 子账号ID |
signature生成规则:
1)将token、timestamp、nonce、companyId三个参数进行字典序排序 2)将三个参数字符串拼接成一个字符串进行sha1加密 3)开发者获得加密后的字符串可与signature对比,标识该请求来源于一洽