Telegram-Registrierungsprüfung: GitHub-Skripte vs. gehostete API

Ein neutraler Vergleich zwischen dem Betrieb eines Open-Source-Skripts zur Telegram-Registrierungsprüfung von GitHub und der Nutzung einer gehosteten API mit Dashboard.

Ein Telegram-Registrierungsprüfungstool von GitHub, wie das Open-Source-Skript von Bellingcat, läuft über Ihr eigenes Telegram-Benutzerkonto und Ihre Entwicklerzugangsdaten. Dies eignet sich für gelegentliche Recherchen, bei denen eine Person das Konto überwachen und den Code warten kann. Eine gehostete API eignet sich für wiederkehrende Geschäftsprozesse, da das Team einen dokumentierten REST-Endpunkt mit einem API-Schlüssel aufruft, ohne ein persönliches Telegram-Konto für Automatisierungen verwenden zu müssen. Die Wahl hängt vom Volumen, dem Kontorisiko, dem Wartungsaufwand und der Art und Weise ab, wie die Ergebnisse in andere Systeme integriert werden sollen.

Funktionsweise von Open-Source-Skripten zur Telegram-Registrierungsprüfung

Die meisten Open-Source-Prüftools auf GitHub folgen demselben Muster. Das Skript meldet sich über die Client-API als normaler Benutzer bei Telegram an, fügt die Zielnummern als Kontakte hinzu, liest aus, welche davon mit einem Konto verknüpft sind, und entfernt sie anschließend wieder. Die dokumentierte contacts.importContacts-Methode von Telegram beschreibt dieses Verhalten: Sie importiert eine Kontaktliste und gibt die Kontakte zurück, die bereits bei Telegram registriert sind. Diese Methode steht nur Benutzerkonten zur Verfügung, nicht Bots.

Das bekannteste Beispiel ist Bellingcats telegram-phone-number-checker, ein Python-Tool unter MIT-Lizenz. Die Dokumentation listet die Voraussetzungen auf:

• Ein Telegram-Konto mit einer aktiven Telefonnummer.
• Eine api_id und ein api_hash, erstellt unter my.telegram.org.
• Eine Liste von Nummern oder Benutzernamen, die über die Befehlszeile oder interaktiv übergeben werden.

Das Tool gibt Benutzernamen, Namen und Kontonummern zurück, sofern verfügbar, kann Profilfotos herunterladen und schreibt die Ergebnisse in eine JSON-Datei. Die Dokumentation warnt zudem, dass Telegram persönliche Konten, die für Automatisierungen genutzt werden, sperren kann, und empfiehlt die Verwendung eines neuen Kontos.

Was der Betrieb eines GitHub-Skripts tatsächlich bedeutet

Der Download ist kostenlos, aber die Betriebskosten liegen an anderer Stelle.

Zugangsdaten und Kontoeinrichtung

Der Leitfaden von Telegram zum Erhalt einer api_id erklärt, dass jede Telefonnummer nur mit einer api_id verknüpft werden kann und dass Konten, die sich über inoffizielle Clients anmelden, unter Beobachtung gestellt werden. Dieselbe Seite warnt, dass die Nutzung der API für Flooding oder Spam zu einer dauerhaften Sperrung führt. Ein Team benötigt daher eine dedizierte Nummer und ein Konto sowie eine verantwortliche Person, die diese Telefonnummer aktuell hält.

Kontobeschränkungen

Große Kontaktimporte über ein einzelnes Konto können Limits auslösen. Wenn dies geschieht, liefert das Skript keine nützlichen Antworten mehr und das Konto muss möglicherweise wiederhergestellt werden. Das Aufteilen der Arbeit auf viele Konten, um dies zu vermeiden, bewegt das Projekt in einen Bereich, der laut den Nutzungsbedingungen von Telegram nicht erwünscht ist.

Wartung

Telegram aktualisiert seine API-Ebenen und Client-Bibliotheken ändern sich. Ein unbeaufsichtigtes Skript kann nach einem Abhängigkeitsupdate ausfallen, und jemand muss Probleme verfolgen, Versionen fixieren und erneut testen. Für eine Forschungsabteilung, die monatlich eine Handvoll Nummern prüft, ist dies machbar. Für eine CRM-Pipeline wird es zu einer ungeplanten technischen Aufgabe.

Datenverarbeitung

Da das Skript Nummern in die Kontakte eines echten Kontos importiert, fließen die Zieldaten durch dieses Konto. Die FAQ von Telegram weisen darauf hin, dass synchronisierte Kontakte so lange synchron gehalten werden, bis sie gelöscht werden. Bereinigungsschritte müssen daher Teil des Prozesses sein.

Unterschiede zu einer gehosteten Telegram-Prüf-API

Ein gehosteter Dienst zur Registrierungsprüfung eliminiert die Ebene des persönlichen Kontos. Bei TG Validator authentifiziert sich die Integration mit einem API-Schlüssel im X-API-Key-Header und sendet eine E.164-Telefonnummer an POST /api/v1/check mit dem Diensttyp tg oder bis zu 100 Nummern an POST /api/v1/batch-check. Die Ergebnisse werden in derselben Antwort innerhalb eines dokumentierten code, msg und data-Envelopes zurückgegeben; eine Prüfung, die nicht eindeutig entschieden werden kann, gibt einen geschäftlichen Code ungleich Null anstelle eines abgeschlossenen Ergebnisses zurück.

