使用 Step 1

从接入到日常回复，这里覆盖了你需要知道的一切。看完还解决不了的问题，点右下角直接问我们。

没有匹配的内容。试试别的关键词，或者直接问我们。

15 分钟接入

注册账号，系统会自动为你创建一个工作区和一个站点。
进入「安装接入」，复制你的专属代码或提示词。
粘贴到你网站的 </body> 之前，保存发布。
打开你的网站，右下角出现客服按钮就成功了。后台会自动检测到，显示「安装成功」。

不需要信用卡，也不需要配置服务器。接入只需要一行 script 标签。

2两种安装方式

方式一：交给 AI 助手（推荐给不熟悉代码的人）

在「安装接入」页面，默认会给你一段提示词，里面已经包含你的专属密钥和具体要求。把整段内容复制给你的 AI 编程工具（Cursor、Claude Code、Copilot 等），它会自己找到正确位置。

提示词里特别强调了要放在全局模板而不是首页。如果你用的是 Next.js、Nuxt、Astro 这类框架，只放在首页会导致其他页面没有客服按钮 —— 这是最常见的接入失败原因。

方式二：手动粘贴代码

在「安装接入」页面切到「手动粘贴代码」，复制这一行：

<script src="https://s1.steplan.io/step1.js?key=你的密钥" async></script>

各平台的具体位置：

WordPress：外观 → 主题文件编辑器 → footer.php，粘在 </body> 前
Shopify：在线商店 → 主题 → 编辑代码 → theme.liquid
Webflow：项目设置 → 自定义代码 → 页脚代码
纯 HTML：直接放在每个页面的 </body> 前

3外观与首屏

三个配置分页

外观样式 —— 主题色、按钮文字、位置、水印
首屏设置 —— 访客点开时先看到的欢迎页：头像、欢迎语、快捷操作按钮
对话界面 —— 客服名称、输入框提示、AI 开场白

右侧预览是真实的挂件

右边不是效果图，是真正运行的组件。改任何设置都会立刻反映在预览里。预览顶部有「对话界面 / 收集表单」切换，可以看访客进入后的两种状态。

关于「预约咨询」按钮

首屏可以放一个预约按钮。你需要在「首屏设置」里填一个外部预约链接（Cal.com、Calendly 等）。 不填链接的话，点击时只会提示「暂时还不能在线预约」 —— 不会假装打开预约页。

4访客信息收集

开启后，访客第一次发起对话时会看到一个简短表单，填写称呼和邮箱。这样对话结束后你还能跟进 —— 否则你只知道对方叫 web_a1b2c3。

三种模式

可选（默认） —— 访客可以填，也可以点「暂时跳过」直接聊
必填 —— 不填不能开始对话
关闭 —— 完全不显示，所有对话匿名

建议先用「可选」。强制留邮箱会让一部分本来会聊的访客直接离开。先跑一两周，看看有多少人愿意主动填，再决定要不要收紧。

在哪里看访客信息

收件箱里每个会话会显示访客姓名和邮箱（如果留了的话）。点「详情」可以看到完整资料：访问过哪些页面、来过几次、发过多少条消息，还能写备注。

5知识库

AI 助手回答问题的依据来自这里。知识库越具体，回答越准。支持三种导入方式：

粘贴文本

适合直接写一段政策说明，比如「退货政策：30 天内可退，需保持原包装」。

从网页导入

贴一个网址，系统会抓取页面正文、去掉导航和广告，存进知识库。同一网址重复导入是更新而不是新建，方便你网页改版后同步。

纯前端渲染的页面（很多 Shopify 店铺）抓不到内容 —— 因为我们的抓取不执行 JavaScript。遇到这种情况请改用粘贴文本。

上传文件

支持 PDF、Word（.docx）、TXT、Markdown、CSV、JSON、HTML，单个文件最大 10MB。上传后会先显示提取出来的文字，你确认无误再入库。

扫描版 PDF（只有图片没有文字层）无法提取内容，系统会明确提示你改用粘贴文本。

写知识库的几个建议

写具体数字：不要写「发货很快」，写「下单后 3–5 个工作日发出」
一个问题一条：把「运费和退换」拆成两条，检索更准
用客户的说法：客户搜「多久能到」，就别只写「物流时效」
定期清理：过期的促销政策要及时删掉，否则 AI 会引用旧信息

6AI 助手

先选服务商

进入「AI Agent → 设置」。默认推荐 DeepSeek，也可以选 OpenAI 或任何兼容 OpenAI 接口的服务。填入你的 API 密钥，选模型，打开「启用 AI 回复」。

密钥是加密存储的。后台只会显示 sk-••••••••abcd 这样的掩码，任何人都无法从界面看到完整密钥。密钥只在服务器端使用。

