API de verificación de teléfono: OTP, SMS y WhatsApp

La verificación de teléfono de Didit ofrece un método fiable para verificar los números de teléfono de los usuarios mediante códigos de un solo uso (OTP). Esta función añade una capa de seguridad esencial a tu proceso de verificación de identidad y garantiza que los datos de contacto del usuario sean legítimos. En la lección de la Academy sobre cómo leer un resultado de verificación, el capítulo del minuto 8:08 trata la verificación de teléfono y la detección de duplicados.

​

Cómo funciona

Nuestra solución de verificación de teléfono ofrece una validación completa del número mediante un proceso sencillo y cómodo para el usuario. El sistema combina la verificación por OTP con una evaluación avanzada de riesgos para ofrecer una verificación de teléfono fiable a gran escala.

​

Funciones de verificación

Nuestro servicio de verificación de teléfono ofrece varias funciones clave para mejorar tu proceso de verificación:

​

Verificación por OTP

• Generación segura de códigos: códigos de un solo uso generados de forma aleatoria
• Entrega por SMS: entrega rápida y fiable a dispositivos móviles
• Tiempos de espera configurables: define los tiempos de caducidad según tus requisitos de seguridad
• Opciones de reintento: permite a los usuarios solicitar códigos nuevos con la limitación de frecuencia adecuada
• Códigos con tu marca: los códigos por SMS nombran tu marca en lugar de enviar un mensaje genérico, sin coste adicional. Consulta Mensajes de verificación con tu marca.
• Tu propio número de WhatsApp: los códigos de WhatsApp pueden enviarse desde tu propio número de WhatsApp Business. Consulta Envía los códigos de WhatsApp desde tu propio número.

​

Mensajes de verificación con tu marca

Los códigos de verificación por SMS pueden nombrar tu marca, para que tus usuarios reconozcan el mensaje como tuyo:

123456 is your verification code for Acme Bank

Solo se puede personalizar el nombre. El resto del texto es un texto estándar registrado ante los operadores móviles de cada país, lo que evita que los códigos se filtren como spam, y se traduce al idioma del destinatario. Poner tu marca es gratis: un código con marca cuesta lo mismo que uno sin ella. Define el nombre del remitente de tus SMS en la Business Console, en Verificación telefónica → Configuración de un flujo o en Marca blanca → SMS. Pertenece a tu aplicación, no a un flujo concreto: firma todos los códigos SMS que envía la aplicación, en cualquier flujo y a través de la API independiente, con o sin personalización de marca blanca. Qué nombre lleva un código, gana la primera coincidencia:

1. options.sms_sender_name en POST /v3/phone/send/, para ese único código.
2. El nombre de remitente de SMS de tu aplicación.
3. Solo en los envíos de marca blanca (un flujo con personalización de marca blanca, o options.use_white_label_customization: true en la API), el nombre público de tu marca blanca.
4. Si no, el código se envía sin nombre.

Un nombre de remitente usa de 1 a 30 caracteres: solo letras, dígitos, espacios y ’ & - !, no solo dígitos, con espacios simples entre palabras. La API rechaza con 400 un nombre que incumpla estas reglas antes de enviar ningún código.

• Canales: el nombre se añade a los mensajes SMS, incluido un SMS enviado como alternativa desde otro canal. Los códigos de WhatsApp se envían con un mensaje fijo y no lo llevan; para que aparezca el nombre de tu empresa, envíalos desde tu propio número.
• Cambios por día: cada aplicación puede empezar a usar hasta dos nombres nuevos por día (UTC), contando tanto los nuevos nombres de remitente como los nuevos valores de sms_sender_name. Después, los códigos mantienen el nombre actual de la aplicación hasta el día siguiente, y un nuevo nombre por solicitud se envía con el nombre de la aplicación. Un nombre que ya usaste antes no cuenta de nuevo.
• La entrega es lo primero: un problema con la marca nunca detiene un código. Si no se puede aplicar un nombre, el código se envía con el nombre de la aplicación o sin ninguno.

​

Envía los códigos de WhatsApp desde tu propio número

Por defecto, los códigos de WhatsApp proceden del número de WhatsApp Business de Didit. Puedes conectar tu propio número de WhatsApp Business, para que tus usuarios reciban los códigos con el nombre y el número de tu empresa. Conecta un número en la Business Console, en Verificación telefónica → Configuración → Número de WhatsApp de un flujo, y selecciona Conectar número de WhatsApp. Se abre una ventana de inicio de sesión: inicia sesión en la cuenta de empresa que gestiona tu número de WhatsApp Business y elige la cuenta de WhatsApp Business y el número desde el que enviar. Didit registra entonces el número para el envío y crea su mensaje de verificación. Editarlo requiere permiso para editar la personalización, igual que el nombre del remitente de SMS. El número pertenece a tu aplicación, no a un flujo concreto: una vez conectado, envía todos los códigos de WhatsApp que envía la aplicación, en cualquier flujo y a través de la API independiente.

• Aprobación: el nuevo mensaje de verificación necesita aprobación antes de que el número pueda enviar códigos, normalmente en pocos minutos. Hasta entonces, la tarjeta muestra el número como pendiente de aprobación y los códigos siguen saliendo desde el número de Didit.
• Texto del mensaje: los mensajes de verificación en WhatsApp usan un texto estándar en el idioma de tu usuario: el código, una nota de seguridad y un botón de copiar. El texto no se puede editar, pero el remitente es tu empresa.
• Entrega: si un código no se puede entregar por WhatsApp, se envía por SMS, firmado con el nombre de remitente de SMS que hayas definido.
• Facturación: los mensajes que envía tu número se facturan a tu cuenta de WhatsApp Business, así que Didit cobra solo su tarifa de verificación ($0.02) por esos códigos. Los códigos enviados por SMS se facturan como de costumbre.
• Requiere atención: si el número ya no puede enviar (por ejemplo, porque se le retiró el acceso a tu cuenta de empresa), los códigos vuelven a salir desde el número de Didit y la tarjeta te pide que vuelvas a conectar el número.
• Desconéctalo en cualquier momento desde la misma tarjeta. Los códigos vuelven a salir desde el número de Didit; el número y su mensaje de verificación permanecen en tu cuenta de WhatsApp Business.

​

Análisis del número de teléfono

• Validación del formato: comprueba que el número de teléfono sigue el formato internacional correcto
• Detección del operador: identifica el proveedor de telecomunicaciones asociado al número
• Tipo de número: distingue entre números móviles, fijos y VoIP
• Validación del país: verifica que el número de teléfono coincide con el formato esperado del país

​

Evaluación de riesgos

• Detección de números desechables: identifica números temporales usados para evitar la trazabilidad
• Identificación de números virtuales: marca los números que pueden ser virtuales o basados en VoIP
• Monitorización de la actividad: rastrea patrones sospechosos entre los intentos de verificación
• Comprobación de listas de bloqueo: contrasta con listas internas de números usados indebidamente con anterioridad

​

Precios

La verificación de teléfono se cobra por mensaje enviado, con precios transparentes de pago por uso: El descuento de tu plan se aplica solo a la tarifa de Didit de $0.02; la tarifa del operador se repercute al coste y nunca se descuenta. Consulta Descuentos. Admitimos varios canales de entrega con precios distintos (la disponibilidad varía según el país): → Precios de la verificación de teléfono