ИИ-бот в Telegram на n8n: что умеет и где ограничения

Telegram — окно к процессу, а не весь продукт

Telegram-бот часто представляют как отдельный продукт: человек пишет вопрос, искусственный интеллект отвечает. На практике Telegram удобнее воспринимать как окно к процессу. Через это окно можно запросить отчёт, отправить голосовое, согласовать публикацию, получить документ, создать задачу или обратиться к базе знаний. Что произойдёт дальше, решает workflow — собранный в n8n сценарий автоматизации.

Для обычного бота большая часть интеграции уже собрана во встроенных, или нативных, нодах n8n. Нода — это отдельный шаг сценария. Готовые Telegram-ноды получают сообщения и нажатия кнопок, скачивают файлы, отправляют текст, фотографии и документы, проверяют участников чата и публикуют посты. HTTP Request — универсальный запрос к API — нужен, когда Bot API уже добавил возможность, которой ещё нет в интерфейсе нативной ноды, либо когда Telegram подключён через внешний сервис.

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

У Telegram уже есть список диалогов, уведомления, текстовое поле, голосовые сообщения, камера, файлы и кнопки. Поэтому компании не обязательно создавать отдельное приложение для каждой внутренней автоматизации. Иногда достаточно бота, который передаёт действие в n8n и возвращает результат.

Искусственный интеллект нужен только там, где приходится понимать свободную формулировку, распознавать содержимое или готовить текст. Если пользователь нажал кнопку «Сформировать отчёт», модель обычно ничего не улучшит. n8n может вызвать API, собрать данные по правилам и вернуть файл без AI-шагов.

Например, руководитель отправляет голосовое: «Создай Ивану задачу подготовить отчёт к пятнице». Telegram передаёт файл в n8n, сервис распознавания речи превращает его в текст, модель выделяет исполнителя, задачу и срок. Бот возвращает карточку без сохранения: «Иван — отчёт — пятница». Только после кнопки «Подтвердить» n8n создаёт задачу. Если голос не распознан или сотрудник не найден, сценарий ничего не записывает и просит уточнение. Десять-двадцать реальных сообщений подходят для первой проверки; перед рабочим запуском отдельно тестируют права, ошибки, дубли и одновременные события.

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

Три способа подключить Telegram

Слово «Telegram» скрывает три разных варианта. У них отличаются права, поведение и сложность интеграции.

Бот через BotFather: основной путь для n8n

Обычного бота создают в BotFather. Он выдаёт токен, который добавляют в Credentials — защищённое хранилище подключений n8n. После этого Telegram Trigger принимает события, а Telegram node выполняет действия.

Это отдельный бот, а не ваш личный профиль. У него своё имя, ссылка и диалог. Обычный бот не может первым начать переписку с произвольным человеком: пользователь должен открыть его, нажать Start, написать сообщение или добавить бота в группу. Токен даёт полный контроль над ботом, поэтому его нельзя вставлять в Code node, URL или текст workflow — для него предназначены Credentials.

Business Bot: официальный доступ к выбранным личным чатам

У Telegram появился официальный режим Business Bots. Владелец аккаунта может подключить бота к выбранным личным чатам и выдать ему права на чтение, ответы и другие действия. Telegram передаёт такие сообщения и ответы с дополнительным идентификатором бизнес-подключения. Telegram описывает этот механизм отдельно.

Это важная поправка к утверждению, что личный Telegram можно автоматизировать только через сторонний сервис. Технически официальный путь существует. Но по состоянию на 27 августа 2026 года в исходнике Telegram Trigger n8n нет событий Business Connection и Business Message, а в нативной операции Send Message нет поля для идентификатора бизнес-подключения. Значит, простая схема из двух готовых нод пока не складывается: понадобится собственный webhook и обращения к Bot API либо другой интеграционный слой.

Личный Telegram через Wazzup

Wazzup подключает личный Telegram через авторизацию аккаунта и предоставляет собственные webhooks и API. Webhook здесь означает автоматическое уведомление n8n о новом сообщении; ответ n8n отправляет обратным API-запросом. Похожим способом сервис работает с поддерживаемыми каналами WhatsApp и MAX.

Это не нативная Telegram-интеграция n8n, а посредник между мессенджером и workflow. У подхода есть практический плюс: один формат API для нескольких каналов и готовое подключение личного аккаунта. Есть и цена: тариф, ещё один обработчик данных, зависимость от состояния сессии и необходимость учитывать ограничения самого сервиса. Поэтому Wazzup стоит выбирать за конкретное удобство, а не подключать автоматически к любому Telegram-боту.

