N8n тг бот

N8n Telegram-бот: полное руководство по созданию и автоматизации

N8n (произносится как «n-eight-n») — это инструмент с открытым исходным кодом для оркестровки рабочих процессов (workflow automation), который позволяет соединять различные приложения и сервисы между собой без необходимости писать код. Создание Telegram-бота на платформе N8n представляет собой процесс визуального программирования, где логика бота строится из узлов (нод), каждый из которых выполняет определенную функцию: прием сообщения, обработку данных, запрос к API, отправку ответа.

Архитектура и принцип работы Telegram-бота на N8n

В основе лежит модель веб-хуков (webhook). N8n выступает в роли сервера, который принимает входящие обновления от Telegram (сообщения, команды, нажатия кнопок) на специальный URL-адрес. Далее эти данные проходят через построенный вами рабочий процесс, где обрабатываются, и в конце формируется исходящее сообщение, которое отправляется обратно пользователю в Telegram через официальное API мессенджера. Для связи N8n с Telegram необходим токен бота, полученный у @BotFather.

Ключевые компоненты системы:

Telegram Bot API: Внешний сервис, отправляющий обновления.
Webhook-узел Telegram Trigger в N8n: Точка входа, которая слушает входящие события.
Обрабатывающие узлы N8n: Ноды для логики, работы с данными, внешними API (например, IF, Switch, Code, HTTP Request).
Узел Telegram Send Message: Точка выхода для отправки ответа пользователю.
Сервер N8n: Может быть развернут локально, на VPS или использован облачный вариант (n8n.cloud).

Настройка окружения и создание бота

Перед построением рабочего процесса необходимо выполнить базовые шаги:

Получение токена бота Telegram через @BotFather.
Развертывание экземпляра N8n. Для тестирования подойдет локальная установка через Docker: docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n. Для продакшена требуется сервер с постоянным адресом и HTTPS.
Настройка веб-хука. Это можно сделать вручную через API Telegram или автоматически, используя встроенные функции узла Telegram Trigger.

Детальный разбор ключевых узлов (нод) для Telegram-бота

Эффективность бота зависит от правильного использования и комбинации узлов.

Узел «Telegram Trigger»

Это стартовый узел, который активирует весь рабочий процесс при новом событии в Telegram. Его необходимо настроить первым.

Credential: Создаются учетные данные с токеном бота.
Update Type: Выбор типа события, на которое будет реагировать бот. Основные варианты:
- Message: Любое текстовое, голосовое, фото или иное сообщение.
- Callback Query: Нажатие на inline-кнопку под сообщением.
- Command: Сообщение, начинающееся с символа «/».

Узел «Telegram» (для отправки сообщений)

Это узел действия, который отправляет сообщения, редактирует их, управляет клавиатурами.

Resource: Выбирается «Message».
Operation: «Send Message», «Edit Message Text», «Answer Callback Query» и др.
Chat ID: Обычно берется из выражения {{ $node['Telegram Trigger'].json.chat.id }}.
Text: Текст ответа. Поддерживает Markdown и HTML-разметку.
Reply Markup: Поле для добавления Inline- или Reply-клавиатуры. Задается в формате JSON.

Обрабатывающие и логические узлы

Эти узлы формируют «мозг» бота.

IF / Switch: Для ветвления логики. Например, проверка текста команды или данных пользователя.
Code: Позволяет выполнить пользовательский JavaScript/Python код для сложных вычислений или преобразования данных.
Function: Упрощенная версия Code-узла для быстрых JS-операций.
HTTP Request: Ключевой узел для интеграции с внешними API (погода, курсы валют, CRM, базы данных).
Spreadsheet File / Google Sheets: Для чтения и записи данных в таблицы.

Практические примеры рабочих процессов (workflow)

Пример 1: Эхо-бот с логированием

Простейший бот, который отвечает тем же текстом и записывает диалог в Google Таблицу.

Узел Telegram Trigger (Update Type: Message).
Узел IF: Проверяет, не пустое ли текстовое сообщение.
Ветка «true»: Узел Telegram отправляет сообщение обратно, используя {{ $json.message.text }}.
Параллельно или после: Узел Google Sheets добавляет строку с данными: время, chat.id, имя пользователя, текст.

Пример 2: Бот-опрос с inline-кнопками

Бот задает вопрос и предлагает варианты ответа кнопками. Реакция на нажатие обрабатывается.

Узел Telegram Trigger (Update Type: Command, command: /poll).
Узел Telegram отправляет сообщение «Как дела?» с Inline-клавиатурой (кнопки «Отлично» и «Не очень»). Callback_data кнопок: «great» и «bad».
Новый рабочий процесс или ветка с триггером Telegram Trigger (Update Type: Callback Query).
Узел Switch проверяет {{ $json.callback_data }}.
В зависимости от значения, узел Telegram (Operation: Answer Callback Query) показывает уведомление «Рад за вас!» или «Бывает…» и/или редактирует исходное сообщение.

Пример 3: Бот-агрегатор новостей через RSS

Бот периодически проверяет RSS-ленту и отправляет новые статьи в заданный чат.

Триггер Cron (запускает workflow каждые 30 минут).
Узел RSS Feed Read забирает новости с указанного URL.
Узел Function фильтрует записи, оставляя только те, которые опубликованы после последней проверки (требуется хранение времени последней статьи).
Узел Loop для каждой новой статьи.
Внутри цикла узел Telegram отправляет заголовок и ссылку в Telegram-канал или чат.

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

