# n8n push-уведомления: оповещения на телефон из любого workflow

> Отправляйте push-уведомления на iPhone или Android из n8n. Один узел HTTP Request, общий подворкфлоу «Send push», error workflow, который пришлёт уведомление при любом сбое, и кнопки «Одобрить» и «Отклонить», которые возобновляют ожидающий workflow.

*30.10.2026*

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

n8n хорошо справляется с задачами, пока вас нет, и плохо сообщает о результатах. Пришла заявка из формы, в ленте появился новый пост, синхронизация упала в 3 часа ночи, и единственная запись об этом — строка в списке выполнений, которую вы откроете только на следующей неделе.

Это руководство связывает n8n с вашим телефоном. Вы будете вызывать API Pocket Alert из узла HTTP Request, оформите этот вызов как один переиспользуемый подворкфлоу, добавите error workflow, который уведомит вас о сбое любого workflow, и закончите кнопками «Одобрить» и «Отклонить», которые возобновляют workflow прямо с экрана блокировки.

Всё ниже проверено на n8n 2.45.7 (Docker-образ `n8nio/n8n`). Узел HTTP Request был направлен на локальный перехватчик запросов, чтобы каждый запрос можно было сверить со справочником API.

## Что понадобится

- Экземпляр n8n: self-hosted или n8n Cloud.
- Аккаунт Pocket Alert и приложение на вашем [iPhone или Android](/get-app). [Зарегистрироваться](/signup) можно бесплатно.
- API-ключ из раздела [API Keys](/account/apikeys).

## Шаг 1: учётные данные Header Auth

Pocket Alert читает API-ключ из заголовка с именем `Token`. В n8n создайте учётные данные типа **Header Auth**:

- **Name:** `Token`
- **Value:** ваш API-ключ

Назовите учётные данные `Pocket Alert`. Если хранить ключ в учётных данных, он не попадёт в JSON workflow, поэтому можно экспортировать и делиться workflow без риска утечки ключа.

## Шаг 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>On</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 натыкаются на это раньше, чем ожидаешь.

Решение — поручить построение JSON JavaScript. Поместите всё тело в одно выражение:

```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» для всего

Если копировать этот узел в каждый workflow, то при смене ключа, логики уровней или кнопки придётся правиться в десяти местах. Лучше вынести его в один подворкфлоу и вызывать из всех остальных.

Скопируйте этот 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` задан, у push появляется кнопка **Open**, которая открывает эту ссылку. Пустой массив `actions` допустим и означает, что кнопок не будет.

**Опубликуйте его.** В n8n 2.x для продакшен-запусков вызывается опубликованная версия подворкфлоу. Пока вы не опубликуете Send push, каждый вызов по расписанию или по вебхуку завершится ошибкой «Workflow is not active and cannot be executed», хотя ручной тест из редактора работает, так как ручные запуски используют черновик. То же касается правок: изменения в Send push попадут в продакшен только после повторной публикации.

Чтобы вызвать его из другого workflow, добавьте узел **Execute Sub-workflow**, выберите **Send push** в списке и заполните четыре поля выражениями, например для заголовка `New order #{{ $json.id }}`.

## Получать push при сбое любого workflow

n8n запускает отдельный error workflow, когда продакшен-выполнение завершается с ошибкой. Создайте workflow с названием **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 неопубликованный error workflow пропускается, а в логе появляется то же сообщение «not active». Затем откройте каждый нужный workflow, перейдите в **Workflow settings** и укажите **Error workflow**: Error alert.

Чтобы проверить оба сценария, намеренно уронили workflow «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**, которая вела к этому выполнению. Важны две детали:

- **Ссылка на выполнение использует ваш публичный адрес.** n8n формирует `execution.url` из `N8N_EDITOR_BASE_URL`, а если переменной нет, берёт адрес вебхуков. В тесте это был `localhost`, что на телефоне бесполезно. На self-hosted экземпляре укажите в `N8N_EDITOR_BASE_URL` адрес, по которому вы открываете n8n.
- **Сбой триггера выглядит иначе.** Если сломался сам триггер, например RSS-лента вернула HTML, выполнения нет. В данных будет `trigger.error` вместо `execution`, и ссылки не будет. Конструкции `?.` и `??` в выражениях выше как раз на этот случай. В тесте пришло «Failed: Changelog to phone» с текстом «Trigger: Non-whitespace before first tag...» и без кнопки.

## Три workflow, которые люди действительно строят

