给第一次部署的你
选好渠道,按步骤接入。
无需自备云服务器。先准备自己渠道的配置,再交给 Cloudflare 或 AI 助手完成部署。
01 选择客服接待渠道
只准备所选渠道的配置。三个渠道可同时启用,咨询窗口各自独立。
02 准备 Cloudflare Secrets
以下只列字段与来源,不用在此输入真实密钥。在你的 Cloudflare 部署配置中填写并加密保存;未选渠道留空。
请至少选择一个渠道。
03 部署到自己的 Cloudflare
- 登录自己的 Cloudflare,开通 R2,确认有 Worker、D1、R2 的资源权限。
- 本项目仓库目前私有,需有仓库权限或取得完整源码。私有仓库通过 Workers & Pages → Create → Continue with GitHub 连接;公开 Deploy 按钮仅支持公开仓库。
- Node.js 使用 24 或以上。构建命令:
npm run verify;部署命令:npm run deploy:cloudflare-build。首次可由脚本创建独立 D1/R2。已有实例更新时保留资源、Secrets 和激活绑定。 - 配置上述字段并发布。第二份实例分别更改 Worker、数据库与 R2 名称,使用自己的 D1 ID 和机器人。
公开源码的 Deploy 按钮如何提示字段?
Cloudflare 从 .dev.vars.example 读取密钥字段,从 package.json → cloudflare.bindings 读取中文说明。本项目已提供六项说明。Cloudflare 原生表单由平台控制,不能保证按渠道动态隐藏字段;请按上面的清单填写所需渠道。
04 激活、绑定与验收
首次需有效激活码,激活绑定整份部署。网页可打开、配置已保存都不代表手机收到消息;分别验证文字、图片和回复回到原网页。
打开本实例渠道设置 ↗AI 一键复制部署提示词
已包含所选渠道、Cloudflare 命令、独立资源、激活、网站接入与验收要求。复制给 Codex 等具备部署能力的助手,并填写提示词中的站点信息。
展开完整提示词
05 复制到自己的网站
只嵌入聊天卡片,保留渠道、语言、记录说明与独立窗口入口。WordPress / WooCommerce:使用“自定义 HTML”区块;Shopify:使用 Custom Liquid;其他网站:放入允许 HTML 的位置。
浮动按钮在点击前不加载聊天页面。若浏览器限制跨站 Cookie,可用“独立窗口”继续咨询,或将客服部署在网站同一主域名下。宿主 CSP 须允许客服域名的 frame-src;浮动脚本另需 script-src 和 style-src。
限制哪些网站可以嵌入
在 Cloudflare 添加普通运行时变量 SUPPORT_EMBED_ORIGINS,值为 https://shop.example https://www.shop.example,来源之间用空格分隔。默认允许 HTTPS 网站嵌入专用聊天页;管理页和完整主页仍禁止嵌入。填写后重新部署生效。