Telegram CRM

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

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

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

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

Настройте права один раз: те же разрешения покрывают API, MCP-сервер и интеграцию с 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.

Автоматическая пометка чатов по внешним триггерам

Клиент достигает 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 с сотнями приложений с помощью визуальных сценариев - новое сообщение Telegram → страница Notion, бронирование Calendly → рассылка Telegram, платёж Stripe → обновление тега в CRM.

Смежный продукт: 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

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 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 по расписанию или в ответ на собственные события. Для push-автоматизаций прямо сейчас интеграция с Make.com может запускать сценарии при новых сообщениях Telegram.