Skip to content
Guía de integración
12 min de lectura30 de agosto de 2025

Guía de integración de Reverse OTP para verificación telefónica

Una guía completa paso a paso para implementar la verificación Reverse OTP en su aplicación móvil, con integración de la API, detección de WhatsApp, manejo de casos límite y estrategias de respaldo para una autenticación de usuarios fluida.

Ilustración de la guía de integración de Reverse OTP que muestra el flujo de verificación telefónica

Dónde encaja esta página

Esta es la guía de implementación. Para saber qué es Reverse OTP y cómo encajan sus piezas, lea cómo funciona Reverse OTP; para los argumentos a favor de cambiar de canal, lea Reverse OTP vs SMS OTP. La referencia de endpoints está en la guía de integración de la API de verificación por WhatsApp.

Reverse OTP es un enfoque innovador de verificación de usuarios que aprovecha apps de mensajería como WhatsApp para agilizar el proceso. En lugar de enviar un SMS OTP al usuario, la propia app envía un mensaje prellenado y el servidor verifica al remitente. Esto reduce los riesgos de fraude, mejora la velocidad y puede disminuir los costos frente a los SMS OTP tradicionales.

En este artículo veremos cómo integrar Reverse OTP en su flujo de verificación telefónica actual, incluyendo la integración de la API, la detección de la app, el manejo de casos límite y qué hacer si WhatsApp no está disponible.

Diagrama del flujo de integración de Reverse OTP
1

Detecte WhatsApp en el dispositivo del usuario

Antes de iniciar la verificación, su app debe comprobar si WhatsApp está instalado mediante canOpenURL.

Implementación en iOS:

Primero registre whatsapp:// como esquema de consulta en el Info.plist de su app, dentro de LSApplicationQueriesSchemes.

Configuración de Info.plist

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>whatsapp</string>
</array>

Implementación en Android:

Use PackageManager para comprobar si el paquete de WhatsApp está presente.

Detección de WhatsApp en Android

try {
    PackageManager pm = getPackageManager();
    pm.getPackageInfo("com.whatsapp", PackageManager.GET_ACTIVITIES);
    // WhatsApp is installed
} catch (PackageManager.NameNotFoundException e) {
    // WhatsApp is not installed
}

Buena práctica: si WhatsApp está disponible, continúe con Reverse OTP. Si no, recurra a SMS de forma transparente.

2

Inicie Reverse OTP

Genere en su backend un código de sesión único y corto (puede ser un identificador existente, como el UUID del usuario). Llame con él a nuestra API start-verification-flow. Devolverá un token único que se usará para generar un deep link de WhatsApp con el mensaje prellenado.

Formato del deep link de WhatsApp

https://wa.me/PHONE_NUMBER?text=VERIFY-12345

El texto generado incluirá este token de verificación entre corchetes para que el backend lo detecte y lo vincule con la sesión original.

El usuario toca el enlace, se abre WhatsApp, pulsa enviar, y el backend extrae el número de teléfono del usuario a partir de los metadatos de WhatsApp.

El usuario recibe un mensaje de confirmación directamente en WhatsApp con una URL de callback para volver a su servicio.

Ejemplo de integración de la 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();
3

Consulte el resultado

Cuando el usuario vuelve al flujo, su backend consultará el estado de la sesión abierta previamente para obtener directamente el número de teléfono. Puede guardar ese número y marcar la verificación como exitosa.

Implementación de la consulta de estado

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;
};

Consejo profesional: implemente polling para consultar el estado de la verificación cada pocos segundos hasta que se complete o expire el tiempo de espera.

4

Maneje los casos límite

A veces los usuarios abren WhatsApp pero no completan el proceso:

  • Rechazan una ventana emergente de permisos de WhatsApp
  • La app fue descargada del dispositivo o eliminada
  • El mensaje se queda atascado en el envío por mala conectividad

Cómo manejarlo:

Tiempo de espera con elegancia:

Tras unos minutos sin recibir el mensaje, pregunte al usuario:

"Parece que su verificación no se completó. ¿Quiere intentarlo de nuevo o cambiar a SMS?"
Mecanismo de reintento:

Ofrezca un botón "Reenviar por WhatsApp" que regenere el enlace.

Opciones de respaldo:

Ofrezca siempre un canal de verificación alternativo para no bloquear el onboarding.

Persistencia del estado:

Si el usuario vuelve más tarde, mantenga su sesión activa y vuelve a ofrecerle las opciones de verificación sin obligarlo a reiniciar el onboarding.

Implementación del manejo de casos límite

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);
5

Respaldo para usuarios sin WhatsApp

Si canOpenURL (iOS) o PackageManager (Android) detecta que WhatsApp no está disponible, recurra automáticamente a SMS OTP o a OTP por correo electrónico.

Implementación del respaldo

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');
  }
};

Consejo de experiencia de usuario: haga que el respaldo sea transparente, sin pedir al usuario que elija. Use automáticamente el mejor método disponible para su dispositivo.

Conclusión

Reverse OTP hace la verificación más rápida, más segura y, a menudo, más barata que el SMS. Pero es fundamental diseñar pensando en las interrupciones del mundo real, desde los permisos de la app hasta los fallos de entrega de mensajes, para que los usuarios siempre tengan una vía fluida para continuar. Un flujo de respaldo bien pensado le permite maximizar tanto la seguridad como las tasas de conversión.