WhatsApp-Verifizierungscodes empfangen, ohne ein Mitarbeiter-Handy zu blockieren

Warum braucht ein Team eine WhatsApp-Nummer, die niemandem persönlich gehört?

Die Situation ist bekannt. Ein Produktteam baut einen Support-Ablauf auf WhatsApp auf oder testet, wie die eigene App Nutzer an einen Chat übergibt, und jemand muss ein Konto registrieren. Am schnellsten geht es mit dem Handy eines Kollegen. Damit hängt ein geschäftliches Setup an der SIM-Karte einer einzelnen Person, Testverkehr vermischt sich mit privaten Unterhaltungen, und alles bricht an dem Tag zusammen, an dem diese Person das Unternehmen verlässt.

Agenturen, die WhatsApp für Kunden einrichten, stoßen auf dasselbe Problem, ebenso QA-Engineers, die ein Testkonto in einem bestimmten Markt brauchen, um einen regionalen Onboarding-Ablauf zu prüfen. Eine WhatsApp-Telefonnummer aus dem OTP Gateway hält diese Arbeit von privaten Leitungen fern: Sie wählen das Land, erhalten den Registrierungscode und machen weiter.

Wann verlangt WhatsApp einen Verifizierungscode per Telefon?

WhatsApp identifiziert jedes Konto über die Telefonnummer und prüft deshalb an einigen Stellen per Einmalcode, ob Sie die Nummer kontrollieren:

• Registrierung: Ein neues Konto erhält einen sechsstelligen Code per SMS, und WhatsApp bietet gegebenenfalls alternativ einen Anruf an.
• Neues Gerät: Bei einer Neuinstallation oder dem Wechsel auf ein anderes Handy wird die Prüfung wiederholt, das bisherige Handy wird abgemeldet.
• Business-Konten: Auch die Einrichtung der WhatsApp-Business-App auf einer Nummer durchläuft denselben Schritt.
• Bestätigung in zwei Schritten: eine optionale PIN, die der Nutzer selbst wählt. Sie wird nie per SMS verschickt, aber zusammen mit dem Code abgefragt, wenn sie aktiviert ist.

Für Tests ist der Punkt einfach: Die SMS belegt, dass Sie die Nummer in diesem Moment besitzen. Eine Nummer, die Ihnen nicht mehr gehört, kann das Konto später nicht mehr verifizieren.

Wie funktioniert der Ablauf der WhatsApp-Verifizierungscode-API?

Verwenden Sie die Service-ID whatsapp zusammen mit der Länder-ID des Testmarkts, zum Beispiel in, br oder us. Mit einem Bearer-Schlüssel aus der Developer-Konsole:

1. GET /api/v1/prices?country=<id>&service=whatsapp liefert den aktuellen Preis und zeigt, ob die Route gerade offen ist.
2. POST /api/v1/activations mit {"service": "whatsapp", "country": "<id>"} reserviert eine Nummer und startet das 20-Minuten-Fenster.
3. Geben Sie die Nummer auf dem Registrierungsbildschirm von WhatsApp ein und fordern Sie die SMS an.
4. Der Code erreicht Sie als Webhook-Ereignis activation.sms_received, oder Sie fragen alle paar Sekunden GET /api/v1/activations/{id} ab.
5. Wird der Durchlauf abgebrochen, schickt POST /api/v1/activations/{id}/cancel den Betrag zurück ins Guthaben.

Prüfen Sie X-OTPRoute-Signature, bevor Sie dem Inhalt vertrauen: Berechnen Sie HMAC-SHA256 über <t>.<raw body> mit dem Secret des Endpunkts, vergleichen Sie das Ergebnis mit v1 und lehnen Sie zu alte Zeitstempel ab. Speichern Sie das Ereignis anschließend unter seiner Aktivierungs-ID, damit eine wiederholte Zustellung nichts verändert. Polling ist die einfachere Wahl, wenn ein Test-Runner keine öffentliche URL bereitstellen kann; die Entwicklerdokumentation beschreibt beide Wege.

In welchen Ländern gibt es WhatsApp-Nummern, und spielt die Wahl eine Rolle?

WhatsApp-Routen sind derzeit in 198 Ländern verfügbar, darunter Indien, Brasilien, Indonesien, Nigeria, Deutschland, Mexiko, das Vereinigte Königreich, die USA, Pakistan, die Philippinen, Ägypten, Kenia, Spanien, die Türkei und Südafrika. Die vollständige Liste finden Sie auf der Länderseite.

Wählen Sie das Land bewusst. Zielt Ihr Onboarding auf brasilianische Nutzer, zeigt eine +55-Nummer, wie Ihre App eine lokale Nummer formatiert, validiert und anzeigt. Soll das Business-Konto einen einzigen Markt bedienen, passen Sie die Nummer diesem Markt an. Ein beliebiges Land spart nichts und kann ein Testergebnis wertlos machen.

Warum kommt der WhatsApp-Code möglicherweise nicht an?

