Telegram API-toegang krijgen: api_id, api_hash en bot-tokens

Telegram API-gids

Telegram API-toegang krijgen: api_id, api_hash en bot-tokens

De Telegram API is niet één API, het zijn er drie: de Bot API, de Client API (MTProto) en de Gateway API. Deze gids laat je precies zien waar je je inloggegevens vandaan haalt, wat api_id, api_hash en elk een BotFather-bottaken ontgrendelen, en de derde optie die de meeste handleidingen overslaan: het verbinden van een bestaand Telegram-gebruikersaccount via Unipile zonder één enkele regel MTProto-code te schrijven.

gehoste-auth.js
// Verbind een bestaand Telegram-gebruikersaccount // Geen api_id / api_hash om zelf te beheren const link = wacht op eenpaal.gehosteAuthenticatie.create({   aanbieders ["TELEGRAM"],   verlooptOp: "2026-12-31T23:59:59.000Z" }); // Gebruiker logt in met QR-code of hun sessie // Accountstatus wordt "verbonden"
account.status: "verbonden"
Aan de slag

De 3 Telegram-API's, en welke je nodig hebt

De meeste handleidingen spreken over "de Telegram-API" alsof het één ding is. Dat is het niet. Telegram levert drie verschillende API's, elk met eigen inloggegevens, eigen regels en eigen limieten. De verkeerde kiezen is de snelste manier om een week te verspillen aan het bouwen tegen de verkeerde deur.

Bot-API

Heb je een geautomatiseerde bot nodig die reageert op commando's en berichten?
Benodigdheden: een bot-token van BotFather
  • HTTP API, geen MTProto-kennis vereist
  • Fungeert als een bot-account, geen mens
  • Gratis te gebruiken

Client-API (MTProto)

Moet je een volledige client bouwen die zich gedraagt als een echte Telegram-gebruiker?
Benodigdheden: api_id + api_hash van my.telegram.org
  • Ruw MTProto-protocol, u implementeert de cliënt
  • Fungeert als een echt gebruikersaccount
  • Gratis, één api_id per telefoonnummer

Gateway API

Hoef je alleen verificatiecodes te sturen voor telefoonnummer-authenticatie?
Benodigdheden: een Gateway API-account
  • Alleen voor eenmalige wachtwoorden (OTP), geen algemene berichten
  • Afzonderlijk gelanceerd van Bot API en Client API
  • Buiten de scope van deze handleiding
Geen van deze passen
Sla het bouwen van je eigen MTProto-client over
Unipile verbindt een bestaand Telegram-gebruikersaccount via Telegram's eigen Apparaten-functie, QR-code-inloggegevens of Hosted Auth. Geen api_id, geen api_hash, geen bot-beperkingen.
Bouw het met Unipile
Client-API / MTProto

Verkrijg uw Telegram API-inloggegevens: api_id en api_hash

Dit is het echte pad om de "Telegram-API te krijgen" waar de meeste mensen naar zoeken en dat nooit duidelijk gedocumenteerd staat: my.telegram.org, sectie API-ontwikkelingstools. Hier is de exacte wandeling, van begin tot eind.
1
Ga naar my.telegram.org en log in
Je hebt een actief Telegram-account nodig, geverifieerd met hetzelfde telefoonnummer waarmee je je zult aanmelden. Voer je telefoonnummer in en de inlogcode die naar je Telegram-app is verzonden.
2
Open "API-ontwikkelingstools"
Dit gedeelte bevindt zich onder je my.telegram.org-accountinstellingen. Dit is de enige officiële plaats waar Telegram Client API-inloggegevens uitgeeft.
3
Vul het aanvraagformulier in
App-titel, korte naam en platform. Deze velden beschrijven de applicatie die MTProto zal gebruiken en hoeven niet overeen te komen met een openbare productnaam.
4
Haal je api_id en api_hash op
Telegram geeft het paar onmiddellijk uit. api_id is een numerieke identificatiecode, api_hash is het overeenkomende geheim. Sla beide op zoals elke andere inloggegevens, ze verifiëren uw MTProto-client bij de servers van Telegram.
Eén beperking om rekening mee te houden bij de planning
Een telefoonnummer kan bevatten slechts één api_id. Als je meerdere apps of meerdere omgevingen nodig hebt, heb je meerdere telefoonwoorden nodig, of je hergebruikt dezelfde api_id in je codebase. Er is geen selfservice-manier om een tweede api_id uit te geven op hetzelfde nummer.

