Мастер-класс по автоматизации процессов в n8n

Введение в экосистему n8n: установка, обзор интерфейса и создание первого линейного сценария

Добро пожаловать на курс «Мастер-класс по автоматизации процессов в n8n». Мы начинаем наше погружение в мир профессиональной автоматизации. Если вы здесь, значит, вы уже понимаете, что рутинные задачи должны выполнять роботы, а люди созданы для творчества и принятия стратегических решений.

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

Что такое n8n и почему он меняет правила игры?

n8n (произносится как «n-eight-n») — это инструмент автоматизации рабочих процессов, основанный на узлах (nodes). В отличие от многих конкурентов, которые предлагают простые линейные списки действий, n8n предоставляет визуальный редактор в виде блок-схемы. Это позволяет создавать сложнейшие ветвления, циклы и логические конструкции, которые наглядно отображают суть бизнес-процесса.

Ключевые преимущества:

* Fair-code лицензия: Вы можете бесплатно использовать n8n на своем сервере для внутренних бизнес-задач. Платите вы только в том случае, если начинаете продавать автоматизацию как услугу или используете облачную версию разработчиков. * Универсальность: n8n работает с JSON-объектами. Это означает, что вы можете манипулировать данными так, как это делают программисты, но без необходимости писать тысячи строк кода. * Независимость: Возможность установки на собственный сервер (Self-hosted) дает вам полный контроль над данными. Ваши клиентские базы и финансовые отчеты не покидают ваш периметр безопасности.

!Слева изображен простой список действий сверху вниз. Справа — сложная сеть узлов с ветвлениями и циклами, демонстрирующая гибкость n8n

Способы начала работы: Облако vs Свой сервер

Прежде чем мы перейдем к интерфейсу, нам нужно получить доступ к системе. Существует три основных пути:

n8n Cloud: Самый быстрый способ. Вы регистрируетесь на официальном сайте, получаете готовый инстанс и платите ежемесячную подписку. Идеально для старта и тех, кто не хочет администрировать серверы.

Desktop App: Приложение для Windows или Mac. Отлично подходит для тестов и обучения, но не подходит для круглосуточной работы автоматизаций, так как компьютер должен быть включен.

Self-hosted (Docker): Золотой стандарт для профессионалов. Вы арендуете виртуальный сервер (VPS) и разворачиваете n8n через Docker. Это дает максимальную производительность и минимальную стоимость.

Для целей этого урока мы предполагаем, что вы уже получили доступ к интерфейсу любым из способов. Если вы только пробуете, рекомендую начать с облачной пробной версии или десктопного приложения.

Обзор интерфейса: Анатомия автоматизации

Когда вы впервые открываете n8n, перед вами предстает рабочее пространство, называемое Canvas (Холст). Давайте разберем основные элементы управления.

!Интерфейс редактора рабочих процессов n8n

1. Панель навигации (слева)

Здесь находятся основные разделы управления вашим аккаунтом: * Workflows (Сценарии): Список всех ваших автоматизаций. * Templates (Шаблоны): Библиотека готовых решений от сообщества. * Credentials (Учетные данные): Безопасное хранилище API-ключей и паролей для подключения к сервисам (Google Sheets, Telegram, CRM). * Executions (Выполнения): Журнал работы ваших сценариев. Здесь можно посмотреть историю запусков и найти ошибки.

2. Холст (Canvas)

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

3. Узлы (Nodes)

Узел — это кирпичик вашей автоматизации. Каждый узел выполняет одно конкретное действие: получает данные, отправляет запрос, фильтрует информацию или изменяет структуру JSON.

Узлы делятся на два глобальных типа: * Trigger (Триггер): То, что запускает сценарий. Это может быть входящее сообщение в Telegram, новая строка в Google Таблице, наступление определенного времени (Cron) или нажатие кнопки (Manual). * Regular Node (Обычный узел): Действие, которое выполняется после запуска. Например, «Отправить письмо» или «Сложить два числа».

