n8n

Что такое n8n?

n8n — это мощная платформа для автоматизации workflow с открытым исходным кодом. Она позволяет соединять различные сервисы и приложения, создавая автоматические процессы обработки данных без необходимости писать код.

Создание инстанса n8n

Выбор тарифа

Aister предлагает три тарифа n8n:

• Starter (990 ₽/мес) — до 1000 выполнений в месяц, 1 пользователь
• Pro (2990 ₽/мес) — до 10000 выполнений, 3 пользователя, приоритетная поддержка
• Enterprise (от 9990 ₽/мес) — неограниченные выполнения, неограниченные пользователи, SLA

Создание инстанса

1. В личном кабинете выберите «n8n»
2. Нажмите «Создать инстанс»
3. Выберите тариф
4. Укажите имя инстанса (например, «production» или «staging»)
5. Нажмите «Создать»

Через 1-2 минуты вы получите URL для доступа к n8n и учётные данные администратора.

Первый workflow

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

Создадим workflow, который отправляет уведомление в Telegram при получении webhook:

1. Войдите в n8n по предоставленному URL
2. Нажмите «Create new workflow»
3. Добавьте узел «Webhook» (триггер)
4. Скопируйте URL webhook из настроек узла
5. Добавьте узел «Telegram» и подключите к webhook
6. Настройте Telegram Bot Token и Chat ID
7. В поле «Message» используйте данные из webhook: {{$json.message}}
8. Активируйте workflow переключателем в правом верхнем углу

Тестирование workflow

Отправьте POST-запрос на URL webhook:

curl -X POST https://your-n8n.aister.store/webhook/test \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from n8n!"}'

Вы должны получить сообщение в Telegram.

Основные узлы n8n

Триггеры

• Webhook — принимает HTTP-запросы от внешних сервисов
• Schedule Trigger — запускает workflow по расписанию (cron)
• Manual Trigger — запуск вручную для тестирования
• Email Trigger (IMAP) — реагирует на новые письма

Действия

• HTTP Request — отправка запросов к любым API
• Set — установка или изменение значений данных
• Function — выполнение JavaScript кода
• IF — условное ветвление workflow
• Switch — множественное ветвление по условиям
• Merge — объединение данных из разных веток

Интеграции

• Gmail — отправка и чтение писем
• Google Sheets — работа с таблицами
• Telegram — отправка сообщений и создание ботов
• Slack — уведомления и интеграция с каналами
• PostgreSQL/MySQL — работа с базами данных
• Notion — управление страницами и базами
• Stripe — обработка платежей

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

Доступ к данным предыдущих узлов

В n8n данные передаются между узлами. Используйте выражения для доступа:

• {{$json.fieldName}} — поле из текущего узла
• {{$node["Node Name"].json.fieldName}} — поле из конкретного узла
• {{$items}} — все элементы данных
• {{$itemIndex}} — индекс текущего элемента

Трансформация данных с Function

Узел Function позволяет обрабатывать данные с помощью JavaScript:

// Получение данных из предыдущего узла
const items = $input.all();

// Обработка каждого элемента
const processedItems = items.map(item => {
  return {
    json: {
      fullName: `${item.json.firstName} ${item.json.lastName}`,
      email: item.json.email.toLowerCase(),
      createdAt: new Date().toISOString()
    }
  };
});

// Возврат обработанных данных
return processedItems;

Фильтрация данных

Используйте узел IF для фильтрации:

1. Добавьте узел IF после источника данных
2. Настройте условие (например, {{$json.status}} равно «active»)
3. Подключите узлы к выходам «true» и «false»

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

Gmail: автоматизация email

Настройка OAuth для Gmail:

1. Перейдите в Google Cloud Console
2. Создайте новый проект
3. Включите Gmail API
4. Создайте OAuth 2.0 credentials
5. Добавьте redirect URI: https://your-n8n.aister.store/rest/oauth2-credential/callback
6. В n8n создайте Gmail credential с Client ID и Secret
7. Авторизуйтесь через OAuth

Telegram: создание бота

