N8n telegram trigger

N8n Telegram Trigger: Полное руководство по автоматизации входящих сообщений

N8n Telegram Trigger — это специализированный узел (node) в платформе автоматизации n8n, предназначенный для инициирования рабочих процессов (workflows) на основе событий, происходящих в Telegram. Этот триггер функционирует как вебхук, который постоянно ожидает входящих данных от серверов Telegram. При получении нового сообщения, callback-запроса от инлайн-клавиатуры или другого типа обновления, узел активирует выполнение всего последующего рабочего процесса, передавая ему все данные о событии для дальнейшей обработки.

Принцип работы и технические основы

Telegram Trigger в n8n реализован через Long Polling API Telegram Bot API. В отличие от триггеров, работающих по расписанию (Schedule Trigger), этот узел запускает workflow в ответ на внешнее событие в реальном времени. При активации узла n8n генерирует уникальный публичный URL (вебхук), который необходимо зарегистрировать в Telegram с помощью вызова setWebhook. Все последующие обновления от Telegram будут отправляться на этот URL, что приводит к запуску экземпляра рабочего процесса. Для корректной работы требуется, чтобы сервер n8n был доступен из публичного интернета, либо используется метод обратного подключения (polling) через Credentials.

Типы событий, на которые можно настроить триггер

Узел Telegram Trigger может реагировать на широкий спектр событий. Выбор типа события осуществляется в поле «Updates» конфигурации узла.

Message: Любое текстовое, графическое, видео или аудио сообщение, отправленное в чат или канал, где присутствует бот.
Callback Query: Нажатие пользователем на кнопки встроенной (inline) клавиатуры, привязанной к конкретному сообщению.
Channel Post: Сообщения, опубликованные непосредственно в канале. Важно для мониторинга или пересылки постов.
Edited Message / Edited Channel Post: Событие редактирования уже отправленного сообщения.
Inline Query: Запросы, начинающиеся с @username_bot в любом чате. Требует отдельной логики обработки через узел Telegram API.
Pre-checkout Query & Shipping Query: События, связанные с обработкой платежей через Telegram Payments.

Подробная настройка узла Telegram Trigger

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

1. Создание и настройка учетных данных (Credentials)

Перед созданием триггера необходимо добавить учетные данные бота Telegram. Для этого требуется токен, полученный от @BotFather. В n8n используется тип аутентификации «Telegram Bot API». Важно выбрать правильный API:

Тип API	Описание	Когда использовать
Standard	Официальный API Telegram. Требует, чтобы сервер n8n имел публичный IP-адрес для приема вебхуков.	Для продакшн-среды с развернутым n8n на VPS или облачном хостинге.
Reverse Proxy (n8n)	Использует инфраструктуру n8n для маршрутизации запросов. Упрощает настройку, не требуя собственного домена и SSL.	Для тестирования, разработки или если n8n работает за NAT/без белого IP.

2. Конфигурация полей узла

Updates: Мультиселект типов событий, которые будут запускать workflow.
Drop Pending Updates: При активации, игнорирует все обновления, накопившиеся во время простоя вебхука. Рекомендуется включать при первом запуске.
Дополнительные поля (Additional Fields):
- Allowed Updates: Точный JSON-массив типов обновлений для фильтрации на стороне Telegram.
- Max Connection: Максимальное количество одновременных HTTPS-соединений к вебхуку (3-100).

Практические примеры использования

Пример 1: Создание простого чат-бота с ответами

Workflow состоит из одного узла Telegram Trigger и одного узла Telegram API (для отправки сообщения). В триггере выбирается событие «message». В узле Telegram API настраивается действие «sendMessage». В поле «Chat ID» подставляется выражение {{$json.message.chat.id}}, а в «Text» — {{$json.message.text}} или любая логика ответа, основанная на входящем тексте.

Пример 2: Модерация входящих сообщений и уведомление в другой чат

Цепочка узлов: Telegram Trigger (message) -> Код (Function) или IF (для проверки текста на наличие запрещенных слов) -> Telegram API (sendMessage). Если условие срабатывает, узел отправки сообщения использует заранее известный ID чата-логера для оповещения модератора.

Пример 3: Сбор данных в Google Sheets из Telegram-опроса

Telegram Trigger (callback_query) -> Узел для парсинга данных (например, Function node) -> Узел Google Sheets (для добавления строки). В Function node извлекаются данные: {{$json.callback_query.data}} (ответ пользователя), {{$json.callback_query.from.username}} (никнейм). Эти данные затем передаются в строку таблицы.

Обработка данных в последующих узлах

Данные, которые триггер передает дальше по workflow, имеют сложную структуру, соответствующую объекту Update из Telegram Bot API. Для доступа к конкретной информации используются выражения в нотации n8n.

