Документация. n8n

A longer introduction

Ваш первый workflow

Это руководство покажет, как создать workflow в n8n, объясняя по пути ключевые концепции.
Вы научитесь:

  • Создавать workflow с нуля.

  • Понимать ключевые концепции и навыки, включая:

    • Запуск workflow с помощью trigger-узлов

    • Настройку учётных данных (credentials)

    • Обработку данных

    • Представление логики внутри workflow n8n

    • Использование выражений (expressions)

(“Скриншот готового workflow”)

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

Шаг первый: создайте новый workflow

При открытии n8n вы увидите либо:

  • Окно с приветственным сообщением и двумя большими кнопками: выберите Start from Scratch, чтобы создать новый workflow.

  • Список Workflow на странице Overview. Выберите Create Workflow, чтобы создать новый workflow.

Шаг второй: добавьте trigger-узел

n8n позволяет запускать workflow двумя способами:

  • Вручную — с помощью Test Workflow.

  • Автоматически — с помощью trigger-узла (первая node). Trigger-узел запускает workflow в ответ на внешнее событие или по заданному расписанию.

В этом примере мы используем Schedule trigger, чтобы запускать workflow по расписанию:

  1. Выберите Add first step.

  2. Введите в поиск Schedule. n8n покажет подходящие узлы.

  3. Выберите Schedule Trigger, чтобы добавить узел на рабочее поле. n8n откроет настройки узла.

  4. В поле Trigger Interval выберите Weeks.

  5. В поле Weeks Between Triggers введите 1.

  6. Укажите время и день. Для примера выберите Monday в Trigger on Weekdays, 9am в Trigger at Hour, и 0 в Trigger at Minute.

  7. Закройте окно настроек узла, чтобы вернуться на рабочее поле.

Шаг третий: добавьте узел NASA и настройте credentials

Узел NASA взаимодействует с публичными API NASA и получает полезные данные.
В этом примере мы будем использовать API для поиска солнечных вспышек.

Настройка credentials:

  1. Нажмите Add node (значок добавления node) на узле Schedule Trigger.

  2. Введите в поиск NASA. n8n покажет подходящие узлы.

  3. Выберите NASA, чтобы увидеть список операций.

  4. Найдите и выберите Get a DONKI solar flare. Эта операция возвращает отчёты о недавних солнечных вспышках. При выборе операции n8n добавит узел и откроет его.

Для доступа к API NASA необходимо настроить credentials:

  1. В поле Credential for NASA API выберите Create new credential. n8n откроет окно создания credentials.

  2. Перейдите на страницу NASA API (по ссылке Generate API Key) и создайте API-ключ. Сайт NASA отправит ключ на вашу почту.

  3. Скопируйте полученный API-ключ из письма и вставьте его в поле API Key в n8n.

  4. Нажмите Save.

  5. Закройте окно credentials. Новый ключ будет автоматически выбран в поле Credential for NASA API.

По умолчанию DONKI Solar Flare возвращает данные за последние 30 дней. Чтобы ограничить их последней неделей, используйте Additional Fields:

  1. Выберите Add field.

  2. Выберите Start date.

  3. Чтобы задать дату неделю назад, используйте выражение: рядом с полем Start date выберите вкладку Expression, затем разверните редактор выражений.

  4. Введите следующее выражение:

bash
{{ $today.minus(7, 'days') }}

Оно сгенерирует дату за 7 дней до текущей.

Теперь проверьте, работает ли узел:

  1. Выберите Execute step, чтобы вручную запустить узел.
    n8n вызовет API NASA и отобразит данные о вспышках за последние 7 дней в разделе OUTPUT.

  2. Закройте узел NASA, чтобы вернуться на рабочее поле.

Шаг четвёртый: добавьте логику с помощью узла If

n8n поддерживает сложную логику в workflow.
В этом примере мы используем узел If, чтобы создать два ветвления — одно для более слабых вспышек, другое для более сильных.

Добавление узла If:

  1. Нажмите Add node (значок добавления node) на узле NASA.

  2. Введите в поиск If.

  3. Выберите If, чтобы добавить узел.

Теперь проверим значение свойства classType в данных NASA:

  • Перетащите поле classType в Value 1.

⚠️ Убедитесь, что вы предварительно выполнили узел NASA, иначе данных для выбора не будет.

  • Измените тип сравнения на String > Contains.

  • В поле Value 2 введите X.
    Это самый высокий класс солнечных вспышек.

Проверьте работу узла:

  • Выберите Execute step, чтобы вручную запустить узел.
    n8n проверит условие и отобразит, какие результаты соответствуют true, а какие — false.

💡 Примечание: если нет вспышек класса X, попробуйте вместо X ввести A, B, C или M.

После проверки закройте узел If.

Шаг пятый: вывод данных из workflow

Последний шаг — отправка отчётов о солнечных вспышках.
В этом примере мы отправим данные в Postbin — сервис, который показывает полученные данные на временной веб-странице.

  1. На узле If, нажмите Add node на ветке true.

  2. Введите в поиск PostBin.

  3. Выберите PostBin.

  4. Выберите Send a request. n8n добавит узел.

Перейдите на сайт Postbin и создайте новый Bin.
Оставьте вкладку открытой для проверки результата.

  • Скопируйте Bin ID (например, 1651063625300-2016451240051).

  • Вставьте его в поле Bin ID в узле Postbin.

Настройка содержимого для отправки:

  • Рядом с полем Bin Content выберите вкладку Expression, затем разверните редактор выражений.

  • Перетащите поле classType из вывода узла If в редактор.
    В редакторе появится ссылка вида:

bash
{{$json["classType"]}}

Добавьте сообщение:

php
There was a solar flare of class {{$json["classType"]}}

Закройте редактор выражений.

Закройте узел Postbin.

Добавьте ещё один узел Postbin для ветки false:

  • Наведите мышь на первый узел Postbin, затем выберите Duplicate node в меню узла.

  • Перетащите коннектор false из узла If на новый узел Postbin.

Шаг шестой: тестирование workflow

Теперь вы можете протестировать весь workflow.

  • Выберите Test Workflow.
    n8n запустит workflow и отобразит прогресс на каждом этапе.

  • Перейдите на ваш Postbin и обновите страницу, чтобы увидеть результат.

Если вы хотите, чтобы этот workflow работал автоматически раз в неделю — активируйте его, включив переключатель Active.

⚠️ Ограничение времени: бин в Postbin действует 30 минут после создания.
Если время истекло — создайте новый бин и обновите Bin ID в узлах Postbin.

Поздравляем 🎉

Теперь у вас есть полностью рабочий workflow, который делает полезную задачу!
Он должен выглядеть примерно так:

(Click to explore / View workflow file — ссылка на просмотр workflow.)

В процессе вы узнали:

  • Как находить нужные узлы и соединять их

  • Как использовать выражения для обработки данных

  • Как создавать credentials и подключать их к узлам

  • Как реализовать логику в workflow

Что можно улучшить:

  • Добавить ещё credentials и узел для отправки email с результатами.

  • Или использовать этот подход в своём проекте.

Следующие шаги

  • Интересно, что можно сделать с ИИ? Узнайте, как создать чат-агента на базе ИИ с помощью n8n.

  • Пройдите текстовые курсы или видеокурсы n8n.

  • Изучите дополнительные примеры в библиотеке шаблонов workflow.