Un flujo de trabajo de HubSpot no puede enviar códigos de un solo uso. La acción Send WhatsApp Template de Flowella no puede dar a un botón de OTP o de copiar código un valor diferente para cada contacto, y HubSpot no debería guardar los códigos. En su lugar, envía los códigos desde tu app con la API.
De un vistazo
Cómo funciona
El diagrama muestra un intento de inicio de sesión, desde la solicitud del código hasta el inicio de sesión o el bloqueo.Antes de empezar
- Crea una clave de API. Consulta Claves de API. Este endpoint solo acepta claves de API, no tokens de acceso OAuth.
- Recoge el número de WhatsApp de cada cliente en formato internacional, como
+447700900123, y su consentimiento para recibir códigos por WhatsApp. Consulta las indicaciones sobre opt-in de Meta. - Lee la introducción a la API para conocer la autenticación, los errores y los límites de velocidad.
Crear la plantilla
Crea la plantilla en WhatsApp Manager de Meta, con la categoría Authentication y un botón de copiar código. Solo las plantillas de autenticación pueden incluir un código de un solo uso, y necesitan un botón de copiar código o de un toque. Meta fija el texto: “<code> is your verification code.” Puedes añadir un aviso para no compartir el código y una línea de caducidad de 1 a 90 minutos.
No se permiten URL, contenido multimedia ni emojis, y el código puede tener hasta 15 caracteres. Cuando Meta aprueba la plantilla, aparece en Flowella. Consulta las directrices de categorización de plantillas y las plantillas de autenticación con copiar código de Meta.
Si además escribes a los clientes sobre un bloqueo, usa una plantilla Utility independiente, como Hi {{1}}, we have paused sign-in to your account after several incorrect codes. Try again in 30 minutes or contact our support team. Una alerta de seguridad de la cuenta sin promoción encaja en Utility.
Enviar un código
1
Buscar la plantilla y el canal
Llama a
GET /v1/templates?status=APPROVED. Anota el id y el wabaId de tu plantilla, y el whatsappChannelId del número desde el que envías. Consulta Multicanal si tienes varios números.2
Crear el código en tu app
Genera un código aleatorio de hasta 15 caracteres. Guarda un hash del código con una caducidad corta y márcalo como de un solo uso.
3
Enviar la solicitud
Incluye el código dos veces: una como parámetro del cuerpo y otra como valor del botón de copiar código. El formato de envío de Meta trata el botón de copiar código como un botón de URL, así que usa Una respuesta
subType url, con index 0 para el primer botón.202 con "status": "accepted" significa que Flowella ha puesto el envío en cola. No confirma la entrega.4
Comprobar el código
Cuando el cliente escriba el código, compáralo con el hash guardado. Acéptalo una sola vez y solo antes de que caduque.
5
Gestionar los reenvíos y el bloqueo
Envía un código nuevo en cada intento e invalida el anterior. Espera al menos 15 segundos antes de un reenvío: Flowella omite un segundo envío de la misma plantilla al mismo número en menos de 15 segundos. Limita los intentos y después bloquea el inicio de sesión durante un periodo determinado y ofrece soporte.
6
Registrar el resultado en HubSpot (opcional)
Haz que tu app actualice el contacto de HubSpot mediante la API de HubSpot, por ejemplo Last WhatsApp verification (selector de fecha y hora) y Last verification result (selección desplegable: Passed, Failed, Locked). Después, un flujo de trabajo de HubSpot puede crear una tarea cuando el resultado sea Locked. No guardes nunca los códigos en HubSpot.
Probar la integración
- Envía un código a tu propio número de WhatsApp y comprueba que el botón de copiar código lo copia.
- Introduce un código incorrecto, solicita un reenvío tras la espera y comprueba que el código anterior ya no funciona.
- Supervisa la entrega con los eventos de webhook
message.deliveredymessage.failed. Consulta Webhooks.
Solución de problemas
Relacionado
- Introducción a la API: autenticación, idempotencia, errores y límites de velocidad.
- Referencia de plantillas: categorías de plantillas y tipos de botones.
- Webhooks: recibe eventos de entrega de Flowella.