Telegram-Telefonnummern-API-Optionen: Bot-API, Client-API oder eine Registrierungsprüfungs-API

Ein Entwicklervergleich der Telegram Bot API, der Telegram Client API und einer Registrierungsprüfungs-API für Aufgaben, die Telefonnummern betreffen.

Es gibt nicht die eine Telegram-Telefonnummern-API. Die Telegram Bot API empfängt eine Telefonnummer nur, wenn ein Benutzer sich entscheidet, diese zu teilen. Die Telegram Client API arbeitet über ein echtes Benutzerkonto und dessen Anmeldedaten, und eine Registrierungsprüfungs-API wie TG Validator beantwortet die Frage, ob eine übermittelte Nummer bei Telegram registriert ist. Wählen Sie die Option, die zu Ihrer Aufgabe passt: das Sammeln einer Nummer von einem zustimmenden Benutzer, die Automatisierung Ihres eigenen Kontos oder das Überprüfen von Nummern, die Sie bereits besitzen.

Was Entwickler unter einer Telegram-Telefonnummern-API verstehen

Suchanfragen nach "telegram phone number api" stammen in der Regel aus einem von drei Aufgabenbereichen:

1. Sammeln einer Benutzernummer innerhalb eines Bots, zum Beispiel um einen Telegram-Chat mit einem Kundenkonto zu verknüpfen.
2. Automatisierung eines Telegram-Benutzerkontos, zum Beispiel um Kontakte zu verwalten oder einen benutzerdefinierten Client zu erstellen.
3. Überprüfen von Nummern, die Sie bereits besitzen, zum Beispiel um zu kennzeichnen, welche CRM-Kontakte ein Telegram-Konto haben, bevor Sie einen Kanal auswählen.

Jede Aufgabe erfordert eine andere Schnittstelle mit unterschiedlichen Anmeldedaten, Limits und Verantwortlichkeiten. Die Wahl der falschen Schnittstelle ist der häufigste Grund für das Scheitern von Integrationen.

Bot-API: Empfangen einer Nummer, die der Benutzer teilen möchte

Die Telegram Bot API sucht Benutzer nicht anhand ihrer Telefonnummer. Ein Bot empfängt eine Nummer nur, wenn der Benutzer sie sendet:

• Eine Antwort-Schaltfläche (Reply Keyboard) mit gesetztem request_contact fordert den Benutzer auf, seine eigene Telefonnummer als Kontakt zu teilen. Die Referenz weist darauf hin, dass dies nur in privaten Chats funktioniert.
• Die geteilte Nachricht enthält ein Contact-Objekt mit der Telefonnummer und optional der Telegram-Kennung des Benutzers.

Dies ist das richtige Werkzeug, wenn Sie möchten, dass ein Kunde seinen Telegram-Chat mit Ihrem Dienst verbindet, wobei der Kunde explizit zustimmen muss. Es können keine Nummernlisten überprüft werden, und Bots können nicht die Kontaktimport-Methode der Client-API aufrufen, die laut Telegram-Dokumentation nur Benutzern zur Verfügung steht (contacts.importContacts).

Client-API: Automatisierung eines echten Telegram-Kontos

Die Telegram Client API (MTProto) wird von offiziellen und Drittanbieter-Apps verwendet. Bibliotheken wie TDLib, Telethon und Pyrogram kapseln diese, und die meisten Open-Source-Skripte zur "Telefonnummernprüfung" basieren darauf.

Bevor Sie darauf aufbauen, beachten Sie, was Telegram unter Obtaining api_id dokumentiert:

• Sie benötigen eine api_id und api_hash von my.telegram.org, die von einem bestehenden Telegram-Konto erstellt wurden; jede Telefonnummer kann nur mit einer api_id verknüpft werden.
• Drittanbieter-Clients müssen die API-Nutzungsbedingungen einhalten. Konten, die inoffizielle Clients verwenden, werden beobachtet, und Flooding oder Spamming über die API kann zu einer dauerhaften Sperrung führen.
• Der Import von Kontakten speichert diese auf dem Konto, das den Code ausführt.

Die Client-API eignet sich gut für die Erstellung eines echten Telegram-Clients oder die Automatisierung Ihres eigenen Kontos. Für die Überprüfung von Geschäftskontaktlisten bedeutet dies jedoch, dass Unternehmensdaten auf dem Konto einer einzelnen Person liegen, und der Verlust dieses Kontos würde den Arbeitsablauf stoppen.

Registrierungsprüfungs-API: Beantwortung der Frage, ob eine Nummer bei Telegram ist

Eine Registrierungsprüfungs-API ist für die dritte Aufgabe konzipiert. Die REST-API von TG Validator funktioniert ohne ein Telegram-Konto auf Ihrer Seite:

