# FastGPT接入 Server酱：工作流关键节点推送微信通知（2026 教程）

> 在 FastGPT 工作流的 HTTP 请求节点配置 Server酱 API，实现生成结束、审核完成、异常分支等关键节点自动推送微信通知。

- 网页版：https://sct.ftqq.com/docs/integrations/fastgpt/
- 更新日期：2026-07-17

# FastGPT + Server酱：工作流关键节点推送微信通知

> 效果：FastGPT 工作流执行到指定节点时，通过 HTTP 请求节点调用 Server酱 API，将 AI 生成结果或状态变更推送到微信。

## 前置条件

- Server酱 SendKey：登录 sct.ftqq.com，在「SendKey」页面复制（[30 秒获取教程](https://sct.ftqq.com/docs/getting-started/sendkey/)）。如需推送到企业微信/钉钉/飞书群，参见[通道配置](https://sct.ftqq.com/docs/getting-started/channels/)。
- FastGPT 实例（自托管或云服务），工作流编辑器可用。

## 配置步骤

### 1. 配置 HTTP 请求节点

在工作流画布中添加一个「HTTP 请求」节点，直接填入以下配置：

- **方法**：POST
- **URL**：`https://sctapi.ftqq.com/你的SENDKEY.send`
- **Body 类型**：JSON
- **Body**：

```json
{
  "title": "FastGPT 工作流通知",
  "desp": "{{AI节点输出变量}}"
}
```

将 `你的SENDKEY` 替换为实际 SendKey。`{{AI节点输出变量}}` 替换为上游节点的输出变量名——双花括号内可引用全局变量、系统变量及上游节点输出。

### 2. 将 SendKey 设为全局变量（推荐）

为避免明文写在 URL 中，可将 SendKey 配置为应用全局变量（如命名为 `SERVERCHAN_KEY`），URL 改为：

```
https://sctapi.ftqq.com/{{SERVERCHAN_KEY}}.send
```

FastGPT 无独立密钥保管功能，全局变量是应用层管理 SendKey 的可用方式。

### 3. 注入动态内容

title 和 desp 均支持双花括号变量引用。常见做法：

- title 填固定文案标识事件类型，如 `FastGPT审核完成`
- desp 引用 AI 节点生成结果，将完整内容推送到微信。

例如上游 AI 节点输出变量为 `answer`，desp 写 `{{answer}}`，推送内容即为该节点的生成文本。

### 4. 连接工作流分支

将该 HTTP 请求节点连接到工作流中需要通知的位置——AI 回复节点之后、审核流程出口、异常分支等。工作流执行到该节点时即触发推送。

## 完整示例

审核完成通知的 HTTP 请求节点配置：

- **方法**：POST
- **URL**：`https://sctapi.ftqq.com/{{SERVERCHAN_KEY}}.send`
- **Body 类型**：JSON
- **Body**：

```json
{
  "title": "【审核完成】FastGPT",
  "desp": "审核结果：{{review_result}}\n\n来源文档：{{doc_name}}"
}
```

异常分支通知将 title 改为 `【异常】FastGPT`，desp 引用错误信息变量即可。

补充：FastGPT v4.9.6 起支持「MCP 工具集」应用类型，可传入 SSE URL 批量创建工具。如需将 Server酱封装为工具供 AI 调用可在此基础上探索，主线推送仍走上述 HTTP 请求节点。

## 常见问题

**免费额度够用吗？**

Server酱免费版每天 5 条、每分钟 50 条。工作流通知频率不高时通常足够；订阅会员目前特价最低 3 元/月，一天最多可发 1000 条（[价格详情](https://sct.ftqq.com/subscribe)）。

**消息没收到怎么排查？**

先检查 SendKey 是否正确（SCT 开头或 sctp 开头），再确认 FastGPT 工作流确实执行到了 HTTP 请求节点。详细排查步骤见[常见问题与排查](https://sct.ftqq.com/docs/getting-started/faq/)。

**频率限制是多少？**

免费版每分钟上限 50 条，每日 5 条。如果工作流短时间内大量触发通知，建议在节点间增加条件判断，仅推送关键事件。

**Body 选 JSON 还是 form？**

两者均可。JSON 是文档演示的默认方式，form-data 和 x-www-form-urlencoded 也受支持，字段名都是 title 和 desp。

**节点 UI 找不到对应选项？**

FastGPT 节点界面随版本迭代可能有变化，具体字段名称以应用内实际显示为准。核心配置项为方法、URL、Body 类型及 Body 内容。

## 相关集成

- [Python 脚本推送](https://sct.ftqq.com/docs/integrations/python/)
- [青龙面板任务通知](https://sct.ftqq.com/docs/integrations/qinglong/)
- [Uptime Kuma 宕机告警](https://sct.ftqq.com/docs/integrations/uptime-kuma/)


## 懒人方案：把这段话复制给你的 AI 助手

把下面这段文字原样粘贴给 Claude Code、Cursor 或任何 AI 编程助手，它就会替你完成 Server酱 的接入：

```text
请帮我把 Server酱 微信通知接入到我当前的项目/工具中：
1. API：POST https://sctapi.ftqq.com/{SendKey}.send，参数 title（必填，不能含换行）、desp（正文，支持 Markdown，可选）；成功时返回 JSON 的 code 为 0。
2. 如果我的 SendKey 以 sctp 开头，则改用 https://{uid}.push.ft07.com/send/{SendKey}.send，uid 是 SendKey 中 sctp 与 t 之间的数字。
3. SendKey 从环境变量 SERVERCHAN_SENDKEY 读取；如果没有，提醒我到 https://sct.ftqq.com 免费获取（每天 5 条额度）。
4. 安全要求：不要把 SendKey 硬编码进代码、不要打印到日志、不要提交到 git。
5. 频率约定：任务结束发 1 条结果摘要即可，批量任务合并成一条，不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。
```