企业官网建设流程全解析

3步把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

把 FastGPT 接入企业微信智能机器人，你的团队就拥有一个 7×24 小时在线的 AI 客服：员工在企微里直接提问，机器人基于你的知识库给出准确回答，常见咨询不再依赖人工值守。

上图是企业微信管理后台的「管理工具」页面，红框标出的「智能机器人」就是本次配置的起点。

适用场景与前置条件

适合需要把内部问答、产品咨询、HR/行政常见问题搬到企业微信里的团队。开始前核对以下条件：

• FastGPT 版本：商业版需要 4.12.4 及以上；云服务版需要 4.14.4 及以上
• 域名要求：企业微信要求消息推送地址必须使用企业主体域名。商业版直接用企业域名；云服务版必须先配置自定义域名，参见 配置自定义域名
• 企微权限：你需要企业创建者或超级管理员身份，普通成员看不到智能机器人入口
• FastGPT 准备：已有可用的 Agent，并且关联了知识问答所需的知识库

核心操作步骤

第一端：在企业微信创建 API 模式机器人并记下密钥

1. 登录企业微信管理后台，进入「安全与管理 → 管理工具」
2. 打开「智能机器人」卡片
3. 在创建页面下拉，点击「API模式创建」
4. 填写机器人名称、简介和可见范围
5. 在Token和Encoding-AESKey两栏点击「随机获取」，并把生成的值记录下来
6. URL 栏暂时留空，完成机器人创建

上图是企业微信 API 模式创建页面，红框内的URL、Token、Encoding-AESKey三项中，后两项现在就要随机生成并抄下来。

第二端：在FastGPT创建企业微信机器人发布渠道

1. 打开要发布的 Agent，进入「发布渠道」页面
2. 点击「创建」，选择「企业微信机器人」
3. 填写渠道名称、QPM（每分钟消息数上限）等基本信息
4. 把刚才在企微端记录的值填入Token和AES Key两项，点击「确认」

注意两边的值必须逐字一致：企微端的 Encoding-AESKey 对应 FastGPT 端的AES Key。

最后一步：把回调地址填回企微完成验证

1. 在「填写回调地址」步骤中，选择你的域名（云服务版选已配置的自定义域名，商业版选企业域名）
2. 复制系统生成的回调地址
3. 回到企微机器人配置页的「API接收消息」，把地址粘贴进URL输入框，点击「确认」
4. 企业微信会向该地址发起验证请求，FastGPT 正确应答后，双向通道即建立完成

上图展示了回调地址的选择与回填位置：FastGPT 生成的链接要复制到企微端红框标注的URL字段中。

完整流程细节可对照 官方文档。

验收与自检 ✅

按下面 4 个动作逐项确认：

1. 企微端粘贴回调地址并点击「确认」→ URL 字段无报错、机器人创建成功，即验证通过
2. 打开企业微信客户端，在「通讯录 → 企业创建的」分组中找到机器人 → 点开即可发起对话
3. 向机器人发送一个知识库内的问题 → 收到基于知识库内容的回答，且响应在数秒内
4. 在 FastGPT 的对话日志中查看 → 能找到刚才这条提问记录，说明消息链路已打通

常见问题排查 ⚠️

Q1：消息发出去后机器人没反应？

• 检查可信域名（URL 使用的域名）是否与企业主体一致且配置正确
• 核对 FastGPT 端与企微端的Token、AES Key是否逐字一致
• 查看 FastGPT 对话日志：有提问记录说明是回复链路问题；完全无记录则可能是渠道运行报错，可先用一个最简单的 Agent 测试

Q2：粘贴回调地址后提示"请输入正确的网址"或验证不通过？

• 确认地址以 http/https 开头，且域名已完成备案、外部可访问
• 云服务版用户确认自定义域名已生效，DNS 解析指向 FastGPT 服务

Q3：管理后台找不到「智能机器人」入口？

• 该入口仅对企业创建者或超级管理员可见，换有权限的账号登录即可

Q4：测试消息能收到回复，但群里或指定员工收不到？

• 检查创建机器人时设置的「可见范围」是否包含目标成员
• 确认渠道未超过QPM限制或已到期

进阶建议

• 知识库持续维护：机器人的回答质量取决于知识库。建议每月更新一次产品与流程文档，并把高频问题的标准答案补充进去
• 复盘对话数据：定期在 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