• Einzelprüfung: POST /api/v1/check mit einem X-API-Key-Header, der Ihren mit sk_ beginnenden Schlüssel enthält. Der JSON-Body benennt den Diensttyp tg und die Telefonnummer im E.164-Format.
• Kleine Batches: POST /api/v1/batch-check akzeptiert bis zu 100 Nummern pro Anfrage.
• Direkter Antwortfluss: Beide Endpunkte geben Ergebnisse direkt in der Antwort zurück; es gibt keine Aufgabe, die übermittelt oder abgefragt werden muss.
• Antwort-Envelope: Der dokumentierte Envelope umschließt jede Antwort mit einem Geschäftscode und einer Nachricht. Ein abgeschlossenes Ergebnis teilt Ihnen in derselben Antwort mit, ob die gesendete Nummer bei Telegram registriert ist. Eine Prüfung, die nicht entschieden werden kann, gibt einen Geschäftscode ungleich Null und kein abgeschlossenes Ergebnis zurück.
• Guthaben: GET /api/v1/balance ermöglicht es Ihrem Dienst, das verbleibende Guthaben vor einem großen Auftrag zu prüfen.

Die aktuelle API-Dokumentation beschreibt Parallelitäts- und Timeout-Kontrollen pro Benutzer anstelle eines Anfragelimits pro Minute: bis zu fünf laufende Prüfungen, ein 60-Sekunden-Timeout für eine Einzelprüfung und 300 Sekunden für eine Prüfung mehrerer Nummern, wobei jeweils eine Prüfung mehrerer Nummern pro Konto gleichzeitig möglich ist. Bestätigen Sie diese Werte in der Dokumentation, bevor Sie Ihre Worker anpassen, da sie sich ändern können.

Für Listen, die weit über 100 Nummern hinausgehen, akzeptieren die separaten asynchronen Bulk-Endpunkte einen TXT- oder CSV-Upload und geben eine result.csv zurück, sobald die Aufgabe abgeschlossen ist.

Vergleich der Telegram-Telefonnummern-APIs

Viele Produkte kombinieren zwei dieser Optionen: einen Bot, um mit Benutzern zu kommunizieren, die ihre Zustimmung gegeben haben, und eine Registrierungsprüfung, um zu entscheiden, welche bestehenden Kontakte überhaupt über Telegram eingeladen werden sollen.

Integrations-Checkliste für eine Registrierungsprüfungs-API

• Zuerst normalisieren. Konvertieren Sie Nummern in das E.164-Format (Pluszeichen, Ländercode, keine führende Null oder Satzzeichen), bevor Sie die API aufrufen.
• Schlüssel serverseitig aufbewahren. Versenden Sie ihn niemals in einer mobilen App oder einem Browser-Bundle und verwalten Sie Schlüssel über das Dashboard.
• Drei Ergebnisse behandeln. Ja, Nein und Unbestimmt. Speichern Sie unbestimmte Prüfungen separat und versuchen Sie es später erneut, anstatt sie als negativ zu werten.
• Parallelität respektieren. Dimensionieren Sie Worker-Pools auf das dokumentierte Limit für laufende Anfragen und reduzieren Sie die Last bei Fehlern, anstatt in einer engen Schleife erneut zu versuchen.
• Prüfzeitpunkt speichern. Die Registrierung ist ein Signal zum Zeitpunkt der Prüfung; speichern Sie das Datum, damit veraltete Ergebnisse aktualisiert werden können.
• Budget für entschiedene Prüfungen einplanen. Jede abgeschlossene, entschiedene Prüfung wird zum geltenden Tarif berechnet, unabhängig vom Ergebnis. Führen Sie daher vor dem Senden eine Deduplizierung durch.
• KI-Clients: Ein MCP-Endpunkt unter https://tgvalidator.com/mcp stellt die direkten Prüfungen und das Guthaben für MCP-kompatible Clients bereit, wobei die Bearer-Authentifizierung mit demselben Schlüssel und Guthaben verwendet wird. Bulk-Aufgaben verbleiben bei der REST-API.

FAQ

Kann ein Telegram-Bot einen Benutzer anhand der Telefonnummer suchen?

Nein. Ein Bot empfängt eine Telefonnummer nur, wenn ein Benutzer sie teilt, typischerweise über eine Antwort-Schaltfläche, die den Kontakt in einem privaten Chat anfordert. Das Überprüfen einer Nummernliste erfordert entweder ein Benutzerkonto über die Client-API oder eine Registrierungsprüfungs-API.

Wie können Teams die Telegram-Registrierung ohne ein Telegram-Konto prüfen?

Verwenden Sie eine Registrierungsprüfungs-API. TG Validator akzeptiert eine E.164-Nummer unter POST /api/v1/check oder bis zu 100 Nummern unter POST /api/v1/batch-check, authentifiziert mit einem X-API-Key-Header, und gibt das Ergebnis in derselben Antwort zurück.

Gibt es ein Ratenlimit pro Minute für die TG Validator API?

Es wird kein Ratenlimit pro Minute veröffentlicht. Die Dokumentation beschreibt stattdessen Parallelitäts- und Timeout-Kontrollen pro Benutzer. Integrationen sollten ihre Worker daher auf diese Kontrollen ausrichten und die aktuelle Dokumentation auf Änderungen prüfen.

Wie können Teams die API vor einer größeren Einführung testen?

Registrierte Benutzer können den Support kontaktieren, um 100 kostenlose Prüfungen zu erhalten. Dies reicht aus, um die Eingabenormalisierung, die Behandlung unbestimmter Ergebnisse und die Protokollierung anhand einer kleinen Stichprobe zu testen.

Mehr erfahren

Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Arbeitsablauf passen.

• Zur Produktdokumentation →
• Kontakt zum Team →