WECOM · AUTO REPLY
让企业微信里的客户,
也能被同一个 AI 客服接住。
商家在企业微信里建一个自建应用,把回调地址指向星语智服,客户发消息就会走你的知识库 + 大模型,并把回复直接回填到企微会话里。 每个客户独立会话与记忆,按 token 扣商家积分。
概览
不需要额外的服务器转发:企业微信把消息推到我们的回调,我们在 5 秒内同步被动回复。
- 支持文字消息;图片/语音/文件目前回一句引导文字。
- 支持明文与 AES 加密两种回调模式,公网建议必须开加密。
- 每个企微 userid 一个会话,保留最近 10 轮上下文与客户记忆。
- 回答范围、话术、订单查询能力与网页客服完全一致。
- 不保存消息正文以外的个人资料;不主动群发、不读取通讯录。
需要准备什么
下面这些都在企业微信管理后台,商家管理员就能拿到。
| 参数 | 在企业微信哪里拿 | 说明 |
|---|---|---|
| CorpID | 企业微信 → 我的企业 → 企业信息 → 企业ID | ww 开头,必填 |
| AgentID | 企业微信 → 应用管理 → 自建应用 → 应用详情 | 纯数字,必填 |
| Secret | 同上,应用详情里的 Secret | 只显示一次,必填 |
| Token | 应用 → 接收消息 → 设置 API 接收(自己填) | 必填,与后台保持一致 |
| EncodingAESKey | 同上,点「随机获取」生成 43 位 | 强烈建议填;不填为明文 |
| 回调 URL | 星语后台「企业微信」页自动生成,复制过去 | https://你的域名/api/v1/wecom/callback/商家编码 |
五步接入
- 企业微信后台 → 应用管理 → 创建自建应用,记下 AgentID 与 Secret。
- 商家端「企业微信」页填写 CorpID / AgentID / Secret / Token,点「保存配置」;Token 可自己起一个随机串。
- 回到企业微信应用 → 接收消息 → 设置 API 接收:URL 粘贴后台生成的回调地址,Token 填同一个,EncodingAESKey 点随机生成并填回商家端,勾选「保存」。
- 企微会立刻发一次 GET 校验;看到「保存成功」即打通。若提示校验失败,多半是 Token/AESKey 两边不一致,或商家端参数还没保存。
- 在商家端打开「自动回复」开关,用「联调测试」先确认知识库+模型正常,再用企微给应用发一条消息验收。
回调地址
每个商家一条独立地址,末尾的编码就是商家编码。
GET https://your-domain.com/api/v1/wecom/callback/YUNQI?msg_signature=...×tamp=...&nonce=...&echostr=... POST https://your-domain.com/api/v1/wecom/callback/YUNQI?msg_signature=...×tamp=...&nonce=...
GET 用于企业微信保存回调时的校验,我们把解密后的 echostr 原样返回;POST 是真实的客户消息。
消息流程
- 客户在企业微信里给应用发「你们的茶怎么卖?」。
- 企业微信把消息加密后 POST 到回调地址(带签名、时间戳、随机串)。
- 我们校验签名 → 解密 → 取
FromUserName / Content。 - 按商家知识库检索,必要时调用订单 webhook,再交给大模型生成口语化回复。
- 按 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。需要主动触达时再单独开通。