Un código para iniciar sesión parece algo pequeño. Hasta que lo construyes: generar un número seguro, guardarlo sin dejarlo a la vista, enviarlo, reenviarlo cuando el cliente no lo ve, expirarlo, limitar los intentos equivocados y evitar que alguien lo use para llenar de mensajes el teléfono de otra persona.
Ahora Boom se encarga de todo eso. Tú haces dos llamadas a la API: una para pedir el código y otra para validar lo que escribió tu cliente.
Cómo funciona
- Pide el código. Tu backend llama a
POST /api/v1/otp/sendcon el teléfono de tu cliente o con su ID externo. Boom crea el código, lo envía por WhatsApp y te responde con unotpId. - Tu cliente lo recibe en WhatsApp con un botón Copiar código, y lo escribe en tu app.
- Valídalo. Tu backend llama a
POST /api/v1/otp/verifycon elotpIdy el código. Boom te responde si es válido.
Lo que desbloquea un código válido sigue en tu app: Boom solo te dice si el código es correcto.
De qué se encarga Boom
- Reenvíos sin código nuevo. Si pides otro mientras el anterior sigue vigente, Boom reenvía el mismo código con el mismo
otpId, así que el primer mensaje no deja de servir. - Límites contra abuso. Un tiempo de espera entre reenvíos y un máximo de envíos por número cada hora. Tras varios intentos equivocados, el código se bloquea.
- Expiración. El código vence cuando lo indica tu plantilla de WhatsApp.
- Teléfonos compartidos. Si dos pacientes o clientes usan el mismo número, cada uno recibe su propio código.
- El código no queda a la vista. Se guarda cifrado solo mientras se puede usar. En la bandeja y para tus agentes de IA aparece oculto, y el agente puede seguir respondiendo si tu cliente contesta el mensaje.
- Llega aunque no quiera mensajes. Un código es algo que la persona acaba de pedir, no un mensaje de marketing, así que llega aunque esté en tu lista de No Contactar. Cada uno de esos envíos queda registrado.
Configúralo en minutos
Entra a Transaccionales › Códigos de un solo uso:
- Elige el número de WhatsApp desde el que se envían los códigos.
- Elige o crea la plantilla del código. WhatsApp escribe el texto, tú eliges el idioma, la expiración y si agrega la línea de seguridad. La aprobación suele tardar unos minutos y la página la revisa sola.
- Ajusta las reglas del código: largo, intentos antes de bloquearse, espera entre reenvíos y envíos por hora.
- Envía un código de prueba a tu teléfono y valídalo desde la misma página.
La tarjeta Conecta tu app te muestra las dos llamadas listas para copiar. Cualquier clave de API de tu espacio de trabajo sirve.
Cuánto cuesta
Cada código que WhatsApp entrega se cobra como un mensaje de plantilla de autenticación, igual que cada reenvío entregado. El código de prueba de la página también es un envío real y se cobra.
Ya está disponible
Los códigos de un solo uso están disponibles en todos los espacios de trabajo. Solo necesitas un número de WhatsApp conectado. Por ahora los códigos se envían por WhatsApp; la documentación tiene cada respuesta y cada error.
