直接鏈接
將聊天頁面鏈接發給客戶，打開即可開始對話。無需網站部署，適用於郵件、App、社交媒體等渠道。
使用場景
- 郵件簽名：在客服郵件底部附上聊天鏈接
- App 內嵌：通過 WebView 打開聊天頁面
- 網頁 iframe：將託管的聊天頁面嵌入現有網站
- 社交媒體：在公眾號菜單、微博簡介等位置放置鏈接
- 二維碼：將鏈接生成二維碼供線下掃碼使用
基礎鏈接
https://page1.visitor-chat.com/direct/{你的项目APPID}
指定工作區
wcode 是客服端工作區列表下發的可選工作區識別碼。需要讓獨立訪客頁使用指定工作區的品牌與訪客設定時，將它追加在 APP_ID 後：
https://page1.visitor-chat.com/direct/{你的项目APPID}_{你的WCODE}
該識別碼由後端生成，請原樣透傳，不要自行生成或校驗格式。不傳 wcode 時沿用預設工作區行為。無效、已刪除、已停用或屬於其他專案的值會按站點不可用處理，不會靜默回退到預設工作區。
在網頁中嵌入聊天頁面（iframe）
如果希望將聊天頁面顯示在現有網站中，可以將託管的直接連結作為 iframe 的 src。請將 {你的项目APPID} 替換為你的專案 APPID：
<iframe
src="https://page1.visitor-chat.com/direct/{你的项目APPID}"
title="TWT 線上客服"
width="100%"
height="720"
style="border: 0"
allow="microphone; camera; autoplay; fullscreen"
></iframe>
請依照頁面佈局調整 iframe 高度。lang、客戶資訊等 URL 參數都可以繼續追加，具體請參考下方參數說明。
瀏覽器和訪客仍會控制攝影機、麥克風及其他 allow 中宣告的能力。如果整合使用剪貼簿或螢幕分享功能，請按需追加 clipboard-read; clipboard-write 或 display-capture。請只申請整合實際需要的權限。
iframe Demo 預覽
開啟 iframe 直聊 Demo。需要完整可複製程式碼時，請查看 iframe 內嵌直聊 Demo。
透過連結直達聊天詳情
在 Standalone 模式下，如果需要透過連結讓訪客直接進入特定的聊天會話詳情，可以使用以下 URL 格式和參數設定。
連結格式
https://page1.visitor-chat.com/direct/{你的项目APPID}?direct=1&chatid={SESSION_ID}
參數說明
| 參數名 | 是否必填 | 說明 |
|---|---|---|
direct | 是 | 必須固定傳 1。作為直達詳情頁的特徵開關，用於明確宣告直達意圖，防止常規訪問中因意外攜帶 chatid 導致非預期跳轉。 |
chatid/chat_id | 是 | 目標聊天的會話 ID (Session ID)。 |
示例
若客服 appid 為 demo_app，目標會話 ID 為 session-abc-123：
https://page1.visitor-chat.com/direct/demo_app?direct=1&chatid=session-abc-123
自定義語言
聊天頁面會自動偵測瀏覽器語言；未偵測到或不支援時回退到 en。也可以在鏈接末尾追加 ?lang= 參數明確指定界面語言：
https://page1.visitor-chat.com/direct/{你的项目APPID}?lang=en
支持的語言代碼：
| 代碼 | 語言 |
|---|---|
zh-cn | 簡體中文 |
zh-tw | 繁體中文 |
en | 英文 |
ja | 日語 |
ko | 韓語 |
de | 德語 |
fr | 法語 |
pt | 葡萄牙語 |
ru | 俄語 |
葡萄牙語瀏覽器語言如 pt-PT、pt-BR 會統一歸一到 pt。
客戶信息參數
將內部系統的客戶信息傳入聊天頁面，客服可在工作臺中查看訪客的身份信息。
| 參數名 | 類型 | 說明 |
|---|---|---|
sbs | string/number | 用戶唯一標識 |
sbs_mm | string | 用戶簽名 |
ranstr | string | 隨機字符串（建議 16 位以上） |
name | string | 用戶姓名 |
nickname | string | 用戶備註名 |
email | string | 用戶郵箱 |
phone | string | 用戶電話 |
customer_remark | string | 客戶備註，需與客戶識別碼一同傳入 |
sbs_mm 生成規則
sbs_mm = md5( md5(sbs + '_' + AppSecret) + '_' + ranstr )
- MD5 結果為小寫 32 位
AppSecret是生成sbs_mm的必要參數，請在 開發設置 中生成，並妥善保存，避免洩露
完整示例
https://page1.visitor-chat.com/direct/{你的项目APPID}?sbs={sbs}&sbs_mm={sbs_mm}&ranstr={ranstr}&name={name}&nickname={nickname}&email={email}&phone={phone}&customer_remark={customer_remark}
sbs_mm 簽名必須在服務端生成，切勿將 AppSecret 暴露到前端代碼或 URL 中。