Skip to content

API de verificare a telefonului

Validați că utilizatorii dețin numărul de telefon pe care îl furnizează.

Confirmați deținerea numărului în câteva secunde

Verificarea telefonului este fundamentul oricărei experiențe de utilizare demne de încredere. Trimiteți o parolă de unică folosință (OTP) prin SMS, WhatsApp sau apel vocal și confirmați deținerea numărului în câteva secunde.

Ce este verificarea telefonului?

Verificarea telefonului înseamnă a dovedi că persoana din fața dumneavoastră controlează într-adevăr numărul de telefon pe care l-a introdus. Un număr dintr-un formular este o afirmație; verificarea o transformă în dovadă. Fără ea, un câmp de înscriere acceptă greșeli de tastare, numere de unică folosință, numerele altor persoane și orice decide un script să lipească.

Această dovadă merită avută din trei motive distincte. Vă oferă un canal de contact funcțional, astfel încât resetările de parolă și notificările de livrare să ajungă la un telefon real. Vă oferă un identificator stabil pentru un cont, ceea ce face costisitoare conturile multiple și abuzul de bonusuri. Și vă oferă un al doilea factor la care puteți reveni ulterior, fără a cere utilizatorului să înroleze ceva nou.

Cum funcționează verificarea telefonului

Orice flux de verificare a telefonului se bazează pe aceeași idee: trebuie să se întâmple ceva pe telefon, ceva ce doar deținătorul său poate provoca. Versiunea clasică trimite un cod de unică folosință prin SMS și cere utilizatorului să îl introducă înapoi. Phone-Verif o rulează invers — utilizatorul trimite un mesaj în loc să primească unul — dar forma este aceeași: se creează o sesiune, se prezintă o provocare, se așteaptă dovada, se citește rezultatul.

În practică, aceasta înseamnă trei elemente mobile de partea dumneavoastră. Un apel care deschide o sesiune de verificare și vă dă ceva de afișat utilizatorului. Un ecran sau un widget în care acesta acționează. Și o modalitate de a afla rezultatul, fie printr-un callback, fie citind starea sesiunii.

Verificarea prin WhatsApp

WhatsApp este canalul principal aici. API-ul returnează un deep link WhatsApp care conține un scurt token de sesiune; îl afișați ca cod QR pe desktop sau ca buton pe mobil. Utilizatorul îl atinge, WhatsApp se deschide cu mesajul deja scris, iar utilizatorul îl trimite. WhatsApp raportează serverului numărul expeditorului și, fiindcă WhatsApp a verificat acel număr la crearea contului, moșteniți o dovadă pe care nu a trebuit să o construiți.

Cât din traficul dumneavoastră acoperă acest canal depinde în întregime de piață. Utilizarea WhatsApp este aproape universală în Brazilia, India și o mare parte din Europa și Africa, și marginală în Statele Unite, Japonia și Coreea de Sud. Merită să verificați unde se află efectiv utilizatorii dumneavoastră înainte de a decide de câtă rezervă aveți nevoie.

Verificarea prin SMS și soluția de rezervă

Pentru utilizatorii fără WhatsApp, aceeași sesiune acceptă același token prin SMS: utilizatorul trimite tokenul ca mesaj text simplu către numărul de verificare. Sesiunea, tokenul și starea pe care o citiți ulterior sunt identice, deci integrarea dumneavoastră nu se ramifică — se schimbă doar instrucțiunea afișată utilizatorului.

Contează mai mult decât pare. Un flux doar cu WhatsApp îi pierde pe tăcute pe toți cei din piețele cu adoptare scăzută; un flux doar cu SMS plătește un operator pentru fiecare încercare, inclusiv pentru cele declanșate de un bot. Păstrarea ambelor pe o singură sesiune vă permite să alegeți implicit canalul ieftin și sigur și să îi atingeți totuși pe ceilalți.

Reverse OTP: de ce contează direcția

Într-un flux OTP clasic, serverul trimite un secret și speră că ajunge la telefonul potrivit și nicăieri altundeva. Această presupunere este exploatată atât de atacurile SIM swap, cât și de phishingul de OTP, și este ceea ce face profitabil traficul umflat artificial: fiecare încercare vă costă un mesaj, indiferent dacă în spate se află sau nu un utilizator real.

Reverse OTP elimină presupunerea. Nu se trimite niciun secret utilizatorului, deci nu există nimic de interceptat, nimic de păcălit de la el și niciun mesaj de ieșire pentru care un fraudator să vă factureze. Propriul act de trimitere al utilizatorului este dovada.

