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

> 从 n8n 向你的 iPhone 或 Android 手机发送推送通知。使用一个 HTTP Request 节点、一个共用的「Send push」子工作流、一个在任何工作流失败时提醒你的错误工作流，以及可以恢复等待中工作流的「批准」和「拒绝」按钮。

*30.10.2026*

<!-- source: https://pocketalert.app/zh/blog/n8n-push-notifications -->

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](/get-app) 手机上安装应用。[免费注册](/signup)。
- 来自 [API 密钥](/account/apikeys) 页面的 API 密钥。

## 第 1 步：创建 Header Auth 凭据

Pocket Alert 从名为 `Token` 的请求头中读取 API 密钥。在 n8n 中，创建一个类型为 **Header Auth** 的凭据：

- **Name：** `Token`
- **Value：** 你的 API 密钥

将凭据命名为 `Pocket Alert`。把密钥保存为凭据，可以让它不出现在工作流 JSON 中，这样你导出和分享工作流时就不会泄露密钥。

## 第 2 步：HTTP Request 节点

添加一个 **HTTP Request** 节点，并按如下方式设置：

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>字段</th><th>值</th></tr></thead>
<tbody>
<tr><th>Method</th><td><code>POST</code></td></tr>
<tr><th>URL</th><td><code>https://api.pocketalert.app/v1/messages</code></td></tr>
<tr><th>Authentication</th><td><strong>Generic Credential Type</strong>，然后 <strong>Header Auth</strong>，然后选择 <code>Pocket Alert</code> 凭据</td></tr>
<tr><th>Send Body</th><td>开启</td></tr>
<tr><th>Body Content Type</th><td><code>JSON</code></td></tr>
<tr><th>Specify Body</th><td><strong>Using JSON</strong></td></tr>
</tbody>
</table>
</div>

请求体需要 `title` 和 `message`，`level` 和 `actions` 是可选的。最直观的写法是普通 JSON，并在字符串中使用表达式：

```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。把整个请求体放进一个表达式中：

```js
{{ 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 实际发送的内容：

```http
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` 处理。更多信息请参阅[优先级](https://info.pocketalert.app/features/priority-levels.html)。

## 第 3 步：统一的「Send push」子工作流

如果把这个节点复制到每个工作流中，那么你每次更换密钥、调整级别逻辑或按钮时，都要修改十个工作流。更好的做法是只放在一个子工作流中，然后从其他地方调用它。

复制下面的 JSON，并粘贴到一个空白的 n8n 画布上（或保存为文件，然后使用 **Import from File**）：

```json
{
  "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，字段设置如下：

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>输入</th><th>表达式</th></tr></thead>
<tbody>
<tr><th>title</th><td><code>Failed: {{ $json.workflow.name }}</code></td></tr>
<tr><th>message</th><td><code>{{ ($json.execution?.lastNodeExecuted ?? 'Trigger') + ': ' + ($json.execution ?? $json.trigger).error.message }}</code></td></tr>
<tr><th>level</th><td><code>high</code></td></tr>
<tr><th>url</th><td><code>{{ $json.execution?.url ?? '' }}</code></td></tr>
</tbody>
</table>
</div>

也要发布 Error alert。在 2.x 中，未发布的错误工作流会被跳过，并在日志中显示同样的 "not active" 消息。然后打开你关心的每个工作流，进入 **Workflow settings**，将 **Error workflow** 设置为 Error alert。

为了验证这些路径，我们故意让一个名为 "Sync orders" 的工作流失败：它的 HTTP Request 节点收到了 `503`。Error Trigger 收到的内容如下（已截断）：

```json
{
  "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` 下。更多思路请参阅[表单提交告警](/use-cases/form-submission-alerts)。

### 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 条推送。更多模式请参阅[自动化告警](/use-cases/automation-alerts)。

## 在锁屏上批准或拒绝

有些工作流不应该在没有人工介入的情况下完成：例如超过限额的退款、即将发布的帖子，或者即将修改生产环境的 AI 智能体。Pocket Alert 的 `http` [操作按钮](/features/action-buttons)可以直接从手机发送请求，而 n8n 的 **Wait** 节点可以暂停，直到收到请求。将两者结合起来：

1. 一个带有请求的触发器，这里使用一个接收 `{"order":"A-1042","amount":129}` 的 **Webhook** 节点。
2. 一个 **HTTP Request** 节点，发送带有两个按钮的推送。
3. 一个 **Wait** 节点：**Resume** 设置为 **On Webhook Call**，**HTTP Method** 为 `POST`，开启 **Limit Wait Time**，时长为 2 小时。
4. 一个 **If** 节点：`{{ $json.body.decision }}` 等于 `approve`。

HTTP Request 节点的请求体：

```js
{{ 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 智能体的同一模式见[人在环路通知](/blog/human-in-the-loop-notifications)。

## 或者 POST 到 Pocket Alert Webhook

如果你不想在 n8n 中保存 API 密钥，可以在控制台的 [Webhooks](/webhooks) 页面创建一个 Webhook，然后让 HTTP Request 节点在无需认证的情况下，将 JSON POST 到它的 `https://p4a.me/wh/...` URL。Webhook 上的模板会把负载转换为消息。取舍在于：标题始终为 `Webhook <name>`，正文来自模板，而不是工作流本身。Webhook 历史记录会记录它收到的每一个请求，在调试时很有帮助。

## 限制与故障排查

- **每日配额。** 免费套餐每天允许发送 50 条消息，于 UTC 时间 00:00 重置。对 200 个条目的循环会发送 200 条推送。达到上限后，API 会返回 `429`；不要让 n8n 重试，因为在重置之前结果不会改变。参阅[每日上限](https://info.pocketalert.app/features/daily-limits.html)。
- **`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 应用](/blog/make-com-integration)。

### 这个方案能在 n8n Cloud 上使用吗？

可以。这里的所有内容都使用内置节点。在 Cloud 上，执行和恢复 URL 已经是公开的，省去了自托管实例需要的 URL 配置。

### 我可以只发送给某一部手机吗？

在请求体中添加 `device_id`，并填入该设备的 ID 即可。不加这个字段，推送会发送到你的所有设备。`application_id` 可以将消息归入某个应用，这样 n8n 的告警就会在 App 中拥有自己的频道。

[免费注册账户](/signup)，导入 Send push 工作流，并把你的错误工作流指向它。下一次失败的运行就会出现在你的手机上，而不必再去翻执行列表。