1. Создайте бота через @BotFather
2. Получите Bot Token
3. Узнайте Chat ID (отправьте сообщение боту и используйте https://api.telegram.org/bot<TOKEN>/getUpdates)
4. В n8n создайте Telegram credential с токеном
5. Используйте узел Telegram для отправки сообщений

PostgreSQL: работа с базой данных

-- Создание credential в n8n
Host: your-db-host.aister.store
Database: mydb
User: myuser
Password: ********
Port: 5432
SSL: Enable

-- Пример запроса в узле PostgreSQL
SELECT * FROM users WHERE created_at > NOW() - INTERVAL '1 day'

Расписание и автоматизация

Schedule Trigger

Запускайте workflow по расписанию:

• Каждый час: 0 * * * *
• Каждый день в 9:00: 0 9 * * *
• Каждый понедельник в 10:00: 0 10 * * 1
• Каждые 15 минут: */15 * * * *

Webhook для внешних сервисов

Настройте webhook в сторонних сервисах для автоматического запуска workflow:

1. Создайте workflow с Webhook триггером
2. Скопируйте Production Webhook URL
3. Добавьте URL в настройки webhook стороннего сервиса
4. Активируйте workflow

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

Error Trigger

Создайте отдельный workflow для обработки ошибок:

1. Создайте новый workflow
2. Добавьте узел «Error Trigger»
3. Настройте уведомления (Telegram, Email, Slack)
4. В основном workflow включите «Error Workflow» в настройках

Retry логика

Настройте повторные попытки для ненадёжных API:

1. Откройте настройки узла HTTP Request
2. Перейдите в раздел «Retry On Fail»
3. Включите опцию
4. Укажите количество попыток (например, 3)
5. Установите интервал между попытками (например, 1000 мс)

Оптимизация производительности

Батчинг запросов

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

// В узле Function
const items = $input.all();
const batchSize = 100;
const batches = [];

for (let i = 0; i < items.length; i += batchSize) {
  batches.push(items.slice(i, i + batchSize));
}

return batches.map(batch => ({ json: { items: batch } }));

Кэширование данных

Используйте узел «Redis» для кэширования часто используемых данных:

1. Установите Redis на сервере OpenClaw
2. Создайте Redis credential в n8n
3. Используйте узел Redis для SET/GET операций
4. Установите TTL для автоматического удаления старых данных

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

Защита webhook

Добавьте аутентификацию для webhook:

1. В настройках Webhook узла включите «Authentication»
2. Выберите тип: Header Auth или Basic Auth
3. Укажите имя заголовка и значение (например, X-API-Key: your-secret-key)
4. Передавайте этот заголовок при вызове webhook

Хранение секретов

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

1. В настройках инстанса n8n добавьте переменные окружения
2. В workflow используйте {{$env.VARIABLE_NAME}}
3. Никогда не храните секреты в коде workflow

Мониторинг и отладка

Просмотр выполнений

В разделе «Executions» доступна история всех запусков:

• Статус выполнения (success, error, waiting)
• Время выполнения
• Входные и выходные данные каждого узла
• Сообщения об ошибках

Отладка workflow

Советы по отладке:

• Используйте Manual Trigger для тестирования
• Добавляйте узлы «Set» для вывода промежуточных данных
• Проверяйте данные на каждом шаге через «Execute Node»
• Используйте узел «Stop and Error» для прерывания при определённых условиях

Готовые примеры workflow

Миграция с других платформ

Миграция с Zapier

Переход с Zapier на n8n позволяет сэкономить до 80% на автоматизации:

1. Экспортируйте список ваших Zaps
2. Для каждого Zap создайте аналогичный workflow в n8n
3. Перенастройте триггеры и действия
4. Протестируйте каждый workflow
5. Постепенно отключайте Zaps и переключайтесь на n8n

Подробное руководство: Миграция с Zapier на n8n

Best Practices

Именование workflow

• Используйте понятные имена: «Sync Contacts to CRM» вместо «Workflow 1»
• Добавляйте префиксы для группировки: «[Production]», «[Staging]», «[Test]»
• Указывайте частоту: «Daily Report», «Hourly Sync»

Организация workflow

• Разбивайте сложные workflow на несколько простых
• Используйте Sub-Workflows для повторяющейся логики
• Добавляйте комментарии к узлам (Notes)
• Группируйте связанные узлы визуально

Тестирование

• Создавайте staging-версии workflow для тестирования
• Используйте Manual Trigger для отладки
• Тестируйте с реальными данными перед активацией
• Настройте уведомления об ошибках

Устранение неполадок

Workflow не запускается

• Проверьте, активирован ли workflow (переключатель в правом верхнем углу)
• Убедитесь, что триггер настроен правильно
• Проверьте лимиты выполнений на вашем тарифе
• Посмотрите логи в разделе «Executions»

Ошибки выполнения

• Проверьте credentials — возможно, истёк токен
• Убедитесь, что API доступен (проверьте через curl)
• Проверьте формат данных — возможно, структура изменилась
• Добавьте retry логику для ненадёжных API

Медленное выполнение

• Используйте батчинг для обработки больших объёмов данных
• Кэшируйте часто используемые данные
• Оптимизируйте SQL-запросы
• Рассмотрите апгрейд тарифа для большей производительности