跳至主要内容

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 中。