用途与准备
以独立客服网址接入任意网站,在 Telegram 接收访客消息并沿原会话回复。
操作前准备
- 已取得独立客服组件的部署地址。
- Telegram 机器人与管理员接收范围已由部署人员安全配置。
- 站点已经准备隐私说明和客服使用规则。
先看完整流程
流程动效只用于提示步骤顺序;所有信息均在图下注明。可使用页头按钮暂停,系统开启“减少动态效果”时会自动停止。
组件如何工作
- 访客从网站的“在线客服”链接进入独立客服页,按当前部署要求完成访问验证。
- 访客填写昵称和邮箱后发送文字或剪贴板截图,系统创建临时会话。
- Telegram 管理员收到新会话通知,先选择目标会话,再进行连续回复。
- 回复沿原会话返回网页,访客无需刷新即可查看。
接入网站
普通 HTML、WordPress 或其他网站只需添加一个指向客服网址的 HTTPS 链接。目标网站不需要保存 Telegram Bot Token、管理员标识或其他部署密钥。
隐私与数据保留
- 客服会话会处理访客主动提交的昵称、邮箱、消息和截图。上线前应向访客说明用途、保留期限和联系渠道。
- 当前组件按临时客服窗口设计,会话、消息和截图最多保留 24 小时;Telegram 端消息按运营方自己的政策管理。
- 不要在客服对话中索取密码、支付密钥、恢复码或其他可直接登录账号的凭据。
- 截图只用于当前支持问题,不应复制到公开图床或长期留存。
上线验收
- 从目标网站打开客服链接,完成访问验证和访客信息提交。
- 分别发送文字与截图,确认 Telegram 收到正确会话通知。
- 先选择会话,再测试普通回复和 Reply,确认内容只回到目标访客。
- 超过保留期后抽查临时数据清理结果。页面可访问不代表消息链路一定正常。
操作结果确认
- 文字和截图可以从网页到达 Telegram。
- 管理员回复只返回目标访客,不发生会话串线。
- 隐私说明明确,临时数据按约定清理。
常见问题
页面能打开但无法发送怎么办?
检查当前访问验证、客服服务状态和部署配置;不要把 Telegram 凭据写进前端或发送到聊天中。
回复到了错误访客怎么办?
停止继续回复,确认管理员先选择正确会话或使用对应 Reply,再复核会话绑定。
经项目历史核对的更新
v1.0.5当前
授权状态改为绑定稳定部署身份,减少重新发布后的状态漂移。
v1.0.4
增加一次性访问验证,并只保存验证值摘要。
v1.0.3
修复 Cloudflare 自动构建中的项目路径解析。
v1.0.2
稳定数据库与媒体资源绑定,并分离普通变量和加密配置。
v1.0.1
兼容不同 CLI 输出,改善构建失败诊断。
v1.0.0
完成网页消息、截图、Telegram 通知与双向回复闭环。