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, а не циклу опроса, а опрос используйте только при разработке или когда пользователь явно возвращается на вашу страницу.

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

Сессии недолговечны, и каждый токен привязан ровно к одной из них, поэтому повторно отправленное сообщение ни с чем не совпадёт. Полученный вами номер приходит из инфраструктуры самого 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.