mirror of
https://github.com/labring/FastGPT.git
synced 2026-05-06 01:02:54 +08:00
Zeng Qingwen
122 lines
3.8 KiB
Plaintext
122 lines
3.8 KiB
Plaintext
---
|
|
title: 接入企微机器人教程
|
|
description: FastGPT 接入企微机器人教程
|
|
---
|
|
|
|
从 4.12.4 版本起，FastGPT 商业版支持直接接入企微机器人，无需额外的 API。
|
|
|
|
## 1. 配置可信域名和可信IP
|
|
|
|
点击企微头像,打开管理企业
|
|
|
|
|
|
|
|
在应用管理中找到"自建"-"创建应用"
|
|
|
|
|
|
|
|
创建好应用后, 下拉, 依次配置"网页授权及JS-SDK"和"企业可信IP"
|
|
|
|
|
|
|
|
其中, 网页授权及JS-SDK要求按照企微指引,完成域名归属认证
|
|
|
|
|
|
|
|
企业可信IP要求为企业服务器IP, 后续企微的回调URL将请求到此IP
|
|
|
|
|
|
|
|
## 2. 创建企业自建应用
|
|
|
|
前往 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 不是企业主体域名, 则验证会失败
|
|
|
|
## 3. 创建智能机器人
|
|
|
|
第二步创建企业自建应用是为了验证域名和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 中, 即可完成智能机器人配置
|
|
|
|
|
|
|
|
## 4. 使用智能机器人
|
|
|
|
在企业微信平台的"通讯录",即可找到创建的机器人,就可以发送消息了
|
|
|
|
|
|
|
|
## FAQ
|
|
|
|
### 发送了消息，没响应
|
|
|
|
1. 检查可信域名和可信IP是否配置正确。
|
|
2. 检查自建应用的 Secret 参数是否与智能机器人一致。
|
|
3. 查看 FastGPT 对话日志，是否有对应的提问记录
|
|
4. 如果没记录，则可能是应用运行报错了，可以先试试最简单的机器人.
|