Telegram CRM

Telegram CRM API - Автоматизируйте ваш рабочий процесс в Telegram

Telegram CRM API: REST API в рамках рабочего пространства для синхронизации чатов и контактов, рассылок, создания тикетов и внутренних инструментов.

Бесплатная пробная

Обзор

Обзор: Telegram CRM API

REST API Entergram предоставляет программный доступ ко всему вашему рабочему пространству Telegram CRM. Синхронизируйте чаты и контакты в BigQuery, Postgres, HubSpot или Salesforce. Запускайте рассылки в Telegram при сбое платежа в Stripe или закрытии сделки. Создавайте тикеты из оповещений мониторинга. Стройте внутренний дашборд, который действительно нужен вашей команде.

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

Для интеграций с AI-агентами смотрите страницу Telegram MCP-сервера - он открывает ту же поверхность данных через Model Context Protocol, чтобы Claude, ChatGPT и другие AI-агенты могли напрямую взаимодействовать с вашим пространством Telegram.

Весь ваш Telegram CRM - доступен вашему коду

Всё, что вы делаете в дашборде Entergram, может делать и ваш код. Это обычный REST API - ключи, привязанные к рабочему пространству, JSON, стандартные HTTP-глаголы, - поэтому любой язык, способный отправить запрос, может перечислять и искать чаты Telegram, читать историю сообщений, управлять контактами и кастомными полями, открывать и обновлять тикеты, запускать рассылки.

Настройте права один раз: те же разрешения покрывают API, MCP-сервер и интеграцию с Make. com.

Читать документацию по API

Ваши аккаунты Telegram

Ваш стек

Продажи EU @lumen_sales_eu
Продажи US @lumen_sales_us
Поддержка @lumen_support
Партнёры @lumen_partners

Entergram

HubSpot
Zendesk
Slack
Notion
Make.com
Ваш API

Синхронизация Telegram в хранилище данных
Выгружайте чаты, контакты и значения кастомных полей из Entergram по расписанию. Загружайте их в BigQuery, Postgres, HubSpot или Salesforce, чтобы остальная часть бизнеса могла объединить данные Telegram с каждым другим каналом. Достаточно ночного cron-задания и нескольких вызовов API.
Запуск рассылок в Telegram по внешним событиям
Когда в Stripe происходит сбой платежа, когда в вашем CRM закрывается сделка, когда срабатывает оповещение мониторинга - отправьте POST в Entergram, и рассылка в Telegram уйдёт нужному сегменту по тегам с нужным шаблоном. Событийный обмен сообщениями без выхода из вашего текущего стека.
Программное создание тикетов
Формы, инструменты мониторинга, пайплайны поддержки по email - везде, где происходит структурированное событие - отправьте POST и создайте тикет, привязанный к нужному чату Telegram с нужным приоритетом и SLA. Замыкает петлю между Telegram и каждым другим каналом, который использует ваша команда.
Внутренние инструменты и дашборды
Стройте лидерский дашборд, который действительно нужен вашей команде - воронка по этапам, время отклика на представителя, пропускная способность по тикетам - на основе API Entergram. Привязка к рабочему пространству означает, что он всегда видит только ваши данные. Комбинируйте с Retool, Appsmith или кастомным фронтендом на React.

Характеристики

Telegram CRM API: подробно

Характеристики

Подробнее

Автоматическая пометка чатов по внешним триггерамКлиент достигает milestone в вашем продукте → API-вызов добавляет тег VIP и обновляет колонку Stage. В следующий раз, когда вы откроете чат Telegram, контекст CRM уже будет там. Работает с любым вебхуком или системой событий.
Безопасность и жизненный цикл API-ключейКлючи привязаны к рабочему пространству, хранятся в виде односторонних хешей и показываются только один раз при создании. Настройте TTL (по умолчанию 90 дней, можно меньше), опциональные белые списки IP-адресов (диапазоны CIDR) и немедленно отзывайте любой ключ из вкладки «Разработчики». Каждый вызов записывается в журнал аудита с префиксом ключа, IP и user agent.
Модель разрешенийworkspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Те же разрешения применяются к API, MCP-серверу и интеграции с Make.com. Выбирайте минимум, необходимый для вашей интеграции - принцип минимальных привилегий ограничивает последствия в случае утечки ключа.
Интеграция с Make.com (low-code)Не хотите писать код? Интеграция с Make.com использует ту же модель разрешений. Соединяйте Entergram с сотнями приложений с помощью визуальных сценариев. Действия приложения обновляют теги, обновляют данные контакта и отмечают чат как прочитанный, например платёж Stripe → обновление тега в CRM или отправка формы Typeform → данные контакта.
Смежный продукт: Telegram MCP-серверЕсли вы хотите, чтобы AI-агенты (Claude, ChatGPT, Cursor) взаимодействовали с вашим пространством Telegram, обратите внимание на Telegram MCP-сервер - он открывает ту же поверхность API через Model Context Protocol, чтобы AI-агенты могли автоматически обнаруживать и вызывать инструменты без написания API-клиента.

