Ноды n8n: справочник по ключевым блокам сценария

АвтоматизацияИгорь Мельник9 мин чтения
Ноды n8n: справочник по ключевым блокам сценария

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

Общий гайд по сборке автоматизации в n8n описывает процесс: как соединить блоки в рабочий поток и протестировать результат. Здесь задача другая: разложить по полочкам сами ноды n8n, их параметры и типичные ошибки настройки. Справочник пригодится, когда логика сценария уже понятна, но неясно, какой блок взять: вызвать внешний API, принять вебхук, обработать данные кодом или подключить ИИ-агента.

Дальше по порядку: типы нод, параметры HTTP Request, Webhook и Code, устройство AI Agent, работа с таблицами и способ подружить n8n с 1С без готового коннектора.

Типы нод n8n

Все ноды n8n делятся на несколько групп по роли в сценарии.

  • Триггеры запускают workflow: Webhook, Schedule Trigger, Manual Trigger, триггеры конкретных сервисов.
  • Обычные ноды выполняют операцию: HTTP Request, Set, IF, Google Sheets, Postgres и сотни готовых интеграций.
  • Code-ноды дают доступ к JavaScript или Python прямо внутри сценария.
  • AI-ноды образуют кластер вокруг AI Agent: модель чата, память и инструменты подключаются к нему как под-ноды.

Таблица ниже группирует частые ноды по задаче, которую они закрывают.

Тип ноды Примеры Когда использовать
Триггер Webhook, Schedule Trigger Запуск по входящему запросу или расписанию
Универсальный коннектор HTTP Request Нет готовой интеграции с сервисом
Готовая интеграция Google Sheets, Airtable, Postgres Сервис поддерживается нативно, нужна простая настройка
Логика и код IF, Switch, Code Ветвление и нестандартные преобразования данных
ИИ-кластер AI Agent, Chat Model, Memory, Tool Сценарии с рассуждением и вызовом инструментов

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

HTTP Request: универсальный коннектор к любому API

HTTP Request открывают, когда готовой интеграции с нужным сервисом нет. Нода поддерживает семь методов: GET, POST, PUT, PATCH, DELETE, HEAD и OPTIONS, и собирает запрос почти к любому REST или HTTP API.

Для авторизации есть два пути. Если сервис входит в список поддерживаемых n8n интеграций, выбирайте Predefined Credential Type: авторизация настраивается в пару кликов. Для остальных случаев есть generic credentials:

  • Basic auth и Digest auth;
  • Header auth и Query auth, когда ключ передаётся в заголовке или параметре запроса;
  • OAuth1 и OAuth2;
  • Custom auth и Simplified Custom Auth для нестандартных схем.

Тело запроса отправляется в формате JSON, form-urlencoded, multipart form-data, как бинарный файл n8n или как raw-строка с произвольным Content-Type. Настройка пагинации берёт на себя постраничную выгрузку: нода либо обновляет параметр в каждом следующем запросе, либо идёт по ссылке next-страницы из ответа, используя переменные $pageCount, $request и $response.

Когда API отдаёт rate limit, помогает Batching: можно задать, сколько элементов отправлять за один пакет и с какой паузой между пакетами. Без этой настройки сценарий на тысячу строк упирается в лимит запросов за несколько секунд.

Webhook: нода-триггер для входящих запросов

Webhook принимает входящий HTTP-запрос и запускает сценарий. Поддерживаются методы DELETE, GET, HEAD, PATCH, POST и PUT, выбор метода задаётся в параметрах ноды.

Ключевая настройка, режим ответа (Respond), определяет, что получит отправитель запроса:

  1. Immediately возвращает код ответа сразу, не дожидаясь выполнения сценария;
  2. When Last Node Finishes отдаёт данные последнего узла после завершения workflow;
  3. Using Respond to Webhook Node формирует ответ вручную отдельной нодой в нужной точке сценария;
  4. Streaming response транслирует данные в реальном времени, пока сценарий работает.

За аутентификацию отвечают четыре варианта: Basic auth, Header auth, JWT auth или None, если запросы принимаются без проверки. У ноды два адреса: тестовый, активный в режиме Listen for Test Event, и продакшн-URL, который начинает работать после активации сценария. Для приёма файла, изображения или аудио включите Binary Property и используйте методы POST, PATCH или PUT: метод GET для бинарных данных не подойдёт.

Code: JavaScript и Python внутри сценария

Code открывает доступ к языку программирования там, где готовых нод не хватает: сложные вычисления, нестандартный парсинг ответа API, объединение нескольких массивов по условию.

Нода поддерживает JavaScript в среде Node.js, с промисами и console.log для отладки, и Python. На облачной версии n8n исполнение Python не позволяет подключать внешние библиотеки, поэтому для задач со сторонними пакетами JavaScript остаётся предсказуемым выбором по умолчанию.

Режим выполнения задаётся отдельно:

  • Run Once for All Items, стандартный режим: код выполняется один раз для всего набора данных, который пришёл в ноду;
  • Run Once for Each Item: код запускается отдельно для каждого элемента, это удобно, когда логика зависит от конкретной строки.

Внутри кода доступны встроенные переменные для обращения к данным текущего и предыдущих узлов, параметрам workflow и окружению n8n. На облачной платформе дополнительно подключены модули crypto и moment, что закрывает большинство задач с хешированием и датами без внешних зависимостей.

AI Agent: инструменты, модель и память

AI Agent собирает вокруг себя кластер из нескольких под-нод, и это отличает его от обычного блока. Сама по себе нода не работает: ей нужна подключённая модель чата, без неё агент не может рассуждать и отвечать.

