FastGPT 接入企业微信：4 步把内部智能问答搬进企业微信聊天窗口
【免费下载链接】FastGPTFastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, and visual AI workflow orchestration, letting you easily develop and deploy complex question-answering systems without the need for extensive setup or configuration.项目地址: https://gitcode.com/GitHub_Trending/fa/FastGPT
FastGPT 智能问答系统可以直接发布到企业微信（WeCom）智能机器人，员工在企业微信里像聊天一样提问，后台由 FastGPT 应用检索知识库并生成回答。本文按实际操作动线拆解整条链路：先在企业微信管理后台创建智能机器人并拿到两把密钥，再到 FastGPT 的发布渠道里配置「企业微信机器人」，最后把回调地址填回去完成验证。文末附了「机器人不回消息」的逐项排查清单。
用什么版本，动手前把门槛搞清楚
在开始之前，先确认你的部署方式满足对应条件，否则会卡在最前面一步：
| 部署方式 | 版本要求 | 额外前提 |
|---|---|---|
| 商业版（自部署） | v4.12.4 及以上 | 使用企业自己的公网域名，无需额外 API |
| 云服务版 | v4.14.4 及以上 | 必须先配置自定义域名，企微要求消息推送地址必须是企业主体域名 |
⚠️ 两条硬规则提前记住：
- 回调地址的域名必须与企业主体备案域名一致（或有关联关系），这是企微的数据安全要求，不是 FastGPT 的限制；
- 只有企业创建者或超级管理员能看到「智能机器人」入口，账号权限不够时会直接找不到这个功能。
云服务版用户请先到「账号 → 自定义域名」页面把域名配好（需已备案域名 + CNAME 解析，状态显示"已生效"后再继续），具体流程见 document/content/guide/workspace/customDomain.mdx。
第一步：企微后台创建智能机器人，拿到 Token 和 AESKey
这一步全程在企业微信管理后台完成，动作动线是：管理工具 → 智能机器人 → API 模式创建 → 记下密钥。
1. 找到入口
用超级管理员登录管理后台，左侧导航进入「安全与管理 → 管理工具」，在"智能专区"里点击「智能机器人」卡片。
2. 选择「API 模式创建」
在创建机器人页面往下滚动，页面底部会看到两种模式说明。这里不要选上面"通过模型分析并输出回复"的普通模式，要点右下角的「API模式创建」——这才是把消息转给 FastGPT 的模式。
3. 填基础信息并生成两把密钥
进入 API 模式创建页后，填写机器人名称、简介、可见范围（决定哪些员工能在通讯录里看到它）。重点是下面三个字段：
- URL：接收消息的地址，现在可以留空，第二步在 FastGPT 里生成后再回填；
- Token：点「随机获取」自动生成；
- Encoding-AESKey：点「随机获取」自动生成。
💡 这两个值生成后先抄下来存好，后面 FastGPT 配置时还要原样填入，填错任何一位都会导致消息无法解密。
第二步：在 FastGPT 里配置企业微信机器人发布渠道
回到 FastGPT 后台，这一步的动线是：选应用 → 发布渠道 → 企业微信机器人 → 填密钥 → 拿回调地址。
1. 选一个要发布的应用，进入发布渠道页
打开你要接入的智能问答应用，切到「发布渠道」标签页，渠道列表里有「企业微信机器人」卡片，点击它右侧的「+ 新增」。
2. 填入企微侧记录的两把密钥
弹出「创建企微机器人」窗口，第一步是配置参数：
- 名称：这个渠道在 FastGPT 里的显示名，随便起；
- QPM：每分钟提问上限，默认 100，按团队规模调整；
- Token / AES Key：把第一步抄下来的 Token 和 Encoding-AESKey 原样填入。
3. 复制回调地址，填回企微完成验证
点击「确认」进入第二步"填写回调地址"。这里先在下拉框选择你配置好的自定义域名，下方会生成一条完整的回调链接（形如https://你的域名/api/support/outLink/wecom/...）。
把这条链接复制，粘贴到企业微信创建机器人页面「接收消息服务器配置」的URL输入框里（就是第一步留空的那个 URL 字段），Token 与 Encoding-AESKey 保持不变，选好需要接收的消息事件类型，点「确认」。企微会向该地址发起验证请求，通过后机器人即创建成功。
联调通过：员工从哪里找到机器人
验证完成后不需要再发公告教程——员工打开企业微信，点左侧「通讯录」，在"企业创建的"分组下就能看到机器人名称，点开即发消息提问，回答由你在 FastGPT 里选的那个应用生成。
建议先自测三类问题再放开可见范围：
- 知识库内明确存在的问题（验证检索命中）；
- 知识库完全没覆盖的问题（观察应用是拒答还是自由发挥，必要时在应用里加拒答/引导话术）；
- 长文本回答（确认消息在企业微信里正常截断、换行）。
如果回答质量不够理想，优先补知识库而不是调机器人配置——给关联的知识集合补充文档、调整检索参数即可，相关能力介绍可参考 document/content/guide/build/publish/wecom.mdx 同一目录下的其他发布渠道文档，以及官方 FAQ 里的检索优化建议。
机器人不回消息：按顺序排查这 4 处
这是接入后最常见的现象：消息发出去了，机器人没反应。按下面顺序查，基本能定位到原因：
| 排查项 | 现象特征 | 解法 |
|---|---|---|
| 可信/自定义域名 | 企微 URL 验证这一步就通不过 | 确认回调地址用的是企业主体备案域名；云服务版确认自定义域名已"生效" |
| Token / AESKey | URL 验证能过，消息无回复 | 两边逐一比对两个密钥是否原样一致，随机值不要手敲 |
| FastGPT 对话日志 | 发了消息但日志里没有提问记录 | 说明消息根本没到达 FastGPT，回到前两项检查链路 |
| 应用运行报错 | 日志里有提问记录但无回答 | 先用一个最简应用（单模型、无插件）验证链路，再逐个排查应用内节点 |
如果只是想先跑通链路，把最简应用配到企微上测试，是最快的定位方式。
收尾：还能顺带接哪些渠道
企微机器人跑通后，同一套「发布渠道」机制还可以把同一个应用挂到钉钉、飞书、微信公众号等入口，配置逻辑与本文基本一致，入口文档在 document/content/guide/build/publish/dingtalk.mdx 和 document/content/guide/build/publish/feishu.mdx。企业内部多 IM 混用的场景，一个应用发布多端，知识库只需维护一份。
【免费下载链接】FastGPTFastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, and visual AI workflow orchestration, letting you easily develop and deploy complex question-answering systems without the need for extensive setup or configuration.项目地址: https://gitcode.com/GitHub_Trending/fa/FastGPT
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
