← Все коннекторы Telegram MCP

n8n · n8n.io

Подключите Telegram к n8n

Добавьте Entergram как MCP-источник данных в n8n и автоматизируйте свой настоящий аккаунт Telegram — отмечайте пропущенные сообщения, догоняйте остывшие лиды и направляйте отзывы клиентов туда, где они нужны.

URL MCP-сервера https://mcp.entergram.com/mcp

В n8n есть нода MCP для подключения к внешним MCP-серверам. Entergram превращает ваш личный аккаунт Telegram в размещённый MCP-сервер, поэтому n8n строит визуальные автоматизации на ваших реальных чатах с полной защитой OAuth — без аккаунта бота и без своего кода.

Готовая конфигурация для вставки

n8n → MCP node → Server URL
https://mcp.entergram.com/mcp

Автоматизации, которые стоит собрать

С подключённым личным аккаунтом n8n следит за вашими чатами и действует в них. Например:

  • Каждое утро присылать сводку пропущенных сообщений и клиентов, всё ещё ждущих ответа.
  • Отмечать лиды, которые написали дважды без ответа, и создавать задачу на напоминание.
  • Когда клиент присылает отзыв — помечать его тегом и записывать в CRM или таблицу.
  • Находить вопросы, оставленные без ответа на 24 часа, и присылать себе напоминание.
  • Подсчитывать упущенные возможности за неделю и отправлять число в Slack.

Подключите n8n за 3 шага

Работает с нодой MCP в n8n.

  1. 01

    Скопируйте свой MCP-адрес в Entergram

    В Entergram откройте Settings → Workspace → Connectors → MCP и скопируйте URL вашего MCP-сервера.

  2. 02

    Добавьте ноду MCP в n8n

    В своём воркфлоу n8n добавьте ноду MCP и укажите MCP-адрес Entergram: https://mcp.entergram.com/mcp.

  3. 03

    Авторизуйтесь и собирайте

    Нажмите Connect, войдите в свой аккаунт Entergram и нажмите Allow access, а затем встройте триггеры и действия Telegram в свои сценарии n8n.

Три способа запустить Entergram внутри n8n

n8n Cloud

Самый короткий путь. Поставьте в воркфлоу ноду MCP Client, вставьте размещённый эндпойнт — и n8n Cloud сам проведёт круг OAuth на своём домене обратного вызова: ни туннеля открывать, ни сертификатов настраивать. Поскольку сервер Entergram удалённый, нода хранит учётные данные, а не поднимает локальный процесс, так что один и тот же воркфлоу одинаково выполняется на любом рабочем узле и переживает экспорт с последующим импортом в другой проект.

Self-hosted n8n

Та же нода, но с одним дополнительным условием: рукопожатие OAuth возвращает пользователя на ваш экземпляр, поэтому n8n должен знать собственный публичный адрес. Задайте переменные хоста и вебхука до создания учётных данных, иначе экран согласия завершится и отправит вас на localhost. Всё дальнейшее ведёт себя так же, как в облаке, включая совместное использование учётных данных между проектами.

N8N_HOST=n8n.yourcompany.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.yourcompany.com/

Нода AI Agent с инструментами MCP

Вместо того чтобы соединять каждый вызов руками, подключите MCP-клиент к ноде AI Agent как поставщика инструментов — и пусть модель сама решает, какие инструменты Entergram вызвать для конкретного входа. Это подходит для нечётких задач: классифицировать входящее сообщение, решить, заслуживает ли оно тикета, — там, где логику ветвления проще описать словами, чем нарисовать. Зафиксируйте список инструментов, который действительно нужен: агент с семьюдесятью доступными инструментами иногда выбирает живописный маршрут, а у агента по расписанию разрушительных инструментов вообще не должно быть под рукой.

Шесть воркфлоу, которые окупают себя

n8n не переписывается с вашим аккаунтом Telegram — он работает с ним по расписанию. Каждая строка ниже — реальная форма воркфлоу: слева триггер и цель, справа упорядоченные вызовы Entergram, которые её закрывают, и то, что оказывается в ваших системах после запуска. Всё это выполняется независимо от того, открыта ли у кого-то вкладка, — собственно, ради этого здесь и строят автоматизацию вместо чат-клиента.

Воркфлоу

Каждую ночь в 02:00 переносить все чаты рабочего пространства и их поля воронки в Postgres для BI-дашборда.

Вызванные инструменты

entergram_list_workspace_chatsentergram_list_custom_columnsentergram_get_chat_custom_fields

Результат запуска

Schedule Trigger разворачивает список чатов в ноду Loop Over Items, один раз читает схему колонок, чтобы ключи были определены, а не угаданы, и делает upsert строки на каждый диалог. Наутро аналитики запрашивают состояние воронки в Telegram обычным SQL, вообще не заходя в Entergram.

Воркфлоу

