
如果您希望在企业微信中启用AI助手功能,但尚未完成集成配置,则可能是由于应用凭证未正确录入或回调地址未通过验证。以下是完成企业微信AI助手接入的具体操作步骤:
一、创建并配置企业微信应用
该步骤用于在企业微信管理后台注册一个独立应用,获取通信所需的唯一身份凭证,并开启消息接收能力,为后续AI服务对接提供基础权限支持。
1、登录企业微信管理后台,使用管理员账号扫码进入。
2、在左侧导航栏点击“应用管理”,进入应用列表页后点击右下角“创建应用”按钮。
3、填写应用名称(如AI助理-技术支持部)、应用简介、上传Logo,设置可见范围为测试部门或指定成员组。
4、勾选“接收消息”权限中的“接收普通消息”与“接收事件推送”,保存应用。
5、在应用详情页记录以下三项关键参数:CorpID、Secret、AgentId,其中Secret需立即复制保存,刷新后不可再次查看。
二、配置可信域名与服务器回调
该步骤确保企业微信服务器能安全地将用户消息推送至您的AI服务端,需完成域名解析、Nginx静态文件响应及后台校验三重验证。
1、在企业微信应用详情页,点击“网页授权及JS-SDK”区域的“设置可信域名”。
2、申请一个子域名(如ai.yourcompany.com),并在DNS服务商处添加A记录,指向您部署AI服务的服务器公网IPv4地址。
3、下载企业微信生成的校验文件(格式为WW_verify_*.txt),通过SSH登录服务器,在Nginx配置中添加对应location块,精确返回该文件内容。
4、执行sudo systemctl restart nginx重启服务,随后在浏览器中访问http://ai.yourcompany.com/WW_verify_*.txt,确认返回纯文本且无HTTP错误。
5、回到企业微信可信域名设置页,上传校验文件并点击“申请校验域名”,状态变为“已验证”即完成。
三、部署AI服务并对接企业微信插件
该步骤将运行AI逻辑的服务实例与企业微信通信协议桥接,使自然语言请求可被识别、转发、处理并响应,依赖标准化插件实现加解密与路由。
1、选择部署方式:从云厂商镜像市场拉取预装wechatpy与fastapi的企业微信AI助理镜像,或使用CLI工具安装通用连接器插件:bot-cli plugins install @enterprise-connectors/wecom-adapter。
2、在服务配置文件中填入第一步获取的CorpID、Secret、AgentId,以及第二步设定的可信域名完整URL(含https前缀)。
商淘连锁店管理系统是一款基于Thinkphp 5开发的门店管理系统,便利店管理系统功能强大,扩展性好,产品涵盖手机、微信、安卓、苹果等访问端的接入,可无缝对接商淘自助收银系统,极其适合连锁企业快速构建线上线下网上商店!
3、配置消息Token与AES密钥:Token设为16位随机字符串,AES密钥为43位Base64编码字符串,二者须与企业微信应用页面中填写值完全一致。
4、启动服务后,通过curl命令验证健康接口:curl -X GET https://ai.yourcompany.com/health,预期返回{"status":"healthy"}。
5、在企业微信中向该应用发送任意文字消息,检查服务端日志是否输出接收到的XML加密消息体,确认双向链路已通。
四、绑定大模型API并启用智能响应
该步骤赋予AI助手实际语义理解与生成能力,通过调用外部大模型服务完成意图识别、知识检索与文本合成,避免本地训练与推理资源消耗。
1、登录阿里云百炼控制台,在“应用管理”中创建智能体应用,模型选择Qwen-Plus,输入System Prompt定义角色(如“你叫小助,专注解答IT系统使用问题”)。
2、发布应用后,在页面右侧复制应用ID(AppID),前往“密钥管理”创建新API Key,保存两组凭证至本地。
3、在AI服务配置项中填入百炼AppID与API Key,启用RAG增强模块,挂载企业内部知识库文档(PDF/Word/Excel格式)。
4、配置消息路由规则:当接收到含“如何重置密码”关键词的消息时,自动触发知识库检索,匹配TOP3相关文档片段作为上下文输入模型。
5、在企业微信中发送测试问题,观察响应内容是否包含知识库引用序号(如【1】【2】)及准确操作指引。
五、启用ima小程序轻量接入方式
该方式适用于无需自建服务器的场景,通过企业微信原生小程序容器直接加载AI交互界面,跳过回调配置与域名验证环节,适合快速试点部署。
1、打开企业微信手机客户端,进入“工作台”页面,点击右上角“+”号添加应用。
2、选择“扫一扫”,对准ima小程序二维码(由AI平台生成并提供)进行扫描。
3、授权小程序获取企业身份信息,系统自动完成用户绑定与会话初始化。
4、在小程序内点击“开始对话”,输入“会议纪要生成”,确认AI即时返回结构化摘要及待办事项列表。
5、管理员可在企业微信管理后台“应用管理→ima小程序”中查看使用统计与高频提问热词。










