N8n: шпаргалка по автоматизации и AI-агентам

Короче: n8n — это open-source альтернатива Zapier/Make, которую вы разворачиваете у себя. Автоматизация всего: боты Telegram, интеграции API, AI-агенты на ChatGPT/Claude, обработка данных, мониторинг. Визуальный редактор workflow, 400+ готовых нод, можно писать свой код на JavaScript. Бесплатно, без лимитов, данные у вас.

Эта шпаргалка — для тех, кто устал платить $500/месяц за Zapier, хочет автоматизировать рутину, создать AI-бота поддержки, интегрировать 10 разных API и наконец перестать делать одно и то же руками 100 раз в день.

Концепция: зачем n8n и почему это круто

Как это было раньше и почему это боль

Сценарий 1: Автоматизация без n8n

1. Начальник: «Сделай так, чтобы при новой заявке в Jira создавалась задача в Trello, отправлялось уведомление в Slack и письмо клиенту»
2. Вы: «Окей, напишу скрипт на Python
3. 3 дня написания кода
4. 2 дня отладки webhooks
5. 1 день борьбы с OAuth
6. Скрипт готов, работает
7. Через месяц API изменился — скрипт сломался
8. Вы переписываете скрипт
9. Коллега спрашивает: «А можно ещё в Discord отправлять?»
10. Вы начинаете пить

Сценарий 2: Zapier/Make (платные сервисы)

1. Регистрируетесь на Zapier
2. Создаёте первую автоматизацию — работает отлично!
3. Создаёте вторую, третью, десятую
4. Получаете счёт: $500/месяц
5. Просите у руководства бюджет
6. Руководство: «Это что, подписка? За автоматизацию? Напиши скрипт!»
7. См. Сценарий 1

Сценарий 3: Делаете всё руками

1. Пришла заявка в почту
2. Копируете текст
3. Открываете Jira → создаёте задачу → вставляете текст
4. Открываете Trello → создаёте карточку → вставляете текст
5. Открываете Slack → пишете в канал
6. Открываете почту → отвечаете клиенту
7. Пришла вторая заявка
8. Повторяете п. 1-6
9. 100 заявок спустя вы — робот, но без зарплаты робота

Как это с n8n (сейчас)

Тот же сценарий с n8n:

1. Открываете n8n
2. Тащите ноды мышкой:
   • Webhook (триггер при новой заявке)
   • Jira (создать задачу)
   • Trello (создать карточку)
   • Slack (отправить сообщение)
   • Email (отправить письмо)
3. Соединяете стрелочками
4. Тестируете
5. Активируете workflow
6. Идёте пить кофе
7. Автоматизация работает вечно
8. Коллега: «А можно в Discord?» — тащите ноду Discord, соединяете, готово (5 минут)

Время:

• Скрипт на Python: 3-7 дней разработки + поддержка
• Zapier: 30 минут + $500/месяц
• Руками: 5 минут на заявку × 100 заявок = 8 часов
• n8n: 30 минут один раз, потом работает само, бесплатно

Почему n8n — это революция

1. Open-source и self-hosted = бесплатно навсегда

Zapier:

• 100 задач/месяц — бесплатно (смешно)
• 750 задач — $19.99/месяц
• 2000 задач — $49/месяц
• 50,000 задач — $599/месяц
• ∞ задач — «call us» (страшно)

n8n:

• ∞ задач — $0 (разворачиваете у себя)
• ИЛИ cloud версия — от $20/месяц (но можно и бесплатно на своём сервере)

2. Ваши данные остаются у вас

С Zapier все данные идут через их серверы. API ключи, токены, личные данные клиентов — всё у них.

С n8n всё работает на вашем сервере. Никаких внешних передач. Compliance, GDPR, PCI DSS — без проблем.

3. Визуальный редактор + код когда нужно

90% задач — просто соединяешь ноды мышкой. Как в Scratch для детей, но для взрослых автоматизаций.

10% сложных задач — можно писать JavaScript прямо в ноде. Full power когда нужно.

4. 400+ готовых интеграций (nodes)

• Google (Sheets, Drive, Calendar, Gmail)
• Slack, Discord, Telegram
• Databases (PostgreSQL, MySQL, MongoDB)
• CRM (Salesforce, HubSpot)
• AI (OpenAI, Anthropic Claude, Hugging Face)
• AWS, Azure, Google Cloud
• И ещё 380+ сервисов