Что уже умеют нативные Telegram-ноды n8n

В n8n есть две основные ноды: Telegram Trigger начинает workflow после события, а Telegram выполняет действие. Они закрывают основные операции обычного BotFather-бота. Состояние диалога, объединение сообщений и функции Bot API, которых ещё нет в интерфейсе n8n, могут потребовать других нод или точечного кода.

Telegram Trigger получает события

Триггер может реагировать на обычное и отредактированное сообщение, нажатие кнопки под сообщением, публикацию или изменение поста в канале, запрос из строки ввода, опрос и некоторые платёжные события. На практике чаще всего нужны четыре типа:

• message — текст, команда, фотография, голосовое, документ и другие входящие сообщения;
• callback_query — нажатие кнопки под сообщением;
• channel_post — новый пост в канале;
• edited_message или edited_channel_post — изменение уже полученного материала.

Из события приходят chat.id, from.id, message_id, текст и метаданные вложения. Это позволяет понять, где произошло действие, кто его вызвал и на какое сообщение отвечать. Перед опасным действием workflow должен отдельно проверить пользователя и его полномочия.

Telegram node отправляет и изменяет сообщения

Нативная нода умеет отправлять текст, фотографии, документы, аудио, видео, стикеры, геолокацию и медиагруппы. Она редактирует и удаляет сообщения, закрепляет их, отвечает на callback query и показывает служебные статусы вроде typing или upload_document.

Отдельные Chat operations получают сведения о чате, администраторах и конкретном участнике. File operation получает файл по file_id. Поэтому сценарий «получить документ — обработать — вернуть результат» не требует самостоятельно собирать URL Telegram API.

Нативная нода не закрывает абсолютно весь Bot API. Telegram развивается быстрее, чем интерфейс интеграции. Если нужной операции нет, сначала стоит проверить текущую документацию Telegram node, а затем решать, оправдан ли HTTP Request. Для редкой декоративной функции сложный обход часто дороже самой пользы.

Когда AI нужен, а когда достаточно команды или кнопки

Telegram-бот не обязан разговаривать. Он может быть панелью управления бизнес-процессом.

Команда /report однозначна: собрать отчёт. Кнопка «Согласовать» однозначна: изменить статус после проверки прав. Меню «Продажи / Поддержка / Документы» уже содержит нужную классификацию. В этих случаях обычный workflow быстрее, дешевле и предсказуемее модели.

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

• расшифровать голосовое и выделить поручения;
• определить тему свободного обращения;
• извлечь поля из фотографии или документа с помощью OCR или модели, которая умеет работать с изображениями;
• найти ответ в базе знаний и сформулировать его простыми словами;
• подготовить черновик публикации или сводку длинного обсуждения.

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

Для Telegram все эти форматы — разные виды сообщения. Telegram Trigger получает объект с подходящим полем: text, voice, document, photo или video. Следующий шаг определяет тип и направляет данные в нужную ветку.

С текстом всё просто: его можно проверить, сохранить или передать модели. С файлом n8n берёт file_id, скачивает данные через Telegram Get File и отправляет их следующему сервису. У стандартного Bot API скачивание через getFile ограничено 20 МБ, а отправка файла ботом обычно — 50 МБ. Telegram предупреждает об этих пределах; перед запуском файлового сценария их стоит перепроверить.

Голосовое не становится текстом внутри Telegram-ноды. После распознавания бот может показать пользователю короткую сводку: «Создать задачу Ивану до пятницы?» — и дать кнопки подтверждения. Это безопаснее, чем молча выполнять поручение по неточно распознанной записи.

С изображениями та же логика. Распознавание текста или модель, которая умеет анализировать изображения, может извлечь номер счёта и сумму, но результат нужно показать человеку перед записью в учётную систему. Каждое вложение может вызвать отдельное событие, даже если пользователь отправил альбом. Telegram передаёт элементам такого альбома общий идентификатор, по которому n8n может собрать их вместе.

Команды, кнопки и управляемый диалог

Команды подходят для частых действий: /report, /new_task, /help. Telegram показывает список команд в меню, если настроить его через BotFather. Но команда — не право доступа. Если пользователь прислал /report, workflow всё равно должен проверить его from.id или роль в вашей системе.

