Skip to content

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.