Нет нужной интеграции? Пишете HTTP Request ноду — работает с любым API.

5. AI-агенты из коробки

n8n встроил поддержку AI агентов:

• Подключаешь OpenAI/Claude
• Добавляешь Tools (действия, которые может делать агент)
• Агент сам выбирает какие tools использовать для решения задачи
• Получается AI-ассистент, который может реально что-то делать, а не только болтать

Например: AI-агент для поддержки, который может:

• Отвечать на вопросы (LLM)
• Проверять статус заказа (API интеграция)
• Создавать тикет если не может помочь (Jira/Zendesk)
• Отправлять email с деталями (SMTP)

Всё это — визуально, без программирования сложных цепочек.

6. Шаблоны workflow от комьюнити

Не хочется создавать с нуля? Берёте готовый шаблон:

• Telegram бот с ChatGPT
• Автоматический парсинг email и создание задач
• Мониторинг сайтов и алерты в Slack
• Бэкапы баз данных в Google Drive
• RSS → Telegram channel автопостинг

Тысячи готовых шаблонов на n8n.io/workflows

Когда использовать n8n

Идеально подходит для:

• Автоматизация рутины — всё, что делаете руками больше 2 раз
• Интеграции между системами — соединяете CRM, почту, Slack, базы данных
• AI-боты и агенты — поддержка, ассистенты, чат-боты
• Обработка данных — парсинг, трансформация, загрузка в БД
• Мониторинг и алерты — проверка API, статуса серверов, цен
• Marketing automation — email рассылки, lead scoring
• DevOps автоматизация — CI/CD триггеры, deployment уведомления

Может быть избыточен для:

• Одноразовых задач — проще написать curl запрос
• Real-time обработки — n8n не для высоконагруженных систем (хотя справляется с тысячами workflow)
• Очень специфичной логики — иногда проще написать полноценный сервис

Когда это использовать

Реальные кейсы:

• Бот поддержки в Telegram — клиенты пишут, AI отвечает, сложные вопросы в тикет-систему
• Автоматизация продаж — новый лид в CRM → создаёт задачу менеджеру → отправляет welcome email
• Мониторинг цен конкурентов — парсит сайты → сравнивает → уведомляет в Slack если цена изменилась
• Бэкапы и отчёты — каждую ночь выгружает данные из БД в Google Sheets
• Social media автоматизация — новый пост в блоге → автопостинг в Twitter, LinkedIn, Telegram
• HR автоматизация — новый сотрудник → создаёт аккаунты, отправляет инструкции, добавляет в группы
• IoT и smart home — датчики → обработка → действия (свет, уведомления)

Типовые ситуации:

• Каждый день вручную копируете данные из одной системы в другую
• Платите сотни долларов за Zapier/Integromat
• Нужен чат-бот, но Dialogflow слишком сложный
• Хотите AI-агента, который может реально что-то делать, а не только болтать
• Интегрируете 5+ сервисов, которые не умеют говорить друг с другом
• Нужна автоматизация, но нет времени писать код

Ошибки новичков:

• Запускают n8n без Docker — возня с зависимостями
• Не настраивают переменные окружения — креды хардкодят в workflow
• Забывают про обработку ошибок — workflow падает при первой проблеме
• Не используют ready-made шаблоны — изобретают велосипед
• Запускают всё на localhost — забывают про webhooks извне
• Не делают бэкапы workflow — потеря при переустановке

Быстрый старт

Установка n8n через Docker (рекомендуется)

# Простейший запуск (для теста)
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

# Открываем браузер
# http://localhost:5678

Production запуск с docker-compose:

# Создаём docker-compose.yml
mkdir n8n && cd n8n
nano docker-compose.yml

version: '3.8'

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=your_secure_password
      - N8N_HOST=n8n.yourdomain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://n8n.yourdomain.com/
      - GENERIC_TIMEZONE=Europe/Moscow
    volumes:
      - ./n8n_data:/home/node/.n8n
      - ./local_files:/files

# Запускаем
docker-compose up -d

# Проверяем
docker-compose logs -f n8n

Первый workflow за 5 минут

