Telegram CRM

Telegram CRM API: автоматизуйте роботу з Telegram

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

Почати безкоштовний період

Огляд

Огляд: Telegram CRM API: автоматизуйте роботу з Telegram

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

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

Для інтеграцій з AI-агентами дивіться супутню сторінку Telegram MCP server: він відкриває ті самі дані через 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 піде потрібному сегменту за тегом із потрібним шаблоном. Повідомлення за подіями без виходу з вашого наявного стеку.
Програмне створення тікетів
Форми, інструменти моніторингу, конвеєри пошти підтримки, будь-яке місце, де виникає структурована подія: надішліть її через POST як тікет, прив'язаний до потрібного чату Telegram, з потрібним пріоритетом і SLA. Так Telegram поєднується з усіма іншими каналами, якими користується ваша команда.
Внутрішні інструменти та панелі
Збудуйте панель для керівництва, якої справді хоче ваша команда (воронка за етапами, час відповіді кожного менеджера, пропускна здатність тікетів), на основі API Entergram. Обмеження робочим простором означає, що вона бачить лише ваші дані. Поєднуйте з Retool, Appsmith або власним фронтендом на React.

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

Telegram CRM API: докладно

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

Дізнатися більше

Автоматичні теги за зовнішніми тригерамиКлієнт досяг важливого етапу у вашому продукті → виклик API додає тег VIP і переводить колонку Stage далі. Коли ви наступного разу відкриєте чат у Telegram, контекст CRM уже буде на місці. Працює з будь-яким вебхуком чи системою подій.
Безпека та життєвий цикл API-ключівКлючі обмежені робочим простором, зберігаються як односторонній хеш і показуються лише один раз під час створення. Налаштуйте TTL (за замовчуванням 90 днів, можна коротше), необов'язкові списки дозволених IP (діапазони CIDR) і миттєво відкликайте будь-який ключ на вкладці Developers. Кожен виклик записується в журнал аудиту з префіксом ключа, 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 serverЯкщо ви хочете, щоб AI-агенти (Claude, ChatGPT, Cursor) працювали з вашим робочим простором Telegram, зверніть увагу на Telegram MCP server. Він відкриває ту саму поверхню API через Model Context Protocol, тож AI-агенти самі знаходять і викликають інструменти, а вам не потрібно писати код клієнта API.

Можливість	Деталі
Потрібний тариф	Pro (і місця Pro в робочому просторі)
Протокол	REST (JSON через 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, щоб аналітики поєднували їх з ончейн-даними. Команда підтримки SaaS має cron-завдання, яке вивантажує вчорашні невирішені тікети й надсилає їх у зведення в Slack. Команда зростання запускає розсилку в Telegram із вебхука щоразу, коли надходить подія апгрейду в Stripe. Операційна команда збудувала панель у Retool з часом відповіді кожного менеджера, пропускною здатністю тікетів і розподілом за етапами воронки, і все це працює на API Entergram.

Як створювати API-ключі та керувати ними?

Відкрийте вкладку Developers у своєму робочому просторі Entergram. Натисніть «Create key», виберіть потрібні області доступу, за бажанням задайте коротший TTL і список дозволених IP та скопіюйте ключ. Повний ключ показується лише один раз, тож збережіть його в надійному місці. Ключі зберігаються як односторонній хеш. Будь-який ключ можна миттєво відкликати на тій самій вкладці.

Як замінити ключ, що витік?

Вкладка Developers → знайдіть ключ за префіксом → Revoke (миттєво). Потім створіть новий ключ з тими самими областями доступу й списком дозволених 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, перш ніж будувати сценарій навколо одного з них.