登录

使用说明与渠道接入指引

这套系统把四个来源的客户消息收进同一个工作台。网页渠道开箱即用; 企业微信、微信客服、QQ 机器人需要在各自平台做一次回调配置,本文给出每一步要填什么、去哪里拿。

快速开始 网页客服 企业微信 微信客服 QQ 机器人 工作台用法 租期与计费 常见问题

快速开始

1
注册并确认租期

注册后自动获得试用租期。正式使用在「套餐与续费」页下单,或输入卡密直接续费。 租期从当前到期时间往后顺延,不会浪费剩余时间。

2
添加渠道

进入「渠道管理」,右上角选择要接入的渠道类型。系统会自动生成唯一的回调地址, 你把它复制到对应平台即可。

3
填写凭据

每个渠道的凭据字段都在「配置」里,全部由你自己填写,平台不预置任何第三方账号。 密码类字段保存后显示为掩码,留空表示不修改。

4
测试连接并开始接待

点「测试连接」会真实调用一次上游接口,返回成功或具体错误码。通过后, 客户消息就会实时出现在「会话工作台」。

网页在线客服

不需要审核、不需要第三方账号,创建后会得到一个专属短码,对应两个地址:

用途地址
客户对话页/c/{短码}
二维码图片/qr/{短码}.png
二维码展示页/qr/{短码}(带下载按钮,适合打印)

可配置项包括:接待品牌名、欢迎语、主题色、是否要求客户先填称呼、是否允许上传附件、 附件大小上限、离线自动回复。

二维码支持指定尺寸:/qr/{短码}.png?size=1024 可直接下载大图。

企业微信客服

适用于「客户在微信里找到企业,给企业发消息」的场景。使用企业微信自建应用接收消息。

要准备的四个值

字段在哪里拿
企业 ID(CorpID)企业微信后台 → 我的企业 → 企业信息,页面底部
应用 AgentId应用管理 → 自建应用 → 点进应用,顶部「AgentId」
应用 Secret同一个页面的「Secret」,点「查看」并复制
Token / EncodingAESKey应用页 → 接收消息 → 设置 API 接收,点「随机获取」

配置步骤

  1. 在企业微信后台创建自建应用,可见范围包含需要接待的成员。
  2. 在「接收消息」里点「设置 API 接收」,把系统渠道页展示的回调地址粘贴到 URL 框。
  3. 把企业微信生成的 Token、EncodingAESKey 填进我们的渠道配置并保存。
  4. 回到企业微信页面点「保存」,它会给我们的回调发一次校验请求,通过即配置成功。
  5. 点渠道页的「测试连接」,确认 access_token 能正常获取。
企业微信对回调有 5 秒超时限制。系统收到消息后立即返回,实际入库与推送在后台完成, 因此不会因为处理慢而失败。

回复方式

默认使用「应用消息」把回复推给客户(需要该客户在应用的可见范围内)。如果你的企业已开通微信客服, 可以在配置里打开「使用微信客服会话接口」,回复将走 kf/send_msg,客户在微信里直接收到。

微信客服(微信生态)

「微信客服」是企业微信提供的、让微信用户直接发起咨询的能力。客户在微信中打开你的客服入口即可对话。

字段在哪里拿
企业 ID同企业微信,我的企业 → 企业信息
微信客服 Secret企业微信后台 → 应用管理 → 微信客服 → 点进「API」查看 Secret(注意不是应用的 Secret)
客服账号 open_kfid微信客服后台的客服账号列表,形如 wkxxxxxx;留空系统会自动取第一个
Token / EncodingAESKey微信客服 → API → 接收消息配置,同页面生成

配置步骤

  1. 在企业微信后台开通「微信客服」,创建至少一个客服账号并添加接待人员。
  2. 把系统渠道页展示的回调地址填进微信客服的「接收消息」配置。
  3. Token 与 EncodingAESKey 填进渠道配置并保存。
  4. 点「测试连接」:会先取 access_token,再列出客服账号,成功时会显示识别到的 open_kfid。
