这套系统把四个来源的客户消息收进同一个工作台。网页渠道开箱即用; 企业微信、微信客服、QQ 机器人需要在各自平台做一次回调配置,本文给出每一步要填什么、去哪里拿。
注册后自动获得试用租期。正式使用在「套餐与续费」页下单,或输入卡密直接续费。 租期从当前到期时间往后顺延,不会浪费剩余时间。
进入「渠道管理」,右上角选择要接入的渠道类型。系统会自动生成唯一的回调地址, 你把它复制到对应平台即可。
每个渠道的凭据字段都在「配置」里,全部由你自己填写,平台不预置任何第三方账号。 密码类字段保存后显示为掩码,留空表示不修改。
点「测试连接」会真实调用一次上游接口,返回成功或具体错误码。通过后, 客户消息就会实时出现在「会话工作台」。
不需要审核、不需要第三方账号,创建后会得到一个专属短码,对应两个地址:
| 用途 | 地址 |
|---|---|
| 客户对话页 | /c/{短码} |
| 二维码图片 | /qr/{短码}.png |
| 二维码展示页 | /qr/{短码}(带下载按钮,适合打印) |
可配置项包括:接待品牌名、欢迎语、主题色、是否要求客户先填称呼、是否允许上传附件、 附件大小上限、离线自动回复。
/qr/{短码}.png?size=1024 可直接下载大图。适用于「客户在微信里找到企业,给企业发消息」的场景。使用企业微信自建应用接收消息。
| 字段 | 在哪里拿 |
|---|---|
| 企业 ID(CorpID) | 企业微信后台 → 我的企业 → 企业信息,页面底部 |
| 应用 AgentId | 应用管理 → 自建应用 → 点进应用,顶部「AgentId」 |
| 应用 Secret | 同一个页面的「Secret」,点「查看」并复制 |
| Token / EncodingAESKey | 应用页 → 接收消息 → 设置 API 接收,点「随机获取」 |
默认使用「应用消息」把回复推给客户(需要该客户在应用的可见范围内)。如果你的企业已开通微信客服,
可以在配置里打开「使用微信客服会话接口」,回复将走 kf/send_msg,客户在微信里直接收到。
「微信客服」是企业微信提供的、让微信用户直接发起咨询的能力。客户在微信中打开你的客服入口即可对话。
| 字段 | 在哪里拿 |
|---|---|
| 企业 ID | 同企业微信,我的企业 → 企业信息 |
| 微信客服 Secret | 企业微信后台 → 应用管理 → 微信客服 → 点进「API」查看 Secret(注意不是应用的 Secret) |
| 客服账号 open_kfid | 微信客服后台的客服账号列表,形如 wkxxxxxx;留空系统会自动取第一个 |
| Token / EncodingAESKey | 微信客服 → API → 接收消息配置,同页面生成 |
支持两种模式,按你的机器人类型选择。
系统提供反向 WebSocket 服务端,让机器人主动连上来。这样不需要公网回调、不需要域名备案, 内网也能跑。
wss://你的域名/ws/onebot/{短码}?access_token=你的Token。| 机器人 | 配置位置 |
|---|---|
| NapCat | 网络配置 → 新建「WebSocket 客户端」→ URL 填反向 WS 地址 |
| Lagrange.OneBot | appsettings.json → Implementations 加一条 ReverseWebSocket |
| go-cqhttp | config.yml → servers → 加一条 ws-reverse 并填 universal 地址 |
如果机器人在本机(同一台服务器),可以直接用内网地址
ws://127.0.0.1:8063/ws/onebot/{短码},不必走域名。
发送回复时,若配置了 OneBot HTTP API 地址则直接调用;否则复用在线的那条反向 WS 连接下发, 不需要额外开端口。
| 字段 | 在哪里拿 |
|---|---|
| AppID | QQ 开放平台 → 你的机器人 → 开发设置 |
| AppSecret | 同页面 |
| 机器人 Token | 开发设置里的 Token,用于回调签名校验;必须填写,否则无法完成地址验证 |
新会话自动分配给在线的、进行中会话最少的坐席;商户主账号可以在会话头部点「指派」手动改派。 坐席登录后只能看到分配给自己的会话。
在「快捷回复」里维护常用话术,工作台输入框上方会出现对应按钮,点一下直接填入输入框,可再编辑后发送。
渠道配置里开启后,当所有坐席都不在线时,客户发来第一条消息会自动收到提示,30 分钟内不重复发送。
系统会记录客户的渠道来源、设备、IP 归属地、首次与最近活跃时间、访问次数。同一渠道同一客户只建一份档案, 可以在会话里给客户加内部备注。
会话页的「导出」按钮会把该会话的全部消息存为文本文件,便于留档。
测试连接会返回上游的真实错误信息,常见几类:
| 提示 | 原因与处理 |
|---|---|
40013 invalid corpid | 企业 ID 填错,注意不要带空格 |
40001 invalid credential | Secret 填错,或复制时带了换行 |
60020 not allow to access from your ip | 企业微信后台的「企业可信 IP」没放行服务器出口 IP |
签名校验失败 | Token 与 EncodingAESKey 和企业微信后台里的不一致 |
| 机器人未连接 | 反向 WS 地址或 access_token 填错,或机器人进程没启动 |
工作台里该条消息下方会显示「投递失败」及上游返回的错误码,按错误码排查即可。 消息本身已入库,不影响你在系统内查看历史。
可以,网页渠道完全不需要第三方账号,注册后立刻可用。