Flujo de trabajo de Verify

Un flujo de trabajo define la secuencia de acciones que Vonage utiliza para llegar al usuario final que deseas verificar con un código PIN. Puedes personalizar tu propio flujo de trabajo especificando qué canales usar y en qué orden, lo que permite enviar mensajes de verificación a múltiples números de teléfono, direcciones de email y más.

El flujo de trabajo se configura mediante una matriz incluida en tu solicitud de verificación:

• El primer canal de la lista es el que se utiliza en primer lugar;
• Si el mensaje no se convierte con éxito, se utilizará el siguiente canal de la lista.

En el ejemplo siguiente, el sistema intentará primero la entrega por SMS. Si no se consigue la conversión, se intentará por RCS y, si fallan los dos intentos anteriores, por voz.

curl -X POST "https://api.nexmo.com/v2/verify" \
    -H "Authorization: Bearer $JWT" \
    -H 'Content-Type: application/json' \
    -d $'{
        "brand": "TestVerify",
        "locale": "es-es",
        "code_length": 4,
        "channel_timeout": 300,
        "workflow": [
        {
            "channel": "sms",
            "to": "'$PHONE_NUMBER'"
        },
        {
            "channel": "rcs",
            "to": "'$PHONE_NUMBER'"
        },
        {
            "channel": "voice",
            "to": "'$PHONE_NUMBER'"
        }
    ]
}'

Compruebe el Especificación API para obtener una lista completa de los parámetros disponibles y descripciones detalladas.

Canales compatibles

Verify admite varios canales para enviar contraseñas de un solo uso (OTP) en función de las preferencias del usuario y la conectividad regional. A continuación se ofrece una descripción general de cada uno de los canales compatibles:

Autenticación silenciosa

Autenticación silenciosa te permite verificar a los usuarios finales sin que tengan que introducir manualmente una contraseña de un solo uso (OTP). Funciona aprovechando la verificación de la red móvil basada en la dirección IP en segundo plano, lo que ofrece una mejor experiencia de usuario. Es ideal para reducir el abandono durante los procesos de registro o inicio de sesión.

Autenticación silenciosa avanzada [Alfa]

Autenticación silenciosa avanzada permite verificar a los usuarios sin necesidad de que introduzcan manualmente una OTP. Utiliza la verificación criptográfica basada en SIM a través del protocolo GSMA TS.43, realizando comprobaciones directamente entre la tarjeta SIM y el núcleo de red del operador. Este método criptográfico garantiza que la tarjeta SIM permanezca conectada al número de teléfono, independientemente de si el usuario utiliza datos móviles, Wi-Fi o una VPN.

RCS

Como mejora del canal SMS, el RCS permite enviar mensajes a través de Wi-Fi o datos móviles a las aplicaciones de mensajería predeterminadas de Android y iPhone.

RCS destaca como alternativa superior a los SMS por su compatibilidad con la validación de marcas y su baja latencia de entrega. Para utilizar el canal RCS, un Agente RCS o Identificador del remitente es obligatorio.

Actualmente, RCS está disponible en un un número limitado de países y en dispositivos compatibles, con planes de expansión futura.

SMS

Los SMS son el canal más popular y más utilizado para la autenticación de dos factores (2FA).

Ofrece un amplio alcance, ya que casi todo el mundo puede recibir mensajes de texto, y la incorporación es muy sencilla. De hecho, Google descubrió que la autenticación de dos factores por SMS ayudó a bloquear:

• 100% de bots automatizados
• El 96 % de los ataques de phishing masivos
• El 76 % de los ataques dirigidos

Debido a su fiabilidad y a su amplia difusión, el SMS suele ser el primer canal que se prueba en un flujo de trabajo de Verify.

WhatsApp

WhatsApp es un gran canal para la autenticación de dos factores gracias a su popularidad mundial y a la posibilidad de enviar mensajes a través de WiFi, lo que lo hace especialmente valioso en zonas con cobertura móvil limitada.

Incorporar WhatsApp como canal secundario puede mejorar considerablemente tus tasas generales de conversión en el proceso de verificación.

Para utilizar Verify API con WhatsApp debe tener su propia WhatsApp Business Account (WABA). Para crear una WABA, vaya a la sección Redes sociales del panel de control para desarrolladores y siga las instrucciones que aparecen en WhatsApp.

Si un usuario no tiene WhatsApp instalado, Verify puede detectarlo automáticamente y recurrir a otro canal.

Modos de verificación de WhatsApp

Verify v2 admite dos experiencias de verificación de WhatsApp:

• OTP (por defecto): envía un código de un solo uso a WhatsApp para que el usuario lo introduzca.
• Zero-tap (Android): una experiencia de verificación más fluida para las aplicaciones de Android. Para activarla, configura mode a zero_tap al utilizar channel = whatsapp.

El mode es opcional. Si no se especifica, el valor por defecto es otp_code.

Voz

La verificación por voz es un poderoso apoyo a los SMS, especialmente en regiones donde:

• El envío de SMS no es fiable.
• Las normativas locales imponen restricciones o exigen un registro previo para el tráfico de SMS.

Con las llamadas de voz, la OTP se entrega a través de una llamada telefónica automatizada, lo que garantiza que los usuarios de regiones menos accesibles puedan completar su proceso de verificación de forma fiable.

Correo electrónico

El correo electrónico también puede utilizarse para enviar OTP, lo que lo convierte en una buena alternativa a los canales móviles.

Es especialmente útil:

• Durante los periodos de congestión de la red.
• Para usuarios que prefieren recibir las verificaciones a través de su cuenta de correo electrónico.