API zur Telefonnummern-Verifizierung
Prüfen Sie, ob Nutzer die angegebene Telefonnummer wirklich besitzen.
Nummerninhaber in Sekunden bestätigen
Die Telefonnummern-Verifizierung ist die Grundlage jedes vertrauenswürdigen Nutzererlebnisses. Senden Sie ein Einmalpasswort (OTP) per SMS, WhatsApp oder Sprachanruf und bestätigen Sie den Besitz in Sekunden.
Was ist Telefonnummern-Verifizierung?
Telefonnummern-Verifizierung heißt nachzuweisen, dass die Person vor Ihnen die eingegebene Telefonnummer tatsächlich kontrolliert. Eine Nummer in einem Formular ist eine Behauptung; die Verifizierung macht daraus einen Beleg. Ohne sie akzeptiert ein Registrierungsfeld Tippfehler, Wegwerfnummern, fremde Nummern und alles, was ein Skript einzufügen beschließt.
Dieser Beleg ist aus drei Gründen wertvoll. Er liefert Ihnen einen funktionierenden Kontaktkanal, sodass Passwort-Resets und Versandbenachrichtigungen ein echtes Mobilgerät erreichen. Er liefert eine stabile Kennung für ein Konto, die Mehrfachkonten und Bonus-Missbrauch teuer macht. Und er liefert einen zweiten Faktor, auf den Sie später zurückgreifen können, ohne dass der Nutzer etwas Neues einrichten muss.
So funktioniert die Telefonnummern-Verifizierung
Jeder Ablauf zur Telefonnummern-Verifizierung beruht auf derselben Idee: Auf dem Mobilgerät muss etwas geschehen, das nur sein Besitzer auslösen kann. Die klassische Variante sendet einen Einmalcode per SMS und lässt den Nutzer ihn zurücktippen. Phone-Verif dreht das um – der Nutzer sendet eine Nachricht, statt eine zu empfangen –, doch der Ablauf bleibt gleich: Sitzung anlegen, Aufgabe stellen, auf den Nachweis warten, Ergebnis auslesen.
In der Praxis bedeutet das drei bewegliche Teile auf Ihrer Seite. Einen Aufruf, der eine Verifizierungssitzung öffnet und Ihnen etwas zum Anzeigen für den Nutzer liefert. Einen Bildschirm oder ein Widget, in dem der Nutzer darauf reagiert. Und eine Möglichkeit, das Ergebnis zu erfahren, entweder per Callback oder durch Abfrage des Sitzungsstatus.
WhatsApp-Verifizierung
WhatsApp ist hier der Hauptkanal. Die API liefert einen WhatsApp-Deep-Link mit einem kurzen Sitzungs-Token; Sie zeigen ihn auf dem Desktop als QR-Code und auf dem Smartphone als Schaltfläche an. Der Nutzer tippt darauf, WhatsApp öffnet sich mit bereits geschriebener Nachricht, und er sendet sie ab. WhatsApp meldet die absendende Nummer an den Server, und da WhatsApp diese Nummer bei der Kontoerstellung verifiziert hat, erben Sie einen Nachweis, den Sie nicht selbst aufbauen mussten.
Wie viel Ihres Datenverkehrs das abdeckt, hängt ganz vom Markt ab. Die WhatsApp-Nutzung ist in Brasilien, Indien und großen Teilen Europas und Afrikas nahezu universell und in den USA, Japan und Südkorea marginal. Prüfen Sie, wo Ihre Nutzer tatsächlich sind, bevor Sie entscheiden, wie viel Alternative Sie brauchen.
SMS-Verifizierung und Fallback
Für Nutzer ohne WhatsApp akzeptiert dieselbe Sitzung dasselbe Token per SMS: Der Nutzer sendet das Token stattdessen als einfache Textnachricht an die Verifizierungsnummer. Sitzung, Token und der Status, den Sie anschließend auslesen, sind identisch, Ihre Integration verzweigt also nicht – nur die dem Nutzer angezeigte Anweisung ändert sich.
Das ist wichtiger, als es klingt. Ein reiner WhatsApp-Ablauf verliert in Märkten mit geringer Verbreitung stillschweigend alle Nutzer; ein reiner SMS-Ablauf bezahlt für jeden Versuch einen Netzbetreiber, auch für die, die ein Bot auslöst. Beide in einer Sitzung zu halten, erlaubt Ihnen, standardmäßig den günstigen, sicheren Kanal zu nutzen und trotzdem den Rest zu erreichen.
Reverse OTP: warum die Richtung zählt
In einem herkömmlichen OTP-Ablauf sendet der Server ein Geheimnis und hofft, dass es am richtigen Mobilgerät und nirgendwo sonst ankommt. Diese Annahme nutzen sowohl SIM-Swap-Angriffe als auch OTP-Phishing aus, und sie macht künstlich aufgeblähten Datenverkehr profitabel: Jeder Versuch kostet Sie eine Nachricht, ob ein echter Nutzer dahintersteht oder nicht.
Reverse OTP beseitigt die Annahme. Es wird nichts Geheimes an den Nutzer gesendet, es gibt also nichts abzufangen, nichts, was man ihm per Phishing entlocken könnte, und keine ausgehende Nachricht, die ein Betrüger Ihnen in Rechnung stellen lässt. Der eigene Sendevorgang des Nutzers ist der Nachweis.
Der Verifizierungsablauf von Anfang bis Ende
Eine Sitzung beginnt im Zustand pending. Sie durchläuft whatsapp_previewed, wenn der Nutzer die vorausgefüllte Nachricht sieht, opened, wenn er den Link öffnet, und verified, sobald die Nachricht eintrifft und der Sitzung zugeordnet wird. Handelt niemand rechtzeitig, endet sie stattdessen bei expired.
Nur der Zustand verified enthält die Telefonnummer; bis dahin ist das Feld null. Betrachten Sie den Status als das Signal und die Nummer als seine Nutzlast, niemals umgekehrt – diese eine Regel beseitigt die meisten Race Conditions, auf die man bei der ersten Integration stößt.
Die API integrieren
Die Integration besteht aus zwei REST-Aufrufen. POST /start-verification öffnet eine Sitzung und liefert die WhatsApp-Nummer, den Deep-Link und eine gehostete Web-URL, falls Sie lieber weiterleiten, als einen eigenen Bildschirm zu bauen. GET /check-verification-status liefert den Zustand der Sitzung und, sobald sie verifiziert ist, die Nummer selbst.
Sie können die Oberfläche ganz überspringen und die gehostete Verifizierungsseite in einen iframe einbetten – der schnellste Weg zu etwas Funktionierendem. In jedem Fall sollten Sie in der Produktion den Callback einer Polling-Schleife vorziehen und nur während der Entwicklung oder dann abfragen, wenn der Nutzer ausdrücklich auf Ihre Seite zurückkehrt.
Sicherheit und Datenschutz
Sitzungen sind kurzlebig, und jedes Token ist an genau eine von ihnen gebunden, sodass eine wiedereingespielte Nachricht zu nichts passt. Die Nummer, die Sie erhalten, stammt aus der eigenen Infrastruktur von WhatsApp und nicht aus der Nutzereingabe. Das schließt die Lücke, in der ein Nutzer einfach die Nummer eines anderen eintippen und auf einen abgefangenen Code warten kann.
Datenschutzseitig bewegt der Ablauf weniger personenbezogene Daten als der, den er ersetzt: Kein Code läuft auf dem Weg zum Nutzer durch ein Telekommunikationsnetz, und Sie speichern die verifizierte Nummer statt einer Spur von Zustellversuchen.
Preise
Verifizierungen werden über vorausbezahlte Credits abgerechnet. Es gibt kein Abonnement, und Credits verfallen nicht – ein saisonaler Registrierungsschub kostet, was er kostet, und ein ruhiger Monat kostet nichts. Neue Konten starten mit kostenlosen Credits, die ausreichen, um den Ablauf in einer Staging-Umgebung von Anfang bis Ende durchzuspielen, bevor Sie sich festlegen.
Häufig gestellte Fragen
- Was ist eine API zur Telefonnummern-Verifizierung?
- Eine API zur Telefonnummern-Verifizierung ist eine HTTP-Schnittstelle, die belegt, dass ein Nutzer eine Telefonnummer kontrolliert. Sie rufen sie auf, um eine Verifizierungssitzung zu öffnen, zeigen dem Nutzer an, was sie zurückliefert, und lesen eine verifizierte Nummer aus, sobald er darauf reagiert hat.
- Funktioniert die Telefonnummern-Verifizierung auch ohne WhatsApp?
- Ja. Dieselbe Sitzung akzeptiert das Verifizierungs-Token auch per SMS, sodass Nutzer ohne WhatsApp das Token stattdessen als einfache Textnachricht senden. Ihre Integration liest das Ergebnis in beiden Fällen vom selben Endpunkt.
- Wie lange dauert eine Verifizierung?
- Der API-Aufruf selbst erfolgt sofort; den Rest erledigt der Nutzer durch Scannen eines Codes und Tippen auf Senden. In der Praxis sind die meisten Sitzungen in Sekunden statt Minuten abgeschlossen, weil kein Zustellschritt über den Netzbetreiber abgewartet werden muss.
- Was liefert die API, sobald eine Nummer verifiziert ist?
- Der Sitzungsstatus wechselt zu verified, und die Antwort enthält die validierte Telefonnummer samt Zeitstempeln für jeden durchlaufenen Schritt. Davor ist das Nummernfeld null.
- Ist die Telefonnummern-Verifizierung dasselbe wie Zwei-Faktor-Authentifizierung?
- Nein. Die Telefonnummern-Verifizierung belegt, dass die Nummer dem Nutzer gehört, in der Regel einmalig bei der Registrierung. Die Zwei-Faktor-Authentifizierung prüft diesen Nachweis bei der Anmeldung oder vor einer sensiblen Aktion erneut. Dieselbe API deckt beides ab, beantwortet aber unterschiedliche Fragen.
Related
Typische Szenarien
Kontaktverifizierung
Bestätigen Sie, dass Nutzer echte, erreichbare Telefonnummern angeben.
Kunden-Onboarding
Schaffen Sie Vertrauen mit verifizierten Kontaktdaten ab dem ersten Tag.
Nummernvalidierung
Weisen Sie ungültige, Wegwerf- oder nicht erreichbare Nummern ab.
Bestätigung der Nutzeridentität
Binden Sie eine Telefonnummer an ein Nutzerprofil für einen sicheren Identitätsnachweis.
Build your telefonnummern-verifizierung flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.