N8N с нуля: полный гайд для новичков — автоматизация, AI-агенты и Telegram-бот

В 2026 году N8N — главная платформа для создания AI-агентов: гибкая, открытая, без ограничений по выбору моделей и хранению данных. Практические примеры применения: голосовые заметки в Notion через Telegram, личный AI-секретарь, автоответчик в почте, отдел продаж, поддержка на сайте, контент-завод для соцсетей.

Подходы к автоматизации: от кода до агентов

• Код — максимальная гибкость, но требует знания Python или вайб-кодинга; риски нестабильной архитектуры.
• No-code — простота, но ограниченное «меню» без возможности кастомизации.
• Low-code (N8N) — золотая середина: 90% работы мышью, недостающее закрывается микроскриптами или HTTP-запросами.
• AI-агенты — максимальная гибкость и «магия», но дорого, непредсказуемо и рискованно без правильной архитектуры.
• Золотое правило: там, где задачу можно решить без AI — решаем без AI. Это даёт предсказуемость, экономию и скорость.

Сравнение трёх подходов на практике

• Задача: получить «Hello САША» из {name: «Саша»} тремя способами.
• Нода Set + встроенный метод — 1 минута, 1 нода, 13 символов.
• Нода Code + JavaScript — 2 минуты, 7 строк кода.
• AI-агент — 10 минут, 4 ноды, 14 строк промта.
• Вывод: начинать изучение N8N нужно с базовых нод, а не с агентов.

Варианты установки и развёртывания N8N

• Облако (Cloud) — просто, быстро, но платно (от $20/мес + налоги, лимит 2 500 запусков). Есть незначительные ограничения: нет глобальных переменных, нет интеграции с GitHub из коробки.
• Self-hosted на сервере — бесплатно, полная свобода настроек. Два пути: кнопочная установка (проще) или терминал (гибче).
• Self-hosted на локальном ПК — удобно для разработки, но компьютер должен работать постоянно; нет публичного URL для входящих вебхуков (Telegram и др.).

Интерфейс N8N: ключевые разделы

• Overview / Personal — режимы отображения Workflow; в Personal доступны папки.
• AI Chat — встроенный чат с поддержкой разных провайдеров (OpenAI, DeepSeek, Gemini и др.); можно переключаться между моделями внутри одного диалога.
• Templates — библиотека готовых Workflow; можно вставлять шаблоны через Ctrl+V прямо в редактор.
• Executions — история запусков с детализацией по каждой ноде.
• Settings — настройки инстанса: пользователи, Community Nodes, MCP, N8N API (только self-hosted).

Работа с Workflow и нодами

• Workflow — визуальное полотно из нод. Ноды добавляются через «+», Tab или перетаскиванием из хвоста предыдущей ноды.
• Типы нод: триггеры (запускают процесс) и action-ноды (обрабатывают данные). Всего 1 000+ нод, из них ~400 интеграций и ~30 AI-нод.
• Горячие клавиши: Tab — новая нода, L — открыть чат, Ctrl+Z — отмена, Ctrl+C/V — копирование нод и целых Workflow.
• Pin-данные — закрепление результата ноды для тестирования без повторного выполнения (экономит деньги на API-запросах).
• История версий — откат к предыдущей рабочей версии; рекомендуется подписывать каждую публикацию.
• Sticky notes — заметки прямо на полотне для документации Workflow.

Типы данных и формат JSON

• JSON — стандартный формат передачи данных между сервисами: фигурные скобки, ключ-значение.
• Типы данных: string (текст), number (число), boolean (true/false), null (пустота), undefined (поле не найдено), array (массив — квадратные скобки), object/dictionary (объект — фигурные скобки).
• Items (айтемы) — объекты внутри массива; каждая нода обрабатывает айтемы по очереди и возвращает массив обработанных результатов.
• Binary-данные — файлы (изображения, PDF, аудио); передаются отдельно от JSON и требуют специальной обработки.

Работа с AI-агентами в N8N

• Нода Agent — универсальный каркас; обязательно требует подключения модели, опционально — памяти и инструментов.
• Модели: поддерживаются OpenAI, Anthropic, Google, Deepseek и др. Удобный агрегатор — OpenRouter (оплата в $ с комиссией 5,5%) или Польза AI (рублёвые карты, 400+ моделей по одному ключу).
• Память агента:
  • Кратковременная (контекст) — вся переписка передаётся в модель при каждом запросе; по мере роста диалога модель «тупеет» из-за ограничений контекстного окна.
  • Долговременная (RAG) — векторная база данных; агент извлекает только релевантные фрагменты под конкретный запрос через эмбеддинги.
• Системный промт — задаёт роль и личность агента; настраивается в разделе Options внутри ноды Agent.

Credentials (учётные данные)

• API-ключ — основной способ подключения сервисов (Telegram, нейронки, внешние API).
• OAuth 2.0 — для сервисов Google и подобных; N8N получает временный токен доступа, не зная пароля пользователя.

Практика: создание Telegram-бота с AI-агентом

1. Создать бота через @BotFather в Telegram, получить токен.
2. Добавить Telegram Trigger в N8N, вставить токен в Credentials.
3. Подключить ноду Agent с нужной моделью и Simple Memory; передать в агента поле message.text и session ID из message.from.id.
4. Добавить ноду Switch для маршрутизации: команда /start → приветствие, остальное → агент.
5. Ограничить доступ к боту через опцию Restrict to User IDs в триггере.
6. Добавить ноду Telegram → Send Message для ответа; отключить Attribution («работает на N8N»).
7. Опубликовать Workflow — переключиться с тестового режима на продовый.

Полезные инструменты и дополнения

• Community Nodes — ноды от сообщества (600+); устанавливаются через Settings → Community Nodes. Работают хуже нативных, но расширяют возможности.
• Data Tables — встроенная база данных N8N: нечто среднее между БД и Google Таблицами.
• Instance-level MCP — открывает доступ к Workflow для внешних AI-агентов (Cursor, Claude Code и др.).
• N8N API (self-hosted) — управление самим N8N через API: создание Workflow, настройка бэкапов.
• Встроенные переменные — доступны через ${ }; например, $now — текущая дата и время.
• Evaluation — инструмент для тестирования и сравнения промтов и моделей (для продвинутых пользователей).

Видео