Skip to content
Technik
6 Min. Lesezeit6. November 2026

So funktioniert die Telefonnummern-Verifizierung auf Telegram

Ein Telegram-Bot sieht die Telefonnummer eines Absenders nie, deshalb funktioniert die Verifizierung dort anders als bei WhatsApp. Hier der Ablauf, die Prüfungen dahinter und was an Ihre Anwendung zurückkommt.

Links: ein Chat mit einem Bot, der eine Nachricht und eine blaue Schaltfläche zum Teilen einer Telefonnummer zeigt. Ein Pfeil führt nach rechts zu einem weißen Schild mit blauem Häkchen auf blauem Hintergrund – die geteilte Nummer wurde verifiziert

WhatsApp war der erste Kanal von Phone-Verif, aber nicht jeder hält sich dort auf. Telegram ist jetzt ein zweiter Kanal: dieselbe API, dasselbe Ergebnis, und standardmäßig aktiv. Die Mechanik darunter ist eine andere, und es lohnt sich, sie zu verstehen, bevor Sie den Kanal anbieten.

Bei WhatsApp besteht der Nachweis aus einer Nachricht, die die Person sendet: Sie kommt von ihrer Nummer, und genau das ist die Idee hinter Reverse OTP. Ein Telegram-Bot hat kein solches Signal. Er identifiziert Personen anhand einer numerischen Konto-ID, und ihre Telefonnummer bleibt privat, solange sie sie nicht freiwillig teilen. Der Bot muss also danach fragen, und der Nachweis muss von woanders kommen als vom Absender.

Was die Person tut

Es gibt keinen Code zu lesen oder einzutippen. Der gesamte Ablauf besteht aus zwei Tipps in Telegram.

1. Link öffnen

Ihre Seite zeigt einen QR-Code oder eine Schaltfläche. Beide führen zu unserem Bot, wobei das Sitzungs-Token im Link mitgeführt wird.

2. Auf Start drücken

Mit Start wird das Token an den Bot übergeben, der dieses Telegram-Konto mit der Sitzung verknüpft.

3. Nummer teilen

Der Bot zeigt eine einzige Schaltfläche, „Meine Telefonnummer teilen“. Ein Tipp darauf sendet die eigene Kontaktkarte, die Telegram für das Konto erstellt.

4. Fertig

Der Bot bestätigt, die Sitzung gilt als verifiziert, und Ihre Anwendung erhält ihren Webhook und das Statusergebnis.

Warum ein geteilter Kontakt als Nachweis gilt

Jeder kann einem Bot eine Ziffernfolge schicken, deshalb werden eingetippte Nummern grundsätzlich abgelehnt: Der Bot antwortet, indem er die Schaltfläche erneut anzeigt. Gelesen wird nur eine Kontaktkarte, und sie muss vier Prüfungen bestehen, bevor die Sitzung abgeschlossen werden kann.

Es ist der eigene Kontakt

Die Nutzer-ID auf der Karte stimmt mit dem Konto überein, das sie sendet. Die Karte einer anderen Person aus einem Adressbuch scheitert hier.

Sie kommt vom richtigen Konto

Der Absender ist das Konto, das bei dieser Sitzung auf Start gedrückt hat, sodass eine Karte keine Sitzung abschließen kann, die jemand anderes geöffnet hat.

Sie wurde nicht weitergeleitet

Eine aus einem anderen Chat weitergeleitete Karte wird abgelehnt, selbst wenn es die eigene des Absenders ist.

Sie ist aktuell

Die Karte wurde nach dem Öffnen der Sitzung gesendet, sodass eine alte nicht erneut verwendet werden kann.

Eine Karte, die eine Prüfung nicht besteht, ändert nichts: Der Bot fragt erneut, und die Sitzung bleibt offen. Eine Nummer auf der Sperrliste wird auf Telegram genauso abgelehnt wie auf WhatsApp.

Jede Sitzung endet genau einmal

