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

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

前置条件

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

配置步骤

1. 配置 HTTP 请求节点

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

  • 方法:POST
  • URLhttps://sctapi.ftqq.com/你的SENDKEY.send
  • Body 类型:JSON
  • Body
{
  "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
  • URLhttps://sctapi.ftqq.com/{{SERVERCHAN_KEY}}.send
  • Body 类型:JSON
  • Body
{
  "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 条(价格详情)。

消息没收到怎么排查?

先检查 SendKey 是否正确(SCT 开头或 sctp 开头),再确认 FastGPT 工作流确实执行到了 HTTP 请求节点。详细排查步骤见常见问题与排查

频率限制是多少?

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

Body 选 JSON 还是 form?

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

节点 UI 找不到对应选项?

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

相关集成

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

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

请帮我把 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 条结果摘要即可,批量任务合并成一条,不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。