Skip to content

API верифікації телефону

Переконайтеся, що користувачі володіють номером телефону, який вони вказали.

Підтвердьте володіння номером за лічені секунди

Верифікація телефону — основа будь-якого довіреного користувацького досвіду. Надішліть одноразовий пароль (OTP) через SMS, WhatsApp або голосовий дзвінок і підтвердьте володіння номером за лічені секунди.

Що таке верифікація телефону?

Верифікація телефону — це доведення того, що людина перед вами справді контролює номер телефону, який вона ввела. Номер у формі — лише твердження; верифікація перетворює його на доказ. Без неї поле реєстрації приймає помилки друку, одноразові номери, чужі номери й усе, що вирішить вставити скрипт.

Цей доказ цінний із трьох окремих причин. Він дає вам робочий канал зв’язку, тож скидання паролів і сповіщення про доставку доходять до реального телефону. Він дає стабільний ідентифікатор акаунта, через що мультиакаунтинг і зловживання бонусами стають дорогими. І він дає другий фактор, до якого можна звернутися пізніше, не просячи користувача налаштовувати щось нове.

Як працює верифікація телефону

Кожен потік верифікації телефону спирається на одну ідею: на телефоні має статися те, що може спричинити лише його власник. Класичний варіант надсилає одноразовий код у SMS і просить користувача ввести його назад. Phone-Verif працює навпаки — користувач не отримує повідомлення, а надсилає його, — але схема та сама: створити сесію, показати завдання, дочекатися доказу, прочитати результат.

На практиці з вашого боку це три рухомі частини: виклик, що відкриває сесію верифікації й повертає те, що слід показати користувачеві; екран або віджет, де користувач виконує дію; і спосіб дізнатися результат — через callback або зчитуванням статусу сесії.

Верифікація через WhatsApp

WhatsApp тут — основний канал. API повертає deep link у WhatsApp із коротким токеном сесії; ви показуєте його як QR-код на десктопі або кнопку на мобільному. Користувач торкається його, WhatsApp відкривається з уже написаним повідомленням, і він його надсилає. WhatsApp повідомляє серверу номер відправника, а оскільки WhatsApp перевірив цей номер під час створення акаунта, ви успадковуєте доказ, який вам не довелося будувати самостійно.

Яку частку вашого трафіку це покриває, повністю залежить від ринку. Використання WhatsApp майже повсюдне в Бразилії, Індії та значній частині Європи й Африки та незначне в США, Японії та Південній Кореї. Перш ніж вирішувати, скільки резерву вам потрібно, варто перевірити, де насправді перебувають ваші користувачі.

SMS-верифікація та резервний канал

Для користувачів без WhatsApp та сама сесія приймає той самий токен через SMS: користувач надсилає токен звичайним текстовим повідомленням на номер верифікації. Сесія, токен і статус, який ви потім зчитуєте, ідентичні, тож ваша інтеграція не розгалужується — змінюється лише інструкція, яку бачить користувач.

Це важливіше, ніж здається. Потік лише через WhatsApp непомітно втрачає всіх на ринках із низьким поширенням; потік лише через SMS платить оператору за кожну спробу, зокрема й ті, що ініціюють боти. Якщо обидва канали працюють в одній сесії, ви можете використовувати за замовчуванням дешевий і безпечний канал і все одно охопити решту.

Reverse OTP: чому важливий напрямок

У звичайному потоці OTP сервер надсилає секрет і сподівається, що він потрапить на потрібний телефон і більше нікуди. Саме на цьому припущенні грають і атаки SIM-свопінгу, і фішинг OTP, і саме воно робить прибутковим штучно завищений трафік: кожна спроба коштує вам повідомлення незалежно від того, чи стоїть за нею реальний користувач.

Reverse OTP знімає це припущення. Користувачеві не надсилається нічого секретного, тож нема чого перехоплювати, нема чого виманювати фішингом і нема вихідного повідомлення, за яке шахрай міг би виставити вам рахунок. Доказом є власна дія користувача — надсилання.

Потік верифікації від початку до кінця