Архитектура ноды построена вокруг Tools Agent: агент сам решает, какой инструмент вызвать для решения задачи, а не выполняет жёстко заданную последовательность действий. Инструментами могут стать:

  • обычные ноды n8n, подключённые как tool-подноды;
  • MCP-серверы через реестр инструментов;
  • специализированные инструменты для Postgres или MySQL, когда агенту нужно самостоятельно писать запросы к базе.

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

Как собрать AI Agent с инструментами шаг за шагом, от подключения модели до первого рабочего вызова tool, описано в статье про настройку ИИ-агента в n8n.

Ноды для таблиц и баз данных

Для таблиц и баз у n8n есть специализированные ноды, которые берут на себя авторизацию и формат данных, которые иначе пришлось бы собирать руками через HTTP Request.

На примере Google Sheets, самой частой ноды для работы с таблицами, набор операций выглядит так:

  • Append Row: создаёт новую строку в конце диапазона;
  • Update Row: обновляет существующую строку по заданному условию;
  • Append or Update Row: добавляет строку или обновляет её, если совпадение по ключевому столбцу уже найдено, по сути upsert;
  • Get Row(s): читает все строки листа или часть по фильтру;
  • Delete Rows or Columns и Clear: удаляют данные или очищают диапазон.

Для сравнения строк при Update и Append or Update нода использует matching columns, столбцы, по которым ищется совпадение, обычно это ID или уникальный ключ. Та же логика upsert повторяется в нодах Airtable, Postgres и MySQL: разница в том, что база сама следит за уникальностью по первичному ключу, а в таблице эту роль берёт на себя указанный столбец.

В сценариях Make похожие операции с таблицами есть, но собираются из нескольких отдельных модулей, а не из одной ноды с параметрами upsert.

Интеграция с 1С: как подключить без готовой ноды

Готовой ноды для 1С в n8n нет, и это нормально: 1С не REST-сервис по умолчанию, а учётная система со своим протоколом. Подключение строится через HTTP Request к интерфейсу, который открывает сама 1С.

Два рабочих варианта:

  1. HTTP-сервисы 1С: в конфигурации публикуется HTTP-сервис с нужными методами, создать заказ, обновить остаток, получить список контрагентов. HTTP Request обращается к этому адресу методом GET или POST, авторизация чаще всего Basic auth, тело запроса в JSON.
  2. OData-интерфейс 1С: платформа отдаёт данные справочников и документов в формате OData, HTTP Request читает и пишет их теми же методами, что и в любом REST API.

Направление может быть обратным: 1С сама отправляет запрос во внешнюю систему при изменении документа, и тогда на стороне n8n нужен не HTTP Request, а Webhook, который примет этот запрос и запустит сценарий. Выбор зависит от того, кто инициирует обмен: n8n тянет данные из 1С или 1С толкает их наружу.

Частые вопросы

Нужно ли уметь программировать, чтобы работать с нодами n8n?

Нет. Большинство нод, включая HTTP Request, Webhook, Google Sheets и десятки готовых интеграций, настраиваются без единой строки кода, через формы с параметрами. Код нужен только в ноде Code, и только для задач, которые не покрывает стандартная логика ветвления и преобразования данных: сложные вычисления, нестандартный парсинг ответа или объединение массивов по условию.

В чём разница между HTTP Request и специализированной нодой, например Google Sheets?

Специализированная нода уже знает формат API сервиса: авторизацию, пагинацию, структуру ответа, и предлагает готовые операции вроде Append или Update. HTTP Request универсален, но все эти детали приходится настраивать руками: заголовки, тип тела запроса, разбор ответа. Берите готовую ноду, если она есть, и HTTP Request, если интеграции с сервисом в n8n не существует.

JavaScript или Python выбрать в ноде Code?

JavaScript работает в среде Node.js без ограничений на облачной платформе и подходит для большинства задач по умолчанию. Python в той же облачной версии не позволяет подключать внешние библиотеки, поэтому годится для простых вычислений без сторонних пакетов. Если сценарий требует специфичных библиотек Python, его обычно разворачивают на self-hosted n8n.

Обязательно ли подключать память к AI Agent?

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

Как n8n обменивается данными с 1С, если нативной ноды нет?

Через HTTP Request к HTTP-сервису или OData-интерфейсу, которые публикует сама 1С, либо через Webhook, если инициатором обмена выступает 1С. Выбор направления зависит от того, какая система должна первой узнать об изменении: заказе, остатке, новом контрагенте.

С чего начать

Если вы уже выбираете между нодами для конкретного сценария, порядок действий такой:

  1. Определите триггер: входящий запрос (Webhook) или расписание (Schedule Trigger).
  2. Проверьте, есть ли готовая интеграция с нужным сервисом; если нет, используйте HTTP Request.
  3. Добавьте Code только там, где логику нельзя собрать из IF, Switch и Set.
  4. Для сценариев с ИИ подключите к AI Agent модель чата, нужные инструменты и память, если диалог не разовый.

Если разбираться в параметрах каждой ноды и собирать сценарий самостоятельно не хочется, настройку автоматизации на n8n под конкретные бизнес-процессы берут на себя специалисты по автоматизации neurounit.

Поделиться:

About Author: Игорь Мельник

nu_editor_melnik@neurounit.ai

Редактор Neurounit. Пишет про автоматизацию, разработку и внедрение AI в процессы.

Neurounit

Запустить рост с AI

Оставьте заявку или напишите в мессенджер