Trimiteți coduri de verificare (OTP) pe WhatsApp
Pentru a trimite un cod de verificare (OTP) pe WhatsApp, o firmă creează un șablon de autentificare Meta, cu formatul fix „<cod> este codul dumneavoastră de verificare.”, plus un buton de copiere a codului sau un buton dintr-o singură atingere. Backend-ul firmei îl trimite prin Cloud API, cu codul completat de două ori: în corpul mesajului și în buton. Codurile pot avea până la 15 caractere, iar avertismentul opțional de expirare poate fi setat între 1 și 90 de minute.
easyCoexistence conectează numărul dumneavoastră de WhatsApp Business la Cloud API de la Meta, prin Coexistence, și oferă backend-ului dumneavoastră tot ce îi trebuie pentru a trimite șabloane de autentificare: endpoint-ul Send, token-ul de acces și, prin asistentul AI, create_template și get_template_status.
Cel mai lung parametru pe care îl acceptă un șablon de autentificare; URL-urile, fișierele media și emoji-urile nu sunt permise în conținutul sau parametrii săi.
Intervalul pentru code_expiration_minutes, care adaugă în mesaj linia „Acest cod expiră în N minute.”.
Timpul implicit de viață (TTL) al unui șablon de autentificare; poate fi setat între 30 de secunde și 15 minute.
Eroarea returnată când un șablon de autentificare este trimis unui ID de utilizator legat de firmă, în loc de un număr de telefon.
Mesajele de autentificare sunt livrate doar pe dispozitivul principal WhatsApp al utilizatorului; dispozitivele conectate văd în schimb o solicitare.
Debitul fix al unui număr Coexistence, plafonul pentru o rafală de coduri de conectare.
Ce este un șablon de autentificare WhatsApp?
Singurul format permis de Meta pentru parolele de unică folosință și codurile de verificare: dacă o aplicație oferă coduri prin WhatsApp, trebuie să folosească unul, iar șabloanele de utilitate sau de marketing nu pot conține o parolă. Textul este fix, „<cod> este codul dumneavoastră de verificare.”, cu două linii opționale: „Pentru siguranța dumneavoastră, nu împărtășiți acest cod.” și „Acest cod expiră în <N> minute.” Ce alegeți este butonul. WhatsApp dezactivează redirecționarea acestor mesaje, iar pe iOS 26 și versiunile ulterioare codul este oferit și ca sugestie în tastatură, fără nicio intervenție din partea dumneavoastră.
Cum creați șablonul de autentificare?
Îl alegeți din Biblioteca de șabloane din WhatsApp Manager sau îl trimiteți prin API, ceea ce asistentul dumneavoastră AI poate face cu create_template și categoria AUTHENTICATION. Nu trimiteți text pentru corpul mesajului: Meta îl generează din setările dumneavoastră, în limba aleasă, și transformă butonul OTP într-un buton URL la creare. Un șablon pentru fiecare limbă. Funcția create_template din conector nu transmite message_send_ttl_seconds, deci se aplică TTL-ul implicit de 10 minute, cu excepția cazului în care îl modificați prin API-ul Meta.
{
"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" }
]}
]
}Cum trimite backend-ul codul?
O cerere către endpoint-ul /messages al numărului pentru fiecare cod, cu token-ul de acces obținut din get_api_credentials sau din cardul „Conectați propriul sistem” din dashboard. Același cod este trimis de două ori: în parametrul corpului și în parametrul butonului URL cu indexul 0, iar destinatarul trebuie să fie un număr de telefon. Înainte de trimitere, backend-ul generează codul, stochează un hash al acestuia cu un termen de expirare și un contor de încercări, iar apoi compară ce tastează utilizatorul cu acel 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" }] }
]
}
}De ce vine codul din backend și nu dintr-o automatizare?
Pentru că sistemul care autentifică utilizatorul trebuie să creeze codul, să-l rețină și să-l verifice, iar doar acel sistem știe când este nevoie de un cod. Automatizările răspund la mesajele trimise de clienți, iar un ecran de autentificare nu scrie niciodată pe numărul dumneavoastră. Șablonul în sine le exclude și el: butonul OTP poartă codul ca variabilă de buton, iar pasul Trimite un șablon completează doar variabilele din corp, deci nu poate trimite un șablon de autentificare. Asistentul AI poate trimite unul prin send_template, care transmite componentele de buton către Meta, dar asta este pentru un test, nu pentru un flux de autentificare.
Ce face un flux OTP pe WhatsApp sigur?
Recomandările Meta și limitele formatului duc la aceeași listă de verificare. Niciuna nu necesită altceva decât backend-ul dumneavoastră și Cloud API:
- Confirmați cu utilizatorul numărul de WhatsApp înainte de primul cod și spuneți-i că un cod va sosi pe WhatsApp.
- Setați timpul de viață la sau sub expirarea codului, astfel încât o livrare întârziată să nu afișeze niciodată un cod expirat.
- Limitați încercările și retrimiterile pe număr și expirați codurile la prima utilizare.
- Nu faceți din codul WhatsApp singurul factor pentru recuperarea contului: numerele de telefon reciclate pot ajunge încă la un cont WhatsApp vechi.
- Urmăriți webhook-ul de stare și oferiți SMS sau e-mail atunci când un cod nu se livrează.
Ce se schimbă când numărul rulează și în aplicația WhatsApp Business?
Trimiterea funcționează ca pe orice număr Cloud API, până la 20 de mesaje pe secundă. Meta copiază mesajele trimise prin API în conversațiile aplicației, astfel că pe un număr Coexistence codurile trimise apar și în acele conversații de pe telefonul firmei; păstrați acel telefon în grija unor persoane de încredere sau trimiteți codurile de pe un număr separat. Recomandările Meta cer, de asemenea, ca fiecare firmă să trimită șabloanele de autentificare de pe propriul număr, niciodată de pe unul comun mai multor firme. Autentificarea este o categorie de șabloane cu plată, facturată pe mesaj livrat, în funcție de țara destinatarului, cu tarife separate pentru autentificare internațională în unele piețe; easyCoexistence nu adaugă niciun comision.
Cum să îl configurați
- 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.
Greșeli frecvente
- Scrierea codului într-un șablon de utilitate, de exemplu „Codul dumneavoastră este {{1}}”. Meta permite parole doar în șabloanele de autentificare și respinge șabloanele de utilitate sau de marketing în care le găsește.
- Trimiterea codului doar în corp. Butonul de copiere a codului are nevoie de aceeași valoare ca parametru; Meta așteaptă codul de două ori în cerere.
- Păstrarea unui TTL de 30 de zile pe un șablon de autentificare mai vechi. Un telefon deconectat o oră primește apoi un cod expirat; setați-l la sau sub expirarea codului.
- Adresarea codului unui ID de utilizator legat de firmă. Șabloanele de autentificare merg doar la numere de telefon, iar Meta returnează eroarea 131062.
Numărul este monitorizat 24/7, astfel încât o deconectare care ar opri codurile de conectare ajunge la dumneavoastră prin e-mail. De la US$ 9 până la US$ 0,75 pe număr și pe lună, scăzând pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
Este un cod OTP pe WhatsApp mai ieftin decât un cod SMS?
Depinde de țară. Meta taxează fiecare mesaj de autentificare livrat la tariful pentru țara destinatarului, cu tarife speciale în unele piețe, iar prețurile SMS variază în funcție de operator și de rută. Comparați tarifele Meta cu cele ale furnizorului dumneavoastră de SMS, pentru principalele țări, înainte de a trece.
Este același lucru cu PIN-ul de verificare în doi pași de pe WhatsApp?
Nu. Verificarea în doi pași este PIN-ul din șase cifre care protejează numărul de WhatsApp Business al firmei. Un șablon de autentificare trimite un cod clienților dumneavoastră, astfel încât aplicația sau site-ul să poată confirma cine sunt.
Utilizatorii trebuie să își dea acordul pentru a primi coduri?
Da. Politica Meta cere permisiunea înainte ca o firmă să trimită mesaje cuiva, iar ghidul său pentru OTP sugerează oferirea unei alegeri de canale, precum WhatsApp, SMS sau e-mail. Alegerea WhatsApp pe ecranul de autentificare, lângă număr, reprezintă această permisiune.
Poate o agenție să trimită coduri pentru mai mulți clienți de pe un singur număr?
Nu. Recomandările Meta cer ca fiecare firmă să aibă propriul cont WhatsApp Business și propriul număr de telefon pentru șabloanele de autentificare; partajarea unui număr între firme încalcă termenii și politica Meta. Conectați câte un număr pentru fiecare client.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la