改善断线后的连接恢复,保留连接关闭状态。
来询使用指南
网站在线咨询,
移动端客服接待。
访客通过网页提交产品、报价与服务需求;客服通过微信、QQ 或 Telegram 接待,回复返回对应咨询窗口。
在线咨询聊天卡片点击展开点击收起
直接在这里咨询,或单独打开聊天卡片 ↗。展开后才加载,首次使用请填写称呼和邮箱。
若浏览器限制跨站会话,请在独立窗口继续咨询 ↗。
部署与网站接入
选好渠道,把步骤交给 AI 助手。
已获得源码权限的用户,可复制下面的完整提示词给 Codex 等部署工具。先填写自己的站点信息,再由工具核对账号、资源和权限;激活、平台审核与手机实际收发仍需完成。
所选渠道需要的 Cloudflare Secrets:
字段名和来源可以查看,不要在本教程或聊天中填写真实密钥。打开逐步部署与接入向导 ↗
展开完整提示词
只把聊天窗口嵌入你的网站
将下方 https://support.example.com 替换为你自己已部署并激活的客服网址。WordPress / WooCommerce 使用“自定义 HTML”区块,Elementor 使用 HTML 小工具,Shopify 使用 Custom Liquid;其他网站放在允许 HTML 的页面或主题位置。
<iframe src="https://support.example.com/embed" title="在线咨询" width="100%" height="740" style="max-width:580px;border:0;border-radius:12px" loading="lazy" referrerpolicy="no-referrer"></iframe>也可以使用右下角浮动咨询按钮,点击前不加载聊天页:
<script src="https://support.example.com/assets/widget.js" data-inlet-url="https://support.example.com" data-label="在线咨询" defer></script>用接入代码生成器 ↗填写自己的域名并一键复制。平台可能过滤脚本;宿主 CSP 需允许客服域名的 frame-src,浮动方式还需 script-src 和 style-src。严格隐私模式或旧浏览器可能阻止跨站会话,可使用独立窗口,推荐将客服部署在网站同一主域名下。
Cloudflare 的公开 Deploy 按钮支持显示变量、密钥与字段说明,但只支持公开源码仓库。私有源码使用 Workers Builds;不会为了“一键部署”将私有仓库公开。
使用前准备
网站访客在网页询问产品、报价与服务,客服在手机接待,回复返回原窗口。
- 已取得独立客服组件的 HTTPS 部署地址,并完成本部署的一次性激活。
- 至少一个渠道已配置并绑定客服;只使用微信不必配置 Telegram。
- 站点已准备隐私说明与客服规则,管理密钥只在可信管理页面输入。
01发起咨询,查看回复
查看详细操作步骤
- 访客从网站的“在线客服”链接进入独立客服页,选择微信、QQ 或电报。默认渠道由运营者设置;未连接的渠道不可选。
- 填写昵称和邮箱后发送文字或剪贴板截图,无需注册。可使用 Ctrl+Enter(macOS 为 Command+Enter)发送;支持 PNG、JPEG、WebP 图片,最大 5 MiB,大截图按需压缩。
- 微信、QQ、Telegram 的会话、历史和草稿各自独立。切换渠道不会自动转发消息;客服在所选渠道的手机机器人会话接收咨询。
- 客服回复返回对应网页窗口。保持页面打开接收实时消息;断线时自动同步和重连,发送失败保留草稿,刷新可恢复仍有效的会话。
- 每个窗口首条咨询 300 秒(5 分钟)未获人工回复时,仅提示一次备用联系方式,不自动升级或跨渠道投递;人工回复会停止该窗口的等待提示。
02选择访客会话并回复
查看详细操作步骤
- 微信与 QQ:打开通知里的接待链接,点击对应访客卡片,返回手机机器人会话发送文字或图片。访客颜色帮助区分,但颜色可能重复,始终核对昵称与会话编号。
- 接待链接有效期为 24 小时,仅限相应渠道与当前绑定客服。重新加载页面后,可从手机最新通知再次打开;请勿公开转发接待链接。
- Telegram:先启动机器人,接收通知后点击“进入该访客会话”按钮;连续回复或 Reply 都会绑定目标会话。一个 Telegram 机器人只能绑定一个 Webhook。
- 也可发送“/会话”查看访客、“/会话 短编号”选中,再直接回复;“/会话 短编号 回复内容”可一次完成选择和回复。
- 访客必须已发起咨询且最近 2 分钟在线,才能选中并接收回复;未咨询、离线、过期或错误渠道会拒绝投递。多访客时不自动猜测对象,新访客通知可能清除之前的选择。
- 支持文字及图片,不支持语音、视频和文件。网页每分钟最多发送 10 条消息;平台本身还可能有额外限额。
03网站在线客服接入
查看详细操作步骤
- 取得独立客服网址,完成一次性激活并配置可用渠道。
- 在网站导航、页脚或常用联系区域添加“在线客服”链接;WordPress 可使用自定义链接。
- 将链接目标填写为本部署的 HTTPS 客服地址,保存设置。机器人与管理密钥只存放在安全配置中。
- 在目标网站实际点击客服入口,确认页面正确打开,并能选择已连接渠道。
- 使用无敏感信息的文字与截图测试,检查手机接收与网页回复;每个启用渠道分别测试。
- 确认移动端与桌面端均可进入咨询页面,再发布网站入口,并向访客提供隐私与客服说明。
普通 HTML、WordPress 或其他网站只需添加指向独立客服网址的 HTTPS 链接。目标网站不需要保存任何机器人或管理员密钥。
来询 Inlet 是 ZOO 旗下的网站访客咨询功能。示例或演示地址:https://chat.198600.xyz/ ↗(在新标签页打开)。可通过演示页面了解咨询流程,再将本部署的客服入口接入网站。
简体中文、英文、台湾繁体仅切换咨询界面的文字,不翻译聊天原文。组件使用 Cloudflare Worker、D1、R2 与 Durable Object;微信、QQ 接入无需另设常驻电脑或服务器。另一份独立部署需使用自己的资源、激活状态及渠道配置,不能共享生产数据库或复用同一个 Telegram 机器人的 Webhook。部署说明见项目仓库,私有仓库访问需授权。
04微信绑定与客服接待
查看详细操作步骤
- 部署人员在 Cloudflare 加密 Secrets 中设置管理密钥;在客服网址的 /admin 页面验证后,点击“生成绑定二维码”,由客服本人在手机微信扫描并确认。登录过期需重新绑定,二维码过期重新生成。
- 绑定后在微信机器人会话发送一条真实消息(例如“你好”),刷新管理状态。保存默认渠道与备用电话;设置默认渠道只影响首次打开的选项卡。
- 网页发送测试文字与图片,手机检查通知;单一待接待访客可直接回复,多访客打开通知中的“点击切换访客”链接选中正确访客,也可引用新的通知回复。
- 长时间没有客服入站消息或平台会话异常时,微信可能拒绝主动投递。客服向机器人发送一条真实消息可刷新上下文,系统会尝试补投仍在留存期内的失败咨询。机器人心跳不能保证刷新,无法保证通过固定频率的消息长期维持有效上下文。
管理页可查看最近真实微信上下文时间及投递状态。“已绑定”不等于每条消息已送达;长期少操作的客服可考虑使用已授权的 QQ 或电报,并完成图文收发验收。
05配置 QQ 机器人与客服
查看详细操作步骤
- 在 QQ 机器人开放平台创建机器人并开通私聊;开发阶段按平台要求配置测试范围,公开使用按平台要求上线。使用普通个人 QQ 登录不能替代官方应用配置。
- 部署人员把 AppID 与 AppSecret 安全保存到 Cloudflare;QQ 平台配置 HTTPS 回调 https://你的客服域名/api/support/qq/webhook,订阅 C2C_MESSAGE_CREATE,确认回调验签成功。
- 客服手机添加机器人并按平台要求允许主动发送。在管理页生成一次性绑定口令,仅在该机器人的私聊发送“/绑定 口令”;5 分钟内有效,成功后不能重复使用。
- 刷新管理状态确认已绑定,然后在 QQ 窗口测试网页文字、图片与手机回复。客服身份来自已验签的机器人用户 OpenID,不是普通 QQ 号码;其他账号的回复不会转给访客。
QQ 主动消息受应用权限、账号关系及平台额度限制。配置、绑定成功与真实收发是不同检查项;出现投递失败时核对权限和状态。
06上线前收发检查
查看详细操作步骤
- 从目标网站打开客服链接,完成本部署激活和访客信息提交;已激活的部署不再让每位访客输入激活码。
- 对每个已启用渠道分别发送无敏感信息的测试文字与截图,确认正确手机渠道实际收到通知。
- 用两位在线访客检查选择、连续文字与图片回复;微信另检查引用新通知。确认只回到所选访客及原渠道,切换时历史和草稿保持独立。
- 刷新网页、短暂断网后恢复,检查会话和新消息;分别核对 300 秒单次备用提示及人工回复停止提示。
- 超过保留期后抽查程序数据清理。页面可访问、渠道已绑定或平台确认投递都不能代替手机及网页两端真实收到的验收。
使用说明与常见问题
网站接入与部署服务
来询 Inlet 是 ZOO 旗下的网站咨询与询盘入口。可在客户自有云账号上部署,并提供网站入口接入、图文收发调试等技术服务。具体交付范围和技术服务费在开始前确认。
隐私与数据保留
- 客服会话会处理访客主动提交的昵称、邮箱、消息和截图。上线前应向访客说明用途、保留期限和联系渠道。
- 程序侧会话、消息和截图最多保留 24 小时,定时任务自动清理。微信、QQ、Telegram 客服端已经收到的副本不由这一清理任务删除,应按运营方自己的政策管理。
- 不要在客服对话中索取密码、支付密钥、恢复码或其他可直接登录账号的凭据。
- 截图只用于当前支持问题,不应复制到公开图床或长期留存。
功能与使用限制
来询 Inlet 支持微信、QQ、Telegram 独立咨询窗口、手机图文接待、多访客选择、失败保留草稿和断线恢复。简体、英文、台湾繁体只切换网页界面,不翻译访客与客服的聊天原文。
消息到达受网络及各平台规则影响。微信需维护有效会话上下文;QQ 主动消息受应用权限与额度限制。启用渠道后,请按下方步骤核对手机与网页两端的实际收发。每个站点使用自己的云资源和渠道配置。
如何确认咨询和回复正常?
- 每个已启用渠道的网页文字与图片实际到达手机,手机回复回到原窗口。
- 两位访客及跨渠道选择不会串线,离线/未咨询访客不能接收回复。
- 300 秒仅提示一次,人工回复停止提示;刷新和断线后能恢复。
- 隐私说明明确,程序数据按约定清理,手机副本另行管理。
版本记录
减少网页初始化请求,优化微信咨询通知排版。
发送请求去重、失败保留草稿及网络中断后确认结果,简化手机多访客接待。
微信、QQ、Telegram 使用独立咨询窗口,改善 QQ 图片展示与手机图文接待。
授权状态改为绑定稳定部署身份,减少重新发布后的状态漂移。
增加一次性访问验证,并只保存验证值摘要。
修复 Cloudflare 自动构建中的项目路径解析。
稳定数据库与媒体资源绑定,并分离普通变量和加密配置。
兼容不同 CLI 输出,改善构建失败诊断。
完成网页消息、截图、Telegram 通知与双向回复闭环。
页面可访问但无法发送消息如何处理?
核对本部署激活、所选渠道、客服状态和网络。发送失败时保留草稿,待结果明确后重试;不要把机器人凭据写进前端或聊天。
微信发送消息后才收到咨询的原因是什么?
真实入站可能刷新微信上下文并触发失败消息补投。查看最近上下文及投递状态;不能把定时由机器人主动发消息当作长期保活。
切换至 QQ 后为何不显示微信聊天记录?
正常。微信、QQ、Telegram 的会话、历史和草稿独立;返回微信可查看仍在保留期内的原记录,不会自动转发。
回复时提示访客离线如何处理?
请访客重新打开原网页窗口并发起咨询,确认在线后重新选择对应访客;不要绕过在线检查向其他会话发送。
QQ 已绑定但未收到新消息如何排查?
核对官方应用私聊权限、测试范围、主动发送授权、平台额度和最近投递状态。绑定成功不等于通知实际送达。
24 小时清理是否包含手机端通知?
不会。程序清理只覆盖程序存储的临时数据;各平台和客服手机中的副本由运营者另行管理。