企业采购或自研AI智能体之后,最常见的需求就是让员工能在企业微信里直接调用,同时让客户从小程序里获得服务。两个渠道的底层逻辑不同,挂载方法也有差别。本文给出可直接套用的配置步骤。
企业微信挂载:自建应用+事件回调
1. 登录企业微信管理后台,进入"应用管理 > 自建应用",创建应用,记录AgentId和Secret。
2. 进入"功能 > 接收消息",设置URL为智能体网关地址(例如 https://bot.example.com/callback/wecom),Token和EncodingAESKey自行生成。
3. 在"企业可信IP"中,填上智能体服务的公网出口IP,否则API调用会被拒绝。
4. 智能体网关需要验证回调签名,解密消息内容;收到文本后调用内部大模型或知识库,并在5秒内返回响应。如果业务耗时较长,则先返回一个占位消息,再通过主动发送接口补发结果。
5. 实际案例:某设备厂商把维修SOP整理成知识库,挂载到企业微信后,一线工程师发送"E12故障代码",智能体直接返回处理步骤和所需工具,平均响应时间压到2秒。
小程序挂载:云开发或自建API
小程序无法直接使用企业微信回调协议,需要走独立的消息通道。
- 方式一:微信云开发。在小程序后台开通云开发,创建一个云函数,把用户输入转发到智能体HTTP API。云函数天然支持HTTPS,无需再备案服务器。
- 方式二:自建后端。在小程序后台的"request合法域名"中添加智能体域名(必须HTTPS且已ICP备案),所有请求由后端统一代理,支持流式返回(SSE),打字机效果更重要。
- 用户身份关联:用微信OpenID作为会话标识,如果用户同时是企业微信内部成员,可在企业微信通讯录中配置对应微信,实现双端身份映射。
- 实际案例:某连锁餐饮品牌在小程序点餐页面挂载智能体,顾客发送"附近门店"或"优惠券入口",智能体自动回复营业时间、门店导航和当前促销,替代了传统的菜单式客服。
统一后台:数据与权限管理
多渠道挂载完成后,需要集中管理。建议:
- 在智能体引擎层为每个渠道分配渠道编码,并统一写入会话ID。
- 后台展示各渠道的调用量、平均响应时长、多轮会话数、转人工率。
- 对话日志需要做字段脱敏,尤其是手机号、地址等个人信息。
- 企业微信端可设置仅允许指定部门使用,小程序端可按用户标签开放不同技能模块。
踩坑与建议
- 企业微信回调地址必须是公网可访问的HTTPS,且不能被防火墙拦截;如果使用内网穿透调试,生产环境必须更换。
- 小程序web-view不能随意打开外部域名,若要把智能体H5嵌入小程序,需在小程序后台配置"业务域名"并校验文件。
- 高并发时最好在网关层加消息队列,避免智能体接口被瞬间打满。对响应时长超过3秒的场景,优先改用流式输出。
- 不同渠道的知识库权限要分开,避免客户从小程序问到了内部制度。
总之,企业微信和小程序只是通道,关键是用统一的智能体中台承接。照着上述步骤配置,当天就能跑通一个多小时的试点场景。
关于企智社
企智社(湖北栖元汇数字科技有限公司)提供 GEO代运营、企业软件定制开发、支付分账SaaS、AI 智能体 四大服务,帮助企业在中国主流搜索引擎与 AI 大模型(文心一言 / 豆包 / 元宝 / 通义千问)中获得品牌曝光与精准获客。
🎁 免费领取您的品牌 AI 曝光诊断报告
看看豆包 / 文心一言 / 元宝 / 千问,是否在主动推荐您的品牌。留下品牌名,企智社免费为您出一版 AI 曝光体检,含「被引用次数」与「优化建议清单」。