1. Открываем n8n: http://localhost:5678
2. Создаём аккаунт
3. New Workflow
4. Добавляем ноды:
   • Schedule Trigger (триггер по расписанию)
   • HTTP Request (запрос к API)
   • Set (обработка данных)
   • Slack (отправка сообщения)
5. Соединяем их стрелочками
6. Настраиваем каждую ноду
7. Тестируем (кнопка «Test workflow»)
8. Сохраняем и активируем

Пример: Ежедневная сводка погоды в Slack

Schedule Trigger (каждый день в 8:00)
    ↓
HTTP Request (получаем погоду с API)
    ↓
Set (форматируем данные)
    ↓
Slack (отправляем в канал #general)

Установка n8n

Способ 1: Docker (рекомендуется)

Минимальный запуск:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Production с PostgreSQL:

version: '3.8'

services:
  postgres:
    image: postgres:15
    container_name: n8n-postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: n8n_password
      POSTGRES_DB: n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -U n8n']
      interval: 5s
      timeout: 5s
      retries: 10

  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=n8n_password
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=SecurePassword123!
      - N8N_HOST=n8n.example.com
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://n8n.example.com/
      - GENERIC_TIMEZONE=Europe/Moscow
      - N8N_METRICS=true
    volumes:
      - ./n8n_data:/home/node/.n8n
      - ./local_files:/files

volumes:
  postgres_data:

# Запуск
docker-compose up -d

# Логи
docker-compose logs -f n8n

# Обновление
docker-compose pull
docker-compose up -d

Способ 2: npm (для разработки)

# Установка Node.js (если нет)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs -y

# Установка n8n глобально
npm install n8n -g

# Запуск
n8n

# Открываем http://localhost:5678

Способ 3: n8n Cloud (managed)

Если не хочется заморачиваться с хостингом:

1. Идём на https://n8n.io
2. Sign Up
3. Выбираем план (есть бесплатный)
4. Получаем готовый n8n

Цены n8n Cloud:

• Free: 20 workflows, 2,500 executions/month
• Starter: $20/month — unlimited workflows, 10,000 executions
• Pro: $50/month — 50,000 executions + advanced features

Настройка HTTPS через Nginx

# Устанавливаем Nginx
sudo apt install nginx certbot python3-certbot-nginx -y

# Создаём конфиг
sudo nano /etc/nginx/sites-available/n8n

server {
    listen 80;
    server_name n8n.example.com;

    location / {
        proxy_pass http://localhost:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket support
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

# Включаем конфиг
sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# Получаем SSL сертификат
sudo certbot --nginx -d n8n.example.com

# Автообновление сертификата
sudo certbot renew --dry-run

Основы работы с n8n

Структура workflow

Workflow в n8n состоит из нод (nodes), соединённых стрелками.

Типы нод:

• Trigger Nodes — запускают workflow (Webhook, Schedule, Email Trigger)
• Action Nodes — выполняют действия (HTTP Request, Database, Slack)
• Logic Nodes — управление потоком (IF, Switch, Merge)
• Data Nodes — обработка данных (Set, Code, Function)

Пример простого workflow:

Webhook Trigger (получаем HTTP POST)
    ↓
Set (извлекаем нужные поля)
    ↓
HTTP Request (отправляем в другой API)
    ↓
Slack (уведомляем в Slack)

Создание первого workflow

1. New Workflow → пустой canvas
2. Нажимаем + → выбираем Schedule Trigger
3. Настраиваем: «Every day at 9:00 AM»
4. Нажимаем + после триггера → HTTP Request
5. Настраиваем:
   • Method: GET
   • URL: https://api.chucknorris.io/jokes/random
6. Нажимаем + → Slack
7. Настраиваем:
   • Operation: Post Message
   • Channel: #random
   • Text: {{$json["value"]}} (Chuck Norris шутка)
8. Execute Workflow (тест)
9. Save → Active (включаем)

Теперь каждый день в 9:00 в Slack будет приходить шутка про Чака Норриса.

Работа с данными (Expressions)

n8n использует выражения для доступа к данным:

// Данные из предыдущей ноды
{{$json["field_name"]}}

// Несколько уровней вложенности
{{$json["user"]["email"]}}

// Данные из конкретной ноды
{{$node["HTTP Request"].json["result"]}}

// Переменные окружения
{{$env["API_KEY"]}}

// Текущая дата
{{$now}}

// Форматирование даты
{{$now.format("YYYY-MM-DD")}}

// JavaScript выражения
{{new Date().getFullYear()}}

// Условия
{{$json["status"] === "active" ? "Yes" : "No"}}

Основные ноды

Trigger Nodes:

• Webhook — HTTP endpoint для внешних систем
• Schedule Trigger — запуск по расписанию (cron-like)
• Email Trigger (IMAP) — при получении email
• Telegram Trigger — при сообщении в Telegram
• Manual Trigger — ручной запуск (для тестирования)

Популярные Action Nodes:

• HTTP Request — запрос к любому API
• Code — JavaScript/Python код
• Set — установка/изменение полей данных
• IF — условное ветвление
• Switch — множественное ветвление
• Merge — объединение данных из разных веток
• Loop Over Items — цикл по массиву

Интеграции:

• Slack — отправка сообщений, создание каналов
• Telegram — боты, отправка сообщений
• Google Sheets — чтение/запись в таблицы
• PostgreSQL/MySQL — работа с БД
• Gmail — отправка/чтение писем
• OpenAI — ChatGPT, DALL-E
• Anthropic — Claude

Создание AI-агентов в n8n

Что такое AI Agent в n8n

AI Agent — это LLM (ChatGPT, Claude), который может использовать Tools для выполнения действий.

Обычный чат-бот:

Пользователь: "Какой статус заказа #12345?"
Бот: "Извините, я не могу проверить статус заказов"

AI Agent:

Пользователь: "Какой статус заказа #12345?"
Agent: [использует Tool "Check Order Status"]
Agent: "Заказ #12345 отправлен. Трек-номер: ABC123. Ожидается доставка 15 февраля."

Создание простого AI-агента

Пример: AI Customer Support Bot

1. New Workflow
2. Добавляем Chat Trigger (для тестирования в UI)
3. Добавляем AI Agent ноду
4. Настраиваем AI Agent:
   • Model: OpenAI ChatGPT-4
   • Credentials: добавляем OpenAI API Key
   • System Message: «You are a helpful customer support agent»
5. Добавляем Tools:
   • HTTP Request Tool — проверка статуса заказа
   • Database Tool — поиск информации о клиенте
   • Email Tool — отправка письма
6. Тестируем через встроенный чат

Подключение OpenAI

# В n8n интерфейсе:
# Settings → Credentials → Add Credential → OpenAI

# Заполняем:
# API Key: sk-...
# Organization ID: (опционально)

Использование в workflow:

1. Добавляем ноду OpenAI
2. Выбираем Operation: Chat
3. Model: gpt-4-turbo или gpt-3.5-turbo
4. Messages:

   
   [
     {
       "role": "system",
       "content": "You are a helpful assistant"
     },
     {
       "role": "user",
       "content": "{{$json['user_message']}}"
     }
   ]
   

Подключение Anthropic Claude

# Credentials → Add → HTTP Header Auth

# Header Name: x-api-key
# Header Value: ваш Anthropic API key
# Также: Content-Type: application/json

HTTP Request к Claude API:

// HTTP Request нода
Method: POST
URL: https://api.anthropic.com/v1/messages

Headers:
  x-api-key: {{$env['ANTHROPIC_API_KEY']}}
  anthropic-version: 2023-06-01
  content-type: application/json

Body:
{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "{{$json['question']}}"
    }
  ]
}

AI Agent с множественными tools

Пример: AI Ассистент с доступом к БД, API и Email

Telegram Trigger
    ↓
AI Agent (Claude)
    ├─ Tool 1: Database Query (PostgreSQL) — поиск клиента
    ├─ Tool 2: HTTP Request — проверка заказа через API
    ├─ Tool 3: Send Email — отправка письма
    └─ Tool 4: Create Ticket (Jira) — создание тикета
    ↓
Telegram (отправка ответа)

AI Agent сам решает какие tools использовать на основе вопроса пользователя.

RAG (Retrieval-Augmented Generation)

Добавляем AI агенту доступ к базе знаний:

1. Загружаем документы (PDF, txt, markdown)
2. Создаём embeddings (векторизация)
3. Сохраняем в Vector DB (Pinecone, Qdrant, Weaviate)
4. AI Agent ищет релевантные документы перед ответом

Workflow:

User Question
    ↓
Vector Store (поиск похожих документов)
    ↓
AI Agent (использует найденные документы как контекст)
    ↓
Response

Создание Telegram ботов

Простой Telegram бот

1. Создаём бота через @BotFather в Telegram
2. Получаем token
3. В n8n:
   • Credentials → Telegram API → вставляем token
   • New Workflow
   • Telegram Trigger → On Message
   • Set (обработка сообщения)
   • Telegram (отправка ответа)

Пример: Echo Bot

Telegram Trigger
    ↓
Set
  message_text = {{$json["message"]["text"]}}
  chat_id = {{$json["message"]["chat"]["id"]}}
    ↓
Telegram (Send Message)
  Chat ID: {{$json["chat_id"]}}
  Text: "Вы написали: {{$json['message_text']}}"

Telegram бот с AI

Telegram Trigger
    ↓
OpenAI (Chat)
  User Message: {{$json["message"]["text"]}}
    ↓
Telegram (Send Message)
  Text: {{$json["choices"][0]["message"]["content"]}}

Telegram бот с командами

Telegram Trigger
    ↓
Switch (по команде)
  Case 1: /start → приветствие
  Case 2: /help → справка
  Case 3: /price → получение цены
  Case 4: Default → AI ответ
    ↓
Telegram (Send Message)

Telegram бот с кнопками (Inline Keyboard)

// Telegram нода, Send Message
Chat ID: {{$json["chat_id"]}}
Text: "Выберите действие:"
Reply Markup:
{
  "inline_keyboard": [
    [
      {"text": "✅ Да", "callback_data": "yes"},
      {"text": "❌ Нет", "callback_data": "no"}
    ],
    [
      {"text": "ℹ️ Подробнее", "callback_data": "info"}
    ]
  ]
}

Обработка нажатий:

Telegram Trigger (On Callback Query)
    ↓
Switch
  Case: {{$json["callback_query"]["data"]}} = "yes"
  Case: {{$json["callback_query"]["data"]}} = "no"
  Case: {{$json["callback_query"]["data"]}} = "info"
    ↓
Telegram (Answer Callback Query + Send Message)

Готовые шаблоны (Templates)

Где найти шаблоны

• Официальная библиотека: https://n8n.io/workflows/
• GitHub: Community workflows
• Внутри n8n: Templates → Browse Templates

Популярные шаблоны

1. RSS to Telegram/Slack

Автоматический постинг новостей из RSS в мессенджеры.

RSS Feed Trigger
    ↓
Set (форматирование)
    ↓
Telegram/Slack (отправка)

2. Email to Task (Gmail → Jira/Trello)

Автоматическое создание задач из писем.

Gmail Trigger (новое письмо)
    ↓
OpenAI (извлечение сути письма)
    ↓
Jira (создание задачи)
    ↓
Gmail (ответ с номером задачи)

3. Website Monitor → Slack Alert

Мониторинг сайта и уведомления при изменениях.

Schedule Trigger (каждые 5 минут)
    ↓
HTTP Request (проверка сайта)
    ↓
IF (код != 200)
    ↓ true
Slack (алерт)

4. Automated Backups to Google Drive

Schedule Trigger (каждый день в 3:00)
    ↓
PostgreSQL (dump database)
    ↓
Compress (zip файл)
    ↓
Google Drive (загрузка)
    ↓
Slack (уведомление об успехе)

5. AI Content Generator

Schedule Trigger (раз в неделю)
    ↓
Google Sheets (получить темы статей)
    ↓
Loop Over Items
    ↓
OpenAI (генерация статьи)
    ↓
WordPress (публикация)
    ↓
Twitter (анонс)

Импорт шаблона

1. Скачиваем JSON файл workflow
2. n8n → Import from File
3. Выбираем файл
4. Настраиваем credentials
5. Тестируем и активируем

Экспорт своего workflow

# В n8n UI:
# Workflow → Download
# Сохраняется JSON файл

# Можно поделиться с коллегами или залить на GitHub

Продвинутые техники

Обработка ошибок

Error Workflow (глобальный обработчик):

1. Settings → Error Workflow
2. Создаём новый workflow для обработки ошибок
3. Этот workflow запускается при любой ошибке

Пример Error Workflow:

Error Trigger
    ↓
Set (форматируем информацию об ошибке)
    ↓
Slack (отправляем алерт)
    ↓
Google Sheets (логируем ошибку)

Try-Catch внутри workflow:

HTTP Request (может упасть)
    ↓ success
Normal Flow
    ↓ error
Error Handler Nodes
    ↓
Slack Alert

Переменные окружения

# docker-compose.yml
environment:
  - API_KEY=your_secret_key
  - DATABASE_URL=postgresql://user:pass@host/db
  - SLACK_WEBHOOK=https://hooks.slack.com/...

Использование в workflow:

// В любой ноде
{{$env["API_KEY"]}}
{{$env["DATABASE_URL"]}}

Credentials Management

Хранение credentials безопасно:

1. Settings → Credentials
2. Add Credential
3. Выбираем тип (OAuth2, API Key, Database)
4. Заполняем данные
5. Credentials шифруются в базе данных

Использование:

• В нодах выбираем сохранённые credentials
• Не хардкодим API keys в workflow
• Можно переиспользовать в разных workflow

Sub-workflows (вложенные workflow)

Создаём переиспользуемые workflow:

1. Создаём отдельный workflow «Send Notification»
2. В основном workflow добавляем ноду Execute Workflow
3. Выбираем «Send Notification»
4. Передаём данные

Преимущества:

• DRY (Don’t Repeat Yourself)
• Легче поддерживать
• Можно обновить логику в одном месте

Webhooks для интеграций

Создание webhook endpoint:

1. Добавляем Webhook ноду
2. HTTP Method: POST
3. Path: custom-endpoint
4. Активируем workflow
5. Получаем URL: https://n8n.example.com/webhook/custom-endpoint

Использование:

# Из внешней системы отправляем POST
curl -X POST https://n8n.example.com/webhook/custom-endpoint \
  -H "Content-Type: application/json" \
  -d '{"user": "John", "action": "signup"}'

n8n workflow получает данные и обрабатывает.

Работа с базами данных

PostgreSQL пример:

Schedule Trigger (каждый час)
    ↓
PostgreSQL (SELECT * FROM orders WHERE status = 'pending')
    ↓
Loop Over Items
    ↓
HTTP Request (обработка каждого заказа)
    ↓
PostgreSQL (UPDATE orders SET status = 'processed')

Настройка credentials:

Host: localhost
Database: mydb
User: n8n_user
Password: secure_password
Port: 5432
SSL: false (или true для production)

Массовая обработка данных

Split In Batches нода:

HTTP Request (получаем 10,000 записей)
    ↓
Split In Batches (по 100 записей)
    ↓
Loop (обработка батча)
    ↓
Database (сохранение)
    ↓
Return to Split (следующий батч)

Избегаем timeout и перегрузку памяти.

Интеграция с популярными сервисами

Google Sheets

Чтение данных:

Schedule Trigger
    ↓
Google Sheets (Read)
  Spreadsheet ID: xxxxx
  Sheet: Sheet1
  Range: A1:D100
    ↓
Process Data

Запись данных:

Webhook (получаем данные)
    ↓
Google Sheets (Append)
  Spreadsheet ID: xxxxx
  Sheet: Sheet1
  Values: {{$json}}

Slack интеграция

Отправка сообщений:

// Slack нода
Operation: Post Message
Channel: #general
Text: Привет из n8n!
Attachments: (опционально)
[
  {
    "color": "#36a64f",
    "title": "Deployment Success",
    "text": "Version 2.0 deployed to production"
  }
]

Slack бот (интерактивный):

Slack Trigger (On Message)
    ↓
OpenAI (обработка)
    ↓
Slack (Reply in Thread)

Email (Gmail/SMTP)

Отправка через SMTP:

# Credentials: SMTP
Host: smtp.gmail.com
Port: 587
User: your-email@gmail.com
Password: app_password (не основной пароль!)

// Email Send нода
To: client@example.com
Subject: Order Confirmation
Text: Ваш заказ #{{$json["order_id"]}} принят
HTML: (можно использовать HTML шаблон)

Чтение писем (IMAP):

Email Trigger (IMAP)
  Check every 5 minutes
  Folder: INBOX
  Criteria: UNSEEN
    ↓
Parse Email
    ↓
Create Task in Jira

Airtable

Webhook
    ↓
Airtable (Create Record)
  Base ID: xxxxx
  Table: Leads
  Fields:
    Name: {{$json["name"]}}
    Email: {{$json["email"]}}
    Status: "New"

Notion

Schedule Trigger
    ↓
Notion (Create Page)
  Database ID: xxxxx
  Title: Daily Report {{$now.format("YYYY-MM-DD")}}
  Properties: {...}

Частые проблемы и решения

Проблема: Webhook не работает

Причина: n8n запущен на localhost, webhooks недоступны извне.

Решение:

# Настраиваем WEBHOOK_URL в docker-compose.yml
environment:
  - WEBHOOK_URL=https://n8n.example.com/

# Перезапускаем
docker-compose restart n8n

Проблема: Workflow не активируется

Причины:

• Нет Trigger ноды
• Trigger нода не настроена
• Ошибка в credentials

Решение:

1. Убедитесь, что есть Trigger нода в начале
2. Проверьте настройки Trigger
3. Execute Workflow для теста
4. Смотрите логи: docker-compose logs -f n8n

Проблема: Ошибка «Unauthorized» при OAuth

Решение:

1. Проверьте Redirect URL в настройках OAuth приложения
2. Должен быть: https://n8n.example.com/rest/oauth2-credential/callback
3. Пересоздайте credentials
4. Авторизуйтесь заново

Проблема: Workflow медленно работает

Причины:

• Обработка больших объёмов данных
• Медленные внешние API
• Много последовательных запросов

Решение:

• Используйте Split In Batches
• Распараллеливайте запросы где возможно
• Кешируйте данные (Redis, временные переменные)
• Оптимизируйте запросы к БД

Проблема: Потеря данных при рестарте

Причина: Данные в памяти, не сохранены в БД.

Решение:

• Используйте PostgreSQL вместо SQLite
• Делайте бэкапы workflow регулярно
• Экспортируйте важные workflow в Git

Проблема: n8n не запускается после обновления

Решение:

# Смотрим логи
docker-compose logs n8n

# Часто помогает пересоздание контейнера
docker-compose down
docker-compose up -d

# Если не помогло — откатываемся на предыдущую версию
# docker-compose.yml
image: docker.n8n.io/n8nio/n8n:1.20.0  # указываем конкретную версию

Бэкапы и миграция

Экспорт всех workflow

# Через UI: Settings → Workflows → Export All

# Через API
curl -X GET http://localhost:5678/api/v1/workflows \
  -u admin:password \
  -H "Accept: application/json" > workflows_backup.json

Бэкап базы данных PostgreSQL

# Автоматический бэкап через cron
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
docker exec n8n-postgres pg_dump -U n8n n8n > /backups/n8n_$DATE.sql
gzip /backups/n8n_$DATE.sql

# Удаляем старые бэкапы (старше 30 дней)
find /backups -name "n8n_*.sql.gz" -mtime +30 -delete

Добавляем в crontab:

0 3 * * * /usr/local/bin/backup-n8n.sh

Восстановление из бэкапа

# Останавливаем n8n
docker-compose stop n8n

# Восстанавливаем БД
gunzip -c /backups/n8n_20260204.sql.gz | docker exec -i n8n-postgres psql -U n8n n8n

# Запускаем n8n
docker-compose start n8n

Миграция на новый сервер

1. Экспортируем workflow и credentials
2. Делаем бэкап БД
3. На новом сервере разворачиваем n8n
4. Восстанавливаем БД
5. Импортируем workflow
6. Настраиваем credentials заново (они зашифрованы, нужен тот же encryption key)

Важно: Скопируйте N8N_ENCRYPTION_KEY из старого сервера:

# Старый сервер
docker exec n8n env | grep N8N_ENCRYPTION_KEY

# Новый сервер в docker-compose.yml
environment:
  - N8N_ENCRYPTION_KEY=тот_же_ключ_что_был_на_старом_сервере

Краткий чек-лист

Установка и настройка:

• ☐ n8n установлен через Docker: docker-compose up -d
• ☐ Доступ по HTTPS настроен (Nginx + Certbot)
• ☐ PostgreSQL подключена (production)
• ☐ Basic Auth или OAuth настроены
• ☐ WEBHOOK_URL правильно указан
• ☐ Переменные окружения настроены

Первые шаги:

• ☐ Создан первый workflow
• ☐ Протестирован через Execute Workflow
• ☐ Workflow активирован
• ☐ Credentials настроены (API keys, OAuth)
• ☐ Импортирован готовый шаблон (для примера)

AI и автоматизация:

• ☐ OpenAI/Claude credentials добавлены
• ☐ Создан AI-агент с tools
• ☐ Telegram бот подключен (опционально)
• ☐ Интеграции настроены (Slack, Email, Database)

Production ready:

• ☐ Error Workflow настроен
• ☐ Бэкапы настроены (cron)
• ☐ Мониторинг работает
• ☐ Логи анализируются: docker-compose logs -f
• ☐ Документация workflow ведётся

Безопасность:

• ☐ API keys в переменных окружения, не в workflow
• ☐ HTTPS включен
• ☐ Basic Auth или OAuth2 настроен
• ☐ Webhook endpoints защищены (auth headers)
• ☐ N8N_ENCRYPTION_KEY сохранён в безопасном месте

Резюме

N8n — это то, что превращает «я трачу 2 часа в день на рутину» в «я настроил автоматизацию за 30 минут, теперь всё работает само». Это визуальный конструктор автоматизаций, который может делать ВСЁ: от простого «отправь мне email при новом заказе» до сложного «AI-агент с доступом к БД, который сам обрабатывает запросы клиентов и создаёт тикеты когда нужна помощь человека».

Три причины использовать n8n вместо Zapier:

1. Бесплатно — разворачиваете у себя, никаких лимитов и подписок за $500/месяц
2. Ваши данные — всё работает на вашем сервере, никаких утечек в облако
3. Гибкость — можете писать код когда нужно, интегрировать любое API, создавать AI-агентов

Что можно автоматизировать:

• Рутину — всё, что делаете руками каждый день
• Интеграции — соединяете системы, которые не умеют говорить друг с другом
• AI-ботов — Telegram, Slack, Discord боты с ChatGPT/Claude
• Мониторинг — проверка сайтов, API, цен, алерты в Slack
• Обработку данных — парсинг, трансформация, загрузка в БД
• Marketing — рассылки, lead scoring, автоответы

Главное преимущество n8n — визуальный интерфейс:

Не нужно быть программистом. Тащите ноды мышкой, соединяете стрелочками, настраиваете — готово. Но когда нужно что-то сложное — можете писать JavaScript прямо в ноде. Best of both worlds.

AI-агенты в n8n:

Это killer feature. Вы создаёте AI-агента, даёте ему tools (проверить БД, отправить email, создать тикет), и он сам решает что использовать. Получается AI, который не просто болтает, а реально что-то делает.

Для кого n8n:

• IT-специалистов — автоматизация DevOps задач, интеграции
• Системных администраторов — мониторинг, бэкапы, алерты
• Разработчиков — быстрые прототипы интеграций
• Предпринимателей — автоматизация бизнес-процессов без программистов
• Support-команд — AI-боты поддержки, тикет-системы
• Маркетологов — автоматизация рассылок, lead generation

Установите n8n через Docker за 5 минут. Импортируйте готовый шаблон Telegram бота с ChatGPT. Протестируйте. Поймёте, что это работает. Начнёте автоматизировать всё подряд. Через месяц будете экономить 10 часов в неделю на рутине.

И да, это бесплатно. Навсегда. Потому что open-source.

Сохраните статью в закладки — пригодится когда в очередной раз будете делать одно и то же руками в сотый раз и подумаете «а ведь это можно автоматизировать…»

Следующая шпаргалка: Make.com (Integromat) vs n8n vs Zapier — сравнение платформ автоматизации.

---

Meta Description

N8n шпаргалка: автоматизация процессов, AI-агенты и боты. Установка n8n через Docker, создание Telegram ботов, интеграция с OpenAI/Claude, готовые шаблоны workflow. Подключение API, nodes, автоматизация рутины. Альтернатива Zapier — бесплатно и open-source. Практическое руководство для IT-специалистов.