帮助中心首页
开发者文档
企业信息对接

业务系统对接

方案概述

企业可将自主研发的业务操作页面以<iframe>的方式嵌入智齿客服工作台右侧、客户中心客户详情页或呼叫中心通话详情页,作为单独的菜单栏。常见的业务操作页面例如:提交工单页、用户个人资料页、用户历史订单页、用户历史工单页。

<集成完毕后客服工作台的实际效果>

<集成完毕后客户中心的实际效果>

<集成完毕后呼叫中心的实际效果>

客服在请求此页面时,将通过在业务操作页面的URL后追加用户对接ID、客服邮箱、安全校验码等信息以便企业进行安全验证、根据用户身份展示该用户相关的业务信息。

在客服工作台请求此页面时,传入字段包括:

字段名称
partnerId对接ID,咨询者在第三方系统的ID,需要企业在集成聊天页时传给智齿
email当前客服的登陆邮箱
sign企业标识和客服email的md5校验码,sign=md5(sysNum+email)
uid咨询用户在智齿系统的用户ID
cid本次咨询对应会话的会话ID
params自定义资料字段

在呼叫中心通话详情页请求此页面时,传入字段包括:

字段名称
email当前客服的登陆邮箱
sign企业标识和客服email的md5校验码,sign=md5(sysNum+email)
uid若此电话号码属于已知用户,则为该用户在智齿系统的用户ID
uphone本次通话的电话号码
uemail若此电话号码属于已知用户,则为该用户在智齿系统中的第一个邮箱

在客户中心客户详情页请求此页面时,传入字段包括:

字段名称
email当前客服的登陆邮箱
sign企业标识和客服email的md5校验码,sign=md5(sysNum+email)
uid用户在智齿系统的用户ID
uphone用户在智齿系统中的第一个电话号码
uemail用户在智齿系统中的第一个邮箱

在外呼任务详情页请求此页面时,传入字段包括:

字段名称
email当前客服的登陆邮箱
sign企业标识和客服email的md5校验码,sign=md5(sysNum+email)
uid用户在智齿系统的用户ID
uphone用户在智齿系统中的第一个电话号码
uemail用户在智齿系统中的第一个邮箱
在工单详情页请求此页面时,传入字段包括
字段名称
email当前客服的登陆邮箱
sign企业标识和客服email的md5校验码,sign=md5(sysNum+email)
uid用户在智齿系统的用户ID
uphone用户在智齿系统中的第一个电话号码
uemail用户在智齿系统中的第一个邮箱
 tickitId 当前工单id
 


成步骤

第一步,集成客服聊天页时传入用户对接ID(partnerId)

如果企业开发的业务操作页面需要和用户身份关联,则此步为必选,否则非必选

第二步,企业根据自己的需要确定业务操作页面的功能和交互效果,基于智齿的开发要求完成业务操作页面开发。

当屏幕宽度为1280像素时,页面规格建议:

  • 人工客服工作台:建议对接页面宽度<=300像素

  • 客户中心:建议对接页面宽度<=730像素,高度<=500像素

  • 呼叫中心:建议对接页面宽度<=790像素,高度<=500像素

  • 建议企业提供https地址,否则如果客服通过https访问智齿客服工作台时,将无法正常打开对接页面

第三步,企业管理员可在智齿客服管理后台手动配置对接菜单名称和对接页面(建议配置https地址)配置完毕后客服重新登录工作台后即可使用

<管理后台-设置-对接页面:添加对接页面>

一个示例

如上图,管理后台,对接页面设置,页面地址栏,企业提供URL示例:

用户咨询客服接入会话后,智齿系统会根据聊天页对接的自定义参数拼接如下URL示例(未Encode的示例),去请求对接页面: