Telegram CRM

Telegram CRM API: automatiseer je Telegram-workflow

Telegram CRM API: een REST API per workspace om chats en contacten te synchroniseren, broadcasts te starten, tickets aan te maken en interne tools te bouwen op je eigen data.

Start gratis proefperiode

Overzicht

Overzicht: Telegram CRM API: automatiseer je Telegram-workflow

Met de REST API van Entergram heb je programmatisch toegang tot je volledige Telegram-CRM-workspace. Synchroniseer chats en contacten naar BigQuery, Postgres, HubSpot of Salesforce. Start Telegram-broadcasts wanneer een Stripe-betaling mislukt of een deal wordt gesloten. Maak tickets aan vanuit monitoringmeldingen. Bouw het interne dashboard waar je team echt om vraagt.

Elke API-aanroep is gebonden aan de workspace, wordt vastgelegd in het auditlog en valt onder hetzelfde scopemodel met minimale rechten dat overal in het platform geldt. Sleutels kun je roteren, beperken tot bepaalde IP-adressen en met één klik intrekken. Voor integraties met AI-agents is er de bijbehorende pagina over de Telegram MCP-server.

Die ontsluit dezelfde data via het Model Context Protocol, zodat Claude, ChatGPT en andere AI-agents rechtstreeks met je Telegram-workspace kunnen werken.

Je hele Telegram-CRM, beschikbaar voor je code

Alles wat je in het Entergram-dashboard doet, kan je code ook. Het is een gewone REST API (sleutels per workspace, JSON, standaard HTTP-methoden), dus elke taal die een request kan versturen, kan Telegram-chats opvragen en doorzoeken, de berichtgeschiedenis lezen, contacten en aangepaste velden beheren, tickets openen en bijwerken en broadcasts starten.

Je stelt de rechten één keer in: dezelfde scopes gelden voor de API, de MCP-server en de Make. com-integratie.

Lees de API-documentatie

Je Telegram-accounts

Je stack

Sales EU @lumen_sales_eu
Sales US @lumen_sales_us
Support @lumen_support
Partners @lumen_partners

Entergram

HubSpot
Zendesk
Slack
Notion
Make.com
Je eigen API

Synchroniseer Telegram met je datawarehouse
Haal volgens een schema chats, contacten en waarden van aangepaste velden uit Entergram. Zet ze in BigQuery, Postgres, HubSpot of Salesforce, zodat de rest van het bedrijf Telegram-data kan combineren met elk ander kanaal. Een nachtelijke cronjob en een paar API-aanroepen is alles wat je nodig hebt.
Start Telegram-broadcasts vanuit externe gebeurtenissen
Als een betaling in Stripe mislukt, een deal in je CRM wordt gesloten of een monitoringmelding afgaat: stuur een POST naar Entergram en er gaat een Telegram-broadcast met de juiste template naar het juiste getagde segment. Berichten op basis van gebeurtenissen, zonder je bestaande stack te verlaten.
Tickets programmatisch aanmaken
Formulieren, monitoringtools, e-mailpipelines voor support: overal waar een gestructureerde gebeurtenis plaatsvindt, stuur je die als POST in als ticket, gekoppeld aan de juiste Telegram-chat met de juiste prioriteit en SLA. Zo sluit je de cirkel tussen Telegram en elk ander kanaal dat je team gebruikt.
Interne tools en dashboards
Bouw het managementdashboard waar je team echt om vraagt (pipeline per stage, responstijd per medewerker, aantal afgehandelde tickets) op basis van de API van Entergram. Omdat alles aan de workspace gebonden is, ziet het alleen jouw data. Combineer het met Retool, Appsmith of een eigen React-frontend.

Specificaties

Telegram CRM API in detail

Specificaties

Meer informatie

Chats automatisch taggen vanuit externe triggersEen klant bereikt een mijlpaal in je product → een API-aanroep voegt de tag VIP toe en zet de Stage-kolom een stap verder. Open je de Telegram-chat daarna, dan staat de CRM-context er al. Werkt met elk webhook- of eventsysteem.
Beveiliging en levenscyclus van API-sleutelsSleutels zijn gebonden aan de workspace, worden eenrichtings gehasht opgeslagen en worden alleen bij het aanmaken één keer getoond. Stel een TTL in (standaard 90 dagen, korter als je wilt), optionele IP-allowlists (CIDR-bereiken), en trek elke sleutel direct in via het tabblad Developers. Elke aanroep wordt vastgelegd in het auditlog met het sleutelprefix, het IP-adres en de user agent.
Scopemodelworkspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Dezelfde scopes gelden voor de API, de MCP-server en de Make.com-integratie. Kies het minimum dat je integratie nodig heeft: minimale rechten beperken de schade als een sleutel uitlekt.
Make.com-integratie (low-code)Geen zin om code te schrijven? De Make.com-integratie gebruikt hetzelfde scopemodel. Koppel Entergram met visuele scenario's aan honderden apps. De acties van de app werken tags bij, werken contactgegevens bij en markeren een chat als gelezen, bijvoorbeeld Stripe-betaling → update van een CRM-tag of Typeform-inzending → contactgegevens.
Aanvulling: Telegram MCP-serverWil je dat AI-agents (Claude, ChatGPT, Cursor) met je Telegram-workspace werken? Bekijk dan de Telegram MCP-server. Die ontsluit dezelfde API via het Model Context Protocol, zodat AI-agents tools automatisch kunnen vinden en aanroepen, zonder dat jij code voor een API-client hoeft te schrijven.

