InloggenGratis proefperiode starten
Meta Tech Provider

Verificatiecodes (OTP) versturen via WhatsApp

Om een verificatiecode (OTP) via WhatsApp te versturen, maakt een bedrijf een authenticatietemplate aan: Meta's vaste opmaak “<code> is je verificatiecode.” met een kopieerknop of een knop met één tik. De backend verstuurt de code vervolgens via de Cloud API, met de code twee keer ingevuld: in de body en in de knop. Codes mogen tot 15 tekens lang zijn, en de optionele vervaltijdwaarschuwing loopt van 1 tot 90 minuten.

easyCoexistence koppelt je WhatsApp Business-nummer via Coexistence aan de Cloud API van Meta en geeft je backend wat nodig is om authenticatietemplates te versturen: het Send-endpoint, het access-token en, via je AI, create_template en get_template_status.

15 characters

Langste parameter die een authenticatietemplate accepteert; URLs, media en emoji's zijn niet toegestaan in de inhoud of de parameters.

1 to 90 minutes

Bereik van code_expiration_minutes, dat de regel “Deze code verloopt over N minuten.” aan het bericht toevoegt.

10 minutes

Standaard levensduur (time-to-live) van een authenticatietemplate; die is in te stellen van 30 seconden tot 15 minuten.

131062

Fout die wordt teruggegeven wanneer een authenticatietemplate wordt verstuurd naar een bedrijfsgebonden gebruikers-ID in plaats van een telefoonnummer.

Primary device

Authenticatieberichten worden alleen afgeleverd op het primaire WhatsApp-apparaat van de gebruiker; gekoppelde apparaten zien in plaats daarvan een melding.

20 msg/s

Vaste doorvoer van een Coexistence-nummer, het plafond voor een piek aan inlogcodes.

Wat is een WhatsApp-authenticatietemplate?

Meta's enige toegestane opmaak voor eenmalige wachtwoorden en verificatiecodes: als een app codes via WhatsApp aanbiedt, moet die dit template gebruiken, en utility- of marketingtemplates mogen geen wachtwoord bevatten. De tekst is vast, “<code> is je verificatiecode.”, met twee optionele regels: “Voor je veiligheid, deel deze code niet.” en “Deze code verloopt over <N> minuten.” Jij kiest zelf de knop. WhatsApp schakelt doorsturen van deze berichten uit, en op iOS 26 en later wordt de code ook als toetsenbordsuggestie aangeboden, zonder dat je daar iets voor hoeft te doen.

Copy codeTapping copies the code to the clipboard; the user pastes it in your app or site
One-tap autofillAndroid: the button opens your app and hands it the code; needs app changes and a handshake
Zero-tapAndroid only, no button: your app receives the code through a broadcast receiver

Hoe maak je de authenticatietemplate aan?

Kies hem in de Template Library in WhatsApp Manager, of dien hem in via de API, wat je AI kan doen met create_template en de categorie AUTHENTICATION. Je stuurt geen bodytekst mee: Meta schrijft die op basis van je instellingen, in de taal die je kiest, en zet de OTP-knop bij het aanmaken om in een URL-knop. Eén template per taal. De create_template van de connector geeft message_send_ttl_seconds niet door, dus geldt de standaard levensduur van 10 minuten, tenzij je die via de API van Meta wijzigt.

create_template arguments for a copy-code template
{
  "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" }
    ]}
  ]
}

Hoe verstuurt je backend de code?

Eén verzoek naar het endpoint /messages van het nummer per code, met het access-token van get_api_credentials of de kaart “Koppel je eigen systeem” in het dashboard. Dezelfde code gaat er twee keer in, als body-parameter en als parameter van de URL-knop op index 0, en de ontvanger moet een telefoonnummer zijn. Voor het verzenden genereert de backend de code, slaat een hash daarvan op met een vervaltijd en een pogingenteller, en vergelijkt daarna wat de gebruiker intypt met die hash.

Sending a login code from your backend
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" }] }
    ]
  }
}

Waarom komt de code van je backend en niet van een automatisering?

Omdat het systeem dat de gebruiker inlogt de code moet aanmaken, onthouden en controleren, en alleen dat systeem weet wanneer een code nodig is. Automatiseringen beantwoorden berichten die klanten sturen, en een inlogscherm schrijft nooit naar je nummer. Ook het template zelf sluit ze uit: de OTP-knop draagt de code als knopvariabele, en de stap Stuur een template vult alleen body-variabelen in, dus die kan geen authenticatietemplate versturen. Je AI kan er wel een versturen via send_template, dat button-componenten aan Meta doorgeeft, maar dat is voor een test, niet voor een inlogflow.