Возможность	Детали
Требования к тарифу	Pro (и рабочие места Pro)
Протокол	REST (JSON over HTTPS)
Эндпоинты	chats · messages · contacts · custom_fields · tickets · broadcasts · workspace · members · accounts
Аутентификация	API-ключ, привязанный к рабочему пространству (Bearer token)
TTL ключа по умолчанию	90 дней (можно настроить меньше)
Белый список IP	Опциональные диапазоны CIDR
Отзыв	Немедленный
Аудит	Каждый вызов записывает префикс ключа, IP, user agent
Лимиты запросов	По ключу и по эндпоинту - 429 с заголовком Retry-After

Часто задаваемые вопросы

Что можно делать с Telegram CRM API?

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

Какие разрешения доступны?

workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Выбирайте минимум, необходимый для вашей интеграции - принцип минимальных привилегий ограничивает последствия в случае утечки ключа. Те же разрешения применяются к API, MCP-серверу и интеграции с Make.com.

Конкретные примеры - что реально строят команды?

Торговая команда синхронизирует каждый чат Telegram в BigQuery каждый час, чтобы аналитики могли объединять данные с on-chain информацией. Команда поддержки SaaS настроила cron-задание, которое выгружает вчерашние нерешённые тикеты и отправляет их в Slack-дайджест. Команда роста запускает рассылку Telegram через вебхук каждый раз, когда происходит событие обновления тарифа в Stripe. Команда операций построила дашборд в Retool, показывающий время отклика на представителя, пропускную способность по тикетам и распределение по этапам воронки - всё на основе API Entergram.

Как создавать API-ключи и управлять ими?

Перейдите во вкладку «Разработчики» в вашем рабочем пространстве Entergram. Нажмите «Создать ключ», выберите нужные разрешения, при необходимости установите более короткий TTL и белый список IP, и скопируйте ключ. Сырой ключ показывается только один раз - храните его надёжно. Ключи хранятся в виде односторонних хешей. Любой ключ можно немедленно отозвать из той же вкладки.

Как ротировать утёкший ключ?

Вкладка «Разработчики» → найдите ключ по его префиксу → Отозвать (немедленно). Затем создайте новый ключ с теми же разрешениями и белым списком IP, задеплойте его в свою интеграцию и проверьте информацию о последнем использовании старого ключа, чтобы убедиться в отсутствии трафика.

Может ли API видеть данные другого рабочего пространства?

Нет. Каждый вызов API привязан к рабочему пространству, выдавшему ключ. Ключ из пространства A буквально не может читать пространство B - изоляция применяется на стороне сервера при каждом запросе.

Какие HTTP-ошибки могут возникнуть?

401 = ключ истёк, отозван или не соответствует рабочему пространству. 403 = у ключа нет нужного разрешения, или запрос пришёл с IP-адреса вне белого списка. 429 = превышен лимит запросов; сделайте паузу и повторите попытку согласно заголовку Retry-After.

В чём разница между API и MCP-сервером?

Оба обращаются к одним и тем же данным рабочего пространства с одинаковыми разрешениями. API предназначен для вашего кода - cron-задачи, вебхуки, внутренние инструменты, пайплайны синхронизации. MCP-сервер предназначен для AI-агентов - Claude, ChatGPT, Cursor - которые автоматически обнаруживают и вызывают инструменты через Model Context Protocol. Используйте API, когда потребитель - код; используйте MCP-сервер, когда потребитель - AI.

Поддерживает ли API вебхуки?

Исходящие вебхуки есть в дорожной карте. Сейчас поддерживается паттерн на основе опроса: вызывайте API по расписанию или в ответ на собственные события. У приложения Make.com также есть триггеры на события рабочего пространства; проверьте их список в Make, прежде чем строить сценарий вокруг одного из них.