Slanje verifikacijskih kodova (OTP) na WhatsAppu
Da biste poslali verifikacijski kod (OTP) na WhatsAppu, tvrtka stvara autentikacijski predložak, fiksni format tvrtke Meta „<kod> je vaš verifikacijski kod.” s gumbom za kopiranje koda ili gumbom za jedan dodir, a njezin poslužitelj ga šalje putem sučelja Cloud API, s kodom upisanim dvaput: u tijelu poruke i u gumbu. Kodovi mogu imati najviše 15 znakova, a neobavezno upozorenje o isteku vrijedi od 1 do 90 minuta.
easyCoexistence povezuje vaš broj WhatsApp Business s Metinim Cloud API-jem putem načina Coexistence i vašem poslužitelju daje ono što treba za slanje autentikacijskih predložaka: endpoint Send, pristupni token i, putem vaše AI, create_template i get_template_status.
Najduži parametar koji autentikacijski predložak prihvaća; URL-ovi, medijski sadržaji i emotikoni nisu dopušteni u njegovu sadržaju ni parametrima.
Raspon vrijednosti code_expiration_minutes, koji poruci dodaje redak „Ovaj kod istječe za N minuta.”
Zadano vrijeme života autentikacijskog predloška; može se postaviti od 30 sekundi do 15 minuta.
Greška koja se vraća kada se autentikacijski predložak šalje na korisnički ID vezan uz poslovni račun, a ne na broj telefona.
Autentikacijske poruke isporučuju se samo na primarni WhatsApp uređaj korisnika; povezani uređaji umjesto toga prikazuju obavijest.
Fiksna propusnost broja u načinu Coexistence, gornja granica za nalet kodova za prijavu.
Što je WhatsApp autentikacijski predložak?
Metin jedini dopušteni format za jednokratne lozinke i kodove za provjeru: ako aplikacija nudi kodove putem WhatsAppa, mora koristiti upravo njega, a uslužni ili marketinški predlošci ne smiju sadržavati zaporku. Tekst je fiksan, „<kod> je vaš verifikacijski kod.”, uz dva neobavezna retka: „Radi vaše sigurnosti, ne dijelite ovaj kod.” i „Ovaj kod istječe za <N> minuta.” Što birate jest gumb. WhatsApp onemogućuje proslijeđivanje ovih poruka, a na iOS 26 i novijima kod se nudi i kao prijedlog na tipkovnici, bez ikakvog truda s vaše strane.
Kako se kreira autentikacijski predložak?
Odaberite ga u biblioteci predložaka (Template Library) u alatu WhatsApp Manager ili ga podnesite putem API-ja, što vaša AI može učiniti pomoću create_template i kategorije AUTHENTICATION. Tekst poruke ne šaljete: Meta ga sastavlja iz vaših postavki, na jeziku koji odaberete, a gumb OTP pri kreiranju pretvara u gumb tipa URL. Jedan predložak po jeziku. Funkcija create_template konektora ne prosljeđuje message_send_ttl_seconds, pa vrijedi zadano vrijeme života od 10 minuta, osim ako ga ne promijenite putem Metinog API-ja.
{
"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" }
]}
]
}Kako vaš poslužitelj šalje kod?
Jedan zahtjev na endpoint /messages za broj po kodu, s pristupnim tokenom iz get_api_credentials ili kartice „Priključi vlastiti sustav” na nadzornoj ploči. Isti kod ide dvaput: u parametar tijela poruke i u parametar URL gumba na indeksu 0, a primatelj mora biti broj telefona. Prije slanja poslužitelj generira kod, pohranjuje njegov hash s vremenom isteka i brojačem pokušaja, a zatim uspoređuje ono što korisnik upisuje s tim hashom.
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" }] }
]
}
}Zašto kod dolazi iz vašeg poslužitelja, a ne iz automatizacije?
Zato što sustav koji prijavljuje korisnika mora stvoriti kod, zapamtiti ga i provjeriti, a samo taj sustav zna kada je kod potreban. Automatizacije odgovaraju na poruke koje kupci šalju, a prijavni ekran nikad ne piše na vaš broj. Sam predložak ih i isključuje: gumb OTP nosi kod kao varijablu gumba, a korak „Pošalji predložak” popunjava samo varijable tijela, pa ne može poslati autentikacijski predložak. Vaša AI može poslati jedan putem send_template, koji prosljeđuje gumbe s komponentama tvrtke Meta, ali to je za test, a ne za tijek prijave.
Što čini WhatsApp OTP tijek sigurnim?
Metine najbolje prakse i ograničenja formata upućuju na istu kontrolnu listu. Ništa od toga ne traži više od vašeg poslužitelja i sučelja Cloud API:
- Potvrdite WhatsApp broj s korisnikom prije prvog koda i recite da će kod stići na WhatsApp.
- Postavite vrijeme života na vrijednost jednaku ili manju od isteka koda, tako da kasna isporuka nikad ne pokaže mrtav kod.
- Ograničite pokušaje i ponovna slanja po broju te neka kodovi isteknu pri prvoj upotrebi.
- Nemojte WhatsApp kod činiti jedinim čimbenikom za oporavak računa: reciklirani brojevi telefona i dalje mogu doseći stari WhatsApp račun.
- Pratite statusni webhook i ponudite SMS ili e-poštu kada kod ne uspije stići.
Što se mijenja kada broj radi i u aplikaciji WhatsApp Business?
Slanje radi kao na bilo kojem broju Cloud API, do 20 poruka u sekundi. Meta poruke poslane putem API-ja prenosi u razgovore aplikacije, pa se na broju Coexistence kodovi koje šaljete pokazuju i u tim razgovorima na poslovnom telefonu; čuvajte taj telefon kod ljudi kojima vjerujete ili šaljite kodove s odvojenog broja. Metine najbolje prakse također traže da svaka tvrtka šalje autentikacijske predloške sa svog broja, nikada s broja koji dijele više tvrtki. Autentikacija je plaćena kategorija predložaka, naplaćuje se po isporučenoj poruci prema zemlji primatelja, uz zasebne stope za međunarodnu autentikaciju na nekim tržištima; easyCoexistence ne dodaje nikakvu maržu.
Kako ga postaviti
- 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.
Uobičajene pogreške
- Upisivanje koda u uslužni predložak, primjerice „Vaš kod je {{1}}”. Meta dopušta zaporke samo u autentikacijskim predlošcima i odbija uslužne ili marketinške predloške koji ih sadrže.
- Slanje koda samo u tijelu poruke. Gumb za kopiranje koda treba istu vrijednost kao svoj parametar; Meta u zahtjevu očekuje kod dvaput.
- Zadržavanje vremena života od 30 dana na starijem autentikacijskom predlošku. Telefon koji je sat vremena bio offline tada dobiva istekli kod; postavite ga na vrijednost jednaku ili manju od isteka koda.
- Slanje koda na korisnički ID vezan uz poslovni račun. Autentikacijski predlošci idu samo na brojeve telefona, a Meta vraća pogrešku 131062.
Broj se nadzire 24 sata dnevno, pa vas e-poštom obavijesti prekid koji bi zaustavio kodove za prijavu. Od US$ 9 do US$ 0,75 po broju mjesečno, a cijena pada kako dodajete brojeve, uz besplatno probno razdoblje od 3 dana.
Često postavljana pitanja
Je li WhatsApp OTP jeftiniji od SMS koda?
Ovisi o zemlji. Meta naplaćuje svaku isporučenu autentikacijsku poruku po stopi za zemlju primatelja, uz posebne stope na nekim tržištima, a cijene SMS-a razlikuju se po operateru i ruti. Prije prebacivanja usporedite Metinu tarifu s tarifom svog SMS pružatelja za glavne zemlje.
Je li ovo isto što i PIN za dvostupanjsku provjeru WhatsAppa?
Ne. Dvostupanjska provjera je šesteroznamenkasti PIN koji štiti vlastiti WhatsApp broj tvrtke. Autentikacijski predložak šalje kod vašim kupcima kako bi vaša aplikacija ili web-stranica mogla potvrditi tko su.
Moraju li korisnici pristati da primaju kodove?
Da. Metina pravila traže dopuštenje prije nego što tvrtka pošalje poruku, a njezine smjernice za OTP preporučuju ponudu izbora kanala, poput WhatsAppa, SMS-a ili e-pošte. Odabir WhatsAppa na prijavnom ekranu, uz broj, upravo je to dopuštenje.
Može li agencija slati kodove za više klijenata s jednog broja?
Ne. Metine najbolje prakse zahtijevaju da svaka tvrtka ima vlastiti račun WhatsApp Business i vlastiti broj telefona za autentikacijske predloške; dijeljenje jednog broja među tvrtkama protivno je uvjetima i pravilima tvrtke Meta. Umjesto toga povežite broj za svakog klijenta.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na