.env
# Van my.telegram.org, API-ontwikkelingshulpmiddelen TELEGRAM_API_ID=1234567 TELEGRAM_API_HASH=0123456789abcdef0123456789abcdef # Eén api_id per telefoonnummer; sla dit veilig op
Bouw in plaats daarvan uw accountkoppeling met Unipile
Bot-API

Verkrijg een bot-token via BotFather

Het andere pad naar de Telegram-API heeft geen my.telegram.org-account, geen api_id en geen api_hash nodig. Het werkt volledig binnen een chat met de eigen bot van Telegram, @BotFather.
1
Open een chat met @BotFather
Zoek naar "BotFather" in Telegram. Dit is de officiële bot die Telegram gebruikt om elke andere bot op het platform te maken en te beheren.
2
Stuur /newbot
BotFather leidt je direct in de chat door het maken van een nieuwe bot, geen dashboard, geen formulier.
3
Kies een naam en een gebruikersnaam
De weergavenaam kan van alles zijn. De gebruikersnaam moet uniek zijn en eindigen op bot, bijvoorbeeld mijn_ondersteuningsbot.
4
Kopieer de bot-token
BotFather antwoordt onmiddellijk met je token. Houd dit geheim, want het authenticeert elke Bot API-aanroep die je bot doet.

De huidige Bot API is versie 10.2, gepubliceerd op 14 juli 2026 (bron: core.telegram.org/bots/api). Elk bot-token werkt tegen dezelfde versie van deze HTTP-API.

terminal
# Test je bot-token met de Bot API krul "https://api.telegram.org/bot/getMe" # Voorbeeldantwoord {   "oké waar,   "resultaat {     "id": 123456789,     "is_bot": waar,     "gebruikersnaam: "my_support_bot"   } }
Vergelijking

Wat elke Telegram-API je daadwerkelijk laat doen

Vier manieren om Telegram te benaderen, vier zeer verschillende sets machtigingen. Dit is waarmee elke methode verbinding maakt, welke inloggegevens nodig zijn en waar het stopt.
CriteriaBot-APIClient-API (MTProto)Gateway APIEenpaal
Wat u aansluitEen botaccountEen echt gebruikersaccount waarvoor je de client bouwtNichts, alleen OTP-bezorgingEen bestaand echt gebruikersaccount
Inloggegevens vereistBot-token van BotFatherapi_id + api_hash van my.telegram.orgGateway API-accountQR-code-inloggen of gehoste authenticatieproviders: "TELEGRAM")
Verzendt/ontvangt als een menselijk accountNee, fungeert als een botJaGeenJa
MTProto-implementatieNiet nodig, alleen HTTPJe bouwt het zelfNiet van toepassingAfgehandeld door Unipile
GroepsdeelnemersbeheerBeperkt tot botrechtenVol, als je het bouwtNiet van toepassingDeelnemers ophalen, toevoegen, verwijderen
InstallatiecomplexiteitLaagHoi, jij bezit de MTProto-clientLaagLaag, geen MTProto om te onderhouden
KostenGratisGratisNiet behandeld in deze handleidingInbegrepen in je Unipile-abonnement
Risico op een ban bij misbruikTokenintrekkingPermanent verbod op spam/floodNiet van toepassingOpgelost met de richtlijnen voor de snelheidslimiet van Unipile
Bot-API
VerbindtEen botaccount
GeloofsbrievenBot-token (BotFather)
Handel als een mensGeen
SetupLaag
KostenGratis
Client-API (MTProto)
VerbindtEen echt gebruikersaccount (doe-het-zelf-klant)
Geloofsbrievenapi_id + api_hash
Handel als een mensJa
SetupHoi, MTProto zelfgebouwd
KostenGratis
Gateway API
VerbindtNichts, alleen OTP-bezorging
GeloofsbrievenGateway API-account
SetupLaag
ReikwijdteUit deze gids
Eenpaal
VerbindtEen bestaand echt gebruikersaccount
GeloofsbrievenQR-code of Gehoste Authenticatie
Handel als een mensJa
SetupLaag, geen MTProto om te onderhouden
GroepenDeelnemers ophalen / toevoegen / verwijderen
Wat Unipile niet dekt op Telegram
Kanalen, communities en uitzendingen, chatthema, geheime chats, contact- / locatie- / poll- / evenementbijlagen, groepsbeheer (goedkeuren, bevorderen, intrekken), chatverwijdering, archivering en spraak- of videogesprekken. Unipile verbindt het account, het repliceert niet elke Telegram-clientfunctie.
Prijzen en limieten

