Resumen
Esta guía explica cómo enviar un Código de Verificación Único (OTP) a través de WhatsApp utilizando la API de WATI. Aprenderás a crear una plantilla de autenticación, obtener aprobación y activar mensajes OTP utilizando la API /sendTemplateMessage.
Instrucciones
Consulta este video tutorial para aprender a enviar OTPs en WhatsApp a través de WATI:
Paso 1: Crear una plantilla de autenticación
Antes de enviar OTPs, debes crear un mensaje de plantilla de autenticación y obtener la aprobación de WhatsApp. Esta plantilla garantiza un formato consistente para los mensajes de autenticación.
Elementos requeridos en la plantilla de autenticación:
Una plantilla de autenticación con botones OTP debe incluir:
Mensaje de verificación: Un texto preestablecido que contenga el marcador de posición del OTP.
<VERIFICATION_CODE>es tu código de verificación.Aviso de seguridad (opcional): Por tu seguridad, no compartas este código.
Aviso de expiración (opcional): Este código expira en
<NUM_MINUTES>minutos.Botón: Un botón Copiar Código o Autocompletar con un clic.
Notas importantes:
URLs, medios y emojis no están soportados en las plantillas de autenticación.
Estas plantillas reducen el riesgo de ser pausadas, ya que consisten solo en texto preestablecido y botones.
Una vez que envíes la plantilla, espera la aprobación de WhatsApp antes de proceder al siguiente paso.
Paso 2: Enviar OTP utilizando la API
Una vez aprobado, puedes activar el OTP utilizando la API /sendTemplateMessage de WATI. Esta API permite que tu sistema envíe el mensaje de autenticación preaprobado a los usuarios.
Punto final de la API:
https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage
Haz clic aquí para leer más sobre la API.
Disponibilidad
Las plantillas de autenticación están disponibles para los clientes de Wati en los planes Growth, Pro y Business. Si estás en un plan legacy de Wati, las plantillas de autenticación están disponibles en los planes Standard y Professional.
Para más detalles, consulta la guía oficial de Plantillas de Autenticación de la API de WhatsApp Business.
Nota: Para los comerciantes que utilizan la API de Wati para enviar mensajes de OTP de autenticación, puedes habilitar SMS de respaldo para ayudar a garantizar la entrega de OTP y mantener operaciones comerciales fluidas incluso si fallan los mensajes de WhatsApp.
Sigue estos pasos para configurar SMS como respaldo si falla un mensaje de OTP de WhatsApp:
Paso 1: Actualizar al plan Business de Wati
El SMS de respaldo solo está disponible en el plan Business.
Paso 2: Conectar Wati con Twilio
En Wati, ve a Más → Integraciones.
Agrega tu cuenta de Twilio y activa Enviar SMS automatizados para transmisiones fallidas.
Paso 3: Crear una plantilla de OTP de WhatsApp
En Wati, crea la plantilla de mensaje que se utilizará para la autenticación de OTP de WhatsApp.
Paso 4: Crear una plantilla de OTP por SMS
Crea una plantilla de SMS coincidente y mápala a la plantilla de OTP de WhatsApp que creaste en el Paso 3.
Paso 5: Enviar el OTP de WhatsApp utilizando la API de Wati
Cuando tu sistema llame a la API de Wati para enviar la plantilla de OTP de WhatsApp, Wati enviará automáticamente el SMS de respaldo a través de Twilio si falla la entrega de WhatsApp.
Preguntas frecuentes (FAQ)
Plantillas de autenticación y OTP
1. ¿Qué es una plantilla de autenticación para OTP?
Es un formato de mensaje preaprobado requerido por WhatsApp para enviar OTPs a través de Wati. Incluye un marcador de posición de OTP, texto de verificación preestablecido y un botón como Copiar Código o Autocompletar con un clic.
2. ¿Qué elementos deben incluirse en una plantilla de autenticación?
Debe contener un mensaje de verificación con el marcador de posición de OTP. Los campos opcionales incluyen un aviso de seguridad y un aviso de expiración. También debe incluir un botón como Copiar Código o Autocompletar con un clic.
3. ¿Pueden las plantillas de autenticación incluir URLs, medios o emojis?
No. Las URLs, medios y emojis no están soportados en las plantillas de autenticación.
4. ¿Necesitan las plantillas de autenticación la aprobación de WhatsApp?
Sí. Debes enviar la plantilla y esperar la aprobación de WhatsApp antes de enviar mensajes OTP.
Enviar OTP a través de la API de Wati
5. ¿Cómo envío mensajes OTP utilizando Wati?
Una vez que tu plantilla de autenticación sea aprobada, puedes enviar OTPs utilizando la API /sendTemplateMessage de Wati.
6. ¿Cuál es el punto final de la API para enviar mensajes OTP?
El punto final es: https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage
Disponibilidad y configuración de respaldo
7. ¿Qué planes de Wati soportan las plantillas de autenticación?
Están soportadas en los planes Growth, Pro y Business. En los planes legacy, están soportadas en los planes Standard y Professional.
8. ¿Qué es el SMS de respaldo y quién puede usarlo?
El SMS de respaldo garantiza la entrega de OTP enviando un SMS si falla el OTP de WhatsApp. Solo está disponible en el plan Business de Wati.
9. ¿Cómo habilito el SMS de respaldo en Wati?
Conecta tu cuenta de Twilio en Wati bajo Más → Integraciones y habilita el SMS automatizado para transmisiones fallidas. También debes crear plantillas de OTP tanto de WhatsApp como de SMS y mapearlas juntas para que el respaldo funcione automáticamente.