Wat maakt een WhatsApp-OTP-flow veilig?

De best practices van Meta en de grenzen van het formaat wijzen naar dezelfde checklist. Niets daarvan vereist meer dan je backend en de Cloud API:

  • Bevestig het WhatsApp-nummer met de gebruiker vóór de eerste code, en zeg dat de code via WhatsApp komt.
  • Stel de time-to-live gelijk aan of lager dan de vervaltijd van de code, zodat een late aflevering nooit een verlopen code toont.
  • Beperk pogingen en hernieuwde verzendingen per nummer, en laat codes verlopen bij het eerste gebruik.
  • Gebruik een WhatsApp-code niet als enige factor voor accountherstel: gerecyclede telefoonnummers kunnen nog steeds een oud WhatsApp-account bereiken.
  • Houd de status-webhook in de gaten en bied sms of e-mail aan wanneer een code niet wordt afgeleverd.

Wat verandert er als het nummer ook in de WhatsApp Business-app draait?

Verzenden werkt zoals bij elk Cloud API-nummer, tot 20 berichten per seconde. Meta spiegelt berichten die via de API zijn verstuurd naar de chats van de app, dus op een Coexistence-nummer verschijnen de codes die je verstuurt ook in die chats op de zakelijke telefoon; houd die telefoon bij mensen die je vertrouwt, of verstuur codes vanaf een apart nummer. Meta's best practices vragen ook dat elk bedrijf authenticatietemplates vanaf het eigen nummer verstuurt, nooit vanaf een nummer dat meerdere bedrijven delen. Authenticatie is een betaalde templatecategorie, afgerekend per afgeleverd bericht op basis van het land van de ontvanger, met in sommige markten aparte authentication-international-tarieven; easyCoexistence rekent er geen opslag op.

Zo stel je het in

  1. Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
  2. 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.
  3. 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.
  4. 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.
  5. Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.

Veelgemaakte fouten

  • Een code in een utility-template zetten, zoals “Je code is {{1}}”. Meta staat wachtwoorden alleen toe in authenticatietemplates en keurt utility- of marketingtemplates af die er een bevatten.
  • De code alleen in de body sturen. De kopieerknop heeft dezelfde waarde nodig als parameter; Meta verwacht de code twee keer in het verzoek.
  • Een time-to-live van 30 dagen behouden op een oudere authenticatietemplate. Een telefoon die een uur offline is, ontvangt dan een verlopen code; stel die gelijk aan of lager dan de vervaltijd van de code.
  • De code richten aan een bedrijfsgebonden gebruikers-ID. Authenticatietemplates gaan alleen naar telefoonnummers, en Meta geeft fout 131062 terug.
Dit doen met EasyCoexistence

Het nummer wordt 24/7 gemonitord, dus een verbindingsverlies dat inlogcodes zou stoppen, bereikt je per e-mail. Van US$ 9 tot US$ 0.75 per nummer per maand, dalend naarmate je nummers toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Is een WhatsApp-OTP goedkoper dan een sms-code?

Meta rekent elk afgeleverd authenticatiebericht tegen het tarief van het land van de ontvanger, met aparte tarieven in sommige markten. easyCoexistence rekent er geen opslag op. Zet Meta's tarieventabel naast de sms-prijs van je provider voor je belangrijkste landen en kies het goedkoopste kanaal per land.

Is dit hetzelfde als de tweestapsverificatie-pincode van WhatsApp?

Nee. Tweestapsverificatie is de zescijferige pincode die het eigen WhatsApp-nummer van het bedrijf beschermt. Een authenticatietemplate stuurt je klanten een code, zodat je app of site kan bevestigen wie ze zijn.

Moeten gebruikers toestemming geven om codes te ontvangen?

Ja. Meta's beleid vereist toestemming voordat een bedrijf iemand een bericht stuurt, en de OTP-richtlijnen raden aan een keuze van kanalen te bieden, zoals WhatsApp, sms of e-mail. Als je op je inlogscherm, naast het nummer, voor WhatsApp kiest, is dat de toestemming.

Kan een bureau codes voor meerdere klanten vanaf één nummer versturen?

Nee. Meta's best practices vereisen dat elk bedrijf een eigen WhatsApp Business Account en telefoonnummer heeft voor authenticatietemplates; één nummer delen tussen bedrijven is in strijd met Meta's voorwaarden en beleid. Koppel daarom per klant een nummer.

Lees verder

Klaar om te beginnen?

Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.

Start je gratis proefperiode

Geverifieerd op