Telegram и n8n: сначала ручное уведомление

Начните с исходящего уведомления

В архиве есть workflows/ru/03-telegram-notification.json. При ручном запуске он отправляет одно фиксированное сообщение в явно заданный приватный чат. Это удобная первая интеграция: проверяются токен, получатель и исходящее соединение, а входящий listener пока не нужен.

Если тестового бота ещё нет, создайте его через BotFather в Telegram. Откройте приватный диалог и отправьте /start. Бот не может сам начать личный разговор с произвольным пользователем, который ещё с ним не взаимодействовал. Не помещайте токен на скриншоты, в JSON workflow и обычные текстовые поля.

Настройте получателя и credential

Импортируйте workflow через меню редактора. Создайте Telegram credential с токеном и выберите его в Send Telegram message. В Message and recipient замените REPLACE_WITH_PRIVATE_CHAT_ID числовым ID своего приватного чата. Если используете наш Python-пример, его команда /id описана в инструкции бота. Иначе получите ID из тестового update существующей интеграции; не запускайте ради этого второй конкурирующий poller.

Проверьте текст и выполните сценарий один раз. Ожидаемый результат — одно сообщение в указанном диалоге. Пример использует HTML parse mode с фиксированным обычным текстом. Если позже подставите пользовательские данные, экранируйте HTML или выберите подходящий режим форматирования. Ограничения длины сообщения Telegram и времени выполнения n8n — разные вещи.

Для отправки не нужен Telegram Trigger

Пример не регистрирует webhook и не читает входящие updates. Поэтому он может отправлять уведомления, не заменяя действующего polling-бота. Добавление Telegram Trigger в n8n меняет схему: он использует webhook Telegram и требует публичного HTTPS.

Для одного токена Telegram хранит один webhook URL. Переключение между тестовым и production-триггером может заменить этот адрес. Токен действующего polling-бота также нельзя одновременно использовать для доставки updates через webhook. Возьмите отдельного тестового бота и изучите polling и webhook до изменения рабочего приёмника.

При автоматизации контролируйте действие

Отчёт по расписанию должен уходить фиксированному получателю под вашим контролем. Обработчик входящих сообщений обязан проверить отправителя и чат перед доступом к приватным данным или платной модели. Если напрямую передать произвольный входящий chat_id в сценарий с доступом к закрытому отчёту, данные могут уйти не тому человеку.

Автоматические повторы в примере отключены. Если Telegram принял сообщение, но ответ потерялся, повтор способен создать дубликат. Для уведомлений по событиям сохраняйте стабильный ID и продумайте дедупликацию. Успешная отправка не доказывает, что человек прочитал сообщение.

Используйте мониторинг выполнений, не копируя токены в журналы. Полноценный диалоговый бот с контекстом и суточным лимитом попыток — отдельная реализация в Telegram-кластере.

Все руководства по n8n.

Официальные источники: Telegram Bot API, Telegram Bot FAQ.