Dasselbe Konto bietet dem Team auch ein Web-Dashboard mit einem Tab für Einzelprüfungen, einem Tab für Batch-Prüfungen (bis zu 500 Nummern per Copy-Paste), Prüfverlauf, Nutzungsberichten und API-Schlüsselverwaltung. Für große Dateien akzeptieren asynchrone Bulk-Aufgaben TXT- oder CSV-Uploads und geben eine herunterladbare result.csv zurück, optional mit Diensten, die Benutzernamen, ungefähre Tage seit der letzten Aktivität oder avatarbasierte Schätzungen hinzufügen. Eine offizielle MCP-Integration stellt Tools für Einzelprüfungen und Guthabenabfragen für kompatible KI-Clients bereit, wobei dieselben Schlüssel, Guthaben und Limits gelten.

Die öffentliche API-Dokumentation beschreibt pro Benutzer geltende Nebenläufigkeits- und Timeout-Kontrollen anstelle eines pro Minute geltenden Ratenlimits, sodass Clients Anfragen in eine Warteschlange einreihen und Timeouts entsprechend handhaben sollten.

Vergleich im Überblick

Keine der beiden Optionen ist universell besser. Das Skript bietet volle Kontrolle und Transparenz über den Code; der gehostete Dienst tauscht dies gegen einen berechenbaren Betrieb ein.

Wann welche Option zur Telegram-Registrierungsprüfung passt

Ein GitHub-Skript passt tendenziell, wenn:

• Die Arbeit gelegentlich, investigativ oder akademisch ist und geringe Volumina umfasst.
• Eine technisch versierte Person das Konto überwachen und den Code aktualisieren kann.
• Die Ausgabe von Menschen gelesen und nicht in Produktionssysteme eingespeist wird.

Eine gehostete API passt tendenziell, wenn:

• Prüfungen nach Zeitplan oder innerhalb von Anmelde-, CRM- oder Support-Prozessen laufen.
• Mehrere Teammitglieder, einschließlich Nicht-Entwickler, Ergebnisse und Verlauf einsehen müssen.
• Die Organisation es vorzieht, einen Geschäftsprozess nicht an ein persönliches Telegram-Konto zu binden.
• Ergebnisse konsistente Zustände erfordern, einschließlich eines klaren unentschiedenen Ergebnisses für nachgelagerte Logik.

Einige Teams nutzen beides: ein Skript für Ad-hoc-Recherchen und einen gehosteten Dienst für die wiederkehrende Pipeline. Wenn dies der Plan ist, halten Sie die beiden Ergebnissätze getrennt, da sich ihre Definitionen eines negativen Ergebnisses unterscheiden.

Fragen vor der Entscheidung

1. Wie viele Nummern pro Monat und wie oft? Wiederkehrendes Volumen begünstigt einen Dienst mit dokumentiertem Verhalten.
2. Wem gehört das Telegram-Konto, das das Skript verwendet? Wenn die Antwort ein persönliches Konto eines Mitarbeiters ist, sollten Sie dies überdenken.
3. Was passiert, wenn ein Ergebnis unentschieden ist? Stellen Sie sicher, dass nachgelagerte Systeme diesen Zustand speichern können.
4. Wo werden die Ergebnisse gespeichert? Planen Sie Feldzuordnungen, Zeitstempel und Aufbewahrungsfristen vor dem ersten Durchlauf.
5. Was ist der Zweck der Prüfung? Ein Registrierungsergebnis unterstützt die Kanalplanung; es begründet keine Identität, Zustimmung oder eine wahrscheinliche Antwort.

Die Beantwortung dieser Fragen macht die Wahl meist offensichtlich und hält den Arbeitsablauf im Einklang mit den API-Nutzungsbedingungen von Telegram und den eigenen Datenrichtlinien des Teams.

FAQ

Ist Bellingcats Telegram-Registrierungsprüfung kostenlos?

Das Tool ist unter MIT-Lizenz lizenziert und kostenlos herunterladbar. Es erfordert ein Telegram-Konto mit einer aktiven Telefonnummer sowie Entwicklerzugangsdaten von my.telegram.org. Die Dokumentation warnt, dass Telegram persönliche Konten, die für Automatisierungen genutzt werden, sperren kann.

Warum benötigen GitHub-Prüftools überhaupt ein Telegram-Konto?

Sie nutzen die Client-API von Telegram als normaler Benutzer, indem sie typischerweise Nummern als Kontakte importieren und auslesen, welche davon mit einem Konto verknüpft sind. Diese Methode steht nur Benutzerkonten zur Verfügung, daher ist ein angemeldetes Konto erforderlich.

Wie können Teams von einem Skript zu einer gehosteten API wechseln, ohne den Verlauf zu verlieren?

Exportieren Sie die vergangenen Ergebnisse des Skripts mit ihren Prüfdaten, speichern Sie diese in einem separaten Feld oder einer Tabelle und beginnen Sie, neue gehostete Ergebnisse daneben aufzuzeichnen. Prüfen Sie ältere Datensätze vor der Wiederverwendung erneut, da sich die Registrierung im Laufe der Zeit ändern kann.

Gibt eine gehostete API dieselben Daten zurück wie ein Open-Source-Skript?

Nicht unbedingt. Eine gehostete Registrierungsprüfung gibt einen dokumentierten Registrierungsstatus zurück, und optionale Bulk-Dienste fügen spezifische Spalten wie Benutzernamen oder ungefähre Aktivität hinzu. Skripte geben das zurück, was der Code vom angemeldeten Konto liest, daher unterscheiden sich Ausgaben und Definitionen.

Mehr erfahren

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

• Zur Produktdokumentation →
• Kontakt zum Team →