在线客服

在你的网站嵌入 CZL Connect 客服浮窗，访客咨询实时进入收件箱；可选绑定企业微信智能机器人，坐席在企业微信里引用消息即可回复。Plus 及以上套餐可用。

快速接入

1. 打开应用详情 →「在线客服」→「设置」，填写允许嵌入的网站（每行一个来源：协议 + 域名，可带端口，不含路径。如 https://www.example.com、http://localhost:3000；https://*.example.com 匹配所有子域，http://127.0.0.1:* 匹配所有端口，适合本地端口不固定的桌面端），开启客服并保存
2. 复制设置页里的嵌入代码，放到页面 </body> 之前：

<script src="https://connect.czl.net/support/widget.js" data-key="你的浮窗标识" async></script>

页面右下角出现客服按钮。访客的消息会出现在应用详情「在线客服」的收件箱，以及导航栏「客服」里的跨应用收件箱。

只有列出的网站能嵌入浮窗（浏览器按 frame-ancestors 拦截其它来源）。访客当前所在页面的地址会随每条消息一起显示给坐席。

自定义入口

不想要右下角按钮时，给脚本加 data-launcher="none"，再给页面上任意元素加 data-czl-support 属性，点击即在该元素旁弹出客服面板：

<button data-czl-support>联系客服</button>
<script src="https://connect.czl.net/support/widget.js" data-key="你的浮窗标识" data-launcher="none" async></script>

• 面板优先在入口下方弹出，空间不足时翻到上方或侧边；手机屏幕下全屏
• 点击页面其它位置或按 Esc 收起
• 未读消息数写在入口元素的 data-czl-support-unread 属性上，可用 CSS 自行显示角标；也可以监听 window 上的 czl-support:unread 事件（event.detail.count）
• JS 接口：CZLSupport.open(元素?)、CZLSupport.close()、CZLSupport.toggle(元素?)

**按页面选择入口：**对外咨询页（首页、定价、文档、帮助中心）适合右下角按钮；右下角已有按钮或固定底栏、全屏编辑器、移动端底部导航、支付流程等页面，改用页面里的自定义入口；登录、授权回调等页面不需要客服。单页应用只加载一次脚本，路由切换时调用 CZLSupport.setLauncher(true / false) 显示或隐藏右下角按钮，离开需要客服的页面时调用 CZLSupport.close()。脚本就绪后会在 window 上派发 czl-support:ready 事件。

会话前表单

在设置页配置访客发起咨询前要填写的字段：名称、邮箱、手机号、留言，每项可单独设为显示或必填，全部关闭时访客直接进入对话。表单内容显示在收件箱会话头部，并随新会话通知推送到企业微信。

开启邮箱字段后，访客离线时坐席的回复会通过邮件送达。

传入访客信息

已登录用户不需要再填表单。按可信程度分两种方式：

预填（无需后端）

在脚本上写属性，或用户登录状态变化后调用 CZLSupport.setVisitor：

<script src="https://connect.czl.net/support/widget.js" data-key="你的浮窗标识"
        data-name="张三" data-email="[email protected]" async></script>

CZLSupport.setVisitor({ name: '张三', email: '[email protected]', phone: '' });

预填信息只用于填好表单，访客可以修改，收件箱里不会标记为已校验。

已校验身份（推荐）

由你的后端调用应用级 API 签发身份令牌，坐席看到的资料带「已校验」标记，表单里这些字段锁定不可改；同一用户在不同设备上共享会话记录。

1. 在应用详情「API 接入」创建凭证，勾选 scope support:identity
2. 用户登录后，由后端签发令牌（凭证只能放在服务端）：

curl -X POST https://connect.czl.net/api/v1/app/support/visitor-identity \
  -H "Authorization: Bearer czlc_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"externalId":"10086","name":"张三","email":"[email protected]"}'

{ "token": "svi_...", "expiresAt": "2026-11-04T12:00:00+08:00" }

• externalId 必填，是你系统里的用户标识（1-128 个字符）；name / email / phone 可选
• 令牌 24 小时有效，在你的页面渲染时签发即可，过期后浮窗按匿名访客处理

1. 把令牌交给浮窗：

<script src="https://connect.czl.net/support/widget.js" data-key="你的浮窗标识"
        data-identity="svi_..." async></script>

单页应用在用户登录、切换账号后调用 CZLSupport.setIdentity('svi_...')，退出登录时调用 CZLSupport.setIdentity('')。

示例： 用户通过 CZL Connect 登录的站点（如 CZL AI），在后端拿到登录用户后签发令牌，externalId 用站内用户 ID，name / email 用账号资料，访客打开客服即可直接对话，坐席看到的是已校验的账号信息。

图片与文件

访客和坐席都可以在对话中发送图片与文件，单个不超过 10 MB。图片在对话中直接显示，文件点击下载。对话记录按套餐保留期清理时，相关图片和文件一并删除。

企业微信转发

访客消息可以转发到企业微信群或单聊，坐席引用消息即可回复访客。

添加机器人

1. 在企业微信管理后台创建智能机器人，开启「API 模式」并选择「长连接」，取得 BotID 与 Secret。建议由企业超级管理员创建，否则回复记录里只能显示加密的成员 ID
2. 在 CZL Connect「账户设置 → 集成」添加机器人。一个机器人可以被你名下的多个应用共用；同一机器人只能被一个账户添加
3. 同一个机器人同时只能有一条长连接。如果其它程序也用它建立了长连接，CZL Connect 会停止连接并在机器人状态里提示，确认后点击「重新连接」

绑定应用

1. 应用详情 →「在线客服」→「设置」→「企业微信转发」，选择机器人并生成绑定码（10 分钟有效）
2. 在企业微信里把绑定码发给机器人：单聊直接发送；群聊需要 @机器人。绑定码发在哪个会话，咨询就转发到哪个会话
3. 多个应用可以绑定到同一个群，转发消息开头会注明应用名

收发规则

• 新会话（包括只提交了表单的情况）立即推送，带访客资料与来访页面；同一访客连续发送的消息会合并成一条转发
• 访客发送的图片直接显示在转发消息里，文件随后以文件消息发送
• **回复：**引用转发消息后输入回复内容。群聊里需要 @机器人。转发消息里的会话编号（如 #S7K2Q）用于确定回复给哪位访客，请不要删除
• **发送图片 / 文件：**企业微信里图片和文件消息无法引用，先引用访客消息回复一条文字，之后 30 分钟内直接发给机器人的图片或文件会发给同一位访客
• 企业微信限制每个会话每分钟 30 条、每小时 1000 条（回复与转发共用）。超出时消息仍在收件箱，下一条转发会提示未转发的条数

离线邮件

坐席回复后，如果访客已离开且留了邮箱，2 分钟后把回复发到访客邮箱，30 分钟内同一会话最多发一封。邮件包含回复原文和回到网站继续对话的链接。

离线邮件计入账户的群发月度额度；访客可在邮件里一键退订该应用的通知，退订后不再收到离线邮件。

套餐限额

• 同一访客 24 小时内再次发言、会话未结束时，续用原会话，不计新会话
• 本月新会话用完后，已有会话照常收发，新访客看到“客服暂时繁忙”
• 仅 Enterprise 可隐藏浮窗底部的“Powered by CZL Connect”