直接链接
将聊天页面链接发给客户，打开即可开始对话。无需网站部署，适用于邮件、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 中。