Когда CI присылает вебхук об окончании деплоя, уведомить клиентские группы, которых касается релиз.

Вызванные инструменты

entergram_list_groupsentergram_send_message

Результат запуска

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

Воркфлоу

Ежечасно закрывать тикеты, в чьих диалогах уже семь дней тишина.

Вызванные инструменты

entergram_list_ticketsentergram_list_messagesentergram_update_ticket

Результат запуска

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

Воркфлоу

По событию неудачного платежа от биллинг-провайдера открывать тикет по возврату задолженности с деталями счёта.

Вызванные инструменты

entergram_list_contactsentergram_create_ticketentergram_create_ticket_comment

Результат запуска

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

Воркфлоу

Каждое воскресенье сверять состав групп Telegram с кадровым реестром и удалять тех, кто уже ушёл.

Вызванные инструменты

entergram_list_groupsentergram_list_group_membersentergram_remove_chat_member

Результат запуска

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

Воркфлоу

Каждые пятнадцать минут пересылать в финансовый канал счета и договоры, которые клиенты скинули в чат.

Вызванные инструменты

entergram_list_messagesentergram_get_messageentergram_forward_messages

Результат запуска

Опрашивающая ветка просматривает недавнюю историю на предмет вложенных документов, нода Filter оставляет те, что подходят под ваши правила именования, а пересылка сохраняет авторство отправителя. Финансы перестают спрашивать, не лежит ли подписанный PDF всё ещё у кого-то в личке.

Что n8n может делать с вашим Telegram

  • Запускать воркфлоу по новым сообщениям и событиям
  • Находить чаты без ответа и остывшие лиды
  • Отправлять сообщения и рассылки из сценария
  • Синхронизировать контакты и кастомные поля с другими сервисами
  • Подсчитывать упущенные возможности по расписанию
  • Перемещать данные Telegram по всему вашему стеку

Набор инструментов, доступный вашим воркфлоу

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

Аккаунты и рабочее пространство

5 инструментов

Определение личности и области доступа. Любому вызову для работы с сообщениями сначала нужен account_id из list_accounts — ИИ-клиент, пропустивший этот шаг, обратится не к тому аккаунту Telegram.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Чаты и поиск

8 инструментов

Поиск переписок. Представления рабочего пространства отдают состояние CRM (тикеты, комментарии, кастомные поля), а живые представления — текущее транспортное состояние Telegram и счётчики непрочитанного.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Сообщения

9 инструментов

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

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Контакты

3 инструментов

С кем вы общаетесь и где ещё пересекаетесь. Именно поиск по общим группам позволяет отвечать на вопросы вроде «кто из моих лидов состоит в одном сообществе?».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Тикеты

10 инструментов

Полный контроль над службой поддержки: открыть, назначить, задать приоритет, прокомментировать и закрыть. Тикет ссылается на чат, из которого он появился, поэтому ИИ-клиент переходит от переписки к очереди за один шаг.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Кастомные поля CRM

11 инструментов

Схема вашей воронки. Прочитайте колонки, прежде чем записывать значения: чекбоксы принимают булевы значения, мультиселекты — массивы значений опций, а даты — строки в формате ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Кастомные поля тикетов

9 инструментов

Тот же контроль схемы на стороне тикетов — категории, уровни критичности, ступени SLA и всё остальное, что ваша поддержка отслеживает помимо статуса и приоритета.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Внутренние заметки

4 инструментов

Комментарии к чату, которых клиент никогда не увидит. Удобно, когда ИИ-клиенту нужно оставить ход своих рассуждений, чтобы его подхватил живой коллега.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Группы и каналы

11 инструментов

Создание и администрирование групп и каналов Telegram — участники, права, приватность и описание — плюс запасной вариант с выполнением сырой команды для всего остального.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

Вы авторизуете воркфлоу, а не человека

Учётные данные, созданные в n8n, продолжают работать долго после того, как вы закрыли вкладку браузера, — в этом и смысл, и риск. Решите заранее, действует ли это подключение от лица одного участника или от лица всего рабочего пространства, потому что запуски без присмотра будут раз за разом использовать всё, что вы выдали. Данные сессии Telegram остаются внутри Entergram; у n8n всегда только токен OAuth.

Персональный агент
Доступен любому участнику рабочего пространства. Он читает рабочее пространство, аккаунты, контакты, чаты, сообщения и тикеты и может читать и писать кастомные поля в чатах, принадлежащих вам. Отчётному или оповещающему воркфлоу больше ничего не нужно, а учётные данные, которые не умеют отправлять, — это учётные данные, которые не опозорят вас в три часа ночи.
Коннектор рабочего пространства
Только для владельцев и администраторов. Это тот уровень, который нужен отправляющему воркфлоу: исходящие сообщения, запись кастомных полей в любом чате, администрирование групп. Он общий для команды, поэтому коллега сможет поддерживать автоматизацию, не пересоздавая учётные данные под своим именем. Держите отправляющие воркфлоу в отдельном проекте от отчётных, чтобы мощные учётные данные не были по умолчанию привязаны ко всему подряд.
Отзыв доступа
Отзовите токен в Settings → Workspace → Connectors → MCP — и каждое запланированное выполнение начнёт падать на следующем вызове, а не молча продолжать работу. Удаление учётных данных внутри n8n даёт тот же эффект с другой стороны. Отзывайте доступ до офбординга того, кто строил воркфлоу, а не после.