Ein Doppeltipp auf die Schaltfläche sendet zwei Kontaktkarten, und eine wiederholte Zustellung kann dieselbe Karte zweimal senden. Der Abschluss einer Sitzung wird deshalb atomar beansprucht: Eine Karte gewinnt, und es gibt ein Ergebnis, einen Webhook und ein verbrauchtes Credit.

Eine Sitzung kann außerdem nur auf einem Kanal abgeschlossen werden. Standardmäßig ist sie für WhatsApp, SMS und den Bot offen, und sobald einer davon sie abschließt, lehnen die anderen ihr Token ab. Eine auf Telegram oder WhatsApp festgelegte Sitzung lehnt den anderen Kanal von Anfang an ab. Der Bot-Link leitet für jedes Token gleich weiter, sodass sich damit nicht herausfinden lässt, welche Tokens aktiv sind.

Eine Nummer, eine Identität

Telegram und WhatsApp schreiben Telefonnummern unterschiedlich, deshalb wird die Nummer vor allem anderen in dieselbe Form normalisiert. Das ist wichtig, weil Identitäten darauf basieren.

Eine Person, die sich heute über WhatsApp und morgen über Telegram verifiziert, erhält dieselbe user_id. Sie ist ein Nutzer, nicht zwei, und flow=login meldet is_new_user entsprechend.

Wir verlassen uns selbst darauf. Telegram Connect und WhatsApp Connect auf unserer eigenen Anmeldeseite führen für dieselbe Nummer zum selben Konto, egal welchen Weg die Person zuerst genutzt hat.

Was zurückkommt

Ihre Integration liest dieselbe Statusantwort und erhält denselben Webhook wie bei WhatsApp, und eine Verifizierung kostet dieselben Credits. Die Abläufe phone, login und 2fa funktionieren alle.

Eines kommt hinzu. Bei flow=phone enthält eine verifizierte Telegram-Sitzung zusätzlich ein telegram-Objekt mit user_id, username, first_name und last_name des Kontos. Login und 2FA lassen es weg: Sie antworten mit einer Nutzer-ID oder einem Treffer, und ein Handle würde die Person genauso identifizieren wie eine Nummer.

Was es nicht belegt

Eine verifizierte Sitzung zeigt, dass dieses Telegram-Konto diese Nummer besitzt. Sie sagt nichts darüber aus, wer heute die SIM-Karte hat – eine Grenze, die sie mit jedem kontobasierten Kanal teilt, wie der Artikel zum SIM-Swap erklärt.

Die Besitzprüfung hängt außerdem von der Nutzer-ID ab, die Telegram auf der Kontaktkarte meldet. Die Dokumentation der Telegram Bot API beschreibt nicht, wie dieses Feld befüllt wird. Sie vertrauen hier also der Plattform, wie Sie bei WhatsApp der Absendernummer vertrauen.

Es gibt auch praktische Grenzen. Die Person braucht Telegram, und eine auf Telegram festgelegte Sitzung hat keinen SMS-Fallback.

Aktivierung

Sitzungen sind standardmäßig für Telegram offen, Sie müssen also keinen Parameter hinzufügen. Senden Sie provider=telegram, um eine Sitzung auf den Bot festzulegen, oder provider=whatsapp, um den Bot auszuschließen.

curl -X POST "https://api.phone-verif.com/start-verification" \
  -H "X-API-Key: $PHONE_VERIF_API_KEY"

Die Antwort enthält neben whatsapp und sms einen telegram-Block, sofern Telegram verfügbar ist. Codieren Sie qr_code_url in Ihrem QR-Code, und verwenden Sie direct_link für eine Schaltfläche auf Mobilgeräten.

{
  "whatsapp": { "...": "..." },
  "sms": { "...": "..." },
  "telegram": {
    "qr_code_url": "https://t.phone-verif.com/tg/<token>",
    "direct_link": "https://t.me/PhoneVerif_com_bot?start=<token>"
  }
}

Ohne Konto können Sie es in der Telegram-Demo ausprobieren. Die Integrationsanleitung behandelt die vollständige API.