N8n позволяет создавать сложных ботов с состоянием (state) и интеграцией в бизнес-процессы.

Хранение состояния пользователя: Использование узлов Set для записи данных в память рабочего процесса (для краткосрочного хранения) или внешних хранилищ, таких как PostgreSQL, SQLite или Redis для долговременного. Это необходимо для создания многошаговых форм (например, сбор заявки).
Интеграция с CRM и ERP: Узел HTTP Request может отправлять данные о лиде из Telegram в системы типа AmoCRM, Bitrix24 или Pipedrive при получении команды /lead.
Работа с медиафайлами: Бот может не только получать фото/документы от пользователя, но и скачивать их через узел HTTP Request, обрабатывать (например, сжимать через Code-узел с библиотекой) и загружать в облачное хранилище, такое как S3 или Google Drive.
Параллельное выполнение: Узел Merge позволяет запускать несколько веток обработки одновременно (например, логирование и отправка уведомления администратору), а затем объединять результаты.

Таблица сравнения: N8n бот vs. Нативный бот на Python/Node.js

Критерий	N8n Telegram-бот	Нативный бот (например, на python-telegram-bot)
Порог входа	Низкий. Не требует глубоких знаний программирования.	Средний/высокий. Требуется знание языка, фреймворков, деплоя.
Скорость разработки	Очень высокая для стандартных сценариев и интеграций.	Зависит от сложности. Стандартные задачи решаются быстро, уникальная логика требует времени на код.
Гибкость и кастомизация	Высокая, но ограничена доступными нодами и возможностями Code-узла. Сложная бизнес-логика может стать громоздкой.	Абсолютная. Можно реализовать любую логику и архитектуру.
Интеграция с другими сервисами	Превосходная. Сотни готовых коннекторов (нод).	Требуется самостоятельная работа с API каждого сервиса или поиск библиотек.
Масштабируемость и производительность	Зависит от инфраструктуры N8n. Для высоких нагрузок требуется кластеризация и оптимизация workflow.	Полный контроль над производительностью. Можно оптимизировать код и инфраструктуру под любые нагрузки.
Мониторинг и отладка	Визуальный трейгер выполнения, детальное логирование каждого узла, возможность повторного запуска.	Требуется настройка систем логирования (например, ELK-стек) и отладчиков.
Стоимость владения	Затраты на сервер для self-hosted версии или подписка на n8n.cloud. Экономия на времени разработки.	Затраты на сервер и время разработчика.

Ответы на часто задаваемые вопросы (FAQ)

Как обрабатывать несколько команд в одном боте?

После узла «Telegram Trigger» (тип «Message» или «Command») используйте узел «Switch». В условии проверяйте поле $json.message.text. Например, создайте правила: «Если текст содержит ‘/start’», «Если текст содержит ‘/help’» и т.д. Каждая ветка будет обрабатывать свою команду.

Можно ли создать бота без своего сервера, на облачном n8n?

Да, облачный сервис n8n.cloud предоставляет готовый хостинг для N8n с публичным URL. Это самый быстрый способ начать. Однако для коммерческих проектов важно учитывать тарифы и ограничения на количество выполненных задач.

Как хранить данные пользователей между сессиями?

Для простых случаев (небольшой объем, одно сервер) можно использовать встроенные узлы баз данных (PostgreSQL, SQLite). Для данных, связанных с чатом, создайте таблицу с полями chat_id, data, updated_at. При старте workflow читайте данные по chat_id, а в конце — обновляйте. Для распределенных систем предпочтительнее Redis.

Бот не отвечает на сообщения. В чем основные причины?

Неверный или просроченный токен в учетных данных.
Не настроен веб-хук. Убедитесь, что в узле Telegram Trigger установлена галочка «Set Webhook» или он был настроен иным способом.
Сервер N8n недоступен из интернета. Проверьте настройки фаервола и проброс порта.
Отсутствует SSL. Telegram требует HTTPS для веб-хуков. Используйте обратный прокси (Nginx) с SSL или облачный вариант.
Ошибка в workflow. Проверьте выполнение workflow в интерфейсе N8n на вкладке «Executions».

Есть ли ограничения на количество запросов к API Telegram через N8n?

Ограничения накладывает сам Telegram API (примерно 30 сообщений в секунду на одного бота). N8n не добавляет своих ограничений, но при интенсивной отправке важно настраивать задержки между сообщениями (узел «Wait») и обрабатывать ошибки «Too Many Requests» в узле «HTTP Request».

Можно ли перенести бота, написанного на другом языке, в N8n?

Да, логику можно перенести. Простые команды и диалоги переносятся легко. Сложную алгоритмическую логику, реализованную в коде, придется воссоздавать с помощью комбинации узлов «Switch», «Function» и «Code». Интеграции с внешними API обычно переносятся проще, так как в N8n для них есть готовые узлы.

Как организовать аутентификацию пользователей в боте?

Можно реализовать через:
1. Простую проверку по ID чата, если известны ID разрешенных пользователей.
2. Кодовое слово/пароль, отправляемое в чат.
3. Веб-авторизацию: Отправка пользователю уникальной ссылки на ваш сайт с OAuth (например, через Google), после успешного входа сайт отправляет запрос на ваш N8n webhook с данными пользователя и привязывает их к chat_id.

Искусственный интеллект