Ограничения, под которые стоит проектировать воркфлоу

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

  • Доступ к MCP входит в тариф Pro. Учётные данные авторизуются на любом тарифе, поэтому проблема всплывает позже — в виде ошибок инструментов внутри запланированного выполнения, а не при настройке.
  • MCP — это запрос и ответ, а не push-канал. Entergram не открывает сокет в n8n, поэтому ощущение событийности создаёт Schedule Trigger с достаточно частым опросом: компромисс между задержкой и количеством выполнений.
  • Отправку за вас никто не согласует. В чат-клиенте каждый черновик читает человек, у задачи по расписанию его нет — относитесь к исходящим веткам как к продакшен-коду, закрывайте их явными фильтрами и флагом тестового режима.
  • Пакетного эндпойнта нет. Рассылка в тридцать чатов — это тридцать отдельных вызовов, поэтому притормаживайте цикл, ограничивайте повторные попытки и помните, что потолком станет собственный флуд-контроль Telegram, а не воркфлоу.
  • Упавший запуск не атомарен. Если выполнение умерло на середине цикла, уже совершённые отправки и записи полей останутся: делайте воркфлоу идемпотентным и фиксируйте, что уже обработано, вместо надежды на чистый откат.
  • Токены истекают. Автоматизация, работавшая неделями, может встать за ночь просто потому, что никто не подтвердил доступ заново, — добавьте ветку обработки ошибок, которая оповестит человека, а не упадёт в пустой лог.

Решение проблем с коннектором n8n

OAuth проходит, но перенаправляет на localhost
Self-hosted экземпляр, не знающий своего публичного адреса, отправляет обратный вызов сам себе. Задайте переменные хоста, протокола и вебхука равными тому URL, который вы реально открываете в браузере, перезапустите n8n, а затем удалите и создайте учётные данные заново — в существующих старый redirect уже зашит.
Нода подключается, но не показывает инструментов
n8n кэширует манифест инструментов в момент создания учётных данных. Откройте ноду заново и обновите список инструментов или один раз продублируйте ноду: воркфлоу, сохранённый до загрузки манифеста, так и будет ссылаться на пустой набор.
Ноды чтения работают, ноды отправки возвращают 403
Это персональный агент, делающий ровно то, на что рассчитан. Исходящие сообщения — прерогатива коннектора рабочего пространства, который создаёт владелец или администратор; повторная авторизация тех же личных учётных данных прав не расширит. Если 403 приходит и на ноды чтения, смотрите на тариф: доступ к MCP требует Pro.
Воркфлоу пишет не из того аккаунта Telegram
Каждому инструменту сообщений нужен явный account_id, и неуказанный определяется за вас. Вызовите список аккаунтов один раз в начале воркфлоу, закрепите нужный id как переменную воркфлоу и ссылайтесь на неё во всех последующих нодах.
Расписание, работавшее неделями, внезапно падает
Почти всегда это истёкший токен. Откройте учётные данные, переподключитесь, подтвердите доступ заново — и ожидающие выполнения возобновятся со следующего тика. Заведите выход ошибок ноды MCP на уведомление, чтобы о следующем истечении вы узнали не от клиента.
Выполнения отваливаются по тайм-ауту на больших выгрузках сообщений
Чтение полной истории по сотням веток в одной ноде выходит за лимит времени выполнения. Разбейте список чатов через Loop Over Items, ограничьте размер пакета и сохраняйте курсор, чтобы каждый запуск продолжал с места остановки. Первичная выгрузка должна быть отдельным воркфлоу от инкрементального, который работает каждый час.

n8n + Telegram: частые вопросы

Заменяет ли это нативную ноду Telegram в n8n?
Дополняет её. Нативная нода Telegram работает с токеном бота; Entergram подключает ваш настоящий личный аккаунт через MCP, поэтому вы автоматизируете чаты, которые боту не видны.
Self-hosted или облачный n8n?
И то и другое. Любой экземпляр n8n с нодой MCP может подключиться к размещённому MCP-адресу Entergram по OAuth.
Может ли это оповещать меня о пропущенных сообщениях?
Да. Соберите воркфлоу, который по расписанию читает чаты без ответа и присылает вам сводку или напоминание туда, куда вам удобно.
Это безопасно?
Да. OAuth 2.0 с ограниченными правами; учётные данные остаются в Entergram, а доступ можно отозвать в любой момент.