Ghid de integrare Reverse OTP pentru verificarea telefonului
Un ghid complet, pas cu pas, pentru implementarea verificării Reverse-OTP în aplicația dumneavoastră mobilă, cu integrarea API, detectarea WhatsApp, tratarea cazurilor limită și strategii de rezervă pentru o autentificare fluidă a utilizatorilor.

Locul acestei pagini
Aceasta este prezentarea implementării. Pentru a afla ce este Reverse OTP și cum se îmbină piesele, citiți cum funcționează Reverse OTP; pentru argumentele în favoarea schimbării canalului, citiți Reverse OTP vs OTP prin SMS. Referința endpointurilor se află în ghidul de integrare a API-ului de verificare WhatsApp.
Reverse-OTP este o abordare inovatoare a verificării utilizatorilor, care folosește aplicații de mesagerie precum WhatsApp pentru a simplifica procesul. În loc să trimită utilizatorului un OTP prin SMS, aplicația însăși trimite un mesaj precompletat, iar serverul verifică expeditorul. Astfel se reduc riscurile de fraudă, crește viteza și pot scădea costurile față de OTP-urile tradiționale prin SMS.
În acest articol vă arătăm cum să integrați Reverse-OTP în fluxul existent de verificare a telefonului: integrarea API, detectarea aplicației, tratarea cazurilor limită și ce să faceți dacă WhatsApp nu este disponibil.

Detectați WhatsApp pe dispozitivul utilizatorului
Înainte de a iniția verificarea, aplicația dumneavoastră ar trebui să verifice dacă WhatsApp este instalat, folosind canOpenURL.
Implementare iOS:
Înregistrați mai întâi whatsapp:// ca schemă de interogare în fișierul Info.plist al aplicației, la LSApplicationQueriesSchemes.
Configurarea Info.plist
<key>LSApplicationQueriesSchemes</key>
<array>
<string>whatsapp</string>
</array>Implementare Android:
Folosiți PackageManager pentru a verifica dacă pachetul WhatsApp este prezent.
Detectarea WhatsApp pe Android
try {
PackageManager pm = getPackageManager();
pm.getPackageInfo("com.whatsapp", PackageManager.GET_ACTIVITIES);
// WhatsApp is installed
} catch (PackageManager.NameNotFoundException e) {
// WhatsApp is not installed
}Bună practică: dacă WhatsApp este disponibil, continuați cu Reverse-OTP. Dacă nu, treceți elegant la SMS.
Inițiați Reverse-OTP
Generați pe backend un scurt cod de sesiune unic (poate fi un identificator existent, cum ar fi UUID-ul utilizatorului). Apelați cu el API-ul nostru start-verification-flow. Acesta va returna un token unic, folosit pentru a genera un deep link WhatsApp precompletat.
Formatul deep linkului WhatsApp
https:/PHONE_NUMBER?text=VERIFY-12345Textul generat va include acest token de verificare între paranteze, pentru ca backendul să îl detecteze și să îl lege de sesiunea inițială.
Utilizatorul atinge linkul, se deschide WhatsApp, apasă pe trimitere, iar numărul său de telefon este extras pe backend din metadatele WhatsApp.
Utilizatorul primește un mesaj de confirmare direct pe WhatsApp, cu un URL de callback pentru a reveni în serviciul dumneavoastră.
Exemplu de integrare API
const response = await fetch('/api/start-verification', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
session_id: userSessionId,
phone_number: userPhoneNumber
})
});
const { validation_token, whatsapp_url } = await response.json();Interogați rezultatul
Când utilizatorul reintră în flux, backendul dumneavoastră va interoga starea sesiunii deschise anterior pentru a obține direct numărul de telefon. Puteți salva acest număr și marca verificarea ca reușită.
Implementarea verificării stării
const checkStatus = async (sessionId) => {
const response = await fetch('/api/check-verification-status', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ session_id: sessionId })
});
const result = await response.json();
if (result.status === 'verified') {
// Save the verified phone number
saveVerifiedPhoneNumber(result.phone_number);
markVerificationComplete();
}
return result;
};Sfat de specialist: implementați un polling care verifică starea verificării la câteva secunde, până la finalizare sau expirarea timpului.
Tratați cazurile limită
Uneori utilizatorii deschid WhatsApp, dar nu finalizează procesul:
- Refuză o fereastră de permisiuni WhatsApp
- Aplicația este descărcată din memorie (offloaded) sau ștearsă
- Mesajul rămâne blocat la trimitere din cauza conectivității slabe
Cum să procedați:
Expirare elegantă:
După câteva minute fără să primiți mesajul, întrebați utilizatorul:
Mecanism de reîncercare:
Oferiți un buton „Retrimite prin WhatsApp” care regenerează un link.
Opțiuni de rezervă:
Oferiți mereu un canal alternativ de verificare, pentru a nu bloca onboardingul.
Persistența stării:
Dacă utilizatorul revine mai târziu, păstrați sesiunea activă și reoferiți opțiunile de verificare, fără a-l obliga să reia onboardingul.
Implementarea tratării cazurilor limită
const handleVerificationTimeout = () => {
showDialog({
title: "Verification Incomplete",
message: "It looks like your verification didn't complete. Would you like to try again or switch to SMS?",
buttons: [
{ label: "Try WhatsApp Again", action: retryWhatsAppVerification },
{ label: "Use SMS Instead", action: fallbackToSMS },
{ label: "Cancel", action: closeDialog }
]
});
};
// Set timeout for 3 minutes
setTimeout(handleVerificationTimeout, 180000);Soluție de rezervă pentru utilizatorii fără WhatsApp
Dacă canOpenURL (iOS) sau PackageManager (Android) detectează că WhatsApp nu este disponibil, treceți automat la OTP prin SMS sau prin e-mail.
Implementarea soluției de rezervă
const initiateVerification = async () => {
const hasWhatsApp = await checkWhatsAppAvailability();
if (hasWhatsApp) {
// Use Reverse-OTP via WhatsApp
return initiateReverseOTP();
} else {
// Fall back to SMS OTP
return initiateSMSOTP();
}
};
const checkWhatsAppAvailability = async () => {
if (Platform.OS === 'ios') {
return await Linking.canOpenURL('whatsapp://');
} else {
// Android package check
return await isAppInstalled('com.whatsapp');
}
};Sfat pentru experiența utilizatorului: faceți trecerea imperceptibilă, fără a cere utilizatorilor să aleagă ei înșiși. Folosiți automat cea mai bună metodă disponibilă pentru dispozitivul lor.
Concluzie
Reverse-OTP face verificarea mai rapidă, mai sigură și adesea mai ieftină decât SMS-ul. Este însă esențial să proiectați pentru întreruperile din lumea reală - de la permisiunile aplicației până la eșecurile de livrare a mesajelor - astfel încât utilizatorii să aibă mereu o cale lină înainte. Un flux de rezervă bine gândit vă asigură atât securitatea, cât și ratele de conversie.
