Обработка ошибок в n8n: флоу не падает молча

Проблема

n8n по умолчанию падает молча. Флоу завершился с ошибкой — ты об этом узнаешь только если зайдёшь в интерфейс и посмотришь историю выполнений. На практике это значит: данные не отправились, webhook не сработал, интеграция сломалась — а ты замечаешь это через день или неделю по последствиям, а не по алерту.

Решение: Error Workflow — специальный флоу в n8n, который автоматически запускается при ошибке в любом другом флоу. Он получает данные об ошибке и отправляет уведомление туда, куда ты скажешь. Мы настроим Telegram.

Архитектура решения

code

Основной флоу → ошибка → n8n Error Trigger → Telegram-нода → сообщение тебе

Error Workflow получает объект с информацией об ошибке:

$workflow.name — имя флоу, где произошла ошибка
$execution.id — ID выполнения для дебага
$execution.error.message — текст ошибки
$execution.error.node.name — нода, на которой упало
$execution.lastNodeExecuted — последняя выполненная нода

Установка Error Workflow

Шаг 1. Создай новый флоу в n8n и назови его Error Handler.

Шаг 2. Добавь ноду n8n Trigger → выбери тип Error Trigger. Это специальный тип триггера, который активируется только при ошибке в других флоу.

Шаг 3. Добавь ноду Telegram после Error Trigger.

Шаг 4. Настрой Telegram-ноду:

Credential: твой Telegram Bot API credential
Resource: Message
Operation: Send Message
Chat ID: твой личный Chat ID или ID группы для алертов
Text: (см. шаблон ниже)

Текст сообщения для Telegram-ноды:

code

🔴 Ошибка в n8n флоу

📋 Флоу: {{ $workflow.name }}
🔧 Нода: {{ $execution.error.node.name }}
💬 Ошибка: {{ $execution.error.message }}
🆔 Execution ID: {{ $execution.id }}
⏰ Время: {{ $now.toISO() }}

Открыть: https://YOUR_N8N_URL/execution/{{ $execution.id }}

Шаг 5. Сохрани флоу Error Handler и запомни его ID (видно в URL).

Шаг 6. Открой настройки каждого основного флоу: Settings → Error Workflow → выбери Error Handler.

JSON шаблон

Импортируй этот JSON в n8n (New Workflow → Import from JSON):

json

{
  "name": "Error Handler",
  "nodes": [
    {
      "parameters": {},
      "id": "error-trigger-node",
      "name": "Error Trigger",
      "type": "n8n-nodes-base.errorTrigger",
      "typeVersion": 1,
      "position": [240, 300]
    },
    {
      "parameters": {
        "resource": "message",
        "operation": "sendMessage",
        "chatId": "={{ $vars.TELEGRAM_ALERT_CHAT_ID }}",
        "text": "🔴 *Ошибка в n8n*\n\n📋 Флоу: `{{ $workflow.name }}`\n🔧 Нода: `{{ $execution.error.node.name }}`\n💬 Ошибка: `{{ $execution.error.message }}`\n🆔 ID: `{{ $execution.id }}`\n⏰ `{{ $now.toISO() }}`",
        "additionalFields": {
          "parse_mode": "Markdown"
        }
      },
      "id": "telegram-notify-node",
      "name": "Telegram Alert",
      "type": "n8n-nodes-base.telegram",
      "typeVersion": 1.2,
      "position": [460, 300],
      "credentials": {
        "telegramApi": {
          "id": "YOUR_TELEGRAM_CREDENTIAL_ID",
          "name": "Telegram Bot"
        }
      }
    }
  ],
  "connections": {
    "Error Trigger": {
      "main": [
        [
          {
            "node": "Telegram Alert",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1"
  }
}

Замени YOUR_TELEGRAM_CREDENTIAL_ID на ID своего Telegram credential из n8n. Chat ID лучше вынести в переменную окружения TELEGRAM_ALERT_CHAT_ID через Settings → Variables.

Подключение к флоу

После создания Error Handler подключи его к каждому важному флоу:

Открой флоу
Перейди в Settings (иконка шестерёнки)
В поле Error Workflow выбери Error Handler
Сохрани

Для массового подключения: используй n8n API или вручную пройди по всем флоу — это нужно сделать один раз.

Что приходит в Telegram

При ошибке ты получишь сообщение вида:

code

🔴 Ошибка в n8n

📋 Флоу: Синхронизация CRM → Telegram
🔧 Нода: HTTP Request
💬 Ошибка: Request failed with status code 429
🆔 Execution ID: 1847
⏰ 2026-05-25T14:32:11.000Z

Открыть: https://n8n.example.com/execution/1847

Прямая ссылка на execution позволяет сразу открыть детали, посмотреть входные данные ноды и понять причину ошибки без поиска по логам.