Het is gratis. Hier gaat het mis.

Zowel de Bot API als de Telegram API (MTProto) zijn gratis te gebruiken. Er is geen factuur, geen toeslag per bericht, geen betaalde abonnementslaag die inloggegevens afschermt. De adder onder het gras is geen geld, maar gedrag.
Overstroming, spam en neptellers
Te snel verzenden, massaal berichten sturen naar willekeurige gebruikers, of het kunstmatig opvullen van weergave- en reactietellers zijn de snelste manieren om een permanente ban, zowel op de Bot API als op de Client API.
Onofficiële clients worden in de gaten gehouden
Elke client die is gebouwd met je eigen api_id en api_hash is automatisch onder observatie geplaatst door de systemen van Telegram. Ongebruikelijke patronen worden sneller gedetecteerd dan op de officiële apps.
Unipiles eigen richtlijnen om onder de radar te blijven
Vermijd gloednieuwe Telegram-accounts voor automatisering, warm ze op zoals elk ander kanaal
Voer het berichtvolume geleidelijk op in plaats van te starten met de volledige doorvoer
Houd ten minste 10 tot 20 seconden aan tussen berichten die vanaf hetzelfde account worden verzonden
Bouw veiligere berichtenstromen met Unipile
De Unipile aanpak

De derde manier: koppel een bestaand Telegram-account

Noch de Bot API noch een zelfgebouwde MTProto-client. Unipile's Telegram API verbindt een bestaand Telegram-gebruikersaccount, via Telegrams eigen Apparaten functie, hetzelfde mechanisme waarmee je Telegram op een nieuwe telefoon of een desktop-app kunt gebruiken.
Inloggen gebeurt via een QR-codescan, of via Gehoste autorisatie met providers: "TELEGRAM" als je een white-label verbindingsstroom wilt binnen je eigen product. Eenmaal verbonden, gedraagt het account zich als zichzelf: het is geen bot en het had geen api_id of api_hash nodig die is uitgegeven via my.telegram.org.
Dit is belangrijk omdat het de twee lastigste onderdelen van het zelf bouwen op de Telegram-API wegneemt: het implementeren van MTProto en het beheren van sessies en herverbindingen wanneer een apparaat wordt verwijderd. Als het Unipile-apparaat wordt verwijderd uit de Telegram-sessies van het account, detecteert Unipile dit en verandert de accountstatus eenvoudigweg in verbroken, klaar om opnieuw verbonden te worden.
Stuur en ontvang direct messages als het echte account
Groepsdeelnemers beheren: opvragen, toevoegen, verwijderen
Geen kanalen, communities of uitzendingen
Geen groepsbeheer (goedkeuren, promoveren, intrekken), geen spraak- of videogesprekken
Begin met bouwen met Unipile

Gekoppeld account
ProviderTelegram
AuthenticatiemethodeQR-code / Gehoste verificatie
Statusaangesloten
Apparaat verwijderd van Telegramverbroken
Synchronisatie ondersteundJa
Gebruiksscenario's

CRM- en ATS-toepassingen voor de Telegram-API

Zodra een Telegram-account is gekoppeld als een echt gekoppeld account, en niet als een bot, duiken er bij klanten van Unipile consequent twee use-cases op: verkoopteams die gesprekken centraliseren en recruiters die kandidaten bereiken waar ze al zijn.

CRM: Telegram-gesprekken samenbrengen

Verkoop- en supportteams die al via Telegram communiceren met leads en klanten, willen hier geen aparte app voor. Door het account te koppelen via Unipile, komt elke Telegram-thread in dezelfde inbox terecht als e-mail-, LinkedIn- of WhatsApp-gesprekken, gekoppeld aan het juiste contactpersoon in het CRM.
Gedeelde inboxGekoppelde accountsContactsynchronisatie

