直接鏈接
將聊天頁面鏈接發給客戶，打開即可開始對話。無需網站部署，適用於郵件、App、社交媒體等渠道。
使用場景
- 郵件簽名：在客服郵件底部附上聊天鏈接
- App 內嵌：通過 WebView 打開聊天頁面
- 社交媒體：在公眾號菜單、微博簡介等位置放置鏈接
- 二維碼：將鏈接生成二維碼供線下掃碼使用
基礎鏈接
.../direct/{你的项目APPID}
透過連結直達聊天詳情
在 Standalone 模式下，如果需要透過連結讓訪客直接進入特定的聊天會話詳情，可以使用以下 URL 格式和參數設定。
連結格式
.../direct/{你的项目APPID}?direct=1&chatid={SESSION_ID}
參數說明
| 參數名 | 是否必填 | 說明 |
|---|---|---|
direct | 是 | 必須固定傳 1。作為直達詳情頁的特徵開關，用於明確宣告直達意圖，防止常規訪問中因意外攜帶 chatid 導致非預期跳轉。 |
chatid/chat_id | 是 | 目標聊天的會話 ID (Session ID)。 |
示例
若客服 appid 為 demo_app，目標會話 ID 為 session-abc-123：
.../direct/demo_app?direct=1&chatid=session-abc-123
自定義語言
聊天頁面會自動偵測瀏覽器語言；未偵測到或不支援時回退到 en。也可以在鏈接末尾追加 ?lang= 參數明確指定界面語言：
.../direct/{你的项目APPID}?lang=en
支持的語言代碼：
| 代碼 | 語言 |
|---|---|
zh-cn | 簡體中文 |
zh-tw | 繁體中文 |
en | 英文 |
ja | 日語 |
ko | 韓語 |
de | 德語 |
fr | 法語 |
pt | 葡萄牙語 |
ru | 俄語 |
葡萄牙語瀏覽器語言如 pt-PT、pt-BR 會統一歸一到 pt。
客戶信息參數
將內部系統的客戶信息傳入聊天頁面，客服可在工作臺中查看訪客的身份信息。
| 參數名 | 類型 | 說明 |
|---|---|---|
sbs | string | 用戶唯一標識 |
sbs_mm | string | 用戶簽名 |
ranstr | string | 隨機字符串（建議 16 位以上） |
name | string | 用戶姓名 |
nickname | string | 用戶備註名 |
email | string | 用戶郵箱 |
phone | string | 用戶電話 |
sbs_mm 生成規則
sbs_mm = md5( md5(sbs + '_' + AppSecret) + '_' + ranstr )
- MD5 結果為小寫 32 位
AppSecret是生成sbs_mm的必要參數，請在 開發設置 中生成，並妥善保存，避免洩露
完整示例
.../direct/{你的项目APPID}?sbs={sbs}&sbs_mm={sbs_mm}&ranstr={ranstr}&name={name}&nickname={nickname}&email={email}&phone={phone}
安全警告
sbs_mm 簽名必須在服務端生成，切勿將 AppSecret 暴露到前端代碼或 URL 中。