Mogelijkheid	Details
Vereist abonnement	Pro (en Pro-seats in een workspace)
Protocol	REST (JSON via HTTPS)
Endpoints	chats · messages · contacts · custom_fields · tickets · broadcasts · workspace · members · accounts
Authenticatie	API-sleutel per workspace (Bearer-token)
Standaard-TTL van sleutels	90 dagen (korter in te stellen)
IP-allowlist	Optionele CIDR-bereiken
Intrekken	Direct
Audit	Elke aanroep legt sleutelprefix, IP-adres en user agent vast
Rate limits	Per sleutel en per endpoint: 429 met Retry-After-header

Veelgestelde vragen

Wat kan ik doen met de Telegram CRM API?

Telegram-chats opvragen en doorzoeken, de berichtgeschiedenis lezen, contacten en aangepaste velden beheren, tickets met prioriteit en toegewezen persoon aanmaken en bijwerken, broadcasts naar getagde segmenten starten, tags toevoegen en verwijderen, en waarden van aangepaste velden bijwerken. Elk endpoint is gebonden aan de workspace en wordt vastgelegd in het auditlog.

Welke scopes zijn er beschikbaar?

workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Kies het minimum dat je integratie nodig heeft: minimale rechten beperken de schade als een sleutel uitlekt. Dezelfde scopes gelden voor de API, de MCP-server en de Make.com-integratie.

Concrete voorbeelden: wat bouwen echte teams?

Een tradingteam synchroniseert elk uur alle Telegram-chats naar BigQuery, zodat analisten ze kunnen combineren met on-chain data. Een SaaS-supportteam laat een cronjob de onopgeloste tickets van gisteren ophalen en als overzicht naar Slack sturen. Een growthteam start een Telegram-broadcast vanuit een webhook zodra er een upgrade-event van Stripe binnenkomt. Een opsteam bouwde een Retool-dashboard met de responstijd per medewerker, de aantal afgehandelde tickets en de verdeling over pipelinefases, allemaal aangedreven door de API van Entergram.

Hoe maak en beheer ik API-sleutels?

Ga naar het tabblad Developers in je Entergram-workspace. Klik op 'Create key', selecteer de scopes die je nodig hebt, stel eventueel een kortere TTL en een IP-allowlist in en kopieer de sleutel. De volledige sleutel wordt maar één keer getoond, dus bewaar hem veilig. Sleutels worden eenrichtings gehasht opgeslagen. Trek elke sleutel direct in via hetzelfde tabblad.

Hoe roteer ik een uitgelekte sleutel?

Tabblad Developers → zoek de sleutel op zijn prefix → Revoke (direct). Maak daarna een nieuwe sleutel met dezelfde scopes en IP-allowlist, zet die in je integratie en controleer de laatste gebruiksgegevens van de oude sleutel om te bevestigen dat er geen verkeer meer is.

Kan de API data van een andere workspace zien?

Nee. Elke API-aanroep is gebonden aan de workspace die de sleutel heeft uitgegeven. Een sleutel van workspace A kan workspace B letterlijk niet lezen. Die afbakening wordt bij elke query aan de serverkant afgedwongen.

Welke HTTP-fouten kan ik tegenkomen?

401 = de sleutel is verlopen, ingetrokken of hoort niet bij deze workspace. 403 = de sleutel mist de benodigde scope, of het verzoek kwam van een IP-adres buiten de allowlist. 429 = je hebt een rate limit bereikt; wacht even en probeer opnieuw volgens de Retry-After-header.

Wat is het verschil tussen de API en de MCP-server?

Beide geven toegang tot dezelfde workspacedata met dezelfde scopes. De API is voor je code: cronjobs, webhooks, interne tools, synchronisatiepipelines. De MCP-server is voor AI-agents (Claude, ChatGPT, Cursor) die tools automatisch vinden en aanroepen via het Model Context Protocol. Gebruik de API als code de afnemer is; gebruik de MCP-server als AI dat is.

Ondersteunt de API webhooks?

Uitgaande webhooks staan op de roadmap. Op dit moment werkt het volgens een pull-model: roep de API aan volgens een schema of als reactie op je eigen gebeurtenissen. De Make.com-app heeft ook triggers op workspace-gebeurtenissen; bekijk de lijst in Make voordat je een scenario rond een ervan ontwerpt.