ATS: bereik kandidaten via Telegram

In regio's waar Telegram een primair berichtenkanaal is, koppelen recruiters hun eigen Telegram-account om kandidaten rechtstreeks vanuit het ATS te bereiken, de volledige berichtengeschiedenis bij het profiel van de kandidaat te bewaren en conversaties over te dragen tussen recruiters zonder context te verliezen.
Kandidaat-benaderingBerichtengeschiedenisTeamoverdracht
Client-API / MTProto

Inloggen met een QR-code: de Apparaten-flow, stap voor stap

Inloggen via een QR-code is het mechanisme achter Telegrams Apparaten functie, dezelfde die je gebruikt om Telegram Desktop of Telegram Web aan je account toe te voegen. Dit is ook het proces dat Unipile namens jou uitvoert wanneer het een bestaand Telegram-gebruikersaccount verbindt. Als je dit zelf bouwt, implementeer je een tweezijdige handdruk tussen het apparaat dat het account al vertrouwt en het apparaat dat er toegang toe wil, en geen enkel verzoek/antwoord-aanroep. Dit is precies wat er gebeurt tussen de twee apps, methode voor methode.
1
Een inlogtoken aanvragen
Het apparaat dat wil inloggen belt auth.exportLoginToken. Telegram antwoordt met een auth.loginTokeneen binaire token plus een vervaltijd, over het algemeen 30 seconden.
2
Codeer het in een QR-code
Het token is gecodeerd in base64url en geplaatst in een tg://login?token=<base64url> URL. Die URL wordt op het scherm weergegeven als een scanbare QR-code.
3
Scan vanuit een reeds ingelogde app
De reeds geauthenticeerde Telegram-app scant de code en roept auth.acceptLoginToken met het gedecodeerde token.
4
Enquête voor de uitslag
Het apparaat dat inlogt, ontvangt een updateInlogToken update, bel dan auth.exportLoginToken opnieuw om het resultaat van de scan op te halen.
5
Bevestig, of migreer datacenters
Als het datacenter overeenkomt, retourneert Telegram auth.loginTokenSuccess, het inloggen is voltooid. Als het niet overeenkomt, is de reactie auth.loginTokenMigrateTo, en de cliënt moet bellen auth.importLoginToken met dezelfde token tegen het aangegeven datacenter.

qr-inlogproces
Apparaat dat om de inloggegevens vraagt auth.exportLoginToken(api_id, api_hash) // -> auth.loginToken { token, expires } // Weergegeven als een QR-code tg://login?token=<base64url(token)> Reeds geauthenticeerd apparaat scand het auth.acceptLoginToken(token) Inloggend apparaat polst opnieuw auth.exportLoginToken() // -> auth.loginTokenSuccess // of auth.loginTokenMigrateTo { dc_id }
Kort venster, plan de poging opnieuw
Het token is over het algemeen slechts geldig voor 30 seconden. Als het verloopt voordat het wordt gescand, moet de klant bellen auth.exportLoginToken nogmaals en genereer een nieuwe code, niet zomaar de oude opnieuw proberen.
AUTHENTICATIE_TOKEN_ONGELDIG
AUTH_TOKEN_VERLOPEN
AUTH_TOKEN_ALREADY_ACCEPTED
Dit is precies het uitwisselingsproces dat Unipile namens u uitvoert wanneer u via zijn Apparaten integratie: de QR-code, de token-uitwisseling, de datacenterafhandeling en de herprobeeractie wanneer een token verloopt. Je roept één eindpunt aan, Unipile voert het hierboven beschreven MTProto-gesprek uit, inclusief het geval waarin het account dat wordt verbonden zich op een ander datacenter bevindt dan het datacenter waarmee je app als eerste communiceerde. Die datacenterafhandeling is makkelijk over het hoofd te zien wanneer je de stroom vanaf nul opbouwt, omdat deze zich alleen voordoet bij een subset van accounts, en het breekt logins stilzwegend voor de accounts die het betreft als de auth.loginTokenMigrateTo vertakking wordt niet afgehandeld.
Bouw uw QR-inlogstroom met Unipile
Client-API / MTProto

Inloggen via telefoonnummer en de 2FA-muur