不配 AI 也能用

没有配置 AI 服务商时，系统会用关键词匹配从知识库里找答案。回答不如 AI 自然，但完全免费，也不会因为服务商故障而中断。

自定义 AI 的语气

「行为设置」里可以写系统提示词，用来约束 AI 的表达方式，例如：

始终用中文回复。
回答不超过 100 字。
不要承诺具体交期，只说「通常 3–5 个工作日」。
遇到价格谈判直接转人工。

先测试再上线

「测试」分页可以点「测试连接」验证密钥是否有效，还能直接提问看 AI 会怎么回答 —— 用的就是和真实访客完全一样的流程。

7回复访客

三个筛选

全部 —— 所有会话
AI 已处理 —— AI 负责的会话（含已解决的）
人工相关 —— 有你或同事介入过的会话

搜索

搜索框会同时匹配访客姓名、邮箱、访客 ID 和消息正文。想找三个月前某个客户问过的型号，直接搜型号即可。

详情面板

点右上角「详情」打开。可以看到访客从哪个页面进来、来过几次、发过多少消息。底部的备注很重要 —— 写一句「问过两次 MOQ，下周要样品」，下次他再来时你或者同事都能看到上下文。

8转人工

两种情况会转人工：

AI 在知识库里找不到答案，会主动说「我转给同事」
你在收件箱里直接回复，会话就归你处理

转人工后 AI 会停止回答

你接管期间，访客发的新消息不会再触发 AI 回复 —— 免得 AI 和你同时说话把访客搞糊涂。

AI 什么时候恢复

两个条件之一：你超过 30 分钟没有回复，AI 会自动接管回来；或者你手动点「恢复 AI」。所以下班后访客也不会无人应答。

9团队成员

在「团队成员」页邀请同事，有三种角色：

所有者 —— 全部权限，包括计费和转让。每个工作区只有一个
管理员 —— 可以改设置、配 AI、管知识库、邀请成员
客服 —— 只能回复对话和加知识库，看不到 API 密钥也改不了设置

邀请链接 7 天内有效，只能用一次。如果对方邮箱已有账号，需要输入原密码确认身份。

10常见问题

按顺序检查这四件事：

在浏览器里按 Ctrl+U（Mac 是 Cmd+Option+U）看页面源码，搜 step1.js —— 搜不到说明代码没生效
打开浏览器控制台（F12），看有没有红色报错
确认密钥没写错，可以在「安装接入」页面核对
换一个浏览器或用无痕窗口试，排除浏览器插件干扰

如果是 Next.js 这类框架，最常见的原因是只放在了首页而没有放在全局布局里。

九成情况是知识库里没有相关内容，或者写得太笼统。到「AI Agent → 测试」输入访客会问的问题，看「知识命中」列表 —— 如果一条都没匹配上，说明知识库缺这块内容；如果匹配错了，说明表述需要更具体。

三个可能：
1. 「访客信息收集」被设成了「关闭」；
2. 这个访客之前填过或跳过，浏览器记住了，不会再问；
3. 他直接从帮助入口进来的，没走首次对话流程。
想强制验证，可以用无痕窗口打开你的网站试。

配置是即时生效的，不需要重新部署。如果没看到变化：先强制刷新页面（Ctrl+Shift+R）；如果还是旧的，检查是不是有多个站点、而你在编辑另一个站点。已经打开的页面最多 1 分钟内会自动同步。

到「安装接入」点「重置密钥」，旧密钥立刻失效。然后更新你网站上的代码。 注意：重置后所有使用旧密钥的页面都会停止工作，需要逐个更新。

可以。每个站点有独立的密钥和独立的知识库，对话会标注来自哪个站点。但所有对话都会汇集到你同一个收件箱。

组件脚本约 40KB（gzip 后更小），异步加载，不阻塞页面渲染。样式完全隔离在 Shadow DOM 里，不会和你网站自己的 CSS 冲突。

有。组件自动适配手机屏幕，小屏上会全屏展开。你回复时用手机浏览器打开后台也可以操作。

11排错清单

客服按钮不出现

页面源码里搜不到 step1.js → 代码没插入或没发布
控制台有 404 → 密钥错误或域名写错
代码在但只有首页有 → 需要放到全局布局
被网站其他脚本干扰 → 用无痕窗口排除插件影响

AI 不回复

「启用 AI 回复」是否打开
API 密钥是否有效（「测试」页点「测试连接」）
会话是否已转人工（转人工后 AI 会沉默 30 分钟）
服务商余额是否用完

收不到邮件通知

邀请邮件可能被归到垃圾箱 → 检查一下
如果确认没收到，邀请链接在后台可以直接复制

以上都检查过还是不行，点右下角的客服按钮直接问我们 —— 回复会同时发到你的邮箱。