Slanje kodova za verifikaciju (OTP) preko WhatsApp-a
Da biste poslali kod za verifikaciju (OTP) preko WhatsApp-a, firma pravi autentifikacioni šablon, Meta-in fiksni format „<kod> je vaš kod za verifikaciju.“ sa dugmetom za kopiranje koda ili dugmetom za jedan dodir, a njen backend ga šalje preko Cloud API-ja, s kodom popunjenim dvaput: u telu poruke i na dugmetu. Kodovi mogu imati najviše 15 znakova, a opciono upozorenje o isteku može da bude od 1 do 90 minuta.
easyCoexistence povezuje vaš WhatsApp Business broj sa Meta-inim Cloud API-jem preko Coexistence-a i daje vašem backendu sve što mu treba za slanje autentifikacionih šablona: Send endpoint, access token i, preko vašeg AI-ja, create_template i get_template_status.
Najduži parametar koji autentifikacioni šablon prihvata; URL-ovi, mediji i emotikoni nisu dozvoljeni ni u njegovom sadržaju ni u parametrima.
Raspon za code_expiration_minutes, koji poruci dodaje red „Ovaj kod ističe za N minuta.“
Podrazumevano vreme života (TTL) autentifikacionog šablona; može se podesiti od 30 sekundi do 15 minuta.
Greška koja se vraća kada se autentifikacioni šablon pošalje korisničkom ID-ju vezanom za firmu umesto broju telefona.
Autentifikacione poruke isporučuju se samo na primarni WhatsApp uređaj korisnika; povezani uređaji umesto toga vide obaveštenje.
Fiksna propusnost Coexistence broja, gornja granica za nalet kodova za prijavu.
Šta je WhatsApp autentifikacioni šablon?
Meta-in jedini dozvoljeni format za jednokratne lozinke i kodove za verifikaciju: ako aplikacija nudi kodove preko WhatsApp-a, mora da koristi taj šablon, a uslužni ili marketinški šabloni ne smeju da nose lozinku. Tekst je fiksiran: „<kod> je vaš kod za verifikaciju.“, uz dva opciona reda: „Radi vaše bezbednosti, nemojte deliti ovaj kod.“ i „Ovaj kod ističe za <N> minuta.“ Vi birate dugme. WhatsApp onemogućava prosleđivanje ovih poruka, a na iOS-u 26 i novijim kod se nudi i kao predlog na tastaturi, bez ikakvog vašeg posla.
Kako se pravi autentifikacioni šablon?
Izaberite ga u Template Library-ju u WhatsApp Manageru ili ga pošaljite preko API-ja, što vaš AI može da uradi pomoću create_template i kategorije AUTHENTICATION. Ne šaljete telo teksta: Meta ga piše iz vaših podešavanja, na jeziku koji izaberete, i pri kreiranju pretvara OTP dugme u URL dugme. Jedan šablon po jeziku. create_template konektora ne prosleđuje message_send_ttl_seconds, pa važi podrazumevano vreme života od 10 minuta, osim ako ga ne promenite preko Meta-inog 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š backend šalje kod?
Jedan zahtev po kodu na /messages endpoint broja, sa access tokenom iz get_api_credentials ili kartice „Plug in your own system“ na kontrolnoj tabli. Isti kod ide dvaput: u parametar tela i u parametar URL dugmeta na indeksu 0, a primalac mora biti broj telefona. Pre slanja backend generiše kod, čuva njegov heš sa vremenom isteka i brojačem pokušaja, a zatim upoređuje ono što korisnik unese sa tim hešom.
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 backenda, a ne iz automatizacije?
Zato što sistem koji prijavljuje korisnika mora da napravi kod, zapamti ga i proveri, a samo taj sistem zna kada je kod potreban. Automatizacije odgovaraju na poruke koje kupci šalju, a ekran za prijavu nikada ne piše na vaš broj. Sam šablon ih takođe isključuje: OTP dugme nosi kod kao promenljivu dugmeta, a korak Send a template popunjava samo promenljive u telu, pa ne može da pošalje autentifikacioni šablon. Vaš AI može da pošalje jedan preko send_template, koji Meta-i prosleđuje komponente dugmadi, ali to je za test, a ne za tok prijave.
Šta čini WhatsApp OTP tok bezbednim?
Meta-ine najbolje prakse i ograničenja formata vode do iste liste. Ništa od toga ne zahteva nešto više od vašeg backenda i Cloud API-ja:
- Potvrdite WhatsApp broj sa korisnikom pre prvog koda i recite mu da će kod stići na WhatsApp.
- Postavite vreme života na isto ili manje od isteka koda, da kasna isporuka nikada ne pokaže mrtav kod.
- Ograničite broj pokušaja i ponovnih slanja po broju, a kodovi ističu pri prvoj upotrebi.
- Ne koristite WhatsApp kod kao jedini faktor za oporavak naloga: reciklirani brojevi telefona i dalje mogu da dođu do starog WhatsApp naloga.
- Pratite status webhook i ponudite SMS ili e-poruku kada kod ne uspe da se isporuči.
Šta se menja kada broj radi i u WhatsApp Business aplikaciji?
Slanje radi kao na svakom Cloud API broju, do 20 poruka u sekundi. Meta preslikava poruke poslate preko API-ja u ćaskanja aplikacije, pa se na Coexistence broju kodovi koje šaljete pojavljuju i u tim ćaskanjima na poslovnom telefonu; zadržite taj telefon kod ljudi kojima verujete ili šaljite kodove sa zasebnog broja. Meta-ine najbolje prakse takođe traže da svaka firma šalje autentifikacione šablone sa sopstvenog broja, nikada sa broja koji dele firme. Autentifikacija je plaćena kategorija šablona, naplaćuje se po isporučenoj poruci prema zemlji primaoca, uz posebne stope za međunarodnu autentifikaciju na nekim tržištima; easyCoexistence ne dodaje nikakvu maržu.
Kako da podesite
- 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.
Česte greške
- Upisivanje koda u uslužni šablon, poput „Vaš kod je {{1}}“. Meta dozvoljava lozinke samo u autentifikacionim šablonima i odbija uslužne ili marketinške šablone koji ih nose.
- Slanje koda samo u telu poruke. Dugme za kopiranje koda zahteva istu vrednost kao svoj parametar; Meta očekuje kod dvaput u zahtevu.
- Zadržavanje 30-dnevnog vremena života na starijem autentifikacionom šablonu. Telefon koji je sat vremena van mreže tada dobija istekao kod; postavite ga na isto ili manje od isteka koda.
- Slanje koda na korisnički ID vezan za firmu. Autentifikacioni šabloni idu samo na brojeve telefona, a Meta vraća grešku 131062.
Broj se prati 24/7, pa vas prekid koji bi zaustavio kodove za prijavu stiže e-poštom. Od US$ 9 do US$ 0.75 po povezanom broju mesečno, uz pad kako dodajete brojeve, sa prvih 3 dana besplatno.
Često postavljana pitanja
Da li je WhatsApp OTP jeftiniji od SMS koda?
Meta naplaćuje svaku isporučenu autentifikacionu poruku po stopi za zemlju primaoca, uz posebne stope na nekim tržištima. SMS provajderi naplaćuju po operateru i ruti. Pre prelaska uporedite Meta-in cenovnik i cenovnik vašeg SMS provajdera za glavne zemlje u kojima imate korisnike.
Da li je ovo isto što i PIN za dvostepenu verifikaciju u WhatsApp-u?
Ne. Dvostepena verifikacija je šestocifreni PIN koji štiti sopstveni WhatsApp broj firme. Autentifikacioni šablon šalje kod vašim kupcima da bi vaša aplikacija ili sajt potvrdili ko su.
Da li korisnici moraju da pristanu da bi primali kodove?
Da. Meta-ina politika traži dozvolu pre nego što firma pošalje poruku nekome, a njene OTP smernice predlažu izbor kanala, na primer WhatsApp, SMS ili e-poštu. Izbor WhatsApp-a na ekranu za prijavu, pored broja, jeste ta dozvola.
Može li agencija da šalje kodove za više klijenata sa jednog broja?
Ne. Meta-ine najbolje prakse zahtevaju da svaka firma ima sopstveni WhatsApp Business nalog i broj telefona za autentifikacione šablone; deljenje jednog broja između firmi krši Meta-ine uslove i politiku. Povežite broj za svakog klijenta.
Nastavite sa čitanjem
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni periodProvereno na