Het klassieke inloggen via een telefoonnummer is waar de meeste zelfgebouwde Telegram-clients vastlopen. Niet omdat het complex is, maar omdat het proces stilletjes splitst zodra tweefactorauthenticatie is ingeschakeld, en die splitsing is niet optioneel. Een client die alleen het ideale pad implementeert (code verzenden, code valideren, klaar) werkt prima bij een testaccount en faalt vervolgens in de productieomgeving zodra deze voor het eerst een echte gebruiker tegenkomt met een cloudwachtwoord ingeschakeld.
1
Stuur de inlogcode
auth.sendCode zendt de code naar het telefoonnummer en retourneert een auth.sentCode object dat een telefoon_code_hash, vereist voor het volgende gesprek.
2
Valideer de code
auth.signIn controleert de code tegen de telefoon_code_hash. Als het telefoonnummer nog geen account heeft, retourneert Telegram authenticatie.autorisatieAanmeldenVereist in plaats van een machtiging.
3
Botst op de 2fa-muur
Als tweefactorauthenticatie is ingeschakeld op het account, auth.signIn antwoorden met a 400-fout: SESSION_PASSWORD_NEEDED. Dit is de verwachte reactie voor elk account met een cloudwachtwoord, geen fout bij de uitzonderingsafhandeling.
4
Stem het af met SRP
Het voltooien van de aanmelding betekent het uitvoeren van het SRP-protocol: het bouwen van een InputCheckPasswordSRP object van de wachtwoordparameters van het account, en roep vervolgens auth.checkPassword. Een succes retourneert een auth.authorization; een onjuist wachtwoord retourneert ONGELDIGE_WACHTWOORD_HASH.
Alleen officiële apps krijgen Firebase SMS
Alleen de eigen officiële mobiele applicaties van Telegram mogen worden gebruikt Op Firebase gebaseerde verzending van sms-codes. Applicaties van derden moeten de code via een ander leveringskanaal leiden, of schrijven naar sms@telegram.org om toegang te bespreken.
Fouten die je op dit pad kunt verwachten
SESSIE_WACHTWOORD_NODIG
ONGELDIGE_WACHTWOORD_HASH
authenticatie.autorisatieAanmeldenVereist
Unipile's Telegram-integratie voert deze hele tak voor je uit: codelevering, de SESSIE_WACHTWOORD_NODIG controleer, en de SRP-uitwisseling wanneer een cloudwachtwoord is ingesteld, of het account verbinding maakt via een telefoonnummer, een QR-code, of Gehoste autorisatie. Dat omvat ook de hierboven genoemde sms-bezorgingsbeperking: omdat applicaties van derden niet kunnen steunen op op Firebase gebaseerde bezorging, is dit een van de aspecten waarbij het zelf beheren van de telefoonnummerstroom echte operationele lasten met zich meebrengt, en niet alleen code, voordat je nog maar één bericht hebt verzonden.
Verzendlimieten

Telegram API-limieten, in cijfers

Sectie 5 behandelde het gedrag dat ervoor zorgt dat accounts worden gebanned. Hier zijn de daadwerkelijke gedocumenteerde limieten aan de Bot API-kant, en wat het kost om deze te verhogen.
1/sec
Maximaal aantal berichten naar dezelfde individuele chat
20/min
Maximum aantal berichten in één groep
~30/sec
Geschat plafond voor het uitzenden naar verschillende chats
429
Er wordt een fout geretourneerd zodra een van deze limieten wordt overschreden
Betaalde uitzendingen verhogen het plafond, onder twee voorwaarden
Bots kunnen inschakelen betaalde uitzendingen via BotFather, wat de verzendlimiet verhoogt tot 1.000 berichten per seconde. Berichten die boven de gratis drempel worden verzonden, kosten 0,1 Telegram Star elk. Het is vergrendeld achter twee vereisten op accountniveau, die beide tegelijkertijd moeten worden vervuld.
100.000 Sterren saldo
100.000 maandelijks actieve gebruikers
Overschrijd de individuele, groeps- of uitzendlimiet en de Bot API antwoordt met de 429 status gedekt in de foutreferentie hieronder, samen met de 420 FLOOD en HOOSBUI_WACHT_X codes die aan de MTProto-kant worden gebruikt. Beide mechanismen bestaan om dezelfde reden: om je te vertragen voordat Telegram besluit je voor je te vertragen.
Foutreferentie

