Verify Guía de migración

La siguiente guía le ayudará a migrar del obsoleto Verify Legacy a Verify. Para ello, debes actualizar las URL de tus puntos finales para que apunten a la nueva versión y modificar la configuración de tu aplicación; no es necesario que rellenes ningún formulario de prerregistro para empezar a utilizar Verify.

Resumen

La API Verify de Vonage es un servicio que permite a los desarrolladores implementar la autenticación de dos factores (2FA) para protegerse contra el fraude y garantizar la autenticidad del usuario. Vonage ofrece dos versiones de esta API: Legacy y la actual Verify. Si bien ambas versiones cumplen la misma función principal, existen diferencias significativas en sus características, funcionalidades y uso.

Principales diferencias

• Flexibilidad y personalización: Verify ofrece ahora una creación de flujos de trabajo más flexible y opciones de personalización mejoradas, como un sistema de gestión de plantillas personalizadas con más funciones en comparación con Legacy.
• Asistencia técnica por canal: Verify ahora incluye soporte adicional para la verificación a través de varios canales nuevos como Silent Auth, RCS, WhatsApp y Email, mientras que Legacy se limita a SMS y voz.
• Características de seguridad: Verify incluye ahora funciones de seguridad mejoradas y el cumplimiento de las normas más recientes.
• Protección contra el fraude: Los clientes que migren de Verify Legacy a la nueva API de Verify contarán con protección y acceso a Vonage Fraud Defender avanzado sin coste adicional.
• Gestión de errores: Verify proporciona ahora mensajes de error más detallados y una gestión mejorada, así como mecanismos más avanzados de limitación de velocidad y reintento automático.
• Diseño e integración de API: Verify admite tanto patrones de integración síncronos como asíncronos.

Comparación de funciones

Llamadas a la API

Se ha introducido el modo asíncrono en Verify, lo que permite recibir mensajes y estados de llamada mediante webhook, recibiendo tanto eventos (en el caso de whatsapp_interactive) y devoluciones de llamada de resumen. También se puede utilizar de forma sincrónica con redirect_url y check_url.

Debe configurar sus webhooks para las retrollamadas Verify en la sección Application del módulo Panel de control del cliente:

Puedes encontrar más documentación sobre los webhooks en aquí.

Criterios de valoración

Todas las llamadas a la API de Verify deben actualizarse para utilizar el nuevo punto final:

Flujos de trabajo

Verify le ofrece la flexibilidad de definir su propio flujo de trabajo, a diferencia de los flujos de trabajo fijos de Legacy. Puede especificar cualquier combinación de canales de soporte de su elección en el flujo de trabajo, hasta un máximo de tres canales.

Encontrará más documentación sobre los flujos de trabajo aquí.

Canales

Ya hay nuevos canales disponibles en Verify:

• SMS
• Voz (antes TTS en Legacy)
• WhatsApp
• Correo electrónico
• Autenticación silenciosa
• RCS

Para obtener información más detallada sobre estos canales, consulta el Especificación API.

Encontrará documentación específica sobre la autenticación silenciosa aquí.

Devoluciones de llamada resumidas

Las respuestas se envían a tu webhook con el estado del evento, correspondiente request_id y canal. Los siguientes diagramas de secuencia muestran cómo funciona esto cuando se utiliza un solo canal, o el uso de múltiples canales en su flujo de trabajo.

Un solo canal

Varios canales

Códigos de respuesta

Además de cambiar sus puntos finales, también es necesario actualizar sus aplicaciones para que comprendan los códigos de respuesta recibidos al utilizar Verify:

Solicitud de anulación

Plantillas

Cumplimiento de la PSD2

Solicitud de verificación de búsqueda

Gestión del fraude

Verify Diagramas de secuencia

Verify Flow

Verify la solicitud con devoluciones de llamada de resumen

Diagrama de secuencia de autenticación silenciosa

Verify el análisis de los parámetros de la carga útil entre la versión 1 y la versión 2

Enviar solicitud de verificación

Solicitud de verificación de cheques

Solicitud de verificación de búsqueda

Cancelar solicitud de verificación

Activar el siguiente proceso de verificación

Plantillas personalizadas

Cumplimiento de la PSD2

Correspondencia entre los flujos de trabajo de Verify V1 y Verify V2

Flujo de trabajo 1 (predeterminado)

Patrón: SMS → TTS → TTS

Verify V1

{
  "api_key": "your_key",
  "api_secret": "your_secret",
  "number": "15555551234",
  "brand": "YourBrand",
  "workflow_id": 1
}

Verify V2

{
  "brand": "YourBrand",
  "workflow": [
    {"channel": "sms", "to": "15555551234"},
    {"channel": "voice", "to": "15555551234"},
    {"channel": "voice", "to": "15555551234"}
  ]
}

Flujo de trabajo 2

Patrón: SMS → SMS → TTS

Verify V1

{
  "api_key": "your_key",
  "api_secret": "your_secret",
  "number": "15555551234",
  "brand": "YourBrand",
  "workflow_id": 2
}

Verify V2

{
  "brand": "YourBrand",
  "workflow": [
    {"channel": "sms", "to": "15555551234"},
    {"channel": "sms", "to": "15555551234"},
    {"channel": "voice", "to": "15555551234"}
  ]
}

Flujo de trabajo 3

Patrón: TTS → TTS

Verify V1

{
  "api_key": "your_key",
  "api_secret": "your_secret",
  "number": "15555551234",
  "brand": "YourBrand",
  "workflow_id": 3
}

Verify V2

{
  "brand": "YourBrand",
  "workflow": [
    {"channel": "voice", "to": "15555551234"},
    {"channel": "voice", "to": "15555551234"}
  ]
}

Flujo de trabajo 4

Patrón: SMS → SMS

Verify V1

{
  "api_key": "your_key",
  "api_secret": "your_secret",
  "number": "15555551234",
  "brand": "YourBrand",
  "workflow_id": 4
}

Verify V2

{
  "brand": "YourBrand",
  "workflow": [
    {"channel": "sms", "to": "15555551234"},
    {"channel": "sms", "to": "15555551234"}
  ]
}

Flujo de trabajo 5

Patrón: SMS → TTS

Verify V1

{
  "api_key": "your_key",
  "api_secret": "your_secret",
  "number": "15555551234",
  "brand": "YourBrand",
  "workflow_id": 5
}

Verify V2

{
  "brand": "YourBrand",
  "workflow": [
    {"channel": "sms", "to": "15555551234"},
    {"channel": "voice", "to": "15555551234"}
  ]
}

Flujo de trabajo 6

Patrón: SMS

Verify V1

{
  "api_key": "your_key",
  "api_secret": "your_secret",
  "number": "15555551234",
  "brand": "YourBrand",
  "workflow_id": 6
}

Verify V2

{
  "brand": "YourBrand",
  "workflow": [
    {"channel": "sms", "to": "15555551234"}
  ]
}

Flujo de trabajo 7

Patrón: TTS

Verify V1

{
  "api_key": "your_key",
  "api_secret": "your_secret",
  "number": "15555551234",
  "brand": "YourBrand",
  "workflow_id": 7
}

Verify V2

{
  "brand": "YourBrand",
  "workflow": [
    {"channel": "voice", "to": "15555551234"}
  ]
}