CRM dla Telegrama

Telegram CRM API: automatyzuj pracę z Telegramem

Telegram CRM API: REST API w zakresie workspace do synchronizacji czatów i kontaktów, uruchamiania broadcastów, tworzenia zgłoszeń i budowy wewnętrznych narzędzi na własnych danych.

Rozpocznij bezpłatny okres próbny

Przegląd

Przegląd: Telegram CRM API: automatyzuj pracę z Telegramem

REST API Entergram daje programowy dostęp do całej przestrzeni roboczej Twojego CRM dla Telegrama. Synchronizuj czaty i kontakty z BigQuery, Postgres, HubSpot lub Salesforce. Wysyłaj broadcasty w Telegramie, gdy płatność w Stripe się nie powiedzie albo transakcja zostanie zamknięta. Twórz zgłoszenia z alertów monitoringu. Zbuduj wewnętrzny panel, którego Twój zespół naprawdę potrzebuje.

Każde wywołanie API jest ograniczone do przestrzeni roboczej, zapisywane w dzienniku audytu i podlega temu samemu modelowi zakresów najmniejszych uprawnień, który obowiązuje w całej platformie. Klucze można rotować, ograniczać do adresów IP i unieważniać jednym kliknięciem. Integracje z agentami AI opisuje towarzysząca strona serwera Telegram MCP.

Udostępnia on te same dane przez Model Context Protocol, dzięki czemu Claude, ChatGPT i inni agenci AI mogą bezpośrednio pracować z Twoją przestrzenią roboczą w Telegramie.

Cały Twój CRM dla Telegrama, dostępny dla Twojego kodu

Wszystko, co robisz w panelu Entergram, może zrobić też Twój kod. To zwykłe REST API (klucze ograniczone do przestrzeni roboczej, JSON, standardowe metody HTTP), więc w każdym języku, który potrafi wysłać żądanie, możesz wyświetlać i przeszukiwać czaty Telegrama, czytać historię wiadomości, zarządzać kontaktami i polami niestandardowymi, otwierać i aktualizować zgłoszenia oraz wysyłać broadcasty.

Uprawnienia ustawiasz raz: te same zakresy obejmują API, serwer MCP i integrację z Make. com.

Przeczytaj dokumentację API

Twoje konta Telegram

Twój stos

Sprzedaż EU @lumen_sales_eu
Sprzedaż US @lumen_sales_us
Wsparcie @lumen_support
Partnerzy @lumen_partners

Entergram

HubSpot
Zendesk
Slack
Notion
Make.com
Twoje API

Synchronizuj Telegram z hurtownią danych
Pobieraj czaty, kontakty i wartości pól niestandardowych z Entergram według harmonogramu. Przenoś je do BigQuery, Postgres, HubSpot lub Salesforce, żeby reszta firmy mogła łączyć dane z Telegrama z każdym innym kanałem. Wystarczy nocne zadanie cron i kilka wywołań API.
Wysyłaj broadcasty w Telegramie po zdarzeniach zewnętrznych
Gdy płatność w Stripe się nie powiedzie, gdy w Twoim CRM zamknie się transakcja, gdy uruchomi się alert monitoringu, wyślij POST do Entergram, a broadcast w Telegramie trafi do właściwego otagowanego segmentu z właściwym szablonem. Komunikacja sterowana zdarzeniami bez wychodzenia z obecnego stosu narzędzi.
Programowe tworzenie zgłoszeń
Formularze, narzędzia monitoringu, potoki e-maili supportowych: wszędzie, gdzie pojawia się ustrukturyzowane zdarzenie, wyślij je przez POST jako zgłoszenie powiązane z właściwym czatem w Telegramie, z właściwym priorytetem i SLA. To zamyka obieg między Telegramem a każdym innym kanałem, z którego korzysta Twój zespół.
Wewnętrzne narzędzia i panele
Zbuduj panel dla kierownictwa, którego Twój zespół naprawdę potrzebuje (lejek według etapów, czas odpowiedzi na handlowca, przepustowość zgłoszeń), oparty na API Entergram. Ograniczenie do przestrzeni roboczej oznacza, że panel widzi wyłącznie Twoje dane. Połącz go z Retool, Appsmith albo własnym frontendem w React.

Specyfikacja

Telegram CRM API w szczegółach

Specyfikacja

Dowiedz się więcej

Automatyczne tagowanie czatów po zewnętrznych zdarzeniachKlient osiąga kamień milowy w Twoim produkcie → wywołanie API dodaje tag VIP i przesuwa kolumnę Stage. Gdy następnym razem otworzysz czat w Telegramie, kontekst CRM już tam będzie. Działa z każdym webhookiem i systemem zdarzeń.
Bezpieczeństwo i cykl życia kluczy APIKlucze są ograniczone do przestrzeni roboczej, przechowywane jako skrót jednokierunkowy i pokazywane tylko raz, przy tworzeniu. Skonfiguruj TTL (domyślnie 90 dni, krócej, jeśli wolisz), opcjonalne listy dozwolonych adresów IP (zakresy CIDR) i natychmiast unieważnij dowolny klucz w zakładce Developers. Każde wywołanie jest zapisywane w dzienniku audytu z prefiksem klucza, adresem IP i user agentem.
Model zakresówworkspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Te same zakresy obowiązują w API, serwerze MCP i integracji z Make.com. Wybierz minimum, którego potrzebuje Twoja integracja. Zasada najmniejszych uprawnień ogranicza skutki wycieku klucza.
Integracja z Make.com (low-code)Nie chcesz pisać kodu? Integracja z Make.com korzysta z tego samego modelu zakresów. Połącz Entergram z setkami aplikacji za pomocą wizualnych scenariuszy. Akcje aplikacji aktualizują tagi, aktualizują dane kontaktu i oznaczają czat jako przeczytany, na przykład płatność w Stripe → aktualizacja tagu w CRM albo wysłany formularz Typeform → dane kontaktu.
Uzupełnienie: serwer Telegram MCPJeśli chcesz, żeby agenci AI (Claude, ChatGPT, Cursor) pracowali z Twoją przestrzenią roboczą w Telegramie, zajrzyj do serwera Telegram MCP. Udostępnia on te same możliwości API przez Model Context Protocol, więc agenci AI mogą automatycznie wykrywać i wywoływać narzędzia, bez pisania przez Ciebie kodu klienta API.

