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.