Inline-кнопки удобны для подтверждений, навигации и изменения статуса без новых сообщений. После нажатия клиент Telegram показывает индикатор ожидания, пока бот не выполнит Answer Query. Поэтому callback лучше подтверждать сразу, а тяжёлую работу запускать после этого. Иначе пользователь видит зависшую кнопку и нажимает её повторно.

Полезный интерфейс обычно смешанный: свободный текст там, где нужно понять мысль; кнопки там, где важны точный выбор и контроль. Не нужно заставлять модель угадывать «да» или «нет», если Telegram уже умеет показать две кнопки.

• reply-кнопка отправляет в чат обычный текст, например «Продажи»;
• inline-кнопка расположена под сообщением и передаёт скрытое значение через `callback_query`, например `approve:invoice_482`.

Почему «печатает…» исчезает раньше ответа

В Telegram node есть нативная операция Send Chat Action с действием typing. Она показывает, что бот готовит ответ. Но Bot API держит такой статус не более пяти секунд, а после сообщения бота снимает его раньше.

Если модель отвечает за две-три секунды, достаточно вызвать Send Chat Action перед AI-шагом. Если генерация длится двадцать секунд, один вызов не обеспечит непрерывный статус. Его пришлось бы повторять примерно раз в несколько секунд параллельно основной обработке и вовремя остановить. Для простого n8n-workflow это уже отдельная фоновая механика с циклами, ожиданием и возможными гонками.

Разумный компромисс: один раз показать typing, а при заведомо долгой операции отправить короткое сообщение «Собираю отчёт, это займёт около минуты». В Bot API есть потоковые черновики sendMessageDraft, но по состоянию на 27 августа 2026 года такой операции нет в списке Message operations нативной Telegram-ноды n8n. Подключать сырой API только ради анимированного ответа стоит после оценки реальной пользы для пользователя.

Как не отвечать пять раз на пять быстрых сообщений

Пользователь редко формулирует запрос одним сообщением. Он пишет: «Нужен отчёт», затем «за август», потом «только Москва» и отдельно «сравни с июлем». Для Telegram это четыре Update, а для n8n — четыре независимых запуска. Наивный workflow четыре раза вызовет модель и вернёт четыре неполных ответа.

Первое решение — окно тишины. Каждый запуск сохраняет фрагмент по chat_id и время последнего сообщения. Через две-три секунды workflow проверяет, не появилось ли более новое сообщение. Обработку запускает только тот экземпляр, который увидел, что окно тишины закончилось. Фрагменты объединяются в один запрос.

Второе — явное завершение. Бот предлагает прислать вводные несколькими сообщениями, а затем нажать кнопку «Готово». Это менее «магически», зато предсказуемо для длинного брифа, набора фотографий или голосовых.

Простой Wait после каждого сообщения сам по себе проблему не решает: четыре исполнения проснутся позже и всё равно ответят четыре раза. Нужна общая запись для этого чата — например, строка в n8n Data Table или другой базе, — куда каждый запуск добавляет фрагмент и время. Обработку продолжает только запуск, соответствующий последнему сообщению. Если команда не готова разбирать параллельные исполнения и хранение состояния, безопаснее предложить кнопку «Готово».

Для действий с деньгами, публикацией или созданием записей также сохраняют идентификатор события либо собственный ключ операции. Перед действием workflow проверяет, не использован ли этот ключ раньше. Такая защита от дублей называется идемпотентностью.

Группы и каналы: публикация, мониторинг и права

Канал и чат обсуждения — разные сущности. В канале публикуют посты; в привязанной группе пользователи общаются. Telegram Trigger умеет получать channel_post, а обычные сообщения группы приходят как message.

Чтобы бот публиковал, редактировал или закреплял посты, его добавляют в канал и выдают подходящие права администратора. Для мониторинга группового общения действует Privacy Mode. По умолчанию бот видит адресованные ему команды, упоминания и ответы. Администратор группы получает все сообщения; Privacy Mode также можно изменить в BotFather, после чего бота обычно нужно добавить в группу заново. Это защищает чат от ботов, которые без причины читают каждую реплику.

Бот не получает всю статистику Telegram автоматически. Он может считать увиденные события и обращаться к доступным API, но нативная Telegram-нода n8n не заменяет полноценную аналитику канала.