Сесія починається в стані pending. Далі вона переходить у whatsapp_previewed, коли користувач бачить попередньо заповнене повідомлення, у opened — коли відкриває посилання, і в verified — коли повідомлення надходить і зіставляється із сесією. Якщо ніхто не діє вчасно, вона завершується станом expired.

Лише стан verified містить номер телефону; до того поле має значення null. Сприймайте статус як сигнал, а номер як його корисне навантаження, і ніколи навпаки — це єдине правило усуває більшість станів гонитви, на які натрапляють під час першої інтеграції.

Інтеграція API

Інтеграція — це два REST-виклики. POST /start-verification відкриває сесію й повертає номер WhatsApp, deep link і хостинговий веб-URL, якщо ви волієте перенаправляти, а не будувати власний екран. GET /check-verification-status повертає стан сесії та, після верифікації, сам номер.

Інтерфейс можна взагалі пропустити й вбудувати хостингову сторінку верифікації в iframe — це найшвидший шлях до працюючого результату. У будь-якому разі на продакшні віддавайте перевагу callback, а не циклу опитування, і застосовуйте polling лише під час розробки або коли користувач сам повертається на вашу сторінку.

Безпека та приватність

Сесії короткоживучі, а кожен токен прив’язаний рівно до однієї з них, тож повторно надіслане повідомлення ні з чим не збігається. Номер, який ви отримуєте, надходить з інфраструктури самого WhatsApp, а не від користувача, що закриває прогалину, коли користувач може просто ввести чужий номер і чекати на код, який він перехопив.

Щодо приватності, цей потік передає менше персональних даних, ніж той, який він замінює: жоден код не проходить телекомунікаційною мережею дорогою до користувача, а ви зберігаєте верифікований номер, а не слід із спроб доставки.

Ціни

Верифікації оплачуються передоплаченими кредитами. Підписки немає, а кредити не згорають, тож сезонний сплеск реєстрацій коштує стільки, скільки коштує, а тихий місяць не коштує нічого. Нові акаунти починають із безкоштовними кредитами — цього достатньо, щоб прогнати потік від початку до кінця в тестовому середовищі, перш ніж до чогось зобов’язуватися.

Поширені запитання

Що таке API верифікації телефону?
API верифікації телефону — це HTTP-інтерфейс, який доводить, що користувач контролює номер телефону. Ви викликаєте його, щоб відкрити сесію верифікації, показуєте користувачеві те, що він повертає, і зчитуєте верифікований номер, щойно користувач виконає дію.
Чи працює верифікація телефону без WhatsApp?
Так. Та сама сесія приймає токен верифікації через SMS, тож користувачі без WhatsApp надсилають токен звичайним текстовим повідомленням. Ваша інтеграція в обох випадках зчитує результат із того самого ендпоінта.
Скільки триває верифікація?
Сам виклик API відбувається миттєво; решта — це сканування коду користувачем і натискання «Надіслати». На практиці більшість сесій завершуються за секунди, а не хвилини, бо немає етапу доставки через оператора, на який треба чекати.
Що повертає API після верифікації номера?
Статус сесії змінюється на verified, а відповідь містить валідований номер телефону та позначки часу кожного етапу, який було пройдено. До цього поле номера має значення null.
Чи верифікація телефону — це те саме, що двофакторна автентифікація?
Ні. Верифікація телефону доводить, що номер належить користувачеві, зазвичай один раз, під час реєстрації. Двофакторна автентифікація повторно перевіряє цей доказ під час входу або перед чутливою дією. Один і той самий API охоплює обидва випадки, але вони відповідають на різні запитання.

Related

Типові сценарії

Верифікація контактів

Переконайтеся, що користувачі вказують реальні, доступні номери телефонів.

Онбординг клієнтів

Будуйте довіру з верифікованими контактними даними з першого дня.

Валідація номерів

Відхиляйте недійсні, одноразові чи недоступні номери.

Підтвердження особи користувача

Прив’яжіть номер телефону до профілю користувача для надійного підтвердження особи.

Build your верифікація телефону flow today

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