Руководство по интеграции Reverse OTP для верификации телефона
Подробное пошаговое руководство по внедрению верификации Reverse OTP в ваше мобильное приложение: интеграция с API, определение WhatsApp, обработка пограничных случаев и запасные сценарии для бесперебойной аутентификации пользователей.

Место этой страницы
Это практическое руководство по внедрению. О том, что такое Reverse OTP и как связаны его компоненты, читайте в материале как работает Reverse OTP, а об аргументах в пользу смены канала — в статье Reverse OTP и SMS OTP. Справочник по эндпоинтам находится в руководстве по интеграции API верификации через WhatsApp.
Reverse OTP — это новый подход к верификации пользователей, который использует мессенджеры вроде WhatsApp, чтобы упростить процесс. Вместо отправки пользователю SMS с одноразовым паролем (OTP) приложение само отправляет сообщение с заполненным текстом, а сервер проверяет отправителя. Это снижает риск мошенничества, ускоряет процесс и может сократить расходы по сравнению с традиционными SMS OTP.
В этой статье мы расскажем, как интегрировать Reverse OTP в ваш текущий процесс верификации телефона: интеграция с API, определение приложения, обработка пограничных случаев и действия на случай, если WhatsApp недоступен.

Определите WhatsApp на устройстве пользователя
Перед запуском верификации ваше приложение должно проверить, установлен ли WhatsApp, с помощью canOpenURL.
Реализация для iOS:
Сначала зарегистрируйте whatsapp:// как схему запросов в Info.plist вашего приложения в разделе LSApplicationQueriesSchemes.
Конфигурация Info.plist
<key>LSApplicationQueriesSchemes</key>
<array>
<string>whatsapp</string>
</array>Реализация для Android:
Используйте PackageManager, чтобы проверить наличие пакета WhatsApp.
Определение WhatsApp на Android
try {
PackageManager pm = getPackageManager();
pm.getPackageInfo("com.whatsapp", PackageManager.GET_ACTIVITIES);
// WhatsApp is installed
} catch (PackageManager.NameNotFoundException e) {
// WhatsApp is not installed
}Лучшая практика: если WhatsApp доступен, переходите к Reverse OTP. Если нет, плавно переключитесь на SMS.
Запустите Reverse OTP
Сгенерируйте на бэкенде короткий уникальный код сессии (можно использовать уже существующий идентификатор, например UUID пользователя). Вызовите с ним наш API start-verification-flow. Он вернёт уникальный токен, который используется для создания ссылки WhatsApp с заполненным сообщением.
Формат deep link для WhatsApp
https:/PHONE_NUMBER?text=VERIFY-12345Сгенерированный текст будет содержать этот токен верификации в скобках, чтобы бэкенд мог его распознать и связать с исходной сессией.
Пользователь нажимает на ссылку, открывается WhatsApp, он нажимает «Отправить», а бэкенд извлекает номер телефона пользователя из метаданных WhatsApp.
Пользователь получает подтверждающее сообщение прямо в WhatsApp со ссылкой callback, по которой он возвращается в ваш сервис.
Пример интеграции с API
const response = await fetch('/api/start-verification', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
session_id: userSessionId,
phone_number: userPhoneNumber
})
});
const { validation_token, whatsapp_url } = await response.json();Запросите результат
Когда пользователь возвращается в процесс, ваш бэкенд запрашивает статус ранее открытой сессии и напрямую получает номер телефона. Вы можете сохранить этот номер и отметить верификацию как успешную.
Реализация проверки статуса
const checkStatus = async (sessionId) => {
const response = await fetch('/api/check-verification-status', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ session_id: sessionId })
});
const result = await response.json();
if (result.status === 'verified') {
// Save the verified phone number
saveVerifiedPhoneNumber(result.phone_number);
markVerificationComplete();
}
return result;
};Совет профессионала: реализуйте опрос (polling) и проверяйте статус верификации каждые несколько секунд до завершения или истечения тайм-аута.
Обработайте пограничные случаи
Иногда пользователи открывают WhatsApp, но не завершают процесс:
- Они отклоняют всплывающее окно с разрешениями WhatsApp
- Приложение выгружено или удалено
- Сообщение зависло при отправке из-за плохого соединения
Как это обработать:
Плавный тайм-аут:
Если сообщение не пришло в течение нескольких минут, предложите пользователю:
Механизм повторной попытки:
Добавьте кнопку «Отправить повторно через WhatsApp», которая заново создаёт ссылку.
Запасные варианты:
Всегда предлагайте альтернативный канал верификации, чтобы не блокировать онбординг.
Сохранение состояния:
Если пользователь вернётся позже, сохраните его сессию и снова предложите варианты верификации, не заставляя начинать онбординг заново.
Реализация обработки пограничных случаев
const handleVerificationTimeout = () => {
showDialog({
title: "Verification Incomplete",
message: "It looks like your verification didn't complete. Would you like to try again or switch to SMS?",
buttons: [
{ label: "Try WhatsApp Again", action: retryWhatsAppVerification },
{ label: "Use SMS Instead", action: fallbackToSMS },
{ label: "Cancel", action: closeDialog }
]
});
};
// Set timeout for 3 minutes
setTimeout(handleVerificationTimeout, 180000);Запасной сценарий для пользователей без WhatsApp
Если canOpenURL (iOS) или PackageManager (Android) определяет, что WhatsApp недоступен, автоматически переключитесь на SMS OTP или OTP по электронной почте.
Реализация запасного сценария
const initiateVerification = async () => {
const hasWhatsApp = await checkWhatsAppAvailability();
if (hasWhatsApp) {
// Use Reverse-OTP via WhatsApp
return initiateReverseOTP();
} else {
// Fall back to SMS OTP
return initiateSMSOTP();
}
};
const checkWhatsAppAvailability = async () => {
if (Platform.OS === 'ios') {
return await Linking.canOpenURL('whatsapp://');
} else {
// Android package check
return await isAppInstalled('com.whatsapp');
}
};Совет по пользовательскому опыту: сделайте переключение незаметным: не заставляйте пользователей выбирать самим. Автоматически используйте лучший доступный для их устройства способ.
Вывод
Reverse OTP делает верификацию быстрее, безопаснее и зачастую дешевле SMS. Но важно учитывать реальные сбои, от разрешений приложения до проблем с доставкой сообщений, чтобы у пользователей всегда был удобный путь вперёд. Продуманный запасной сценарий позволяет максимально повысить и безопасность, и конверсию.