Fluxul de verificare, de la cap la coadă

O sesiune începe în starea pending. Trece prin whatsapp_previewed când utilizatorul vede mesajul precompletat, prin opened când deschide linkul și ajunge la verified odată ce mesajul sosește și este asociat sesiunii. Dacă nimeni nu acționează la timp, se încheie în schimb la expired.

Doar starea verified poartă numărul de telefon; până atunci câmpul este null. Tratați starea ca pe semnal și numărul ca pe încărcătura sa, niciodată invers — această singură regulă elimină majoritatea condițiilor de cursă (race conditions) întâlnite la prima integrare.

Integrarea API-ului

Integrarea înseamnă două apeluri REST. POST /start-verification deschide o sesiune și returnează numărul WhatsApp, deep linkul și un URL web găzduit, dacă preferați redirecționarea în locul construirii propriului ecran. GET /check-verification-status returnează starea sesiunii și, după verificare, numărul în sine.

Puteți sări complet peste interfață și încorpora pagina de verificare găzduită într-un iframe, ceea ce este cea mai rapidă cale către ceva funcțional. În ambele cazuri, preferați callbackul unei bucle de polling în producție și faceți polling doar în dezvoltare sau când utilizatorul revine explicit pe pagina dumneavoastră.

Securitate și confidențialitate

Sesiunile sunt de scurtă durată, iar fiecare token este legat de exact una dintre ele, astfel că un mesaj retrimis nu se potrivește cu nimic. Numărul pe care îl primiți provine din infrastructura proprie WhatsApp, nu din datele introduse de utilizator, ceea ce închide breșa prin care un utilizator ar putea pur și simplu să tasteze numărul altcuiva și să aștepte un cod interceptat.

Din punctul de vedere al confidențialității, fluxul mută mai puține date personale decât cel pe care îl înlocuiește: niciun cod nu circulă printr-o rețea de telecomunicații în drum spre utilizator, iar dumneavoastră stocați numărul verificat, nu o istorie a încercărilor de livrare.

Prețuri

Verificările sunt facturate ca credite preplătite. Nu există abonament, iar creditele nu expiră, astfel că un vârf sezonier de înscrieri costă cât costă, iar o lună liniștită nu costă nimic. Conturile noi pornesc cu credite gratuite, suficiente pentru a rula fluxul de la cap la coadă într-un mediu de staging înainte de a vă angaja la ceva.

Întrebări frecvente

Ce este un API de verificare a telefonului?
Un API de verificare a telefonului este o interfață HTTP care dovedește că un utilizator controlează un număr de telefon. Îl apelați pentru a deschide o sesiune de verificare, afișați utilizatorului ce returnează și citiți înapoi un număr verificat după ce acesta a acționat.
Funcționează verificarea telefonului fără WhatsApp?
Da. Aceeași sesiune acceptă tokenul de verificare prin SMS, deci utilizatorii fără WhatsApp trimit tokenul ca mesaj text simplu. Integrarea dumneavoastră citește rezultatul de la același endpoint în ambele cazuri.
Cât durează o verificare?
Apelul API în sine este imediat; restul înseamnă ca utilizatorul să scaneze un cod și să apese pe trimitere. În practică, majoritatea sesiunilor se finalizează în câteva secunde, nu în minute, deoarece nu există un pas de livrare prin operator de așteptat.
Ce returnează API-ul după verificarea unui număr?
Starea sesiunii devine verified, iar răspunsul conține numărul de telefon validat, împreună cu marcajele de timp pentru fiecare etapă parcursă. Înainte de aceasta, câmpul numărului este null.
Este verificarea telefonului același lucru cu autentificarea în doi factori?
Nu. Verificarea telefonului dovedește că numărul aparține utilizatorului, de obicei o singură dată, la înregistrare. Autentificarea în doi factori reverifică această dovadă la autentificare sau înainte de o acțiune sensibilă. Același API le acoperă pe amândouă, dar ele răspund la întrebări diferite.

Related

Scenarii frecvente

Verificarea contactului

Confirmați că utilizatorii furnizează numere de telefon reale și accesibile.

Onboardingul clienților

Construiți încredere cu date de contact verificate din prima zi.

Validarea numerelor

Respingeți numerele invalide, de unică folosință sau inaccesibile.

Confirmarea identității utilizatorului

Asociați un număr de telefon unui profil de utilizator pentru o dovadă sigură a identității.

Build your verificarea telefonului flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.