跳到主要内容

URL 参数说明

通过 URL 参数可以自定义聊天页面的语言，以及将你系统中的客户信息同步到 TWT Chat。

语言参数​

在链接末尾追加 ?lang= 参数切换界面语言：

https://visitorchat.twt.com/direct/{你的APPID}?lang=en
代码语言
zh-cn简体中文（默认）
zh-tw繁体中文
en英文

客户信息参数​

将内部系统的客户信息传入聊天页面，客服可在工作台中查看访客的身份信息。

参数名类型说明
sbsstring用户唯一标识
sbs_mmstring用户签名
ranstrstring随机字符串（建议 16 位以上）
namestring用户姓名
nicknamestring用户备注名
emailstring用户邮箱
phonestring用户电话

sbs_mm 生成规则​

sbs_mm = md5( md5(sbs + '_' + AppSecret) + '_' + ranstr )
  • MD5 结果为小写 32 位
  • AppSecret 是生成 sbs_mm 的必要参数，请在 开发设置 中生成，并妥善保存，避免泄露

完整示例​

https://visitorchat.twt.com/direct/8cba81d468aac01b4f15f8ea4ef33677?sbs={sbs}&sbs_mm={sbs_mm}&ranstr={ranstr}&name={name}&nickname={nickname}&email={email}&phone={phone}
安全警告

sbs_mm 签名必须在服务端生成，切勿将 AppSecret 暴露到前端代码或 URL 中。