Telegram API-fouten die je moet kennen

MTProto-fouten hebben dezelfde driedimensionale structuur als de HTTP-statuscodes die de meeste ontwikkelaars al kennen, gekoppeld aan een korte machinaal leesbare tekenreeks. Hier is de referentietabel, plus één fout die alleen verschijnt voor uw eindgebruikers, en niet voor u. Het kennen van deze lijst voordat u publiceert is belangrijker dan erna: verschillende van deze codes, 303 en 420 in het bijzonder geen uitzonderlijke fouten zijn, maar deel uitmaken van de normale bedrijfsomstandigheden van een MTProto-client en in het codepad moeten worden afgehandeld, in plaats van te worden gelogd en genegeerd.
CodeBetekenis
303 Zie andereHet verzoek moet worden herhaald, gericht op een ander datacenter.
400 ONGELDIG_VERZOEKDe zoekvraag bevat fouten. API_ID_ONGELDIG is een veelvoorkomend voorbeeld van deze code.
401 NIET GEAUTORISEERDDe methode vereist een functie die is gereserveerd voor geautoriseerde gebruikers.
403 VERBODENPrivacyschending, bijvoorbeeld proberen te schrijven naar een gebruiker die jou heeft geblokkeerd.
404 NIET_GEVONDENHet gevraagde object of de gevraagde methode bestaat niet.
420 FLOOD / FLOOD_WAIT_XHet maximum aantal toegestane oproepen is overschreden, wacht X seconden voordat u het opnieuw probeert.
303 Zie andereHet verzoek moet worden herhaald, gericht op een ander datacenter.
400 ONGELDIG_VERZOEKDe zoekvraag bevat fouten. API_ID_ONGELDIG is een veelvoorkomend voorbeeld van deze code.
401 NIET GEAUTORISEERDDe methode vereist een functie die is gereserveerd voor geautoriseerde gebruikers.
403 VERBODENPrivacyschending, bijvoorbeeld proberen te schrijven naar een gebruiker die jou heeft geblokkeerd.
404 NIET_GEVONDENHet gevraagde object of de gevraagde methode bestaat niet.
420 FLOOD / FLOOD_WAIT_XHet maximum aantal toegestane oproepen is overschreden, wacht X seconden voordat u het opnieuw probeert.
Nog eentje, aan de kant van de eindgebruiker
API_ID_PUBLISHED_FLOOD verschijnt voor uw eindgebruikers wanneer een gepubliceerd programma het voorbeeld hergebruikt api_id meegestuurd in open-source voorbeeldcode in plaats van om een eigen exemplaar te vragen. Elke applicatie die u publiceert heeft een eigen nodig api_id en api_hash van my.telegram.org.
Een client die rechtstreeks is gebouwd op de Client API (MTProto) moet elk van deze codes zelf afhandelen: opnieuw proberen tegen het juiste datacenter op 303, minderen met 420, en behandelen 401 en 403 als signalen over de accountstatus in plaats van als generieke fouten. Het koppelen van een bestaand account via Unipile verplaatst die foutafhandeling achter een enkele status van een gekoppeld account, in plaats van een reeks MTProto-codes die uw eigen code bij elke aanroep juist moet interpreteren.
Client-API / MTProto

Het kiezen van een MTProto-bibliotheek, en wat deze niet voor je zal doen

Als u ervoor kiest om zelf het Client API-pad te bouwen, implementeert u MTProto niet vanaf een specificatieblad. Een handvol bibliotheken spreekt het protocol al, dus de client zelf is zelden het moeilijkste deel. Er een kiezen lost slechts een deel van het probleem op, en het deel dat het oplost is meestal het kleinste.
Python

Telethon

Een in pure Python geschreven MTProto-implementatie, gebouwd rond async/await, met een client-API die dicht in de buurt komt van normale Python in plaats van ruwe protocol-aanroepen.
Python

Pyrogram

Nog een Python MTProto-client, met een eigen aanpak voor sessiebeheer en een client-interface die meer aanvoelt als een conventionele SDK dan als een protocolbibliotheek.
Node.js

GramJS

