API weryfikacji telefonu
Sprawdź, czy użytkownicy są właścicielami podanego numeru telefonu.
Potwierdzenie własności numeru w kilka sekund
Weryfikacja telefonu to fundament każdego zaufanego doświadczenia użytkownika. Wyślij hasło jednorazowe (OTP) przez SMS, WhatsApp lub połączenie głosowe i potwierdź własność numeru w kilka sekund.
Czym jest weryfikacja telefonu?
Weryfikacja telefonu to udowodnienie, że osoba po drugiej stronie faktycznie kontroluje wpisany numer telefonu. Numer w formularzu to deklaracja, a weryfikacja zamienia ją w dowód. Bez niej pole rejestracji przyjmuje literówki, numery jednorazowe, cudze numery i wszystko, co zdecyduje się wkleić skrypt.
Taki dowód jest wart posiadania z trzech niezależnych powodów. Daje działający kanał kontaktu, dzięki czemu resety haseł i powiadomienia o dostawie trafiają na prawdziwy aparat. Daje stabilny identyfikator konta, co podnosi koszt wielokrotnych kont i nadużyć bonusów. I daje drugi składnik, z którego można skorzystać później, bez proszenia użytkownika o nową rejestrację.
Jak działa weryfikacja telefonu
Każdy przepływ weryfikacji telefonu opiera się na tej samej idei: na aparacie musi wydarzyć się coś, co może spowodować tylko jego posiadacz. Klasyczna wersja wysyła kod jednorazowy SMS-em i prosi użytkownika o jego wpisanie. Phone-Verif działa odwrotnie, bo użytkownik wysyła wiadomość zamiast ją odbierać, ale schemat jest ten sam: utworzenie sesji, przedstawienie wyzwania, oczekiwanie na dowód, odczyt wyniku.
W praktyce oznacza to trzy elementy po stronie integratora. Wywołanie, które otwiera sesję weryfikacyjną i zwraca coś do pokazania użytkownikowi. Ekran lub widżet, na którym użytkownik na to reaguje. Oraz sposób poznania wyniku: przez callback lub odczyt statusu sesji.
Weryfikacja przez WhatsApp
WhatsApp to tutaj główny kanał. API zwraca deep link WhatsApp zawierający krótki token sesji, który wyświetla się jako kod QR na komputerze lub przycisk na urządzeniu mobilnym. Użytkownik go dotyka, WhatsApp otwiera się z gotową wiadomością, a użytkownik ją wysyła. WhatsApp przekazuje serwerowi numer nadawcy, a ponieważ WhatsApp zweryfikował ten numer przy zakładaniu konta, integrator dziedziczy dowód, którego nie musiał budować.
To, jaką część ruchu to obejmuje, zależy wyłącznie od rynku. Użycie WhatsAppa jest bliskie powszechnemu w Brazylii, Indiach oraz dużej części Europy i Afryki, a marginalne w Stanach Zjednoczonych, Japonii i Korei Południowej. Zanim zdecyduje się, jak duże rozwiązanie awaryjne jest potrzebne, warto sprawdzić, gdzie faktycznie są użytkownicy.
Weryfikacja SMS i rozwiązanie awaryjne
Dla użytkowników bez WhatsAppa ta sama sesja przyjmuje ten sam token przez SMS: użytkownik wysyła token jako zwykłą wiadomość tekstową na numer weryfikacyjny. Sesja, token i status odczytywany później są identyczne, więc integracja się nie rozgałęzia. Zmienia się tylko instrukcja pokazywana użytkownikowi.
Ma to większe znaczenie, niż się wydaje. Przepływ wyłącznie przez WhatsApp po cichu traci wszystkich na rynkach o niskiej adopcji, a przepływ wyłącznie przez SMS płaci operatorowi za każdą próbę, także tę wywołaną przez bota. Połączenie obu w jednej sesji pozwala domyślnie używać taniego, bezpiecznego kanału i nadal docierać do pozostałych.
Reverse OTP: dlaczego kierunek ma znaczenie
W konwencjonalnym przepływie OTP serwer wysyła sekret i ma nadzieję, że trafi on na właściwy aparat i nigdzie indziej. To założenie wykorzystują zarówno ataki SIM swap, jak i phishing kodów OTP, i to ono sprawia, że sztucznie zawyżany ruch jest opłacalny: każda próba kosztuje wiadomość, niezależnie od tego, czy stoi za nią prawdziwy użytkownik.
Reverse OTP usuwa to założenie. Użytkownikowi nie jest wysyłany żaden sekret, więc nie ma czego przechwycić, nie ma czego od niego wyłudzić i nie ma wiadomości wychodzącej, za którą oszust mógłby wystawić rachunek. Dowodem jest sam akt wysłania przez użytkownika.
Przepływ weryfikacji od początku do końca
Sesja zaczyna w stanie pending. Przechodzi przez whatsapp_previewed, gdy użytkownik zobaczy gotową wiadomość, opened, gdy otworzy link, i verified, gdy wiadomość dotrze i zostanie dopasowana do sesji. Jeśli nikt nie zareaguje na czas, sesja kończy w stanie expired.
Numer telefonu zawiera tylko stan verified, a do tego czasu pole ma wartość null. Status należy traktować jako sygnał, a numer jako jego ładunek, nigdy odwrotnie. Ta jedna zasada usuwa większość sytuacji wyścigu, na które natrafiają osoby przy pierwszej integracji.
Integracja z API
Integracja to dwa wywołania REST. POST /start-verification otwiera sesję i zwraca numer WhatsApp, deep link oraz adres URL strony hostowanej, jeśli wolno przekierować użytkownika zamiast budować własny ekran. GET /check-verification-status zwraca stan sesji, a po weryfikacji także sam numer.
Interfejs można pominąć całkowicie i osadzić hostowaną stronę weryfikacji w iframe, co jest najszybszą drogą do działającego rozwiązania. W obu przypadkach na produkcji należy preferować callback zamiast pętli odpytywania, a odpytywać tylko podczas rozwoju lub gdy użytkownik wyraźnie wraca na stronę.
Bezpieczeństwo i prywatność
Sesje są krótkotrwałe, a każdy token jest powiązany z dokładnie jedną z nich, więc odtworzona wiadomość nie pasuje do niczego. Otrzymany numer pochodzi z infrastruktury WhatsAppa, a nie z danych wpisanych przez użytkownika, co zamyka lukę, w której użytkownik mógłby po prostu wpisać cudzy numer i czekać na przechwycony kod.
Pod względem prywatności przepływ przenosi mniej danych osobowych niż ten, który zastępuje: żaden kod nie przechodzi przez sieć telekomunikacyjną w drodze do użytkownika, a przechowywany jest zweryfikowany numer, a nie ślad prób dostarczenia.
Cennik
Weryfikacje są rozliczane jako kredyty przedpłacone. Nie ma subskrypcji, a kredyty nie wygasają, więc sezonowy szczyt rejestracji kosztuje tyle, ile kosztuje, a spokojny miesiąc nic. Nowe konta zaczynają z darmowymi kredytami, co wystarcza, aby przejść cały przepływ w środowisku testowym przed podjęciem jakiejkolwiek decyzji.
Najczęstsze pytania
- Czym jest API weryfikacji telefonu?
- API weryfikacji telefonu to interfejs HTTP, który dowodzi, że użytkownik kontroluje numer telefonu. Wywołuje się je, aby otworzyć sesję weryfikacyjną, pokazuje się użytkownikowi to, co zwraca, a po jego działaniu odczytuje zweryfikowany numer.
- Czy weryfikacja telefonu działa bez WhatsAppa?
- Tak. Ta sama sesja przyjmuje token weryfikacyjny przez SMS, więc użytkownicy bez WhatsAppa wysyłają token jako zwykłą wiadomość tekstową. Integracja odczytuje wynik z tego samego endpointu w obu przypadkach.
- Jak długo trwa weryfikacja?
- Samo wywołanie API jest natychmiastowe, a resztę stanowi zeskanowanie kodu przez użytkownika i naciśnięcie wyślij. W praktyce większość sesji kończy się w kilka sekund, a nie minut, ponieważ nie ma etapu dostarczania przez operatora, na który trzeba czekać.
- Co zwraca API po zweryfikowaniu numeru?
- Status sesji zmienia się na verified, a odpowiedź zawiera zweryfikowany numer telefonu wraz ze znacznikami czasu każdego etapu, przez który sesja przeszła. Wcześniej pole numeru ma wartość null.
- Czy weryfikacja telefonu to to samo co uwierzytelnianie dwuskładnikowe?
- Nie. Weryfikacja telefonu dowodzi, że numer należy do użytkownika, zwykle jednorazowo, przy rejestracji. Uwierzytelnianie dwuskładnikowe ponownie sprawdza ten dowód przy logowaniu lub przed wrażliwym działaniem. To samo API obsługuje oba przypadki, ale odpowiadają one na różne pytania.
Related
Typowe scenariusze
Weryfikacja kontaktu
Potwierdź, że użytkownicy podają prawdziwe, osiągalne numery telefonów.
Wdrażanie klientów
Buduj zaufanie dzięki zweryfikowanym danym kontaktowym od pierwszego dnia.
Walidacja numerów
Odrzucaj nieprawidłowe, jednorazowe lub nieosiągalne numery.
Potwierdzenie tożsamości użytkownika
Powiąż numer telefonu z profilem użytkownika, aby bezpiecznie potwierdzić tożsamość.
Build your weryfikacja telefonu flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.