企业官网建设流程全解析

把企业微信机器人接到 FastGPT 知识库：一次完整的接入走查

【免费下载链接】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

某 SaaS 团队把客服 FAQ 全部灌进 FastGPT 之后，决定把机器人挂到企业微信上给内部同事用。上线当天，有人在通讯录里 @ 机器人问了一句"发票抬头怎么改"，十秒内拿到了带文档出处的答案；但另一台机器上发的消息石沉大海，排查半天才发现是回调地址填了默认的云服务域名，而企微只认企业自己的域名。这篇文章按消息实际流动的顺序，把整条接入链路拆开讲一遍，最后附上两个最常见的"没响应"排查方向。

消息从企微到 FastGPT 的完整路径

先把机制说清楚，配置时不容易迷路。整个链路是双向的：

• 下行（员工提问）：员工在企业微信里给机器人发消息，企微服务器把消息加密后 POST 到你在机器人配置页填写的回调地址（即 FastGPT 生成的/api/support/outLink/wecom/...接口）。FastGPT 校验 Token 和解密密钥后，把问题转给绑定的应用，走 RAG 检索加模型推理，再把回答经同一通道加密推回企微。
• 上行（机器人回复）：走企微的主动消息接口，不需要额外配置。

两个身份凭证贯穿全程：Token（验证消息来源）和Encoding-AESKey（消息加解密）。这两个值只在企微创建机器人时生成一次，必须和 FastGPT 发布渠道里填的分毫不差。

动手前确认两件前提

版本要求：FastGPT 商业版从 4.12.4 起支持直接接入企微机器人，云服务版从 4.14.4 起支持。如果你是云服务版用户，还必须先完成自定义域名配置——企微强制要求消息推送地址使用企业主体域名，默认的fastgpt.cn域名填进去会被直接拒收，这也是开头那个团队踩的坑。

权限要求：企微"智能机器人"入口在「安全与管理 → 管理工具」下，且只有企业创建者或超级管理员能看到。如果你的账号里找不到这个入口，先找管理员开权限，别在别处浪费时间找。

在企微创建 API 模式机器人并记下两个密钥

进入「安全与管理 → 管理工具 → 智能机器人」，创建时向下滚动到底部，点击"API模式创建"（上方的"普通模式"走的是企微自带模型，接不进 FastGPT）。

API 模式表单里有三个必填项：URL（接收消息的地址，稍后回填）、Token、Encoding-AESKey。后两项直接点"随机获取"生成，然后把这两组值抄下来——它们只在这里出现，是后面 FastGPT 配置的输入。URL 此时留空即可，先点创建。

在 FastGPT 发布渠道填入 Token 与 AES Key

回到 FastGPT，打开要发布的那个应用（也就是承载知识库问答的 Agent），进入发布渠道页面，渠道列表里选择"企业微信机器人"，点击创建。

创建弹窗第一步是基本信息加企微 API 参数：名称、QPM（每分钟请求数上限，默认 100）、积分上限、过期时间，以及刚在企微记下的Token和AES Key。填完点"确认"。

这里容易踩坑：Token 和 AES Key 是纯拷贝关系，多一个空格、漏一位字符都会导致校验失败，而且报错往往不直观，表现为消息发出去没反应。建议粘贴后逐字段核对一遍。

把回调地址填回企微，完成 URL 验证

确认之后弹窗进入第二步：选择一个域名（云服务版选你配置的自定义域名），页面会生成形如https://你的域名/api/support/outLink/wecom/xxxx的回调地址，把它整段复制，粘贴到企微机器人配置页的 URL 输入框里，再点确认。企微会立刻向这个地址发一次验证请求，两边凭证一致就会通过，机器人随即出现在通讯录中。

上线后怎么验证、没响应查哪里

验证方式很简单：在企微左侧「通讯录」里找到刚创建的机器人，发一条知识库里确定有的问题，确认回答内容和出处符合预期，再试一条知识库外的问题，看它是否如实说不知道而不是硬编。

实测中"发了消息没反应"集中在四类原因，按概率从高到低查：

1. Token / AES Key 不一致——回到企微表单和 FastGPT 渠道配置逐字符对比。
2. 回调域名不对——云服务版必须是自定义域名，且域名已生效（DNS 解析、HTTPS 证书都正常）。
3. FastGPT 侧应用报错——去 FastGPT 的对话日志看有没有这条提问记录：有记录说明消息已进来、是应用执行失败；没记录说明消息根本没到 FastGPT，问题在前两步。
4. 先用最简提示词的应用试一遍，排除工作流本身的问题。

发布渠道上的几个配额参数值得留意

创建弹窗里除了凭证，还有三个参数决定这个渠道的"寿命"和"上限"：过期时间（到期后渠道直接失效，长期使用的客服渠道建议留足余量或设一个远期日期）、积分上限（-1表示不限制，按量计费的用户可以先设个较小值跑一周看消耗）、QPM（默认 100，内部几十个同事用完全够，做对外客服且并发高时才需要往上调，上限 1000）。这些参数在渠道创建后同样可以编辑，不用一开始纠结。

配置全部完成后，你手上应该已经在企微通讯录里有一个能直接提问的机器人了。现在就给它发一条你们知识库里出现频率最高的真实问题——如果回答带上了正确的文档出处，这条链路就算正式交付了。

【免费下载链接】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