Каждый из них заканчивается узлом 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` требует URL вида `http(s)`, и ссылка `mailto:` привела бы к отказу с кодом `400`. То же работает с узлом **Webhook** за формой вашего сайта: тогда поля лежат в `$json.body`. Больше идей — в разделе [уведомления о заявках из формы](/use-cases/form-submission-alerts).

### Новый пост в RSS-ленте

Триггер **RSS Feed Trigger** опрашивает changelog или блог каждые 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** ведёт к посту.

### Плановая проверка

**Schedule Trigger** каждые 5 минут, затем узел **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 или таймаут по-прежнему ломают узел, и тогда push отправит error workflow. Учтите, что такая проверка будет присылать уведомление при каждом запуске, пока сайт лежит: двенадцать push в час при интервале 5 минут. Больше шаблонов — в разделе [уведомления для автоматизаций](/use-cases/automation-alerts).

## Одобрить или отклонить с экрана блокировки

Некоторые workflow не должны завершаться без человека: возврат средств сверх лимита, публикация поста, ИИ-агент, который собирается изменить продакшен. Кнопки действий Pocket Alert с типом `http` [отправляют запрос](/features/action-buttons) прямо с телефона, а узел **Wait** в n8n может ждать, пока не придёт запрос. Соберите всё вместе:

1. Триггер с запросом: узел **Webhook**, который получает `{"order":"A-1042","amount":129}`.
2. Узел **HTTP Request**, который отправляет push с двумя кнопками.
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 слушает именно это выполнение.

В тесте POST на URL кнопки «Approve» с её телом вернул `200`, workflow возобновился, `$json.body.decision` равнялся `approve`, и узел If пошёл по ветке true. «Decline» ушёл на ветку false. Детали, на которые пришлось потратить несколько попыток:

- **Передавайте решение в теле, а не в URL.** В n8n 2.45.7 resume-URL уже заканчивается на `?signature=...`. Если добавить `?decision=approve`, подпись ломается, и n8n отвечает `401`. JSON-тело обходится без манипуляций со строками.
- **Повторное нажатие отклоняется.** Как только выполнение возобновлено, следующее нажатие получает `409` «has finished already», и приложение показывает уведомление о неудачном запросе с кнопкой Retry. Важно первое нажатие.
- **Отсутствие ответа — это отказ.** Когда истекает лимит в 2 часа, узел Wait продолжает работу без `decision`, и узел If уходит на ветку false. Сделайте безопасной именно эту ветку.
- **Телефон должен достучаться до n8n.** Запрос идёт с телефона, а не от Pocket Alert. `$execution.resumeUrl` формируется из адреса вебхуков (`WEBHOOK_URL`, который n8n 2.45 просит переименовать в `N8N_WEBHOOK_URL`). В n8n Cloud или за публичным доменом это работает сразу. На домашнем сервере — только пока телефон в той же сети или через VPN, например Tailscale.
- **Кнопки — платная функция.** На бесплатном тарифе push всё равно придёт, но без кнопок. Системные кнопки уведомлений требуют приложение Pocket Alert версии 2.0.1 или новее.

Тот же подход для ИИ-агентов описан в статье [уведомления с участием человека](/blog/human-in-the-loop-notifications).

## Или отправляйте POST на вебхук Pocket Alert

Если не хочется хранить API-ключ в n8n, создайте вебхук в разделе [Webhooks](/webhooks) в консоли и настройте узел HTTP Request на POST-запрос с JSON на его URL вида `https://p4a.me/wh/...` без аутентификации. Шаблон вебхука превращает данные в текст уведомления. Компромисс такой: заголовок всегда будет `Webhook <name>`, а текст берётся из шаблона, а не из workflow. История вебхука фиксирует каждый полученный запрос, что помогает при отладке.

## Лимиты и устранение неполадок

- **Дневная квота.** На бесплатном тарифе доступно 50 сообщений в день, сброс в 00:00 UTC. Цикл по 200 элементам отправит 200 push. После лимита API отвечает `429`; не позволяйте n8n повторять такой запрос, ответ не изменится до сброса. См. [дневные лимиты](https://info.pocketalert.app/features/daily-limits.html).
- **`401`** означает, что ключ неверный или в учётных данных имя заголовка отличается от `Token`.
- **`400`** означает, что в теле нет `title` или `message` (пустой результат выражения тоже считается отсутствием), указан неизвестный level или кнопка не проходит проверку: больше 3 кнопок, URL в `view` не вида `http(s)`, или значение `http` не является JSON-строкой с `url`.
- **«not valid JSON» в n8n** означает, что значение сломало JSON-тело. Перейдите на `JSON.stringify`, как в шаге 2.
- **Ничего не приходит при сбое.** Проверьте, что Error alert и Send push опубликованы и что в настройках упавшего workflow указан Error alert. Ручные тестовые запуски из редактора error workflow не вызывают.

## FAQ

### Есть ли узел Pocket Alert для n8n?

Пока нет. Узел HTTP Request покрывает весь API, а подворкфлоу Send push даёт блок, похожий на узел, который вы настраиваете один раз. Если вы используете Make, есть официальное [приложение для Make](/blog/make-com-integration).

### Работает ли это в n8n Cloud?

Да. Всё описанное использует встроенные узлы. В Cloud адреса выполнения и возобновления уже публичные, поэтому не нужна та настройка URL, которая требуется self-hosted экземпляру.

### Можно ли отправлять push только на один телефон?

Добавьте в тело `device_id` с ID устройства. Без него push уходит на все ваши устройства. `application_id` относит сообщение к приложению, так что уведомления n8n получат собственный канал в приложении.

[Создайте бесплатный аккаунт](/signup), импортируйте workflow Send push и укажите ему свой error workflow. Следующий сбой появится на телефоне, а не только в списке выполнений.