消息拉取采用游标机制,游标持久化在数据库中,服务重启不会丢消息。 同时支持定时补偿拉取,避免回调丢失造成漏消息。

QQ 机器人客服

支持两种模式,按你的机器人类型选择。

模式一:OneBot v11(推荐,NapCat / Lagrange / go-cqhttp)

系统提供反向 WebSocket 服务端,让机器人主动连上来。这样不需要公网回调、不需要域名备案, 内网也能跑。

  1. 在渠道配置里设置一个 OneBot 访问 Token(自己定,足够随机即可)。
  2. 保存后,渠道页会展示反向 WebSocket 地址,形如 wss://你的域名/ws/onebot/{短码}?access_token=你的Token。
  3. 把该地址填进机器人配置:
    机器人配置位置
    NapCat网络配置 → 新建「WebSocket 客户端」→ URL 填反向 WS 地址
    Lagrange.OneBotappsettings.json → Implementations 加一条 ReverseWebSocket
    go-cqhttpconfig.yml → servers → 加一条 ws-reverse 并填 universal 地址
  4. 保存并重启机器人,渠道页「测试连接」会显示机器人已经连接上。

如果机器人在本机(同一台服务器),可以直接用内网地址 ws://127.0.0.1:8063/ws/onebot/{短码},不必走域名。

也支持 HTTP 上报:把上报地址填成渠道页展示的回调地址即可, 但需要机器人能访问到本站域名。

发送回复时,若配置了 OneBot HTTP API 地址则直接调用;否则复用在线的那条反向 WS 连接下发, 不需要额外开端口。

模式二:QQ 官方机器人开放平台

字段在哪里拿
AppIDQQ 开放平台 → 你的机器人 → 开发设置
AppSecret同页面
机器人 Token开发设置里的 Token,用于回调签名校验;必须填写,否则无法完成地址验证
  1. 把渠道页展示的回调地址填到开放平台的「事件订阅」。
  2. 平台会发一次地址验证请求,系统用 Bot Token 派生密钥自动签名应答,验证自动通过。
  3. 沙箱环境可打开配置里的「沙箱环境」开关。
官方机器人对私聊有主动消息次数限制,建议用于「用户先发消息、我们再回复」的场景。

工作台用法

会话分配

新会话自动分配给在线的、进行中会话最少的坐席;商户主账号可以在会话头部点「指派」手动改派。 坐席登录后只能看到分配给自己的会话。

快捷回复

在「快捷回复」里维护常用话术,工作台输入框上方会出现对应按钮,点一下直接填入输入框,可再编辑后发送。

离线自动回复

渠道配置里开启后,当所有坐席都不在线时,客户发来第一条消息会自动收到提示,30 分钟内不重复发送。

客户档案

系统会记录客户的渠道来源、设备、IP 归属地、首次与最近活跃时间、访问次数。同一渠道同一客户只建一份档案, 可以在会话里给客户加内部备注。

导出

会话页的「导出」按钮会把该会话的全部消息存为文本文件,便于留档。

租期与计费

常见问题

渠道测试连接失败怎么办?

测试连接会返回上游的真实错误信息,常见几类:

提示原因与处理
40013 invalid corpid企业 ID 填错,注意不要带空格
40001 invalid credentialSecret 填错,或复制时带了换行
60020 not allow to access from your ip企业微信后台的「企业可信 IP」没放行服务器出口 IP
签名校验失败Token 与 EncodingAESKey 和企业微信后台里的不一致
机器人未连接反向 WS 地址或 access_token 填错,或机器人进程没启动

消息发出去了但客户没收到?

工作台里该条消息下方会显示「投递失败」及上游返回的错误码,按错误码排查即可。 消息本身已入库,不影响你在系统内查看历史。

可以只用网页渠道吗?

可以,网页渠道完全不需要第三方账号,注册后立刻可用。