Verifizierungscodes (OTP) per WhatsApp senden
Um einen Verifizierungscode (OTP) per WhatsApp zu senden, legt ein Unternehmen ein Authentifizierungs-Template an, Metas festes Format „<Code> ist Ihr Verifizierungscode.“ mit einem Copy-Code- oder Ein-Tipp-Button. Das Backend sendet es über die Cloud API und setzt den Code zweimal ein, im Text und im Button. Codes dürfen bis zu 15 Zeichen lang sein, und die optionale Ablaufwarnung reicht von 1 bis 90 Minuten.
easyCoexistence verbindet Ihre WhatsApp-Business-Nummer über Coexistence mit der Cloud API von Meta und gibt Ihrem Backend, was es zum Versenden von Authentifizierungs-Templates braucht: den Send-Endpoint, das Access-Token und über Ihre KI create_template und get_template_status.
Längster Parameter, den ein Authentifizierungs-Template akzeptiert; URLs, Medien und Emojis sind in seinem Inhalt und seinen Parametern nicht erlaubt.
Bereich von code_expiration_minutes, der die Zeile „Dieser Code läuft in N Minuten ab.“ zur Nachricht hinzufügt.
Standard-Time-to-live eines Authentifizierungs-Templates; sie lässt sich von 30 Sekunden bis 15 Minuten einstellen.
Fehler, der zurückkommt, wenn ein Authentifizierungs-Template an eine unternehmensbezogene Nutzer-ID statt an eine Telefonnummer gesendet wird.
Authentifizierungsnachrichten werden nur an das primäre WhatsApp-Gerät des Nutzers zugestellt; verknüpfte Geräte sehen stattdessen einen Hinweis.
Feste Durchsatzrate einer Coexistence-Nummer, die Obergrenze für einen Schub von Anmeldecodes.
Was ist ein WhatsApp-Authentifizierungs-Template?
Metas einziges zulässiges Format für Einmalpasswörter und Verifizierungscodes: Wenn eine App Codes über WhatsApp anbietet, muss sie dieses Format verwenden, und Utility- oder Marketing-Templates dürfen keinen Passcode enthalten. Der Text ist fest: „<Code> ist Ihr Verifizierungscode.“ mit zwei optionalen Zeilen, „Zu Ihrer Sicherheit geben Sie diesen Code nicht weiter.“ und „Dieser Code läuft in <N> Minuten ab.“ Sie wählen den Button. WhatsApp deaktiviert die Weiterleitung dieser Nachrichten, und unter iOS 26 und neuer wird der Code zusätzlich als Tastaturvorschlag angeboten, ohne dass Sie etwas tun müssen.
Wie legen Sie das Authentifizierungs-Template an?
Wählen Sie es in der Template-Bibliothek im WhatsApp Manager, oder reichen Sie es über die API ein, was Ihre KI mit create_template und der Kategorie AUTHENTICATION erledigen kann. Sie senden keinen Textkörper: Meta erstellt ihn aus Ihren Einstellungen in der gewählten Sprache und wandelt den OTP-Button bei der Erstellung in einen URL-Button um. Ein Template pro Sprache. Das create_template des Connectors übergibt message_send_ttl_seconds nicht, daher gilt der Standard-Time-to-live von 10 Minuten, sofern Sie ihn nicht über die API von Meta ändern.
{
"connection_id": "<from list_numbers>",
"name": "login_code",
"language": "en_US",
"category": "AUTHENTICATION",
"components": [
{ "type": "BODY", "add_security_recommendation": true },
{ "type": "FOOTER", "code_expiration_minutes": 5 },
{ "type": "BUTTONS", "buttons": [
{ "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
]}
]
}Wie sendet Ihr Backend den Code?
Pro Code eine Anfrage an den Endpoint /messages der Nummer, mit dem Access-Token aus get_api_credentials oder der Karte „Eigenes System anbinden“ im Dashboard. Derselbe Code wird zweimal übergeben, im Body-Parameter und im Parameter des URL-Buttons mit Index 0, und der Empfänger muss eine Telefonnummer sein. Vor dem Senden erzeugt das Backend den Code, speichert einen Hash davon mit Ablaufzeit und Versuchszähler und vergleicht danach die Eingabe des Nutzers mit diesem Hash.
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>
{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "template",
"template": {
"name": "login_code",
"language": { "code": "en_US" },
"components": [
{ "type": "body",
"parameters": [{ "type": "text", "text": "482913" }] },
{ "type": "button", "sub_type": "url", "index": "0",
"parameters": [{ "type": "text", "text": "482913" }] }
]
}
}Warum kommt der Code von Ihrem Backend und nicht von einer Automatisierung?
Weil das System, das den Nutzer anmeldet, den Code erzeugen, speichern und prüfen muss, und nur dieses System weiß, wann ein Code benötigt wird. Automatisierungen beantworten Nachrichten, die Kunden senden, und ein Anmeldebildschirm schreibt nie an Ihre Nummer. Auch das Template selbst schließt sie aus: Der OTP-Button trägt den Code als Button-Variable, und der Schritt „Template senden“ füllt nur Body-Variablen, kann also kein Authentifizierungs-Template versenden. Ihre KI kann eines über send_template senden, das Button-Komponenten an Meta übergibt, das ist aber für einen Test gedacht, nicht für einen Anmeldeablauf.
Was macht einen WhatsApp-OTP-Ablauf sicher?
Metas Best Practices und die Grenzen des Formats führen zur selben Checkliste. Dafür brauchen Sie nichts außer Ihrem Backend und der Cloud API:
- Bestätigen Sie die WhatsApp-Nummer mit dem Nutzer, bevor der erste Code gesendet wird, und sagen Sie, dass der Code per WhatsApp kommt.
- Setzen Sie die Time-to-live auf die Ablaufzeit des Codes oder darunter, damit eine verspätete Zustellung nie einen abgelaufenen Code zeigt.
- Begrenzen Sie Versuche und erneutes Senden pro Nummer, und lassen Sie Codes beim ersten Gebrauch ablaufen.
- Machen Sie einen WhatsApp-Code nicht zum einzigen Faktor für die Kontowiederherstellung: Recycelte Telefonnummern können noch ein altes WhatsApp-Konto erreichen.
- Beobachten Sie den Status-Webhook und bieten Sie SMS oder E-Mail an, wenn ein Code nicht zugestellt werden kann.
Was ändert sich, wenn die Nummer auch in der WhatsApp-Business-App läuft?
Der Versand funktioniert wie bei jeder Nummer der Cloud API, bis zu 20 Nachrichten pro Sekunde. Meta spiegelt über die API gesendete Nachrichten in die Chats der App, sodass die Codes, die Sie über eine Coexistence-Nummer senden, auch in diesen Chats auf dem Geschäftstelefon erscheinen. Bewahren Sie dieses Telefon bei Personen auf, denen Sie vertrauen, oder senden Sie Codes von einer separaten Nummer. Metas Best Practices verlangen außerdem, dass jedes Unternehmen Authentifizierungs-Templates von seiner eigenen Nummer sendet, niemals von einer Nummer, die mehrere Unternehmen teilen. Authentifizierung ist eine kostenpflichtige Template-Kategorie, die pro zugestellter Nachricht nach dem Land des Empfängers abgerechnet wird, in einigen Märkten mit eigenen Tarifen für „authentication-international“. easyCoexistence schlägt darauf keinen Aufschlag.
So richten Sie es ein
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
- Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
- Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
- Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
- Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.
Häufige Fehler
- Den Code in ein Utility-Template schreiben, etwa „Ihr Code ist {{1}}“. Meta erlaubt Passcodes nur in Authentifizierungs-Templates und lehnt Utility- oder Marketing-Templates ab, die sie enthalten.
- Den Code nur im Body senden. Der Copy-Code-Button braucht denselben Wert als Parameter; Meta erwartet den Code zweimal in der Anfrage.
- Eine Time-to-live von 30 Tagen auf einem älteren Authentifizierungs-Template behalten. Ein Telefon, das eine Stunde offline war, erhält dann einen abgelaufenen Code; setzen Sie den Wert auf die Ablaufzeit des Codes oder darunter.
- Den Code an eine unternehmensbezogene Nutzer-ID adressieren. Authentifizierungs-Templates gehen nur an Telefonnummern, und Meta gibt Fehler 131062 zurück.
Die Nummer wird rund um die Uhr überwacht, sodass eine Trennung, die Anmeldecodes stoppen würde, Sie per E-Mail erreicht. Ab US$ 9 pro verbundener Nummer und Monat, sinkend auf US$ 0.75 mit jeder weiteren Nummer, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Ist ein WhatsApp-OTP günstiger als ein SMS-Code?
Meta berechnet jede zugestellte Authentifizierungsnachricht zum Tarif des Empfängerlandes, in einigen Märkten mit Sondertarifen. SMS-Preise variieren je nach Anbieter und Route. Vergleichen Sie Metas Preisliste mit dem SMS-Tarif Ihres Anbieters für Ihre wichtigsten Länder, bevor Sie umstellen.
Ist das dasselbe wie die Zwei-Schritt-Verifizierungs-PIN von WhatsApp?
Nein. Die Zwei-Schritt-Verifizierung ist die sechsstellige PIN, die die eigene WhatsApp-Nummer des Unternehmens schützt. Ein Authentifizierungs-Template sendet einen Code an Ihre Kunden, damit Ihre App oder Website bestätigen kann, wer sie sind.
Müssen Nutzer zustimmen, um Codes zu erhalten?
Ja. Metas Richtlinie verlangt eine Erlaubnis, bevor ein Unternehmen jemandem schreibt, und seine OTP-Leitlinien empfehlen, eine Auswahl von Kanälen anzubieten, etwa WhatsApp, SMS oder E-Mail. Wenn Sie WhatsApp auf Ihrem Anmeldebildschirm neben der Nummer wählbar machen, ist das diese Erlaubnis.
Kann eine Agentur Codes für mehrere Kunden von einer Nummer senden?
Nein. Metas Best Practices verlangen, dass jedes Unternehmen sein eigenes WhatsApp-Business-Konto und seine eigene Telefonnummer für Authentifizierungs-Templates hat. Eine Nummer zwischen Unternehmen zu teilen verstößt gegen Metas Bedingungen und Richtlinien. Verbinden Sie stattdessen eine Nummer pro Kunden.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am