Saltar al contenido principal
El API Verify de OneSignal te permite enviar códigos de verificación a usuarios vía SMS, haciéndolo ideal para autenticación de dos factores, registro de cuentas y restablecimientos de contraseña.

​
Para configurar verify:

  1. Crear un servicio de verificación Haz una solicitud al endpoint create verification service y proporciona un FriendlyName. El friendly name debe ser una cadena descriptiva que creas para describir el servicio de verificación. Este es el nombre usado en el SMS enviado al usuario final. (por ejemplo, Tu código de verificación de [FriendlyName] es: XXXXXX) Puede tener hasta 32 caracteres de longitud. Este valor no debe contener PII. Opcionalmente, también puedes proporcionar estos parámetros adicionales:
    1. CodeLength La longitud del código de verificación a generar. Debe ser un valor entero entre 4 y 10, inclusive.
    2. LookupEnabled: Si realizar una búsqueda con cada verificación iniciada y devolver información sobre el número de teléfono
    3. SkipSMSToLandlines: Si omitir el envío de verificaciones SMS a líneas fijas. Requiere lookup_enabled.
    4. Psd2Enabled: Si pasar parámetros de transacción PSD2 al iniciar una verificación.
    5. DoNotShareWarningEnabled: Si agregar una advertencia de seguridad al final del cuerpo de una verificación SMS. Deshabilitado por defecto y se aplica solo a SMS. Ejemplo de cuerpo SMS: Tu código de verificación de AppName es: 1234. No compartas este código con nadie; nuestros empleados nunca pedirán el código
    6. CustomCodeEnabled: Si permitir el envío de verificaciones con un código personalizado en lugar de uno generado aleatoriamente.
    7. Totp.Issuer: Configuración opcional para factores TOTP. Establece el emisor TOTP para este servicio. Esto permitirá configurar el emisor del URI TOTP. Por defecto es el friendly name del servicio si no se proporciona.
    8. Totp.TimeStep: Configuración opcional para factores TOTP. Define con qué frecuencia, en segundos, se generan códigos TOTP. es decir, se genera un nuevo código TOTP cada time_step segundos. Debe estar entre 20 y 60 segundos, inclusive. Por defecto es 30 segundos
    9. Totp.CodeLength: Configuración opcional para factores TOTP. Número de dígitos para códigos TOTP generados. Debe estar entre 3 y 8, inclusive. Por defecto es 6
    10. Totp.Skew: Configuración opcional para factores TOTP. El número de pasos de tiempo, pasados y futuros, que son válidos para la validación de códigos TOTP. Debe estar entre 0 y 2, inclusive. Por defecto es 1 Nota: por defecto, el mensaje al usuario final dirá “Tu código de verificación de [friend name] es: XXXXXX”. Para personalizar este lenguaje, contacta a soporte.
  2. Enviar un código de verificación Haz una solicitud al endpoint create verification. Proporciona el número de teléfono del usuario y el canal (SMS) que quieres usar. Esto enviará el código de verificación al usuario.
  3. Verificar el código de verificación Haz una solicitud al endpoint verification check. Proporciona el número de teléfono del usuario y el código de verificación enviado por el usuario que quieres verificar.
Consideraciones adicionales
  • Tiempo de expiración: por defecto es 10 mins (contacta a soporte para personalizar la expiración)
  • Reintentos: Asegúrate de considerar la experiencia de tu usuario para intentos de verificación fallidos y reintentos.
  • Seguridad: Implementa mejores prácticas para manejar información sensible como números de teléfono y códigos de verificación.
Para información más detallada y ejemplos, consulta la documentación del API Twilio Verify: https://www.twilio.com/docs/verify