WhatsApp entscheidet selbst, an welche Nummern es sendet, und kann eine virtuelle Nummer für die Registrierung auch komplett ablehnen. Dann erreicht nichts die Aktivierung, das Fenster schließt sich, und der volle Betrag geht zurück in Ihr Guthaben; Sie zahlen nur, wenn tatsächlich ein Code ankommt. Andere Ursachen sind banaler: eine ausgelastete Route, eine Aufforderung von WhatsApp, vor der nächsten Code-Anforderung zu warten, oder ein Code, der per Anruf statt per SMS angefordert wurde.

Das können Sie tun:

• Lassen Sie die Aktivierung für das gesamte Fenster offen, statt schon nach einer Minute abzubrechen.
• Achten Sie darauf, dass auf dem Registrierungsbildschirm eine SMS und kein Anruf angefordert wurde.
• Versuchen Sie es später erneut oder über eine andere Länderroute, sofern der Markt des Kontos das zulässt.
• Verteilen Sie Ihre Versuche zeitlich. Wer Code um Code in einer schnellen Schleife anfordert, macht es meist nur schlimmer.

Sollte ein langlebiges WhatsApp-Konto eine dedizierte Nummer nutzen?

In der Regel ja. Eine Nummer aus dem OTP Gateway gilt für einen Code, und muss das Konto nach einem Handywechsel oder einer Neuinstallation erneut verifiziert werden, brauchen Sie genau diese Nummer zurück. Für eine Support-Leitung, ein gemeinsames Business-Konto oder ein QA-Konto, das Tester monatelang wiederverwenden, passt eine Dedicated Virtual Number besser. Sie werden in den USA und Kanada sofort bereitgestellt, kosten ab $1.95/Monat, verlängern sich aus dem Guthaben, leiten eingehende SMS als number.sms_received an Ihren Webhook weiter und lassen sich jederzeit freigeben. Außerhalb dieser beiden Länder gibt es keine Self-Service-Langzeitnummer; schreiben Sie in diesem Fall an [email protected]. Einzelheiten stehen auf der Seite virtuelle Nummern.

Geht das auch ohne API-Zugang direkt im Dashboard?

Ja. Melden Sie sich an, laden Sie das Guthaben per Karte oder mit USDT/USDC auf, wählen Sie WhatsApp und ein Land, bestätigen Sie den angezeigten Preis und bestellen Sie. Tippen Sie die Nummer in WhatsApp ein; sobald der Code eintrifft, erscheint er auf der Aktivierungsseite. Es gibt weder eine monatliche Gebühr noch einen Tarif, jede Aufladung kommt mit einer PDF-Rechnung per E-Mail, und es gilt dieselbe Erstattungsregel wie bei der API. Entwickler, die eine Integration vorab proben wollen, können den Support bitten, ein Entwicklungskonto in den Sandbox-Modus zu versetzen, in dem simulierte Nummern und Codes den Webhook ohne Kosten durchspielen.

Was bedeutet verantwortungsvolle Nutzung von WhatsApp-Nummern?

OTP Route dient dazu, Ihre eigenen legitimen Produkte und Konten zu testen und zu betreiben. Halten Sie sich an die Nutzungsbedingungen von WhatsApp, bleiben Sie bei einem Konto pro realer Person oder Unternehmen und nutzen Sie die Routen weder für Massenregistrierungen noch für unerwünschte Nachrichten noch für eine Rückkehr auf die Plattform nach einer Sperre. Die Acceptable Use Policy von OTP Route gilt für jede Aktivierung. WhatsApp ist eine Marke seines Inhabers, und OTP Route steht in keiner Verbindung dazu.

Häufige Fragen

Kann ich einen WhatsApp-OTP ohne SIM-Karte empfangen?

Ja. Eine Nummer aus dem OTP Gateway empfängt die WhatsApp-Registrierungs-SMS und zeigt den Code in Ihrem Dashboard an oder sendet ihn an Ihren Webhook, ganz ohne physische SIM-Karte.

Wie lautet die Service-ID für WhatsApp in der API?

Verwenden Sie whatsapp als Dienst in GET /api/v1/prices und POST /api/v1/activations, zusammen mit einer Länder-ID wie in oder us.

Akzeptiert WhatsApp jede virtuelle Nummer?

Nein. WhatsApp kann virtuelle Nummern ablehnen. Deshalb wird eine Aktivierung, die keinen Code erhält, vollständig an Ihr Guthaben erstattet.

Kann ich mich später mit derselben Nummer wieder im WhatsApp-Konto anmelden?

Nicht mit einer Gateway-Nummer, die nur für einen einzigen Code gilt. Muss das Konto erneut verifiziert werden, nutzen Sie eine Dedicated Virtual Number in den USA oder Kanada.

Was kostet eine WhatsApp-Verifizierungsnummer?

Die Preise beginnen bei $0.20 pro Code und variieren je nach Land. Der aktuelle Preis erscheint vor der Bestellung im Dashboard und über den Prices-Endpunkt.

Ist die WhatsApp-SMS-Verifizierung zum Testen auch in einer CI-Pipeline möglich?

Ja, für Ihre eigenen Testkonten. Entwickeln Sie zunächst gegen die Sandbox und rufen Sie die Live-Routen danach sparsam und mit Backoff zwischen den Versuchen auf.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.