---
title: 接入企微机器人教程
description: FastGPT 接入企微机器人教程
---

从 4.12.4 版本起，FastGPT 商业版支持直接接入企微机器人，无需额外的 API。 

## 1.配置可信域名和可信IP

点击企微头像,打开管理企业

![图片](/imgs/wecom-bot-1.png)

在应用管理中找到"自建"-"创建应用"

![图片](/imgs/wecom-bot-2.png)

创建好应用后, 下拉, 依次配置"网页授权及JS-SDK"和"企业可信IP"

![图片](/imgs/wecom-bot-3.png)

其中, 网页授权及JS-SDK要求按照企微指引,完成域名归属认证

![图片](/imgs/wecom-bot-4.png)

企业可信IP要求为企业服务器IP, 后续企微的回调URL将请求到此IP

![图片](/imgs/wecom-bot-5.png)

## 2. 创建企业自建应用

前往 FastGPT ,选择想要接入的应用，在 发布渠道 页面，新建一个接入企微智能机器人的发布渠道，填写好基础信息。

![图片](/imgs/wecom-bot-6.png)

现在回到企业微信平台,找到 Corp ID, Agent ID, Token, AES Key 信息并填写回 FastGPT 平台

![图片](/imgs/wecom-bot-7.png)

在"我的企业"里找到企业 ID, 填写到 FastGPT 的 Corp ID 中

![图片](/imgs/wecom-bot-8.png)

在应用中找到 Agent Id 和 Secret, 并填写回 FastGPT

![图片](/imgs/wecom-bot-9.png)

点击"消息接收"-"设置API接收"

![图片](/imgs/wecom-bot-10.png)

随机生成或者手动输入 Token 和 Encoding-Key, 分别填写到 FastGPT 的 Token 和 AES Key 中

![图片](/imgs/wecom-bot-11.png)

填写完成后确认创建

然后点击请求地址, 复制页面中的链接

![图片](/imgs/wecom-bot-12.png)

回到刚才的配置详情, 将刚才复制的链接填入 URL 框中, 并点击创建

注意: 若复制的链接是以 "http://localhost" 开头, 需要将本地地址改为企业主体域名

因为企微会给填写的 URL 发送验证密文, 若 URL 为本地地址, 则本地接收不到企微的密文

若 URL 不是企业主体域名, 则验证会失败

## 3. 创建智能机器人

在"安全与管理" - "管理工具"页面找到"智能机器人" ( 注意: 只有企业创建者或超级管理员才有权限看到这个入口 )

![图片](/imgs/wecom-bot-13.png)

创建机器人页面,下拉,找到,点击"API模式创建"

![图片](/imgs/wecom-bot-14.png)

与刚才配置自建应用同理, 配置这三个参数

![图片](/imgs/wecom-bot-15.png)

注意: 这里的 Agent ID , 和上面的不同, 可以先随意填写一个值, 后续会根据企业微信提供的数据重新更改

Secret 为用户自己决定的密令

填写完成后确认创建

然后点击请求地址, 复制页面中的链接, 链接的地址也必须为企业主体域名

创建完成后, 找到智能机器人的配置详情

![图片](/imgs/wecom-bot-16.png)

复制 Bot ID, 填写到 FastGPT 的 Agent ID 中

![图片](/imgs/wecom-bot-17.png)

## 4. 使用智能机器人

在企业微信平台的"通讯录",即可找到创建的机器人,就可以发送消息了

![图片](/imgs/wecom-bot-18.png)

## FAQ

### 发送了消息，没响应

1. 检查企微机器人回调地址、权限等是否正确。
2. 查看 FastGPT 对话日志，是否有对应的提问记录
3. 如果没记录，则可能是应用运行报错了，可以先试试最简单的机器人。（飞书机器人无法输入全局变量、文件、图片内容）
