星语智服XINGYU AI

WECOM · AUTO REPLY

让企业微信里的客户,也能被同一个 AI 客服接住。

商家在企业微信里建一个自建应用,把回调地址指向星语智服,客户发消息就会走你的知识库 + 大模型,并把回复直接回填到企微会话里。 每个客户独立会话与记忆,按 token 扣商家积分。

概览

不需要额外的服务器转发:企业微信把消息推到我们的回调,我们在 5 秒内同步被动回复。

  • 支持文字消息;图片/语音/文件目前回一句引导文字。
  • 支持明文与 AES 加密两种回调模式,公网建议必须开加密。
  • 每个企微 userid 一个会话,保留最近 10 轮上下文与客户记忆。
  • 回答范围、话术、订单查询能力与网页客服完全一致。
  • 不保存消息正文以外的个人资料;不主动群发、不读取通讯录。

需要准备什么

下面这些都在企业微信管理后台,商家管理员就能拿到。

参数在企业微信哪里拿说明
CorpID企业微信 → 我的企业 → 企业信息 → 企业IDww 开头,必填
AgentID企业微信 → 应用管理 → 自建应用 → 应用详情纯数字,必填
Secret同上,应用详情里的 Secret只显示一次,必填
Token应用 → 接收消息 → 设置 API 接收(自己填)必填,与后台保持一致
EncodingAESKey同上,点「随机获取」生成 43 位强烈建议填;不填为明文
回调 URL星语后台「企业微信」页自动生成,复制过去https://你的域名/api/v1/wecom/callback/商家编码

五步接入

  1. 企业微信后台 → 应用管理 → 创建自建应用,记下 AgentID 与 Secret。
  2. 商家端「企业微信」页填写 CorpID / AgentID / Secret / Token,点「保存配置」;Token 可自己起一个随机串。
  3. 回到企业微信应用 → 接收消息 → 设置 API 接收:URL 粘贴后台生成的回调地址,Token 填同一个,EncodingAESKey 点随机生成并填回商家端,勾选「保存」。
  4. 企微会立刻发一次 GET 校验;看到「保存成功」即打通。若提示校验失败,多半是 Token/AESKey 两边不一致,或商家端参数还没保存。
  5. 在商家端打开「自动回复」开关,用「联调测试」先确认知识库+模型正常,再用企微给应用发一条消息验收。
小提示:企业微信回调地址必须是 公网可访问的 HTTPS。本地调试可以用内网穿透(ngrok / cpolar 等),把外网地址填到企微即可。

回调地址

每个商家一条独立地址,末尾的编码就是商家编码。

GET  https://your-domain.com/api/v1/wecom/callback/YUNQI?msg_signature=...&timestamp=...&nonce=...&echostr=...
POST https://your-domain.com/api/v1/wecom/callback/YUNQI?msg_signature=...&timestamp=...&nonce=...

GET 用于企业微信保存回调时的校验,我们把解密后的 echostr 原样返回;POST 是真实的客户消息。

消息流程

  1. 客户在企业微信里给应用发「你们的茶怎么卖?」。
  2. 企业微信把消息加密后 POST 到回调地址(带签名、时间戳、随机串)。
  3. 我们校验签名 → 解密 → 取 FromUserName / Content。
  4. 按商家知识库检索,必要时调用订单 webhook,再交给大模型生成口语化回复。
  5. 按 token 扣商家积分,写入会话记忆,把回复 XML 加密后作为 HTTP 响应返回,企微展示给客户。

整条链路不落客户消息原文以外的隐私数据;若模型超过 4.5 秒未返回,会先回一句「稍后再发一次」,避免企微超时重试。

加密与验签

启用 EncodingAESKey 后,消息体是 AES-256-CBC(PKCS#7 按 32 字节补位):

key  = Base64Decode(EncodingAESKey + "=")   // 32 字节
iv   = key[0..16]
明文 = random(16) + msgLen(4, 大端) + msgXml + CorpID
签名 = sha1(sort([token, timestamp, nonce, encrypt]).join(""))

响应用同样的方式加密,外层是 <Encrypt> + <MsgSignature> + <TimeStamp> + <Nonce>,企业微信会自行解密。你不需要自己实现这部分——全部在星语这一侧完成。

计费

与企业微信的每条 AI 回复按 token 计费,单价与网页客服相同(总后台「积分与套餐」里统一配置)。余额不足时不回复,并提示联系商家。

在商家端「积分与充值 → 积分流水」里,来源会标记为「企业微信」。

常见问题

企业微信提示「回调地址校验失败」

99% 是 Token 或 EncodingAESKey 两边不一致;其次是没有先在星语后台保存参数。改完两边都重新保存一次。

客户发消息没有回复

检查「自动回复」开关、商家积分余额;如果是图片/语音,目前只回引导文字。

回复乱码或解密失败

EncodingAESKey 填错了(必须是 43 位),或者填了 AESKey 但企业微信那边选的是明文模式。

能不能主动推送消息?

当前只做被动回复,不调用发消息接口,所以不需要配置企业可信 IP。需要主动触达时再单独开通。

需要协助?把商家编码和企业微信应用截图发给我们,可以帮你核对参数。前往商家端配置 →