Как пользоваться n8n: первый сценарий + 6 ошибок

Установить n8n просто, а вот первый рабочий сценарий у многих не складывается: холст открылся, блоки есть, а что с ними делать — непонятно. Ниже — порядок, по которому собирается первая настоящая автоматизация, и шесть мест, где она обычно не срабатывает.

Сначала мелочь: как это читается

Название пишется строчными и читается как «эн-эйт-эн» — от nodemation, «node» плюс «automation», где восьмёрка заменяет восемь букв в середине. По-русски прижилось «энэйтэн», реже «эн-восемь-эн». Вопрос звучит несерьёзно ровно до первого созвона, где его надо произнести вслух.

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

• Установленный n8n — облако, Docker или npx для быстрой пробы. Установка по шагам.
• Одна настоящая задача. «Разберусь с инструментом» — не задача. «Каждое утро присылать в Telegram новые заявки из таблицы» — задача.
• Доступы к сервисам, которые будете соединять: токен бота, доступ к таблице, ключ API.
• Час времени. Первый сценарий — знакомство, а не работа.

1. Понять устройство: три типа нод

Весь n8n держится на одной идее. Сценарий — это цепочка блоков (нод), по которой едут данные в виде JSON. Каждая нода получает список записей и отдаёт список записей.

Ноды бывают трёх типов, и путать их — главная причина ступора на старте:

• Триггеры запускают сценарий: вебхук, расписание, новое письмо, сообщение в чате, отправленная форма. Триггер в сценарии один, и он всегда первый.
• Действия делают работу: HTTP-запрос, отправка в Telegram, запись в таблицу, обращение к базе.
• Логика управляет потоком: IF для ветвления, Switch для нескольких веток, Merge для слияния, Loop Over Items для перебора, Code для того, что не закрывается блоками.

2. Начать с триггера

Первым блоком поставьте то, от чего сценарий запускается. Для первой задачи проще всего два варианта:

• Schedule Trigger — по расписанию: каждые N минут, часов, раз в сутки;
• Webhook — n8n даёт адрес, внешний сервис на него стучится.

Про вебхук важно знать сразу: боевой адрес работает только когда сценарий включён зелёным переключателем. Тестовый адрес живёт, только пока открыт редактор. Половина вопросов «вебхук не срабатывает» — это про перепутанные адреса.

3. Добавить первое действие и проверить его отдельно

Не собирайте всю цепочку разом. Поставьте одну ноду, нажмите на ней выполнение и посмотрите, что она вернула.

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

Универсальный блок, которым закрывается всё, чего нет среди четырёхсот встроенных интеграций, — HTTP Request. Если у сервиса есть API, он подключается через него.

4. Связать ноды выражениями

Данные из предыдущего блока подставляются выражениями в двойных фигурных скобках:

{{ $json.email }}                       // поле из текущей записи
{{ $json["название с пробелом"] }}      // поле с пробелом в имени
{{ $('Имя ноды').item.json.id }}        // поле из конкретной ноды
{{ $now.minus({days: 7}).toISO() }}     // неделю назад
{{ $json.price * 1.2 }}                 // вычисление на лету

Это тот момент, где «без кода» заканчивается и начинается «почти без кода». Пугаться не стоит: девяносто процентов работы закрывается первыми двумя строчками из списка.

ПолезноНе помните точное имя поля — перетащите его мышью из панели входных данных в поле ввода. n8n подставит правильное выражение сам.

5. Отладить по запускам

Когда цепочка собрана, запустите её целиком и откройте раздел с историей запусков. Там видно каждый шаг: что пришло, что ушло, где упало.

Разбор ошибки почти всегда сводится к одному из трёх:

• нода получила не то, что ожидала — смотрите выход предыдущей;
• сервис ответил ошибкой — смотрите код ответа и тело;
• выражение не нашло поле — имя поля изменилось или запись пустая.

У каждой ноды есть настройка поведения при ошибке: остановить весь сценарий, продолжить, отправить ошибку в отдельную ветку или повторить попытку. Для нестабильных внешних API повтор — то, что нужно.

6. Включить и не забыть про безопасность

Сценарий начинает работать сам, когда включён переключатель в правом верхнем углу. До этого он существует только в редакторе.

Что проверить перед включением:

• доступы лежат в разделе учётных данных, а не в блоках Set или Code. Учётные данные хранятся зашифрованно и не попадают в экспорт сценария;
• вебхук защищён — проверкой секрета в заголовке или базовой аутентификацией в настройках ноды. Открытый вебхук может дёргать кто угодно;
• сам n8n не торчит наружу голым портом. Только через обратный прокси с HTTPS.

Шесть ошибок

1. Собирать всю цепочку, не проверяя блоки по одному. Потом непонятно, какой из семи блоков сломал результат.

2. Путать тестовый и боевой адреса вебхука. Тестовый живёт, пока открыт редактор; боевой — только при включённом сценарии.

3. Забыть включить сценарий. Он собран, проверен, работает при ручном запуске — и молчит. Переключатель в правом верхнем углу.

4. Хранить ключи в блоках вместо учётных данных. Тогда они уезжают в экспорт вместе со сценарием.

5. Гонять большие объёмы без разбиения на порции. Loop Over Items с размером порции спасает и от таймаутов, и от лимитов чужих API.

6. Не чистить историю запусков. База растёт, инстанс тормозит. Лечится настройкой автоочистки старых записей.

Что дальше

• Шаблоны — девять тысяч готовых сценариев, которые можно импортировать и переделать под себя. Это самый быстрый способ научиться.
• ИИ-агент в n8n — блок AI Agent, модель, память и инструменты.
• n8n или Make — если ещё выбираете платформу.
• MCP для n8n — чтобы ИИ-агент сам собирал и чинил сценарии.

Коротко о главном

• Читается «эн-эйт-эн», от nodemation.
• Сценарий — цепочка нод, по которой едет JSON; ноды бывают триггерами, действиями и логикой.
• Собирайте по одному блоку и смотрите вход-выход каждого — это главный приём отладки.
• Данные подставляются выражениями {{ $json.поле }}; поле проще перетащить мышью, чем вспоминать.
• Боевой вебхук работает только при включённом сценарии — самая частая причина «не срабатывает».
• Ключи — в учётные данные, вебхук — под защиту, n8n — за обратный прокси.