Inhoudsopgave
Uw inloggegevens ophalen
Authenticatie & vergelijking
Limieten en betrouwbaarheid
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.// 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
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.
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.
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.
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.
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.
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.
# Van my.telegram.org, API-ontwikkelingshulpmiddelen
TELEGRAM_API_ID=1234567
TELEGRAM_API_HASH=0123456789abcdef0123456789abcdef
# Eén api_id per telefoonnummer; sla dit veilig opBot-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.
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
BotFather leidt je direct in de chat door het maken van een nieuwe bot, geen dashboard, geen formulier.
/newbotBotFather 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
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.
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.
# 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.
| Criteria | Bot-API | Client-API (MTProto) | Gateway API | Eenpaal |
|---|---|---|---|---|
| Wat u aansluit | Een botaccount | Een echt gebruikersaccount waarvoor je de client bouwt | Nichts, alleen OTP-bezorging | Een bestaand echt gebruikersaccount |
| Inloggegevens vereist | Bot-token van BotFather | api_id + api_hash van my.telegram.org | Gateway API-account | QR-code-inloggen of gehoste authenticatieproviders: "TELEGRAM") |
| Verzendt/ontvangt als een menselijk account | Nee, fungeert als een bot | Ja | Geen | Ja |
| MTProto-implementatie | Niet nodig, alleen HTTP | Je bouwt het zelf | Niet van toepassing | Afgehandeld door Unipile |
| Groepsdeelnemersbeheer | Beperkt tot botrechten | Vol, als je het bouwt | Niet van toepassing | Deelnemers ophalen, toevoegen, verwijderen |
| Installatiecomplexiteit | Laag | Hoi, jij bezit de MTProto-client | Laag | Laag, geen MTProto om te onderhouden |
| Kosten | Gratis | Gratis | Niet behandeld in deze handleiding | Inbegrepen in je Unipile-abonnement |
| Risico op een ban bij misbruik | Tokenintrekking | Permanent verbod op spam/flood | Niet van toepassing | Opgelost 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.
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.
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.
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 Bouw veiligere berichtenstromen met Unipile
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
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
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.
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.
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
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
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
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
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
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. 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
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
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
Bouw uw QR-inlogstroom met Unipile auth.loginTokenMigrateTo vertakking wordt niet afgehandeld.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,
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
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.
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.
SESSIE_WACHTWOORD_NODIG
ONGELDIGE_WACHTWOORD_HASH
authenticatie.autorisatieAanmeldenVereist
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
Maximaal aantal berichten naar dezelfde individuele chat
20/min
Maximum aantal berichten in één groep
Maximum aantal berichten in één groep
~30/sec
Geschat plafond voor het uitzenden naar verschillende chats
Geschat plafond voor het uitzenden naar verschillende chats
429
Er wordt een fout geretourneerd zodra een van deze limieten wordt overschreden
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
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.Deze nummers zijn specifiek voor de Bot API. Voor een verbonden gebruikersaccount, er is geen gepubliceerd plafond, alleen Unipile's eigen snelheidsrichtlijnen behandeld in het is gratis, hier zit het addertje onder het graswarm nieuwe accounts op, voer het geleidelijk op, houd ten minste 10 tot 20 seconden aan tussen berichten.
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.| Code | Betekenis |
|---|---|
| 303 Zie andere | Het verzoek moet worden herhaald, gericht op een ander datacenter. |
| 400 ONGELDIG_VERZOEK | De zoekvraag bevat fouten. API_ID_ONGELDIG is een veelvoorkomend voorbeeld van deze code. |
| 401 NIET GEAUTORISEERD | De methode vereist een functie die is gereserveerd voor geautoriseerde gebruikers. |
| 403 VERBODEN | Privacyschending, bijvoorbeeld proberen te schrijven naar een gebruiker die jou heeft geblokkeerd. |
| 404 NIET_GEVONDEN | Het gevraagde object of de gevraagde methode bestaat niet. |
| 420 FLOOD / FLOOD_WAIT_X | Het 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
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.
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.