Inhaltsübersicht
Abrufen Ihrer Anmeldeinformationen
Authentifizierung & Vergleich
Grenzwerte & Zuverlässigkeit
Telegram-API-Handbuch
So erhalten Sie Zugriff auf die Telegram-API: api_id, api_hash und Bot-Token
Die Telegramm-API ist nicht eine API, es sind drei: die Bot-API, die Client-API (MTProto) und die Gateway-API. Dieser Leitfaden zeigt Ihnen genau, wo Sie Ihre Anmeldeinformationen erhalten, was
api_id, API-Hash und jeweils einen BotFather-Bot-Token freischalten, und die dritte Option, die die meisten Anleitungen überspringen: das Verbinden eines bestehenden Telegram-Benutzerkontos über Unipile, ohne eine einzige Zeile MTProto-Code zu schreiben.// Bestehendes Telegram-Benutzerkonto verknüpfen
// Keine api_id / api_hash selbst zu verwalten
const Verknüpfung = await unipile.Gehostete Authentifizierung.create({
Anbieter: ["TELEGRAMM"],
gültigBis: "2026-12-31T23:59:59.000Z"
});
// Benutzer meldet sich mit QR-Code oder ihrer Sitzung an
// Kontostatus wird zu "verbunden"account.status: "verbunden"
Erste Schritte
Die 3 Telegram-APIs und welche Sie benötigen
Die meisten Anleitungen sprechen von "der Telegram-API", als ob es eine einzige gäbe. Das stimmt nicht. Telegram bietet drei verschiedene APIs an, jede mit eigenen Zugangsdaten, eigenen Regeln und eigenen Limits. Die falsche auszuwählen ist der schnellste Weg, eine Woche damit zu verschwenden, an der falschen Tür zu bauen.
Bot-API
Benötigst du einen automatisierten Bot, der auf Befehle und Nachrichten reagiert?
Benötigt: ein Bot-Token von BotFather
- HTTP-API, keine MTProto-Kenntnisse erforderlich
- Agiert wie ein Bot-Account, nicht wie ein Mensch
- Kostenlos zu verwenden
Client-API (MTProto)
Müssen Sie einen vollständigen Client erstellen, der wie ein echter Telegram-Benutzer agiert?
Benötigt: api_id + api_hash von my.telegram.org
- Rohes MTProto-Protokoll, Sie implementieren den Client
- Agierst wie ein echtes Benutzerkonto
- Kostenlos, eine api_id pro Telefonnummer
Gateway-API
Müssen Sie nur Bestätigungscodes für die Telefonnummern-Authentifizierung senden?
Benötigt: Ein Gateway-API-Konto
- Nur OTP-Zustellung, keine allgemeinen Nachrichten
- Getrennt von Bot-API und Client-API gestartet
- Außerhalb des Geltungsbereichs dieses Leitfadens
Client-API / MTProto
Holen Sie sich Ihre Telegram-API-Zugangsdaten: api_id und api_hash
Dies ist der echte "Telegram-API-abrufen"-Pfad, nach dem die meisten Leute suchen und den sie nie klar dokumentiert finden: my.telegram.org, Abschnitt API-Entwicklungstools. Hier ist der genaue Weg, von Anfang bis Ende.
1
Gehe zu my.telegram.org und melde dich an.
Sie benötigen ein aktives Telegram-Konto, das mit derselben Telefonnummer verifiziert ist, mit der Sie sich authentifizieren werden. Geben Sie Ihre Telefonnummer und den an Ihre Telegram-App gesendeten Anmeldecode ein.
Sie benötigen ein aktives Telegram-Konto, das mit derselben Telefonnummer verifiziert ist, mit der Sie sich authentifizieren werden. Geben Sie Ihre Telefonnummer und den an Ihre Telegram-App gesendeten Anmeldecode ein.
2
Öffne "API-Entwicklungstools"
Dieser Abschnitt befindet sich in den Einstellungen Ihres my.telegram.org-Kontos. Dies ist der einzige offizielle Ort, an dem Telegram Client-API-Anmeldeinformationen ausstellt.
Dieser Abschnitt befindet sich in den Einstellungen Ihres my.telegram.org-Kontos. Dies ist der einzige offizielle Ort, an dem Telegram Client-API-Anmeldeinformationen ausstellt.
3
Füllen Sie das Antragsformular aus
App-Titel, Kurzname und Plattform. Diese Felder beschreiben die Anwendung, die MTProto verwenden wird, sie müssen nicht mit einem öffentlichen Produktnamen übereinstimmen.
App-Titel, Kurzname und Plattform. Diese Felder beschreiben die Anwendung, die MTProto verwenden wird, sie müssen nicht mit einem öffentlichen Produktnamen übereinstimmen.
4
Holen Sie sich Ihre api_id und Ihren api_hash
Telegram gibt das Paar sofort aus.
Telegram gibt das Paar sofort aus.
api_id ist eine numerische Kennung, API-Hash ist das Geheimnis des Matchings. Speichern Sie beide wie jede andere Anmeldeinformation, sie authentifizieren Ihren MTProto-Client gegenüber den Telegram-Servern. Eine Einschränkung, um die herum geplant werden muss
Eine Telefonnummer kann enthalten nur eine api_id. Wenn Sie mehrere Apps oder mehrere Umgebungen benötigen, brauchen Sie mehrere Telefonnummern oder Sie verwenden dieselbe api_id in Ihrer gesamten Codebasis wieder. Es gibt keinen Self-Service-Weg, um eine zweite api_id für dieselbe Nummer auszustellen.
Eine Telefonnummer kann enthalten nur eine api_id. Wenn Sie mehrere Apps oder mehrere Umgebungen benötigen, brauchen Sie mehrere Telefonnummern oder Sie verwenden dieselbe api_id in Ihrer gesamten Codebasis wieder. Es gibt keinen Self-Service-Weg, um eine zweite api_id für dieselbe Nummer auszustellen.
# Von my.telegram.org, API-Entwicklungstools
TELEGRAM_API_ID=1234567
TELEGRAM_API_HASH=0123456789abcdef0123456789abcdef
# Eine „api_id“ pro Telefonnummer, sicher speichernBot-API
Einen Bot-Token über BotFather erhalten
Der andere Weg in die Telegram-API benötigt kein my.telegram.org-Konto, keine api_id und keinen api_hash. Er läuft vollständig innerhalb eines Chats mit Telegrams eigenem Bot, @BotFather.
1
Öffne einen Chat mit @BotFather
Suche nach "BotFather" in Telegram. Es ist der offizielle Bot, den Telegram verwendet, um jeden anderen Bot auf der Plattform auszugeben und zu verwalten.
Suche nach "BotFather" in Telegram. Es ist der offizielle Bot, den Telegram verwendet, um jeden anderen Bot auf der Plattform auszugeben und zu verwalten.
2
Senden Sie
BotFather führt Sie direkt im Chat durch die Erstellung eines neuen Bots, ganz ohne Dashboard oder Formular.
/neuerbotBotFather führt Sie direkt im Chat durch die Erstellung eines neuen Bots, ganz ohne Dashboard oder Formular.
3
Wähle einen Namen und einen Benutzernamen
Der Anzeigename kann beliebig sein. Der Benutzername muss eindeutig sein und enden auf
Der Anzeigename kann beliebig sein. Der Benutzername muss eindeutig sein und enden auf
Bot, zum Beispiel mein_support_bot. 4
Bot-Token kopieren
BotFather antwortet sofort mit Ihrem Token. Bewahren Sie es geheim, da es jeden Bot-API-Aufruf Ihres Bots authentifiziert.
BotFather antwortet sofort mit Ihrem Token. Bewahren Sie es geheim, da es jeden Bot-API-Aufruf Ihres Bots authentifiziert.
Die aktuelle Bot-API ist Version 10.2, veröffentlicht am 14. Juli 2026 (Quelle: core.telegram.org/bots/api). Jeder Bot-Token funktioniert mit derselben versionierten HTTP-API.
# Teste dein Bot-Token mit der Bot-API
locken. "https://api.telegram.org/bot/getMe"
# Beispielantwort
{
"Okay wahr,
"Ergebnis {
"ID 123456789,
"ist_bot": wahr,
"Benutzername: "my_support_bot"
}
}Vergleich
Was jede Telegram-API tatsächlich tun kann
Vier Wege, Telegram zu nutzen, vier völlig unterschiedliche Berechtigungssätze. Hier ist, womit sich die einzelnen Wege verbinden, welche Anmeldedaten sie benötigen und wo sie enden.
| Kriterien | Bot-API | Client-API (MTProto) | Gateway-API | Unipile |
|---|---|---|---|---|
| Was du verbindest | Ein Bot-Account | Ein echtes Benutzerkonto, für das Sie den Client bauen | Nichts, nur OTP-Zustellung | Ein bestehendes echtes Benutzerkonto |
| Anmeldedaten erforderlich | Bot-Token von BotFather | api_id + api_hash von my.telegram.org | Gateway-API-Konto | QR-Code-Anmeldung oder Hosted AuthAnbieter: "TELEGRAM") |
| Sendet/empfängt als menschliches Konto | Nein, fungiert als Bot | Ja | Nein | Ja |
| MTProto-Implementierung | Nicht erforderlich, nur HTTP | Du baust es selbst | Nicht anwendbar | Bearbeitet von Unipile |
| Gruppenteilnehmerverwaltung | Beschränkt auf Bot-Berechtigungen | Voll, wenn du es baust | Nicht anwendbar | Teilnehmer abrufen, hinzufügen, entfernen |
| Einrichtungsaufwand | Niedrig | Hallo, du besitzt den MTProto-Client | Niedrig | Gering, kein zu wartendes MTProto |
| Kosten | Kostenlos | Kostenlos | Nicht in diesem Leitfaden enthalten | In Ihrem Unipile-Tarif enthalten |
| Bannsperre bei Missbrauch | Token-Widerruf | Permanentes Verbot von Flooding/Spam | Nicht anwendbar | Mit den Ratenbegrenzungs-Richtlinien von Unipile entschärft |
Bot-API
VerbindetEin Bot-Account
BerechtigungsnachweiseBot-Token (BotFather)
Als Mensch agierenNein
EinrichtungNiedrig
KostenKostenlos
Client-API (MTProto)
VerbindetEin echtes Benutzerkonto (DIY-Kunde)
Berechtigungsnachweiseapi_id + api_hash
Als Mensch agierenJa
EinrichtungHallo, MTProto selbstgebaut
KostenKostenlos
Gateway-API
VerbindetNichts, nur OTP-Zustellung
BerechtigungsnachweiseGateway-API-Konto
EinrichtungNiedrig
UmfangAus diesem Leitfaden
Unipile
VerbindetEin bestehendes echtes Benutzerkonto
BerechtigungsnachweiseQR-Code oder Hosted Auth
Als Mensch agierenJa
EinrichtungGering, kein zu wartendes MTProto
GruppenTeilnehmer abrufen / hinzufügen / entfernen
Was Unipile auf Telegram nicht abdeckt
Kanäle, Communities und Broadcasts, Chat-Design, geheime Chats, Anhänge für Kontakte, Standorte, Umfragen und Veranstaltungen, Gruppenverwaltung (genehmigen, befördern, entziehen), Chat-Löschung, Archivierung sowie Sprach- oder Videoanrufe. Unipile verbindet das Konto, repliziert jedoch nicht jede Funktion des Telegram-Clients.
Kanäle, Communities und Broadcasts, Chat-Design, geheime Chats, Anhänge für Kontakte, Standorte, Umfragen und Veranstaltungen, Gruppenverwaltung (genehmigen, befördern, entziehen), Chat-Löschung, Archivierung sowie Sprach- oder Videoanrufe. Unipile verbindet das Konto, repliziert jedoch nicht jede Funktion des Telegram-Clients.
Preise und Limits
Es ist kostenlos. Hier ist der Haken.
Sowohl die Bot-API als auch die Telegram-API (MTProto) können kostenlos genutzt werden. Es gibt keine Rechnung, keine Gebühr pro Nachricht und keine kostenpflichtigen Tarifbeschränkungen für Zugangsdaten. Der Haken ist nicht das Geld, sondern das Verhalten.
Überschwemmung, Spam und gefälschte Zähler
Zu schnelles Senden, das Massenmessaging an unbeteiligte Nutzer oder das künstliche Aufblähen von Aufruf- und Rechnungszählern sind der schnellste Weg, um eine dauerhafte Sperrung, sowohl für die Bot-API als auch für die Client-API.
Zu schnelles Senden, das Massenmessaging an unbeteiligte Nutzer oder das künstliche Aufblähen von Aufruf- und Rechnungszählern sind der schnellste Weg, um eine dauerhafte Sperrung, sowohl für die Bot-API als auch für die Client-API.
Inoffizielle Clients werden überwacht
Jeder Client, der mit Ihrer eigenen api_id und api_hash erstellt wurde, ist automatisch unter Beobachtung gestellt von den Systemen von Telegram. Ungewöhnliche Muster werden schneller als in den offiziellen Apps markiert.
Jeder Client, der mit Ihrer eigenen api_id und api_hash erstellt wurde, ist automatisch unter Beobachtung gestellt von den Systemen von Telegram. Ungewöhnliche Muster werden schneller als in den offiziellen Apps markiert.
Unipiples eigene Anleitung, um unbemerkt zu bleiben Entwickeln Sie sicherere Messaging-Abläufe mit Unipile
Vermeide brandneue Telegram-Konten für die Automatisierung, wärme sie auf wie jeden anderen Kanal
Erhöhen Sie das Nachrichtenvolumen schrittweise, anstatt mit dem vollen Durchsatz zu beginnen.
Halten Sie zwischen Nachrichten, die von demselben Konto gesendet werden, mindestens 10 bis 20 Sekunden ein
Der Unipile-Ansatz
Der dritte Weg: Verknüpfen Sie ein bestehendes Telegram-Konto
Weder die Bot-API noch ein selbstgebauter MTProto-Client. Die Telegram-API von Unipile verbindet einen bestehendes Telegram-Benutzerkonto, über Telegrams eigenes Geräte Funktion, derselbe Mechanismus, mit dem Sie Telegram auf einem neuen Telefon oder einer Desktop-App nutzen können.
Die Anmeldung erfolgt über eine QR-Code-Scan, oder durch Gehostete Autorisierung mit
Anbieter: "TELEGRAM" wenn Sie einen eigenen, mit Ihrem Branding versehenen Verbindungsworkflow in Ihr Produkt integrieren möchten. Nach der Verbindung verhält sich das Konto wie das Konto selbst: Es ist kein Bot und benötigt keine von my.telegram.org ausgestellte api_id oder api_hash.Das ist wichtig, weil es die beiden schwierigsten Teile beim Erstellen auf der Telegram-API selbst entfernt: das Implementieren von MTProto und das Verwalten von Sitzungen und Wiederverbindungen, wenn ein Gerät entfernt wird. Wenn das Unipile-Gerät aus den Telegram-Sitzungen des Kontos entfernt wird, erkennt Unipile dies und der Kontostatus wechselt einfach zu
getrennt, bereit für die Wiederverbindung.Sende und empfange Direktnachrichten als das echte Konto
Gruppenteilnehmer verwalten: abrufen, hinzufügen, entfernen
Keine Kanäle, Communities oder Broadcasts
Keine Gruppenverwaltung (genehmigen, befördern, entziehen), keine Sprach- oder Videoanrufe
AnbieterTelegram
AuthentifizierungsmethodeQR-Code / Hosted Auth
Statusverbunden
Gerät von Telegram entferntgetrennt
Erneute Synchronisierung unterstütztJa
Anwendungsfälle
CRM- und ATS-Anwendungsfälle für die Telegram-API
Sobald ein Telegram-Konto als echtes verknüpftes Konto und nicht als Bot verbunden ist, treten bei Unipile-Kunden immer wieder zwei Anwendungsfälle auf: Vertriebsteams, die Konversationen zentralisieren, und Recruiter, die Kandidaten dort erreichen, wo sie bereits sind.
CRM: Telegram-Konversationen zusammenführen
Vertriebs- und Supportteams, die bereits über Telegram mit Leads und Kunden kommunizieren, möchten dafür keine separate App. Durch die Verbindung des Kontos über Unipile landet jeder Telegram-Thread im selben Posteingang wie E-Mail-, LinkedIn- oder WhatsApp-Konversationen, verknüpft mit dem richtigen Kontaktdatensatz im CRM.
ATS: Kandidaten auf Telegram erreichen
In Regionen, in denen Telegram ein primärer Nachrichtenkanal ist, verknüpfen Recruiter ihr eigenes Telegram-Konto, um Kandidaten direkt aus dem ATS zu erreichen, den gesamten Nachrichtenverlauf im Kandidatenprofil zu speichern und Gespräche zwischen Recruitern ohne Verlust des Kontexts zu übergeben.
Client-API / MTProto
Anmeldung mit einem QR-Code: Der Geräefluss Schritt für Schritt
QR-Code-Anmeldung ist der Mechanismus hinter Telegrams Geräte Funktion, dieselbe, die Sie verwenden, um Telegram Desktop oder Telegram Web zu Ihrem Konto hinzuzufügen. Es ist auch der Ablauf, den Unipile in Ihrem Namen ausführt, wenn er ein bestehendes Telegram-Benutzerkonto verbindet. Wenn Sie ihn selbst entwickeln, implementieren Sie einen zweiseitigen Handshake zwischen dem Gerät, das dem Konto bereits vertraut, und dem Gerät, das um Beitritt bittet, keinen einfachen Anfrage-/Antwort-Aufruf. Hier ist genau, was zwischen den beiden Apps passiert, Methode für Methode.
1
Anmeldetoken anfordern
Das Gerät, das sich anmelden möchte, ruft an
Das Gerät, das sich anmelden möchte, ruft an
auth.exportLoginToken. Telegram antwortet mit einer auth.loginToken: ein binäres Token plus im Allgemeinen ein Ablaufdatum 30 Sekunden. 2
In einen QR-Code umwandeln
Das Token ist codiert in Base64URL und platziert in einem
Das Token ist codiert in Base64URL und platziert in einem
tg://login?token=<base64url> URL. Diese URL wird als scanbarer QR-Code auf dem Bildschirm gerendert. 3
Scan über eine bereits angemeldete App
Die bereits authentifizierte Telegram-App sciniert den Code und ruft auf
Die bereits authentifizierte Telegram-App sciniert den Code und ruft auf
auth.acceptLoginToken mit dem decodierten Token. 4
Über das Ergebnis abstimmen
Das sich anmeldende Gerät erhält eine
Das sich anmeldende Gerät erhält eine
AnmeldetokenAktualisieren aktualisieren, dann anrufen auth.exportLoginToken erneut, um das Ergebnis des Scans abzurufen. 5
Datenzentrum bestätigen oder migrieren
Wenn das Rechenzentrum übereinstimmt, gibt Telegram zurück
Wenn das Rechenzentrum übereinstimmt, gibt Telegram zurück
auth.loginTokenSuccess, der Login ist erfolgt. Wenn er nicht übereinstimmt, lautet die Antwort auth.loginTokenMigrateTo, und der Client muss aufrufen auth.importLoginToken mit demselben Token gegen das angegebene Rechenzentrum. // Das Gerät, das die Anmeldung anfordert
auth.exportLoginToken(api_id, api_hash)
// -> auth.loginToken { token, expires }
// Als QR-Code gerendert
tg://login?token=<base64url(token)>
Bereits authentifiziertes Gerät scannt es
auth.acceptLoginToken(Token)
Das sich anmeldende Gerät fragt erneut ab
auth.exportLoginToken()
// -> auth.loginTokenSuccess
// oder auth.loginTokenMigrateTo { dc_id } Kurzes Zeitfenster, planen Sie den erneuten Versuch
Das Token ist im Allgemeinen nur gültig für 30 Sekunden. Wenn es vor dem Scannen abläuft, muss der Kunde anrufen
Das Token ist im Allgemeinen nur gültig für 30 Sekunden. Wenn es vor dem Scannen abläuft, muss der Kunde anrufen
auth.exportLoginToken wiederholen Sie das und generieren Sie einen neuen Code, anstatt nur den alten erneut zu versuchen. UNGÜLTIGER_AUTHENTIFIZIERUNGSTOKEN
AUTH_TOKEN_EXPIRED
AUTH_TOKEN_ALREADY_ACCEPTED
AUTH_TOKEN_EXPIRED
AUTH_TOKEN_ALREADY_ACCEPTED
Das ist genau der Datenaustausch, den Unipile in Ihrem Namen durchführt, wenn Sie ein Telegram-Konto über dessen Geräte Integration: der QR-Code, der Token-Austausch, die Behandlung des Rechenzentrums und die Wiederholung, wenn ein Token abläuft. Sie rufen einen Endpunkt auf, und Unipile führt die oben beschriebene MTProto-Konversation aus – einschließlich des Falls, dass sich das zu verbindende Konto in einem anderen Rechenzentrum befindet als dem, mit dem Ihre App zuerst gesprochen hat. Diese Behandlung des Rechenzentrums lässt sich leicht übersehen, wenn man den Ablauf von Grund auf neu erstellt, da sie nur bei einer Untergruppe von Accounts auftritt und bei den betroffenen Accounts die Anmeldung im Stillen fehlschlägt, wenn die
Entwickeln Sie Ihren QR-Login-Workflow mit Unipile auth.loginTokenMigrateTo Zweig wird nicht behandelt.Client-API / MTProto
Anmeldung per Telefonnummer und die 2FA-Sperre
Die klassische Anmeldung per Telefonnummer ist der Punkt, an dem die meisten selbstgebauten Telegram-Clients scheitern. Nicht, weil sie komplex ist, sondern weil der Ablauf in dem Moment, in dem die Zwei-Faktor-Authentifizierung aktiviert ist, im Hintergrund abzweigt, und diese Abzweigung ist nicht optional. Ein Client, der nur den Idealfall implementiert (Code senden, Code bestätigen, fertig), funktioniert problemlos mit einem Testkonto und versagt dann in der Produktion beim ersten echten Benutzer, der ein Cloud-Passwort aktiviert hat.
1
Senden Sie den Anmeldecode
auth.sendCode sendet den Code an die Telefonnummer und gibt einen auth.sentCode Objekt, das ein enthält phone_code_hash, für den nächsten Anruf erforderlich. 2
Code validieren
auth.signIn prüft den Code anhand der phone_code_hash. Wenn die Telefonnummer noch kein Konto hat, gibt Telegram zurück Registrierung zur Autorisierung erforderlich anstelle einer Autorisierung. 3
Vor die 2FA-Wand laufen
Wenn für das Konto die Zwei-Faktor-Authentifizierung aktiviert ist,
Wenn für das Konto die Zwei-Faktor-Authentifizierung aktiviert ist,
auth.signIn Antworten mit a 400 Fehler: SESSION_PASSWORD_NEEDED. Dies ist die erwartete Antwort für jedes Konto mit einem Cloud-Passwort, kein Fehler bei der Ausnahmebehandlung. 4
Klären Sie das mit der SRP
Das Abschließen der Anmeldung bedeutet die Ausführung des SRP-Protokolls: Erstellen eines
Das Abschließen der Anmeldung bedeutet die Ausführung des SRP-Protokolls: Erstellen eines
InputCheckPasswordSRP Objekt aus den Passwortparametern des Kontos, rufen Sie dann auf auth.checkPassword. Erfolg gibt einen Berechtigung; ein falsches Passwort gibt zurück PASSWORT_HASH_UNGÜLTIG. Nur offizielle Apps erhalten Firebase-SMS
Nur die offiziellen mobilen Anwendungen von Telegram dürfen verwendet werden Firebase-basierte SMS-Code-Zustellung. Anwendungen von Drittanbietern müssen den Code über einen anderen Bereitstellungskanal leiten oder schreiben in sms@telegram.org über den Zugang sprechen.
Nur die offiziellen mobilen Anwendungen von Telegram dürfen verwendet werden Firebase-basierte SMS-Code-Zustellung. Anwendungen von Drittanbietern müssen den Code über einen anderen Bereitstellungskanal leiten oder schreiben in sms@telegram.org über den Zugang sprechen.
SESSION_PASSWORT_ERFORDERLICH
PASSWORT_HASH_UNGÜLTIG
Registrierung zur Autorisierung erforderlich
PASSWORT_HASH_UNGÜLTIG
Registrierung zur Autorisierung erforderlich
Die Telegram-Integration von Unipile übernimmt diesen gesamten Bereich für Sie: Code-Bereitstellung, das SESSION_PASSWORT_ERFORDERLICH überprüfen, und den SRP-Austausch, wenn ein Cloud-Passwort festgelegt ist, ob das Konto sich über eine Telefonnummer, einen QR-Code oder verbindet Gehostete Autorisierung. Dazu gehört auch die genannte Einschränkung bei der SMS-Zustellung: Da Anwendungen von Drittanbietern sich nicht auf die Firebase-basierte Zustellung stützen können, ist dies einer der Bereiche, in denen die eigenständige Verwaltung des Rufnummern-Workflows echten operativen Aufwand bedeutet – nicht nur Code –, noch bevor Sie eine einzige Nachricht versendet haben.
Versandlimits
Telegram-API-Ratenlimits in Zahlen
Abschnitt 5 behandelte das Verhalten, das zur Sperrung von Konten führt. Hier sind die tatsächlich dokumentierten Obergrenzen auf Seiten der Bot-API und was es kostet, diese anzuheben.
1/Sek.
Maximale Nachrichten an denselben einzelnen Chat
Maximale Nachrichten an denselben einzelnen Chat
20/Min.
Maximale Nachrichtenanzahl in einer einzigen Gruppe
Maximale Nachrichtenanzahl in einer einzigen Gruppe
~30/Sek.
Ungefähre Obergrenze für das Senden von Nachrichten in verschiedene Chats
Ungefähre Obergrenze für das Senden von Nachrichten in verschiedene Chats
429
Es wird ein Fehler zurückgegeben, sobald eines dieser Limits überschritten wird.
Es wird ein Fehler zurückgegeben, sobald eines dieser Limits überschritten wird.
Kostenpflichtige Sendungen erhöhen die Obergrenze, unter zwei Bedingungen
Bots können aktivieren kostenpflichtige Sendungen über BotFather, was das Sendeimit erhöht auf 1.000 Nachrichten pro Sekunde. Nachrichten, die über dem kostenlosen Schwellenwert gesendet werden, kosten 0,1 Telegram-Stern jeweils. Es ist an zwei Kontoforderungen gekoppelt, die beide gleichzeitig erfüllt sein müssen.
100.000 Sterne Guthaben
100.000 monatlich aktive Nutzer
100.000 monatlich aktive Nutzer
Überschreiten Sie das individuelle, Gruppen- oder Broadcast-Limit und die Bot-API antwortet mit dem 429 Status abgedeckt im Fehlerreferenz unten, neben dem
420 FLOOD und FLOOD_WAIT_X Codes, die auf der MTProto-Seite verwendet werden. Beide Mechanismen existieren aus demselben Grund: Damit du langsamer wirst, bevor Telegram beschließt, dich für dich zu verlangsamen.Diese Nummern sind Bot-API-spezifisch. Für eine verbundene Benutzerkonto, es gibt keine veröffentlichte Obergrenze, sondern nur die eigenen Tempoladungen von Unipile, die abgedeckt sind in Es ist kostenlos, hier ist der HakenWärmen Sie neue Konten auf, steigern Sie sich schrittweise und lassen Sie mindestens 10 bis 20 Sekunden Zeit zwischen den Nachrichten.
Fehlerreferenz
Telegram-API-Fehler, die Sie kennen müssen
MTProto-Fehler haben dasselbe dreistellige Format wie die den meisten Entwicklern bereits bekannten HTTP-Statuscodes, gepaart mit einer kurzen maschinenlesbaren Zeichenkette. Hier ist die Referenztabelle sowie ein Fehler, der nur für Ihre Endbenutzer und nicht für Sie auftritt. Diese Liste vor dem Release zu kennen, ist wichtiger als danach: Mehrere dieser Codes,
303 und 420 insbesondere sind keine außergewöhnlichen Fehler, sie sind Teil der normalen Betriebsbedingungen eines MTProto-Clients und müssen im Codepfad behandelt und nicht protokolliert und ignoriert werden.| Code | Bedeutung |
|---|---|
| 303 See Other | Die Anfrage muss wiederholt werden und dabei auf ein anderes Rechenzentrum abzielen. |
| 400 UNGÜLTIGE_ANFRAGE | Die Anfrage enthält Fehler. API_ID_UNGÜLTIG ist ein häufiges Beispiel für diesen Code. |
| 401 NICHT AUTORISIERT | Die Methode erfordert eine Funktion, die autorisierten Benutzern vorbehalten ist. |
| 403 FORBIDDEN | Verletzung der Privatsphäre, zum Beispiel der Versuch, einem Nutzer zu schreiben, der Sie blockiert hat. |
| 404 NICHT_GEFUNDEN | Das angeforderte Objekt oder die angeforderte Methode existiert nicht. |
| 420 FLOOD / FLOOD_WAIT_X | Die maximal zulässige Anzahl von Anrufen wurde überschritten, warten Sie X Sekunden, bevor Sie es erneut versuchen. |
303 See OtherDie Anfrage muss wiederholt werden und dabei auf ein anderes Rechenzentrum abzielen.
400 UNGÜLTIGE_ANFRAGEDie Anfrage enthält Fehler.
API_ID_UNGÜLTIG ist ein häufiges Beispiel für diesen Code.401 NICHT AUTORISIERTDie Methode erfordert eine Funktion, die autorisierten Benutzern vorbehalten ist.
403 FORBIDDENVerletzung der Privatsphäre, zum Beispiel der Versuch, einem Nutzer zu schreiben, der Sie blockiert hat.
404 NICHT_GEFUNDENDas angeforderte Objekt oder die angeforderte Methode existiert nicht.
420 FLOOD / FLOOD_WAIT_XDie maximal zulässige Anzahl von Anrufen wurde überschritten, warten Sie X Sekunden, bevor Sie es erneut versuchen.
Noch einer, auf Seite des Endbenutzers
API_ID_PUBLISHED_FLOOD wird für Ihre Endbenutzer angezeigt, wenn eine veröffentlichte Anwendung das Beispiel wiederverwendet api_id innerhalb von Open-Source-Beispielcode versendet, anstatt einen eigenen anzufordern. Jede Anwendung, die Sie veröffentlichen, benötigt eine eigene api_id und API-Hash von my.telegram.org. Ein Client, der direkt auf der Client-API (MTProto) aufsetzt, muss jeden einzelnen dieser Codes selbst verarbeiten: Wiederholen gegen das korrekte Rechenzentrum bei 303, mach langsamer bei 420, und behandeln 401 und 403 als Signale zum Kontostatus statt als generelle Fehler. Die Verknüpfung eines bestehenden Kontos über Unipile verlagert diese Fehlerbehandlung hinter einen einzigen Status des verknüpften Kontos, anstatt eine Reihe von MTProto-Codes bereitzustellen, die Ihr eigener Code bei jedem Aufruf korrekt interpretieren muss.
Client-API / MTProto
Die Wahl einer MTProto-Bibliothek und was sie für Sie nicht tun wird
Wenn Sie sich entscheiden, den Client-API-Pfad selbst zu bauen, implementieren Sie MTProto nicht nach einem Lastenheft. Eine Handvoll Bibliotheken sprechen das Protokoll bereits, daher ist der Client selbst selten der schwierige Teil. Einen davon auszuwählen, löst nur einen Teil des Problems, und der Teil, den es löst, ist normalerweise der kleinere.
Python
Telethon
Eine rein in Python geschriebene MTProto-Implementierung, basierend auf async/await, mit einer Client-API, die sich eher wie normales Python als wie rohe Protokollaufrufe liest.
Python
Pyrogram
Ein weiterer Python-MTProto-Client mit einem eigenen Ansatz für die Sitzungsverwaltung und einer Client-Oberfläche, die sich eher wie ein herkömmliches SDK als wie eine Protokollbibliothek anfühlen soll.
Node.js
GramJS
Das nächstgelegene Äquivalent zu Telethon für JavaScript- und TypeScript-Codebasen, das dieselbe MTProto-Konversation für eine Node.js-Laufzeitumgebung implementiert.
Offiziell
TDLib
Die offizielle Bibliothek von Telegram, geschrieben in C++, mit Bindungen für verschiedene Sprachen. Sie implementiert den vollständigen MTProto-Stack auf die Art und Weise, wie es die offiziellen Apps von Telegram tun.
Welche Lösung passt, hängt meistens von dem bereits verwendeten Tech-Stack ab und weniger von einem Funktionsvergleich: Ein Python-Backend spricht für Telethon oder Pyrogram, weist ein Node.js- oder TypeScript-Backend auf GramJS, und ein Team, das so nah wie möglich an den offiziellen Apps von Telegram bleiben möchte, spricht für TDLib und dessen Bindungen. Keine dieser Optionen entfernt die zweite Hälfte des nachstehenden Werks.
Was eine Bibliothek Ihnen gibt
Die MTProto-Verschiebungsschicht und die rohen Methodenaufrufe
Aktualisierung der Verarbeitung eingehender Ereignisse von Telegram-Servern
Eine clientseitige API zum Aufrufen von Authentifizierungs-, Messaging- und Kontomethoden
Was Sie noch selbst bauen
Sitzungen zuverlässig über Neustarts und Deployments hinweg speichern
Vollständige Handhabung des SESSION_PASSWORD_NEEDED- und SRP-Ablaufs für Ihre Benutzer
Wiederherstellung der Verbindung und Überprüfung des Kontostatus beim Entfernen eines Geräts
Telegram-API: Häufig gestellte Fragen
Klare Antworten zu api_id, api_hash, BotFather-Bot-Tokens und der Verbindung eines bestehenden Telegram-Kontos mit Unipile.
Telegram hat nicht nur eine API, sondern drei. Die Bot API ist eine HTTP-Schnittstelle für Bot-Konten. Die Telegram API, auch Client API genannt, basiert auf dem MTProto-Protokoll und bildet die Grundlage für vollständige Telegram-Clients. Die Gateway API sendet lediglich Bestätigungscodes. Welche davon Sie benötigen, hängt davon ab, ob Sie einen Bot automatisieren oder als echtes Benutzerkonto agieren.
Es gibt keinen einzelnen Telegram-API-Schlüssel. Für die Client-API melden Sie sich unter my.telegram.org an, öffnen die API-Entwicklungstools und füllen das Formular aus, um eine api_id und einen api_hash zu erhalten. Für die Bot-API schreiben Sie BotFather innerhalb von Telegram eine Nachricht, der daraufhin ein Bot-Token zurückgibt. Beachten Sie, dass Telegram nur eine api_id pro Telefonnummer erlaubt.
Ja. Telegram gibt an, dass sowohl die Bot-API als auch die Telegram-API kostenlos und ohne pro-Nachricht-Gebühr genutzt werden können. Die tatsächlichen Kosten liegen in der Infrastruktur, die Sie betreiben, der Sitzungsverwaltung und dem Risiko einer Sperrung, wenn Sie zu aggressiv vorgehen.
Die Bot-API ist eine einfache HTTPS-Schnittstelle: Sie rufen Methoden wie sendMessage mit Ihrem Bot-Token gegen api.telegram.org auf. Die Client-API ist ein binäres MTProto-Protokoll, weshalb die meisten Entwickler eine Bibliothek wie Telethon, Pyrogram oder GramJS verwenden, anstatt sie selbst zu implementieren.
Bot-API 10.2, veröffentlicht am 14. Juli 2026. Sie folgte auf 10.1 am 11. Juni 2026 und 10.0 am 8. Mai 2026.
Ja. Sie können ein bestehendes Telegram-Konto über die Telegram-eigene Geräteeinrichtungsfunktion verbinden, über die auch Unipile Konten verknüpft, indem Sie einen QR-Code-Login oder einen gehosteten Authentifizierungsablauf verwenden. Sie erhalten Zugriff auf das Benutzerkonto, ohne MTProto, Sitzungsspeicher oder die Verwaltung der Zwei-Faktor-Authentifizierung selbst implementieren zu müssen.
Haben Sie noch Fragen? Unser Team ist für Sie da.
Die Telegram-API, richtig gemacht
Integrieren Sie Ihre Telegram-API mit Unipile
Überspringen Sie den MTProto-Client und die Bot-Beschränkungen. Verbinden Sie ein bestehendes Telegram-Konto über Unipile und führen Sie es mit WhatsApp, LinkedIn, Instagram, Gmail, Outlook und IMAP in einer einzigen API zusammen.