• подготовить пост, показать предпросмотр и опубликовать после кнопки «Согласовать»;
• собирать вопросы под публикациями и раскладывать их по темам;
• находить просьбы о помощи и [направлять их нужному исполнителю](/flows/request-routing/);
• считать команды, заявки, вопросы и реакции на кнопки бота;
• формировать ежедневную сводку обсуждения.

Проверка подписки перед выдачей файла

Сценарий «подпишитесь и получите документ» можно собрать без AI. Пользователь открывает бота по ссылке, нажимает «Получить», а workflow берёт его from.id и вызывает Telegram → Chat → Get Member для нужного канала.

Telegram гарантирует получение статуса других пользователей через getChatMember, когда бот является администратором чата. Поэтому бота нужно добавить в канал с минимально достаточными правами. После подписки пользователь нажимает «Проверить ещё раз»: Bot API не обязан мгновенно запускать workflow только из-за самого факта подписки.

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

Практические сценарии: от отчёта до AI-помощника

Чем дороже ошибка, тем меньше действий стоит оставлять свободному тексту и модели. Telegram удобен тем, что подтверждение можно вернуть в тот же диалог кнопкой, не создавая отдельный интерфейс.

Ограничения, которые проявляются после запуска

Кроме статуса typing и файлов есть несколько эксплуатационных ограничений.

У бота один webhook. Telegram Trigger регистрирует адрес n8n. Если запустить тестовый webhook тем же токеном, он может перезаписать адрес рабочего, или production, сценария. n8n рекомендует отдельного тестового бота либо временное отключение рабочего workflow.

Self-hosted n8n должен быть доступен по HTTPS. Если n8n установлен на собственном сервере, Telegram должен видеть его публичный защищённый адрес. Ошибка в настройке домена или промежуточного веб-сервера может помешать доставке событий. Переменная WEBHOOK_URL должна указывать на публичный HTTPS-адрес.

Сообщение не бесконечное. Send Message ограничивает текст 4096 символами. Длинный ответ лучше разделить по смыслу или оформить документом, а не резать посреди абзаца.

Есть ограничения скорости. n8n приводит приблизительный общий предел в 30 сообщений в секунду, но фактические ограничения зависят от типа и адресата отправки. Массовые уведомления отправляют пакетами, а при ответе Telegram с параметром retry_after выдерживают указанную паузу.

Права зависят от контекста. Бот в личном диалоге, группе, канале и Business Connection — не одно и то же. Операция, которая работает в тестовом чате владельца, может быть запрещена в рабочем канале.

Входящие события могут идти параллельно или повторяться. Если workflow создаёт сделку, публикует пост или списывает лимит, он должен запоминать обработанное событие: повторная доставка не должна повторять бизнес-действие.

История диалога не появляется сама. Модель видит только то, что workflow передал ей в текущем вызове. Части ввода, текущий шаг анкеты, права пользователя и идентификаторы уже обработанных событий нужно хранить отдельно и удалять по понятным правилам.

Минимальная рабочая архитектура

Для первого бота не нужен десяток агентов. Достаточно прозрачного маршрута.

Начать лучше с одного сценария и десяти-двадцати реальных примеров. Проверить текст, голос, ошибочный файл, несколько быстрых сообщений, повторное нажатие кнопки, пользователя без доступа и недоступность внешней системы. После этого становится понятно, нужны ли отдельное состояние, очередь и агентная логика или достаточно фиксированного workflow.

Если используется Wazzup, меняются только вход и выход: Webhook принимает нормализованное событие, HTTP Request отправляет ответ. Правила, проверка пользователя, обработка ошибки и журнал остаются обязательными.

Что проверить перед запуском

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

• Описан один первый сценарий: кто пишет, что отправляет, откуда берутся данные, что бот возвращает и что подтверждает человек.
• Выбран правильный тип подключения: BotFather, Business Bot или внешний шлюз.
• Токен и API-ключи находятся в Credentials, а не в тексте workflow.
• У бота только необходимые права в группе и канале.
• Тестовый и рабочий боты используют разные токены.
• Текст, кнопки, голосовые и файлы проходят отдельные тестовые ветки.
• Несколько быстрых сообщений не создают несколько конфликтующих ответов.
• Повтор события или кнопки не дублирует действие.
• Долгая операция сообщает пользователю, что происходит.
• Ошибка модели или внешней системы ведёт к понятному ответу и журналу, а не к молчанию.