接入企微机器人教程

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

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

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

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

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

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

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

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

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

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

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

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

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

填写完成后确认创建

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

回到刚才的配置详情, 将刚才复制的链接填入 URL 框中, 并点击下方的保存 ,即可完成自建应用的创建

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

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

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

第二步创建企业自建应用是为了验证域名和IP的合规性, 并获取 secret 参数, 下面创建智能机器人才是正式的配置流程

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

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

与刚才配置自建应用同理, 在 FastGPT 平台再新增一个发布渠道, 并回到企业微信配置参数

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

Corp ID 和 Secret 这两个参数和刚才的自建应用保持一致

Agent ID 和自建应用的不同, 需要先填写一个自定义值, 后续会根据企业微信提供的数据重新更改

在 FastGPT 将Corp ID, Secret, Agent ID, Token, AES Key 等参数都填写完毕后, 点击确认

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

回到企业微信, 将链接粘贴到智能机器人的 URL 配置栏, 点击创建

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

复制 Bot ID, 填写到 FastGPT 的 Agent ID 中, 即可完成智能机器人配置

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