API de verificación mediante código OTP de WhatsApp para registros, inicios de sesión y pagos
Envía contraseñas de un solo uso a través de la API de verificación OTP de WhatsApp de Dexatel. Si WhatsApp no puede contactar con un cliente, se utiliza un canal alternativo, y solo pagas por los mensajes que llegan.
Por qué las empresas eligen Dexatel para la verificación mediante OTP en WhatsApp
Hay tres factores que determinan si el código OTP de WhatsApp funciona en entorno de producción: que el código llegue, que solo se pague por los que llegan y que Meta apruebe tu plantilla.
Lo que obtienes con el OTP de WhatsApp de Dexatel
Realiza un seguimiento para saber si un mensaje de verificación se ha enviado, se ha entregado o ha fallado. Si comparas esta información con tus propios resultados de validación, podrás distinguir entre un código que nunca llegó y uno que el cliente nunca introdujo. Cada envío de verificación comunica su resultado a un webhook firmado, o bien puedes consultar el estado a través de la API.
Deja que Dexatel genere el código de verificación o introduce el tuyo propio si ya generas códigos en otro sitio. Elige una longitud de entre cuatro y ocho dígitos y establece el tiempo de validez, desde 30 segundos hasta 15 minutos.
Los mensajes incluyen el nombre y el logotipo de tu empresa, y se envían desde tu propio remitente registrado en WhatsApp. Los clientes pueden abrir el perfil y ver qué empresa ha enviado el código antes de escribir nada.
Utiliza el método POST para enviar un código y el método GET para comprobar el que haya introducido el usuario. Autentícate con tu clave de API, gestiona el resultado en el proceso de registro o inicio de sesión que ya tengas y empieza por los ejemplos de nuestra guía de integración.
No hay entorno de pruebas. Envías códigos reales a números reales a través de los mismos puntos de conexión que utilizarás en producción, para que puedas comprobar la entrega y la validación antes del lanzamiento.
Configurar el código OTP de WhatsApp con Dexatel
Antes de empezar, ten a mano lo siguiente:
Cómo empezar
Cómo utilizan las empresas el código OTP de WhatsApp
Las cuatro son las mismas dos llamadas a la API. Lo que cambia es cuándo se ejecutan.
Verificar las cuentas nuevas y reducir el spam
Cuando un nuevo usuario se registra, necesitas asegurarte de que el número de teléfono es válido. Envía un código antes de que la cuenta se active y, de nuevo, antes de que pueda publicar contenido. Las plataformas de mercado, los anuncios clasificados, las aplicaciones de transporte compartido y de juegos de azar en línea lo utilizan durante el proceso de registro. El código confirma que el número es suyo, no su identidad.
Proteger los datos de inicio de sesión y la recuperación
Envía un código después de la contraseña al iniciar sesión, o al número registrado cuando alguien se queda sin acceso. Las aplicaciones fintech, los neobancos, las plataformas SaaS y los sitios web de viajes lo utilizan. La autenticación de dos factores añade un código a la contraseña, mientras que la autenticación sin contraseña la sustituye, por lo que conviene mantener ambas conceptos bien diferenciados.
Comprobar los ingresos y las retiradas
El dinero está a punto de salir de la cuenta, así que pide primero un código. Los operadores de iGaming lo utilizan en las retiradas de fondos, los servicios de pago y las transferencias, y los comercios al realizar el pago. El código confirma la identidad de la persona, no el importe, por lo que tus propios límites siguen siendo los que determinan el resto.
Verificar los cambios importantes en la cuenta
Alguien modifica una dirección de correo electrónico, un número de teléfono o los datos de pago. Envía un código al contacto que ya tienes registrado, antes de que se guarde el cambio. Los bancos, las empresas de telecomunicaciones y las plataformas de comercio electrónico lo utilizan. Los cambios en una tarjeta SIM requieren algo más que un código, ya que eso es precisamente lo que se pretende con el «SIM swap».
Código OTP de WhatsApp frente a código OTP por SMS
Ambas funcionan. Esto es lo que las diferencia.
| Característica | Código OTP de WhatsApp | Código OTP por SMS |
|---|---|---|
Comentarios sobre la entrega | Estado del envío, se consulta de vez en cuando | Solo recibo de entrega |
Formato del mensaje | Plantilla aprobada de tu perfil de empresa, con tu nombre y tu logotipo | Texto sin formato procedente de un identificador de remitente, un código corto o un número largo |
Se requiere una aplicación | Sí, hay una cuenta activa de WhatsApp con ese número. | No, funciona en la mayoría de los teléfonos. |
Conexión a Internet | Requiere conexión Wi-Fi o datos móviles | No se necesitan datos, pero es necesario disponer del servicio de SMS |
Fortaleza regional | Merece la pena probarlo en América Latina, la región de Oriente Medio y Norte de África (MENA), el sur de Asia y el sudeste asiático | Todos los países, todas las redes, incluidos los clientes que no tienen WhatsApp |
Introducción del código | Botón «Copiar código»: el único tipo de botón que admiten las plantillas de autenticación | Introducción manual o autocompletado de la contraseña de un solo uso (OTP) del dispositivo |
Configuración | Un remitente registrado y una plantilla de autenticación aprobada | Registro de remitentes y aprobación de plantillas en algunos mercados |
Solución alternativa | Recurre a SMS, Viber, Telegram o correo electrónico a través de la API de Verify | Puede situarse por detrás de WhatsApp o liderar con WhatsApp como respaldo |
¿Qué impide la entrega? | Sin Internet, sin cuenta de WhatsApp, un cliente que ha bloqueado a tu empresa | Cobertura, itinerancia, filtrado de operadores, enrutamiento |
Precios | Por mensaje entregado; varía según el destino | Por segmento de mensaje; varía según el destino |
Conecta la API de OTP de WhatsApp de Dexatel a tu aplicación
Crea tu integración de OTP en WhatsApp con dos llamadas REST, una opción alternativa configurada en la misma solicitud y webhooks firmados. Envía un código desde tu aplicación, valida el que haya introducido el usuario y comprueba qué ha ocurrido con ambos.
Una solicitud realizada con éxito devuelve un ID de mensaje. Esto confirma que se ha creado la solicitud, pero no que el mensaje haya llegado ni que el cliente lo haya verificado.
Los recibos
No te fíes solo de lo que decimos
Precios de OTP de WhatsApp
Se paga por los mensajes entregados. No se cobra nada por los mensajes que no se entregan, y un código entregado es facturable aunque el cliente nunca lo introduzca.
| Por qué pagas | Cómo se cobra |
|---|---|
Código OTP de WhatsApp | Por mensaje entregado |
Solución alternativa por SMS | A la tarifa de SMS, solo si se activa |
Cuota mensual del remitente | 28 dólares por cada remitente activo de WhatsApp |
Las tarifas varían en función del país de destino y de tu volumen mensual. La creación y el envío de plantillas son gratuitos.
Preguntas frecuentes
¿Mis usuarios tienen que tener instalado WhatsApp?
Sí. Un código OTP de WhatsApp solo llega a alguien que tenga una cuenta activa de WhatsApp en ese número. Para eso sirve el sistema de respaldo: se pueden utilizar SMS, Viber, Telegram o el correo electrónico como alternativa a WhatsApp y, de este modo, el resto de usuarios también podrán verificarse.
¿Qué ocurre si no se envía el código?
Dexatel pasa al siguiente canal según el orden que hayas establecido. No se te cobrará el mensaje de WhatsApp que haya fallado, y el mensaje de reserva se facturará según la tarifa de su propio canal. Cada intento es un mensaje independiente con su propio ID.
¿Cuánto tiempo es válido un código OTP de WhatsApp?
Elige tú mismo, entre 30 segundos y 15 minutos. Configúralo en tu plantilla de autenticación mediante otp_expiration_seconds. Si no lo configuras, los códigos tendrán una validez de 15 minutos.
¿Necesito tener mi propio remitente de WhatsApp?
Sí. Meta exige a las empresas que envíen los mensajes de autenticación desde su propia dirección de remitente registrada, en lugar de desde una compartida. El registro forma parte del proceso de configuración.
¿Cuál es el precio del OTP de WhatsApp?
Se paga por cada mensaje entregado, a una tarifa que depende del país de destino y de tu volumen mensual, más 28 dólares al mes por cada remitente activo de WhatsApp. Los mensajes no entregados no tienen ningún coste. Calcula tu coste
¿Puedo utilizar la aplicación WhatsApp Business y la API con el mismo número?
No. El número no se puede vincular a ninguna cuenta de WhatsApp, ni a una personal, ni a la aplicación WhatsApp Business, ni a la de otro proveedor. O bien lo desregistras primero o utilizas un número diferente, y el historial de chat no se transfiere. Si estás dudando entre las dos opciones, comprueba cómo la se comparan la aplicación WhatsApp Business y la API.
¿Se puede comprobar el mismo código más de una vez?
Sí. Al comprobar un código, este no se agota, y no hay ningún límite en cuanto al número de veces que se puede introducir un código incorrecto. Añade límites de intentos en tu propia aplicación si tu flujo lo requiere.
¿Cuáles son vuestros límites de tarifas?
20 solicitudes por segundo por cuenta, no por clave API. Si se supera ese límite, las solicitudes devuelven el código de error HTTP 429. No hay límite por número ni margen para picos de tráfico. A las cuentas más grandes se les puede aumentar el límite, así que consulta a tu gestor de cuentas.
¿Quién es responsable de los gastos derivados del fraude en los peajes?
Así es. No contamos con un programa de protección ni concedemos créditos tras un ataque. Lo que sí te ofrecemos es una lista negra por países que funciona en todos los canales, incluido el de reserva, y límites de SMS específicos para este servicio. Vale la pena configurar ambos antes de poner el servicio en marcha.
¿Dónde se almacenan y se tratan los datos de verificación?
En la UE, en AWS. Cumplimos con el RGPD y contamos con la certificación ISO/IEC 27001:2022; además, los datos de verificación se eliminan en un plazo de seis meses tras la finalización del servicio, de conformidad con el acuerdo de tratamiento de datos incluido en nuestras condiciones de servicio. Los clientes empresariales pueden consultar las opciones de alojamiento regional.
¿Pueden aparecer códigos de verificación en los registros de nuestro servidor?
Sí, siempre y cuando tus sistemas registren las URL completas de las solicitudes. La solicitud de comprobación incluye el código como parámetro de consulta, por lo que debes ocultar las cadenas de consulta en los registros de la aplicación, del proxy y de supervisión, y evitar por completo que aparezcan claves de API en ellos.
¿Cómo puedo conseguir una insignia de verificación en mi perfil de WhatsApp?
El hecho de registrar un remitente no garantiza que se te conceda. Meta decide los requisitos y la aprobación por separado, por lo que podemos ayudarte con el proceso, pero no podemos garantizar el resultado.
¿Debería utilizar el mismo remitente de WhatsApp tanto para los códigos OTP como para el marketing?
Un remitente con autenticación independiente mantiene separados los mensajes de acceso a la cuenta de los promocionales. Gestiona tus campañas y chats de atención al cliente desde otro remitente a través de la API de WhatsApp Business. Esto es importante porque un cliente que bloquee tu remitente tras recibir demasiadas promociones dejará también de recibir tus códigos.
¿Qué indicadores debería seguir?
Analiza primero las verificaciones completadas, no las pendientes. A continuación, el tiempo de entrega, la tasa de reenvío, la frecuencia con la que se activa el plan de contingencia y cuánto te cuesta cada verificación completada. Compara los datos por país y por canal, ya que la respuesta varía de un mercado a otro.
¿Cómo puedo pasar de la contraseña de un solo uso (OTP) por SMS a WhatsApp?
Cambia el orden en lugar de cambiar de canal. Pon WhatsApp en primer lugar en tu cadena de canales alternativos y deja los SMS en segundo lugar, de modo que los clientes que tengan WhatsApp reciban el mensaje por ahí y el resto reciba exactamente lo mismo que antes.