Funkcja	Szczegóły
Wymagany plan	Pro (oraz stanowiska Pro w przestrzeni roboczej)
Protokół	REST (JSON przez HTTPS)
Endpointy	chats · messages · contacts · custom_fields · tickets · broadcasts · workspace · members · accounts
Uwierzytelnianie	Klucz API ograniczony do przestrzeni roboczej (Bearer token)
Domyślny TTL klucza	90 dni (można ustawić krótszy)
Lista dozwolonych adresów IP	Opcjonalne zakresy CIDR
Unieważnianie	Natychmiastowe
Audyt	Każde wywołanie zapisuje prefiks klucza, adres IP, user agent
Limity żądań	Na klucz i na endpoint: 429 z nagłówkiem Retry-After

Najczęstsze pytania

Co mogę zrobić z Telegram CRM API?

Wyświetlać i przeszukiwać czaty Telegrama, czytać historię wiadomości, zarządzać kontaktami i polami niestandardowymi, tworzyć i aktualizować zgłoszenia z priorytetem i osobą przypisaną, uruchamiać broadcasty do otagowanych segmentów, dodawać i usuwać tagi oraz aktualizować wartości pól niestandardowych. Każdy endpoint jest ograniczony do przestrzeni roboczej i zapisywany w dzienniku audytu.

Jakie zakresy są dostępne?

workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Wybierz minimum, którego potrzebuje Twoja integracja. Zasada najmniejszych uprawnień ogranicza skutki wycieku klucza. Te same zakresy obowiązują w API, serwerze MCP i integracji z Make.com.

Konkretne przykłady: co budują prawdziwe zespoły?

Zespół tradingowy co godzinę synchronizuje każdy czat z Telegrama do BigQuery, żeby analitycy mogli łączyć go z danymi on-chain. Zespół wsparcia firmy SaaS ma zadanie cron, które pobiera wczorajsze nierozwiązane zgłoszenia i wysyła je jako podsumowanie na Slacka. Zespół growth wysyła broadcast w Telegramie z webhooka za każdym razem, gdy pojawi się zdarzenie upgrade w Stripe. Zespół operacyjny zbudował w Retool panel pokazujący czas odpowiedzi na handlowca, przepustowość zgłoszeń i rozkład etapów lejka, w całości oparty na API Entergram.

Jak tworzyć klucze API i nimi zarządzać?

Przejdź do zakładki Developers w swojej przestrzeni roboczej Entergram. Kliknij „Create key”, wybierz potrzebne zakresy, opcjonalnie ustaw krótszy TTL i listę dozwolonych adresów IP, a następnie skopiuj klucz. Pełny klucz jest pokazywany tylko raz, więc przechowuj go w bezpiecznym miejscu. Klucze są przechowywane jako skrót jednokierunkowy. Dowolny klucz unieważnisz natychmiast w tej samej zakładce.

Jak zrotować klucz, który wyciekł?

Zakładka Developers → znajdź klucz po prefiksie → Revoke (natychmiast). Następnie utwórz nowy klucz z tymi samymi zakresami i listą dozwolonych adresów IP, wdróż go w swojej integracji i sprawdź informacje o ostatnim użyciu starego klucza, żeby potwierdzić, że nie ma już ruchu.

Czy API widzi dane innej przestrzeni roboczej?

Nie. Każde wywołanie API jest ograniczone do przestrzeni roboczej, która wydała klucz. Klucz z przestrzeni roboczej A dosłownie nie może odczytać przestrzeni roboczej B, bo ograniczenie jest egzekwowane po stronie serwera przy każdym zapytaniu.

Jakie błędy HTTP mogę zobaczyć?

401 = klucz wygasł, został unieważniony albo nie pasuje do przestrzeni roboczej. 403 = klucz nie ma wymaganego zakresu albo żądanie przyszło z adresu IP spoza listy dozwolonych. 429 = przekroczono limit żądań; odczekaj i ponów próbę zgodnie z nagłówkiem Retry-After.

Czym różni się API od serwera MCP?

Oba mają dostęp do tych samych danych przestrzeni roboczej, z tymi samymi zakresami. API jest dla Twojego kodu: zadań cron, webhooków, narzędzi wewnętrznych, potoków synchronizacji. Serwer MCP jest dla agentów AI (Claude, ChatGPT, Cursor), które automatycznie wykrywają i wywołują narzędzia przez Model Context Protocol. Używaj API, gdy odbiorcą jest kod; używaj serwera MCP, gdy odbiorcą jest AI.

Czy API obsługuje webhooki?

Wychodzące webhooki są w planach. Obecnie model opiera się na pobieraniu: wywołuj API według harmonogramu albo w odpowiedzi na własne zdarzenia. Aplikacja Make.com ma też wyzwalacze dla zdarzeń w przestrzeni roboczej; sprawdź ich listę w Make, zanim zaprojektujesz scenariusz wokół jednego z nich.