4. Панель управления (снизу/сверху)

Здесь находятся кнопки для сохранения (Save), активации сценария (Active) и тестового запуска (Execute Workflow).

Понятие данных в n8n: JSON и массивы

Это, пожалуй, самая важная теоретическая часть. n8n общается на языке JSON (JavaScript Object Notation). Данные передаются от узла к узлу в виде массива объектов.

Представьте, что каждый узел — это рабочий на конвейере. Предыдущий рабочий передает следующему коробку (массив). В коробке лежат детали (объекты). Даже если деталь всего одна, она все равно лежит в коробке.

Пример структуры данных, которую видит n8n:

Понимание этой структуры критически важно: n8n по умолчанию пытается выполнить действие для каждого объекта в массиве. Если вы передадите 100 строк из таблицы, следующий узел (например, отправка email) сработает 100 раз.

Практика: Создаем первый линейный сценарий

Хватит теории. Давайте создадим простую, но показательную автоматизацию.

Наша задача: Получить случайный интересный факт из открытого API и подготовить его для отправки (симуляция).

Шаг 1: Добавление Триггера

Нажмите на кнопку + или Add first step на холсте.

В поиске введите Manual.

Выберите узел On clicking 'Execute' (ранее назывался Manual Trigger).

Этот узел позволяет запускать сценарий вручную, что идеально для тестов. Теперь на вашем холсте есть стартовая точка.

Шаг 2: Получение данных (HTTP Request)

Мы будем использовать бесплатный API, который отдает случайные факты о кошках.

Нажмите на маленький + (плюс) справа от узла Триггера, чтобы добавить следующий шаг.

В поиске найдите HTTP Request.

Откроется окно настройки узла. Заполните следующие поля:

* Method: GET (мы запрашиваем данные). * URL: https://catfact.ninja/fact

Нажмите кнопку Execute Node (или Test step) в окне настройки.

Если вы все сделали верно, в правой части окна (Output) вы увидите зеленый статус и полученные данные в формате JSON:

!Настройка HTTP запроса и просмотр результата

Шаг 3: Обработка данных (Edit Fields / Set)

Часто API возвращают много лишней информации (в нашем случае поле length нам не нужно). Давайте оставим только сам факт и переименуем поле на русский манер, подготовив данные для дальнейшего использования.

Добавьте новый узел после HTTP Request.

Найдите узел Edit Fields (в старых версиях он назывался Set).

В настройках выберите режим Manual Mapping (или просто добавьте поле).

В поле Name (имя новой переменной) напишите: text_message.

В поле Value нам нужно подставить значение из предыдущего шага.

Нажмите на иконку шестеренки или перетащите значение fact из панели Input (слева) в поле Value*. * Вы увидите выражение вида {{ $json.fact }}. Это и есть магия n8n — динамическая подстановка данных.

Нажмите Execute Node. Теперь на выходе у вас чистый объект:

Шаг 4: Сохранение и запуск

Закройте окно настройки узла.

Нажмите Save в правом верхнем углу (или Ctrl+S / Cmd+S).

Дайте имя вашему сценарию, например: My First Automation.

Нажмите большую кнопку Execute Workflow внизу экрана.

Вы увидите, как зеленые линии «пробегут» от узла к узлу. Это визуализация потока данных. Если какой-то узел загорится красным — значит, произошла ошибка, и вы сможете открыть его, чтобы посмотреть детали.

Отладка и история выполнений

После запуска перейдите в раздел Executions в левом меню. Вы увидите запись о вашем последнем запуске.

Кликнув на него, вы попадете в режим «посмертного анализа» (post-mortem). Вы можете нажать на любой узел в этом историческом запуске и увидеть: * Что пришло на вход (Input). * Что узел сделал. * Что ушло на выход (Output).