Het dichtstbijzijnde equivalent van Telethon voor JavaScript- en TypeScript-codebases, dat dezelfde MTProto-conversatie implementeert voor een Node.js-runtime.
Officieel

TDLib

Telegram's eigen officiële bibliotheek, geschreven in C++, met bindings beschikbaar voor verschillende talen. Het implementeert de volledige MTProto-stack op dezelfde manier als Telegram's eigen apps doen.
Welke optie past, komt meestal neer op de stack die je al gebruikt in plaats van een functievergelijking: een Python-backend wijst naar Telethon of Pyrogram, wijst een Node.js- of TypeScript-backend naar GramJS, en een team dat zo dicht mogelijk bij de eigen officiële apps van Telegram wil blijven, wijst richting TDLib en de bijbehorende bindingen daarvan. Geen van die keuzes heft de tweede helft van het onderstaande werk op.
Wat een bibliotheek je geeft
De MTProto-coderingslaag en de ruwe methodeaanroepen
Verwerking van binnenkomende gebeurtenissen van Telegram-servers bijwerken
Een client-side API om auth-, messaging- en accountmethoden aan te roepen
Wat je nog zelf bouwt
Sessies betrouwbaar behouden bij herstarts en implementaties
Het end-to-end afhandelen van de SESSION_PASSWORD_NEEDED- en SRP-flow voor je gebruikers
Subonieters opnieuw verbinden en accountstatus bijhouden wanneer een apparaat wordt verwijderd
Of sla de klant helemaal over
Unipile draait de MTProto-client al voor je
Sessieduurzaamheid, de 2fa-muur, herverbinding en de levenscyclus van het account worden afgehandeld achter één API. Je verbindt een bestaand Telegram-account, je onderhoudt geen bibliotheek.
Bouw met Unipile

Telegram API: Veelgestelde Vragen

Eerlijke antwoorden over api_id, api_hash, BotFather bot-tokens en het verbinden van een bestaand Telegram-account met Unipile.

Telegram heeft niet één API, het heeft er drie. De Bot API is een HTTP-interface voor botaccounts. De Telegram API, ook wel de Client API genoemd, draait op het MTProto-protocol en is waar volledige Telegram-clients op zijn gebouwd. De Gateway API verzendt alleen verificatiecodes. Welke u nodig heeft, hangt ervan af of u een bot automatiseert of als een echt gebruikersaccount handelt.
Er is niet één enkele Telegram API-sleutel. Voor de Client API meld je je aan op my.telegram.org, open je API development tools en vul je het formulier in om een api_id en een api_hash te ontvangen. Voor de Bot API stuur je een bericht naar BotFather in Telegram en deze retourneert een bottoken. Let op dat Telegram slechts één api_id per telefoonnummer toestaat.
Ja. Telegram stelt dat zowel de Bot API als de Telegram API gratis te gebruiken zijn, zonder kosten per bericht. De echte kosten zitten in de infrastructuur die je draait, de sessiebehandeling en het risico op een ban als je te agressief verzendt.
De Bot API is een eenvoudige HTTPS-interface: je roept methoden aan zoals sendMessage op api.telegram.org met je bottoken. De Client API is een binair MTProto-protocol, wat de reden is dat de meeste ontwikkelaars een bibliotheek zoals Telethon, Pyrogram of GramJS gebruiken in plaats van dit zelf te implementeren.
Bot API 10.2, gepubliceerd op 14 juli 2026. Het volgde op 10.1 op 11 juni 2026 en 10.0 op 8 mei 2026.
Ja. Je kunt een bestaand Telegram-account koppelen via de eigen Apparaten-functie van Telegram, wat de manier is waarop Unipile accounts koppelt, met behulp van een QR-code-inlog of een gehoste authenticatiestroom. Je krijgt toegang tot het gebruikersaccount zonder zelf MTProto, sessie-opslag of tweefactorauthenticatie te hoeven implementeren.

Heb je nog vragen? Ons team staat klaar om te helpen.

Praat met een expert
Telegram API, goed aangepakt

Bouw uw Telegram API-integratie met Unipile

Sla de MTProto-client over en omzeil de botbeperkingen. Verbind een bestaand Telegram-account via Unipile en voeg het samen met WhatsApp, LinkedIn, Instagram, Gmail, Outlook en IMAP in één API.
nl_NLNL