Тип события	Путь к данным в n8n	Описание
Текст сообщения	`{{$json.message.text}}`	Текст входящего сообщения.
ID чата	`{{$json.message.chat.id}}`	Уникальный идентификатор чата для ответа.
Имя пользователя	`{{$json.message.from.username}}`	Юзернейм отправителя.
Данные callback	`{{$json.callback_query.data}}`	Значение, присвоенное нажатой кнопке.
ID сообщения для ответа	`{{$json.callback_query.message.message_id}}`	ID сообщения, к которому привязана клавиатура.

Отладка и решение распространенных проблем

Триггер не активируется: Проверьте, что бот добавлен в чат/канал и имеет нужные права. Убедитесь, что публичный URL n8n доступен для Telegram (можно проверить, открыв URL в браузере). Проверьте логи n8n на наличие ошибок.
Ошибка 409: Conflict: Вебхук уже зарегистрирован на другом сервере. Используйте вызов deleteWebhook (через узел Telegram API или прямой запрос) перед активацией нового триггера.
Дублирование запусков: Убедитесь, что в настройках Credentials не создано несколько активных подключений для одного бота, ведущих на разные инстансы n8n.
Проблемы с типами обновлений: Если триггер настроен только на «message», но ожидается обработка «callback_query», workflow не запустится. Необходимо явно указать все требуемые типы в поле «Updates».

Интеграция с другими узлами n8n

Мощь Telegram Trigger раскрывается в комбинации с другими узлами n8n:

Базы данных (PostgreSQL, MySQL): Сохранение пользователей, запросов или логов действий.
Облачные хранилища (Google Drive, S3): Автоматическое сохранение медиафайлов, отправленных боту.
Коммуникации (Email, SMS, другие мессенджеры): Пересылка критичных сообщений из Telegram на другие каналы связи.
API-запросы (HTTP Request): Отправка данных из Telegram во внешние системы: CRM (Bitrix24, AmoCRM), таск-трекеры (Jira, Trello), системы мониторинга.
Логика (IF, Switch, Function): Для создания сложных сценариев ответов, ветвления диалога, валидации входящих данных.

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

Можно ли использовать Telegram Trigger для мониторинга личных сообщений или групповых чатов?

Да, но с ограничениями. Бот может обрабатывать сообщения только в тех чатах, куда он был добавлен как участник. Для личных сообщений пользователь должен начать диалог с ботом первым. Для групповых чатов бота необходимо добавить в участники, после чего он будет получать все сообщения, если не отключены уведомления. Для супергрупп и каналов бот должен быть назначен администратором для получения событий.

Чем отличается Telegram Trigger от узла Telegram API в n8n?

Это принципиально разные узлы. Telegram Trigger — это точка входа (источник события), который только слушает входящие обновления и запускает workflow. Он не может отправлять сообщения. Узел Telegram API — это узел для выполнения действий: отправка сообщений, фото, документов, управление клавиатурами, редактирование сообщений и т.д. В типичном workflow триггер запускает цепочку, в которой используются один или несколько узлов Telegram API для реакции.

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

Для каждого бота необходимо создать отдельные учетные данные (Credentials) с уникальным токеном. Затем в каждом экземпляре узла Telegram Trigger или Telegram API нужно выбирать соответствующие учетные данные. Таким образом, один инстанс n8n может обслуживать множество независимых ботов.

Что делать, если мой сервер n8n находится за NAT или без белого IP-адреса?

В этом случае необходимо использовать опцию «Reverse Proxy (n8n)» при создании учетных данных. Это позволит n8n использовать свой облачный прокси для получения обновлений от Telegram, а затем перенаправлять их на ваш локальный инстанс через устойчивое соединение. Альтернатива — использование служб типа ngrok для создания туннеля, но метод Reverse Proxy интегрирован и более стабилен.

Как ограничить доступ к боту по ID пользователя или чата?

Сразу после узла Telegram Trigger необходимо добавить узел IF или Switch. В условии сравните ID чата ({{$json.message.chat.id}}) или ID пользователя ({{$json.message.from.id}}) с разрешенным списком (можно хранить в переменных, коде или базе данных). Если ID не совпадает, workflow можно прервать или отправить сообщение об ошибке.

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

Нет. Для получения событий о новых сообщениях (постах) в канале, бот должен быть добавлен в канал в качестве администратора. Без прав администратора бот не будет получать обновления через Bot API.

Как правильно тестировать workflow с Telegram Trigger?

Рекомендуется создать отдельного тестового бота через @BotFather. Активируйте workflow в n8n, убедитесь, что он находится в статусе «Active». Отправьте тестовое сообщение боту в личный чат или в тестовую группу. Все запущенные экземпляры workflow можно отслеживать на вкладке «Executions» в n8n, где видны все входящие данные и ошибки на каждом шаге.