n8n 推送通知:从任意工作流发送告警到手机

n8n 很擅长在你离开时自动执行任务,却不擅长告诉你发生了什么。表单提交进来了,订阅源有了新帖子,凌晨 3 点同步失败了,而唯一的记录只是执行列表里的一行,等你下周才会打开看到。
本指南将 n8n 与你的手机连接起来。你将从 HTTP Request 节点调用 Pocket Alert API,把这个调用封装进一个可复用的子工作流,添加一个错误工作流,在任何工作流失败时提醒你,最后再添加「批准」和「拒绝」按钮,让你可以直接在锁屏上恢复一个等待中的工作流。
以下所有内容都在 n8n 2.45.7(n8nio/n8n Docker 镜像)上测试过。HTTP Request 节点指向本地的请求捕获工具,以便对照 API 参考文档检查每一个请求。
你需要准备
- 一个 n8n 实例:自托管或 n8n Cloud。
- 一个 Pocket Alert 账户,并在你的 iPhone 或 Android 手机上安装应用。免费注册。
- 来自 API 密钥 页面的 API 密钥。
第 1 步:创建 Header Auth 凭据
Pocket Alert 从名为 Token 的请求头中读取 API 密钥。在 n8n 中,创建一个类型为 Header Auth 的凭据:
- Name:
Token - Value: 你的 API 密钥
将凭据命名为 Pocket Alert。把密钥保存为凭据,可以让它不出现在工作流 JSON 中,这样你导出和分享工作流时就不会泄露密钥。
第 2 步:HTTP Request 节点
添加一个 HTTP Request 节点,并按如下方式设置:
| 字段 | 值 |
|---|---|
| Method | POST |
| URL | https://api.pocketalert.app/v1/messages |
| Authentication | Generic Credential Type,然后 Header Auth,然后选择 Pocket Alert 凭据 |
| Send Body | 开启 |
| Body Content Type | JSON |
| Specify Body | Using JSON |
请求体需要 title 和 message,level 和 actions 是可选的。最直观的写法是普通 JSON,并在字符串中使用表达式:
{
"title": "New signup",
"message": "{{ $json.name }} on {{ $json.plan }}",
"level": "high"
}
只要值中不包含双引号或换行符,这种写法就能正常工作。如果 name 的值是 Ana "AJ" Silva,n8n 会停止该节点,并报错 "The value in the JSON Body field is not valid JSON",因为引号提前结束了字符串。表单消息和 RSS 标题比你预想的更容易遇到这个问题。
解决办法是让 JavaScript 来构建 JSON。把整个请求体放进一个表达式中:
{{ JSON.stringify({
title: 'New signup',
message: $json.name + ' on ' + $json.plan,
level: 'high'
}) }}
或者,如果你更想保留 JSON 的排版,可以用 JSON.stringify() 包裹每个动态值,并去掉它外面的引号:"message": {{ JSON.stringify($json.name + ' on ' + $json.plan) }}。在测试中,两种写法都生成了有效的 JSON,引号也都被正确转义。以下是 n8n 实际发送的内容:
POST /v1/messages
Content-Type: application/json
Token: <your API key>
User-Agent: n8n
{"title":"New signup","message":"Ana \"AJ\" Silva on Pro","level":"high"}
level 可选值为 silent、low、default、high 或 critical。high 可以在 iPhone 的专注模式下突破限制。critical 即使在静音开关打开或勿扰模式下也会播放提示音。这是付费功能,在免费套餐中会按 high 处理。更多信息请参阅优先级。
第 3 步:统一的「Send push」子工作流
如果把这个节点复制到每个工作流中,那么你每次更换密钥、调整级别逻辑或按钮时,都要修改十个工作流。更好的做法是只放在一个子工作流中,然后从其他地方调用它。
复制下面的 JSON,并粘贴到一个空白的 n8n 画布上(或保存为文件,然后使用 Import from File):
{
"name": "Send push",
"nodes": [
{
"parameters": {
"workflowInputs": {
"values": [
{ "name": "title" },
{ "name": "message" },
{ "name": "level" },
{ "name": "url" }
]
}
},
"name": "When called",
"type": "n8n-nodes-base.executeWorkflowTrigger",
"typeVersion": 1.1,
"position": [0, 0]
},
{
"parameters": {
"method": "POST",
"url": "https://api.pocketalert.app/v1/messages",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={{ JSON.stringify({\n title: $json.title,\n message: $json.message,\n level: $json.level || 'default',\n actions: $json.url ? [{ type: 'view', label: 'Open', value: $json.url }] : []\n}) }}",
"options": {}
},
"name": "Pocket Alert",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [220, 0]
}
],
"connections": {
"When called": { "main": [[{ "node": "Pocket Alert", "type": "main", "index": 0 }]] }
},
"settings": { "executionOrder": "v1" }
}
导入后,打开 Pocket Alert 节点,并选择你的凭据。该子工作流接收四个输入:title、message、可选的 level(默认回退为 default),以及可选的 url。设置了 url 后,推送会附带一个用于打开该链接的 Open 按钮。空的 actions 数组也是合法的,仅表示没有按钮。
记得发布。 在 n8n 2.x 中,生产环境运行会调用子工作流的已发布版本。在你发布 Send push 之前,每次定时或由 Webhook 触发的调用都会失败,并报错 "Workflow is not active and cannot be executed"。而在编辑器中手动测试却能成功,因为手动运行使用的是草稿版本。编辑之后同样如此:只有再次发布,Send push 的修改才会在生产环境中生效。
要从另一个工作流调用它,添加一个 Execute Sub-workflow 节点,在列表中选择 Send push,然后用表达式填写四个字段,例如标题可以填 New order #{{ $json.id }}。
任何工作流失败时收到推送
当生产环境的执行失败时,n8n 会运行一个单独的错误工作流。创建一个名为 Error alert 的工作流,包含一个 Error Trigger 节点,后面接一个 Execute Sub-workflow 节点,用来调用 Send push,字段设置如下:
| 输入 | 表达式 |
|---|---|
| title | Failed: {{ $json.workflow.name }} |
| message | {{ ($json.execution?.lastNodeExecuted ?? 'Trigger') + ': ' + ($json.execution ?? $json.trigger).error.message }} |
| level | high |
| url | {{ $json.execution?.url ?? '' }} |
也要发布 Error alert。在 2.x 中,未发布的错误工作流会被跳过,并在日志中显示同样的 "not active" 消息。然后打开你关心的每个工作流,进入 Workflow settings,将 Error workflow 设置为 Error alert。
为了验证这些路径,我们故意让一个名为 "Sync orders" 的工作流失败:它的 HTTP Request 节点收到了 503。Error Trigger 收到的内容如下(已截断):
{
"execution": {
"id": "5",
"url": "http://localhost:5678/workflow/WPErAWNJyV6MWO11/executions/5",
"error": {
"message": "Service unavailable - try again later or consider setting this node to retry automatically (in the node settings)",
"description": "down",
"httpCode": "503"
},
"lastNodeExecuted": "Fetch orders",
"mode": "webhook"
},
"workflow": { "id": "WPErAWNJyV6MWO11", "name": "Sync orders" }
}
手机收到了 "Failed: Sync orders",内容为 "Fetch orders: Service unavailable...",并带有一个指向该次执行的 Open 按钮。有两个细节很重要:
- 执行链接使用你的公网 URL。 n8n 会根据
execution.url生成N8N_EDITOR_BASE_URL,如果未设置,则回退为 Webhook URL。在测试中它是localhost,在手机上毫无用处。对于自托管实例,请把N8N_EDITOR_BASE_URL设置为你打开 n8n 时使用的地址。 - 触发器失败时情况不同。 如果触发器本身失败,例如 RSS 订阅源返回了 HTML,那么就不会有执行记录。负载中是
trigger.error而不是execution,也没有 URL。上面表达式中的?.和??就是为处理这种情况而设计的。在测试中,它收到的推送是 "Failed: Changelog to phone",内容为 "Trigger: Non-whitespace before first tag...",并且没有按钮。
人们实际会搭建的三种工作流
以下每个示例最终都通过 Execute Sub-workflow 节点调用 Send push。三者都在捕获工具上运行过,并生成了有效的请求。
新的表单提交
一个 n8n Form Trigger,包含三个字段,标签分别为 Name、Email 和 Message。表单的输出以标签作为键,因此输入如下:
- title:
Contact form: {{ $json.Name }} - message:
{{ $json.Email }}和{{ $json.Message }}放在下一行 - level:
default
这里将 url 留空。view 按钮需要 http(s) 类型的 URL,如果使用 mailto: 链接,请求会被以 400 拒绝。使用你自己网站表单背后的 Webhook 节点也可以实现同样的效果,此时字段位于 $json.body 下。更多思路请参阅表单提交告警。
RSS 订阅源中的新帖子
一个 RSS Feed Trigger,每 10 分钟轮询一次更新日志或博客:
- title:
New post: {{ $json.title }} - message:
{{ $json.contentSnippet }} - level:
low - url:
{{ $json.link }}
contentSnippet 是去除了 HTML 的描述文本,因此 <p>You can now work <b>offline</b>.</p> 会以纯文本的形式出现。该触发器只会输出比上次看到的更新的条目,所以开启它不会把历史归档一股脑推给你。Open 按钮会指向该帖子。
定时检查
每 5 分钟执行一次 Schedule Trigger,然后是一个 HTTP Request 节点,用 GET 请求访问你的网站,并在 Response 下开启两个选项:Include Response Headers and Status 和 Never Error。如果不开启 Never Error,遇到 503 时节点会停止,而无法进入下一步。接着是一个 If 节点,条件为 {{ $json.statusCode }} 不等于 200,在 true 分支上设置:
- title:
Site check failed: {{ $json.statusCode }} - level:
high - url:你要检查的页面
Never Error 只处理错误的状态码,并不处理网站完全无响应的情况。DNS 解析失败或超时仍然会使节点失败,此时由错误工作流发送推送。请注意,网站宕机期间,这类检查每次运行都会提醒你:如果间隔为 5 分钟,每小时就会收到 12 条推送。更多模式请参阅自动化告警。
在锁屏上批准或拒绝
有些工作流不应该在没有人工介入的情况下完成:例如超过限额的退款、即将发布的帖子,或者即将修改生产环境的 AI 智能体。Pocket Alert 的 http 操作按钮可以直接从手机发送请求,而 n8n 的 Wait 节点可以暂停,直到收到请求。将两者结合起来:
- 一个带有请求的触发器,这里使用一个接收
{"order":"A-1042","amount":129}的 Webhook 节点。 - 一个 HTTP Request 节点,发送带有两个按钮的推送。
- 一个 Wait 节点:Resume 设置为 On Webhook Call,HTTP Method 为
POST,开启 Limit Wait Time,时长为 2 小时。 - 一个 If 节点:
{{ $json.body.decision }}等于approve。
HTTP Request 节点的请求体:
{{ JSON.stringify({
title: 'Refund $' + $json.body.amount + '?',
message: 'Order ' + $json.body.order + ' is asking for a refund.',
level: 'high',
actions: ['approve', 'decline'].map(decision => ({
type: 'http',
label: decision === 'approve' ? 'Approve' : 'Decline',
value: JSON.stringify({
url: $execution.resumeUrl,
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ decision })
})
}))
}) }}
http 按钮的 value 本身是一个 JSON 字符串,这就是为什么 JSON.stringify 会嵌套在另一个 JSON.stringify 中。$execution.resumeUrl 是 Wait 节点为这一次执行所监听的地址。
在测试中,向「批准」按钮的 URL 发送带有对应请求体的 POST 请求,返回了 200,工作流恢复执行,$json.body.decision 为 approve,因此 If 节点走了 true 分支。「拒绝」则走了 false 分支。以下是经过几次尝试才搞清楚的细节:
- 决定要放在请求体中,而不是 URL 中。 在 n8n 2.45.7 上,恢复 URL 已经以
?signature=...结尾。追加?decision=approve会破坏签名,n8n 会返回401。使用 JSON 请求体可以避免字符串拼接的问题。 - 第二次点击会被拒绝。 执行一旦恢复,再次点击会返回
409,提示 "has finished already",应用会显示请求失败的通知,并附带一个重试按钮。起作用的是第一次点击。 - 没有回应就等于拒绝。 当 2 小时的时限到了,Wait 节点会在没有
decision的情况下继续执行,于是 If 节点会走 false 分支。请把这个分支设计为安全的分支。 - 手机必须能访问到 n8n。 请求是从手机发出的,而不是从 Pocket Alert 发出的。
$execution.resumeUrl是基于你的 Webhook URL 生成的(即WEBHOOK_URL,n8n 2.45 会提示你将其改名为N8N_WEBHOOK_URL)。在 n8n Cloud 或位于公网域名之后时,这一切都能直接运行。如果是部署在家庭服务器上,则需要手机与 n8n 处于同一网络,或者通过 Tailscale 等 VPN 连接。 - 按钮是付费功能。 在免费套餐中,推送仍然会送达,但不带按钮。系统通知按钮需要 Pocket Alert 应用 2.0.1 或更高版本。
用于 AI 智能体的同一模式见人在环路通知。
或者 POST 到 Pocket Alert Webhook
如果你不想在 n8n 中保存 API 密钥,可以在控制台的 Webhooks 页面创建一个 Webhook,然后让 HTTP Request 节点在无需认证的情况下,将 JSON POST 到它的 https://p4a.me/wh/... URL。Webhook 上的模板会把负载转换为消息。取舍在于:标题始终为 Webhook <name>,正文来自模板,而不是工作流本身。Webhook 历史记录会记录它收到的每一个请求,在调试时很有帮助。
限制与故障排查
- 每日配额。 免费套餐每天允许发送 50 条消息,于 UTC 时间 00:00 重置。对 200 个条目的循环会发送 200 条推送。达到上限后,API 会返回
429;不要让 n8n 重试,因为在重置之前结果不会改变。参阅每日上限。 401表示密钥错误,或者凭据中的请求头名称不是Token。400表示请求体缺少title或message(计算结果为空的表达式也算缺失)、级别无效,或者按钮不合法:超过 3 个、view的 URL 不是http(s),或者http的值不是包含url的 JSON 字符串。- n8n 中出现 "not valid JSON" 表示某个值破坏了 JSON 请求体。请按照第 2 步的做法改用
JSON.stringify。 - 失败时没有收到任何推送。 请检查 Error alert 和 Send push 是否都已发布,并且出错的工作流在其设置中已将 Error alert 设为错误工作流。在编辑器中进行的手动测试运行不会触发错误工作流。
常见问题
n8n 有 Pocket Alert 节点吗?
目前还没有。HTTP Request 节点可以覆盖整个 API,而 Send push 子工作流则为你提供了一个只需设置一次、类似节点的模块。如果你使用 Make,还有官方的 Make 应用。
这个方案能在 n8n Cloud 上使用吗?
可以。这里的所有内容都使用内置节点。在 Cloud 上,执行和恢复 URL 已经是公开的,省去了自托管实例需要的 URL 配置。
我可以只发送给某一部手机吗?
在请求体中添加 device_id,并填入该设备的 ID 即可。不加这个字段,推送会发送到你的所有设备。application_id 可以将消息归入某个应用,这样 n8n 的告警就会在 App 中拥有自己的频道。
免费注册账户,导入 Send push 工作流,并把你的错误工作流指向它。下一次失败的运行就会出现在你的手机上,而不必再去翻执行列表。