Основы n8n: workflow, данные, credentials и executions ¶

Обновлено: 2026-05-29

Этот раздел превращает n8n из набора кнопок в понятную систему. Почти любой сценарий можно разложить на одни и те же блоки: trigger получает событие, ноды нормализуют JSON, условия направляют items по веткам, действия меняют данные во внешних сервисах, а executions помогают понять, что произошло при запуске.

Карта раздела ¶

• Работа с данными — items, JSON, массивы и нормализация.
• Выражения — $json, $node, даты, fallback и условия.
• Логика workflow — IF, Switch, Merge и fallback-ветки.
• Credentials — API keys, OAuth и безопасное хранение секретов.
• Executions — история запусков, retry и диагностика.
• Item linking — почему после Code/Merge иногда теряются предыдущие данные.
• Обработка ошибок — Error Trigger, алерты и логи.

Как проектировать workflow ¶

Перед сборкой ответьте на четыре вопроса: что запускает сценарий, какие данные приходят на вход, какие условия меняют маршрут и что считается успешным завершением. Если хотя бы один вопрос неясен, workflow быстро станет хрупким.

Хороший базовый шаблон выглядит так: Trigger → Normalize → Validate → Route → Action → Log → Error handling. Такой порядок проще отлаживать и расширять.

Имена нод и структура ¶

Называйте ноды по действию: Normalize Lead, Validate Email, Create CRM Deal, Send Telegram Alert. Названия Set, HTTP Request1 и IF2 мешают поддержке и увеличивают риск ошибок в выражениях с $node.

Как избежать хаоса ¶

Стабилизируйте названия полей: email, phone, source, status, created_at. Не протаскивайте сырой ответ API через весь workflow, а приводите его к понятному формату сразу после trigger или HTTP Request.

Что читать дальше ¶

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

Чеклист внедрения ¶

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

• Ноды названы по действию, а не по типу.
• Входные данные нормализованы в начале workflow.
• Есть fallback для неожиданных статусов и пустых полей.
• Ошибки пишутся в execution и при необходимости отправляются в alert.

Как понять, что тема нужна ¶

Если одна и та же проблема повторяется в нескольких workflow, лучше оформить её как отдельный шаблон: нормализация входа, проверка credentials, обработка ошибки или типовой фрагмент выражения. Так база знаний становится не набором заметок, а рабочей системой поддержки n8n.