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