Это невероятно мощный инструмент. В отличие от написания кода, где вам нужно расставлять console.log для отладки, n8n сохраняет состояние данных на каждом шаге автоматически (в режиме разработки).

Заключение

Поздравляю! Вы только что создали свой первый линейный сценарий в n8n. Мы прошли путь от пустого холста до работающей логики: триггер -> получение данных -> обработка данных.

В этом уроке мы намеренно не касались сложных тем, таких как циклы, условия IF и работа с авторизацией. Это фундамент, на котором мы будем строить дальше.

В следующей статье мы разберем «Логические операторы и ветвления: IF, Switch и Merge», где научим нашего робота принимать решения в зависимости от полученных данных.

> Автоматизация — это не про замену людей, а про освобождение их от робо-работы.

Готовы проверить свои знания? Приступайте к выполнению домашнего задания.

Управление данными и логикой: работа с JSON, условные переходы IF и объединение потоков Merge

В предыдущей статье мы создали линейный сценарий: данные шли строго друг за другом, как вагоны поезда. Но реальные бизнес-процессы редко бывают прямыми. В них всегда есть условия: «Если клиент оплатил, отправить письмо, иначе — напомнить», «Если сумма сделки больше 10 000, уведомить директора».

Сегодня мы превратим ваш линейный скрипт в разветвленную логическую систему. Мы научимся управлять потоками данных, разделять их с помощью узла If и снова соединять через Merge.

Глубокое погружение в структуру данных n8n

Прежде чем строить логику, нужно окончательно разобраться, чем мы управляем. Как мы упоминали ранее, n8n работает с массивами объектов JSON. Но что это значит на практике при ветвлении?

JSON: Универсальный язык обмена

JSON (JavaScript Object Notation) — это текстовый формат обмена данными. В n8n каждый элемент, проходящий через узел, является объектом.

Взгляните на этот пример данных о заказах:

Здесь мы видим массив (квадратные скобки []), содержащий два объекта (фигурные скобки {}).

Важное правило: Узлы в n8n обрабатывают каждый объект в массиве по отдельности. Если вы подключите этот массив к узлу отправки Email, n8n попытается отправить два письма. Это происходит автоматически, без необходимости создавать циклы for или while, как в традиционном программировании.

!Визуализация того, как n8n обрабатывает массив объектов: каждый элемент массива проходит через узел независимо.

Доступ к данным (Dot Notation)

Чтобы использовать данные внутри узла, мы обращаемся к ним через точку. Если вы хотите получить сумму первого заказа в выражении (Expression), путь будет выглядеть так:

{{ json.customer.details.name }}.

Узел IF: Принятие решений

Узел If — это мозг вашей автоматизации. Он делит поток данных на два направления: True (Истина) и False (Ложь).

Как это работает?

Вы задаете условие. n8n берет каждый входящий объект и проверяет его на соответствие этому условию.

* Если условие выполняется (например, amount > 10000), объект выходит через выход True. * Если условие не выполняется, объект выходит через выход False.

Это означает, что из 10 входящих элементов 3 могут пойти по верхней ветке, а 7 — по нижней. Поток физически разделяется.

!Принцип работы узла IF: разделение потока данных на основе условий.

Типы условий

В настройках узла If вы встретите разные типы данных для сравнения:

String (Строка): Для текста.

Пример: status Equal to* paid.

Number (Число): Для математических сравнений.

Пример: amount Larger than* 1000.

Boolean (Булево): Истина или Ложь.

Пример: is_active Equal to* true.

Date & Time: Для работы с датами.

Пример: created_at After* 2023-01-01.

Практический пример: Фильтрация заказов

Представим, что у нас есть список заказов, и мы хотим отправить VIP-подарок тем, кто купил на сумму более 10 000 рублей.

Добавьте узел If после источника данных.

В параметрах выберите:

* Value 1: перетащите поле amount из входных данных ({{ json.type }} Operation: Equal to* * Value 2: Urgent

Шаг 3: Обработка веток

К выходу True подключите узел Edit Fields (назовем его «Send to Slack»).

* Создайте поле action со значением Sent to Slack.

К выходу False подключите другой узел Edit Fields (назовем его «Archive»).

* Создайте поле action со значением Archived.

Теперь у нас два параллельных потока. Срочные задачи получают метку «Отправлено», обычные — «Архивировано».

Шаг 4: Объединение (Merge)

Добавьте узел Merge.

Соедините выход узла «Send to Slack» с Input 1 узла Merge.

Соедините выход узла «Archive» с Input 2 узла Merge.

В настройках Merge выберите Mode: Append.

Шаг 5: Запуск

Нажмите Execute Workflow.

Вы увидите, как данные разделились: 2 задачи пошли вверх, 2 вниз. Затем они встретились в узле Merge, и на выходе вы получили снова 4 задачи, но теперь у каждой есть поле action, соответствующее её пути.

Частые ошибки при работе с логикой

Типы данных: Строка "100" не равна числу 100. Если API отдает число как строку, используйте преобразование типов или сравнивайте как текст.

Пустые ветки: Если после фильтрации в ветку True не попало ни одного элемента, следующие узлы в этой ветке не запустятся. Это нормальное поведение.

Merge ждет вечно: Если вы используете Merge, но логика вашего сценария такова, что данные могут пойти только по одной ветке (никогда по обеим сразу), Merge может зависнуть в ожидании второго входа. В таких случаях нужно использовать настройки «Always Output Data» или менять логику.

Заключение

Теперь вы владеете инструментами управления потоком. Вы можете разделять данные, принимать решения и собирать результаты воедино.

В следующей статье мы перейдем к одной из самых мощных возможностей n8n — «Работа с внешними API: HTTP Request, авторизация и вебхуки». Мы научимся подключать n8n к реальным сервисам, таким как Telegram, Google Sheets и Trello, чтобы автоматизация приносила реальную пользу.

Интеграции и API: отправка HTTP-запросов, настройка вебхуков и авторизация в сервисах

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

В этой статье мы разберем три кита интеграции:

HTTP Request: Как отправить данные в другой сервис (например, создать задачу в Trello или получить курс валют).

Credentials: Как безопасно хранить пароли и API-ключи.

Webhooks: Как заставить внешний сервис самому «постучаться» в n8n, когда произошло событие.

Что такое API и зачем нам HTTP-запросы?

API (Application Programming Interface) — это набор правил, по которым одна программа может общаться с другой. Представьте, что вы в ресторане. Вы (клиент) не идете на кухню готовить еду. Вы говорите официанту (API), что хотите заказать. Официант передает заказ на кухню (Сервер), забирает еду и приносит её вам.

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

!Визуализация принципа работы API: запрос от n8n и ответ от сервера

Универсальный солдат: Узел HTTP Request

В n8n есть сотни готовых узлов (Telegram, Google Sheets, Slack). Но иногда нужного сервиса нет в списке, или вам нужна функция, которую разработчики узла еще не добавили. В этом случае на помощь приходит узел HTTP Request.

Это самый мощный инструмент в вашем арсенале. С его помощью можно подключиться практически к чему угодно. Основные параметры, которые вам нужно знать:

Method (Метод): Тип действия, которое мы хотим совершить.

* GET — Получить данные (например, список пользователей). * POST — Создать новые данные (например, добавить товар). * PUT / PATCH — Обновить существующие данные. * DELETE — Удалить данные.

URL: Адрес, куда мы стучимся (например, https://api.example.com/users).

Headers (Заголовки): Служебная информация (тип контента, авторизация).

Body / Query Parameters: Сами данные, которые мы передаем.

Безопасность превыше всего: Credentials

Когда вы работаете с API, вам часто нужен ключ доступа (API Key) или токен. Новички часто совершают ошибку, вставляя этот ключ прямо в URL или заголовки внутри узла HTTP Request.

Почему так делать нельзя: * Если вы поделитесь сценарием (JSON-файлом), вы случайно отдадите свой пароль. * Если ключ изменится, вам придется искать его во всех узлах и менять вручную.

В n8n есть специальный раздел Credentials. Это безопасное хранилище.

Как это работает:

Вы создаете Credential один раз (например, для OpenAI или Google).

В узле HTTP Request в разделе Authentication вы выбираете Predefined Credential Type.

n8n сам подставит нужные заголовки при отправке запроса.

Это похоже на менеджер паролей, встроенный прямо в платформу автоматизации.

Вебхуки (Webhooks): Мгновенная реакция

До сих пор мы запускали сценарии вручную или могли бы запускать их по расписанию (Cron). Но что, если нам нужно сработать мгновенно, когда клиент оплатил заказ на сайте?

Здесь на сцену выходят Вебхуки.

Вебхук — это «обратный звонок». Вы даете сервису (например, платежной системе) специальную ссылку, сгенерированную в n8n. Как только происходит событие, сервис отправляет данные на эту ссылку, и ваш сценарий запускается автоматически.

!Схема работы вебхука: внешний сервис инициирует запуск сценария в n8n

Анатомия узла Webhook

Добавьте узел Webhook на холст. Вы увидите два типа URL:

Test URL: Используется только при настройке. Сценарий сработает, только если у вас открыт интерфейс n8n и нажата кнопка Execute Workflow. Это нужно для отладки, чтобы поймать пример данных.

Production URL: Используется в боевом режиме. Сценарий должен быть активирован (переключатель Active в правом верхнем углу). Этот URL работает 24/7 в фоновом режиме.

Важно: URL для теста и продакшена отличаются. Не забудьте поменять ссылку в настройках внешнего сервиса, когда закончите отладку!

Метод вызова

Чаще всего вебхуки используют метод POST, так как внешний сервис передает вам тело запроса (JSON с данными заказа). Убедитесь, что в настройках узла Webhook выбран правильный HTTP Method.

Практика: Создаем эхо-сервер

Давайте объединим знания и создадим сценарий, который принимает данные через вебхук, делает запрос к внешнему API и возвращает результат.

Задача: Мы отправляем n8n название криптовалюты (например, "bitcoin"), а он возвращает нам её текущую цену.

Шаг 1: Настройка триггера

Создайте новый Workflow.

Добавьте узел Webhook.

Установите HTTP Method: GET (для простоты теста через браузер).

Установите Path: crypto.

Скопируйте Test URL.

Шаг 2: Получение данных (HTTP Request)

Мы будем использовать публичный API CoinGecko (он не требует ключей).

Добавьте узел HTTP Request.

URL: https://api.coingecko.com/api/v3/simple/price.

Method: GET.

В разделе Query Parameters добавьте два параметра:

* Name: ids, Value: {{ json.query.id }} сработало, вам нужно сначала запустить узел Webhook и перейти в браузере по ссылке вида .../crypto?id=bitcoin, чтобы n8n увидел структуру входящих данных.

Шаг 3: Ответ (Webhook Respond)

По умолчанию вебхук просто отвечает "200 OK". Но мы хотим вернуть цену пользователю.

Добавьте узел Respond to Webhook (в старых версиях он мог быть частью настроек Webhook, но сейчас это отдельный узел для гибкости).

В поле Respond With выберите JSON.

В Response Body перетащите цену из выхода узла HTTP Request.

Шаг 4: Тестирование

Нажмите Execute Workflow.

Откройте браузер и вставьте ваш Test URL, добавив в конце ?id=ethereum.

В браузере вы должны увидеть JSON с ценой эфириума.

Частые ошибки при интеграциях

CORS ошибки: Если вы вызываете вебхук n8n из JavaScript кода в браузере, вы можете столкнуться с блокировкой CORS. В настройках узла Webhook есть опция Response Headers, где можно настроить Access-Control-Allow-Origin.

Таймауты: Узел HTTP Request ждет ответа определенное время. Если внешний сервис думает дольше 30 секунд, n8n может выдать ошибку. Это настраивается в опциях узла.

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

Заключение

Теперь ваш n8n — это не замкнутая система, а полноценный интеграционный хаб. Вы умеете принимать сигналы извне через Webhooks и отправлять команды другим сервисам через HTTP Request.

В следующей статье мы разберем «Трансформацию данных: работа с датами, строками и регулярными выражениями», чтобы вы могли приводить полученные из API данные в идеальный порядок перед сохранением.

Low-code возможности: написание функций на JavaScript, использование выражений и обработка ошибок

Добро пожаловать на четвертую часть нашего мастер-класса по n8n. В предыдущих статьях мы научились строить логику с помощью готовых «кубиков» — узлов IF, Merge, HTTP Request. Мы создавали линейные и разветвленные сценарии, интегрировали сервисы и передавали данные.

Но что делать, если готового кубика недостаточно? Что, если вам нужно не просто передать данные, а сложным образом их трансформировать: разбить строку по регулярному выражению, отформатировать дату в специфический формат или выполнить математический расчет, которого нет в стандартных узлах?

Здесь мы вступаем на территорию Low-code. n8n позволяет вам писать собственный JavaScript-код прямо внутри узлов. Это превращает инструмент из простого конструктора в мощную среду разработки.

В этой статье мы разберем три уровня погружения в код:

Expressions (Выражения): Быстрые формулы внутри полей.

Code Node: Написание полноценных скриптов на JavaScript.

Error Handling (Обработка ошибок): Как сделать так, чтобы сценарий не падал, когда что-то идет не так.

Expressions: Магия внутри двойных скобок

Вы уже сталкивались с выражениями, когда перетаскивали параметры из одного узла в другой. Вы видели конструкцию вида {{ json.name.charAt(0).toUpperCase() + today.toFormat('dd.MM.yyyy') }} // Или для конкретной даты из входящих данных: {{ DateTime.fromISO(json.amount * 0.2 }} javascript {{ Math.round(input.all() в новых версиях). Это массив объектов, которые пришли на вход узла.

Важный принцип: Code Node должен вернуть массив объектов. Каждый объект должен содержать свойство json.

Пример базовой структуры:

Практический пример: Разбиение текста

Допустим, вам приходит строка с тегами через запятую: "marketing, sales, urgent". Вы хотите превратить это в массив, чтобы n8n обработал каждый тег отдельно.

Код внутри узла:

После этого узла n8n запустит следующие шаги 3 раза (для каждого тега отдельно).

Использование внешних библиотек

Если вы используете Self-hosted версию n8n, вы можете разрешить использование внешних npm-пакетов (например, lodash или axios) через переменные окружения Docker. В облачной версии доступен ограниченный набор встроенных библиотек.

!Трансформация данных внутри узла Code: из одного объекта в массив

Обработка ошибок: Делаем сценарии надежными

В идеальном мире API всегда отвечают за 100мс, а данные всегда валидны. В реальности серверы падают, токены протухают, а пользователи вводят текст в числовые поля.

Если в n8n происходит ошибка (например, HTTP Request получает статус 404 или 500), выполнение сценария по умолчанию останавливается. Это не всегда приемлемо. Критически важные процессы должны уметь «переваривать» ошибки.

Стратегия 1: Continue On Fail (Продолжить при ошибке)

В настройках каждого узла (вкладка Settings) есть опция Continue On Fail.

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

* Сценарий: Мы пытаемся найти пользователя в CRM по email. * Без обработки: Если пользователя нет (404 Not Found), сценарий падает с ошибкой. * С Continue On Fail: Узел выдает ошибку, следующий IF проверяет наличие поля error. Если ошибка есть — создаем нового пользователя. Если нет — обновляем старого.

Стратегия 2: Error Trigger (Глобальный перехватчик)

Что делать, если ошибка может произойти в любом из 50 узлов сценария? Ставить проверку после каждого — утомительно.

Для этого существует специальный узел-триггер: Error Trigger.

Вы создаете отдельный Workflow, который начинается с Error Trigger. Когда любой ваш сценарий падает с ошибкой, n8n автоматически запускает этот «аварийный» сценарий.

В Error Trigger приходят данные: * В каком сценарии произошла ошибка. * В каком узле. * Текст ошибки.

Обычно этот Workflow настраивают на отправку уведомления администратору в Telegram или Slack: «Внимание! Сценарий 'Заказы' упал на узле 'Google Sheets' с ошибкой 'Invalid Credentials'».

Чтобы связать основной сценарий с аварийным, нужно зайти в настройки основного сценария (Workflow Settings) и выбрать созданный Error Workflow в поле Error Workflow.

!Принцип работы Error Workflow: перехват ошибок из основного процесса

Лучшие практики Low-code в n8n

Не усложняйте. Если задачу можно решить стандартным узлом (например, Edit Fields или Date & Time), используйте его. Код сложнее поддерживать и читать другим членам команды.

Комментируйте код. Даже если это простое выражение. Через месяц вы забудете, зачем здесь этот regex.

Проверяйте входные данные. В узле Code всегда помните, что массив items может быть пустым. Добавьте проверку if (items.length === 0) return [];.

Используйте методы массивов. map, filter, reduce — ваши лучшие друзья для обработки данных в n8n.

Заключение

Теперь вы владеете полным спектром инструментов: от простых кубиков до написания собственной логики на JavaScript и создания отказоустойчивых систем. Вы больше не ограничены возможностями интерфейса — вы ограничены только вашим знанием алгоритмов.

В следующей, заключительной статье курса, мы поговорим о «Развертывании и масштабировании». Мы обсудим, как перенести ваши сценарии на собственный сервер, настроить Docker и обеспечить безопасность данных.

Реальные кейсы: создание умного Telegram-бота и полная автоматизация бизнес-процессов

Мы прошли долгий путь. Вы научились устанавливать n8n, понимать структуру JSON, управлять ветвлением логики и интегрировать внешние API. Теперь у вас есть все необходимые кирпичики. Пришло время построить из них здание.

В этой статье мы не будем разбирать отдельные узлы. Мы займемся архитектурой. Мы создадим два полноценных продукта: умного Telegram-бота для квалификации лидов и систему согласования документов с участием живого человека (Human-in-the-loop).

Кейс №1: Умный Telegram-бот для поддержки и продаж

Многие считают, что создание бота — это программирование на Python. В n8n это визуальный процесс. Наша цель — создать бота, который не просто отвечает заготовленными фразами, а «понимает» контекст, сохраняет данные в CRM и уведомляет менеджеров.

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

Наш бот будет работать по следующему алгоритму:

Прием сообщения: Пользователь пишет в Telegram.

Анализ: Мы определяем, чего хочет пользователь (например, по ключевым словам или через AI).

Маршрутизация: Если это вопрос о цене — отвечаем автоматически. Если жалоба — создаем тикет.

Сохранение: Записываем контакт в Google Sheets (наша импровизированная CRM).

!Схема логики работы умного бота: от получения сообщения до распределения задач.

Шаг 1: Настройка Telegram Trigger

Для начала работы вам нужно создать бота через отца всех ботов — BotFather в Telegram, получить токен и добавить узел Telegram Trigger.

В настройках триггера важно выбрать, на что именно он реагирует. Обычно нас интересуют: * Updates: message * Message Type: text

Как только вы активируете сценарий, n8n автоматически установит Webhook на серверах Telegram. Теперь каждое сообщение, написанное вашему боту, будет мгновенно попадать в ваш Workflow.

Шаг 2: Логика «Свой-Чужой»

Допустим, мы хотим отсеивать спам. Добавим узел IF сразу после триггера.

Условие: {{ json.message.text.length }} Larger than* 10 — считаем, что осмысленный вопрос должен быть длиннее 10 символов.

Шаг 3: Интеграция с Google Sheets

Если сообщение прошло проверку, мы хотим сохранить пользователя. Используем узел Google Sheets -> Append or Update Row.

Это важный паттерн: Upsert (Update + Insert). Мы проверяем, есть ли уже такой chat_id в таблице. * Если есть — обновляем дату последнего сообщения. * Если нет — создаем новую строку с именем и ID клиента.

Шаг 4: Ответ пользователю

В конце цепочки обязательно должен стоять узел Telegram с операцией Send Message. Мы берем chat_id из входящего триггера и отправляем текст: «Спасибо, {{ json.messageId }}).

Webhook (Второй сценарий): Нам нужен отдельный маленький сценарий, который ловит нажатие кнопки в Telegram (Callback Query) и «дергает» Webhook из пункта 3, передавая решение (approve/reject).

Когда руководитель нажимает кнопку в Telegram, данные передаются в узел Wait, сценарий «просыпается» и продолжает выполнение по нужной ветке.

Паттерн «Sub-workflows»: Модульная архитектура

Когда вы начнете создавать сложные системы, ваш холст превратится в «спагетти» из сотен узлов. Этой системой невозможно управлять.

Решение: Execute Workflow (Выполнить сценарий).

Вы разбиваете огромный процесс на маленькие логические блоки:

Main Workflow: Дирижер. Он принимает данные и решает, кого вызвать.

Sub-Workflow 1 (Enrichment): Получает email, ищет данные о компании в интернете, возвращает результат.

Sub-Workflow 2 (CRM): Отвечает только за создание сделки в Pipedrive/HubSpot.

Преимущества модульности:

* Повторное использование: Сценарий «Отправка уведомления в Slack» можно вызывать из 10 разных процессов. * Отладка: Если сломалась запись в CRM, вы чините только один маленький сценарий, не трогая основную логику. * Читаемость: Главный сценарий выглядит как простой список шагов, а не как схема атомного реактора.

Масштабирование и Production-режим

Вы создали бота, настроили согласования. Как убедиться, что это будет работать стабильно?

1. Разделение сред (Dev / Prod)

Никогда не редактируйте активный сценарий, который обслуживает клиентов. * Используйте Tags для пометки сценариев (например, prod, dev`). * В n8n есть возможность экспортировать сценарии в JSON. Храните резервные копии в Git или хотя бы в отдельной папке.

2. Управление секретами

Если вы передаете сценарий заказчику или коллеге, убедитесь, что в узлах HTTP Request не прописаны API-ключи открытым текстом. Всегда используйте раздел Credentials. При экспорте сценария Credentials не экспортируются, что сохраняет ваши доступы в безопасности.

3. Мониторинг

Мы говорили об Error Trigger в прошлой статье. Для бизнес-процессов это обязательно. Создайте единый журнал ошибок в Google Таблице или специальном канале Slack. Каждая ошибка должна быть зафиксирована.

Заключение курса

Поздравляю! Вы прошли путь от новичка до архитектора автоматизации.

Мы изучили: * Как мыслить потоками данных и JSON-объектами. * Как управлять логикой с помощью IF и Merge. * Как общаться с внешним миром через API и Webhooks. * Как писать код там, где не хватает стандартных инструментов. * И сегодня — как собирать это в реальные бизнес-продукты.

n8n — это инструмент с бесконечным потенциалом. Лучший способ продолжить обучение — это практика. Найдите рутинную задачу в своей работе прямо сейчас и поручите её роботу.

> Автоматизация — это привычка. Как только вы начнете видеть процессы как алгоритмы, вы уже не сможете работать по-старому.

Удачи в ваших проектах!