Resumen

Esta guía explica cómo enviar una Contraseña de Un Solo Uso (OTP) a través de WhatsApp utilizando la API de Wati. Aprenderás a crear una plantilla de autenticación, obtener su aprobación y activar mensajes OTP mediante la API /sendTemplateMessage.

Disponibilidad

  • Las plantillas de autenticación están disponibles para los clientes de Wati en los planes Growth, Pro y Business.

  • Si te encuentras en un plan heredado (legacy) de Wati, las plantillas de autenticación están disponibles en los planes Standard y Professional.

Instrucciones

Consulta esta guía en video para aprender a enviar OTP a través de WhatsApp con Wati:

Paso 1: Crear una plantilla de autenticación

Antes de enviar OTP, debes crear un mensaje de plantilla de autenticación y obtener la aprobación de WhatsApp. Esta plantilla garantiza un formato coherente para los mensajes de autenticación.

Elementos requeridos en la plantilla de autenticación:

Una plantilla de autenticación con botones de OTP debe incluir:

  • Mensaje de verificación: Un texto preestablecido que contenga el marcador de posición para la OTP.

  • <VERIFICATION_CODE> es tu código de verificación.

  • Aviso de seguridad (opcional): Por tu seguridad, no compartas este código.

  • Aviso de caducidad (opcional): Este código expira en <NUM_MINUTES> minutos.

  • Botón: Un botón de Copiar código o Autocompletado con un toque.

Notas importantes

  • Las URLs, archivos multimedia y emojis no son compatibles en las plantillas de autenticación.

  • Estas plantillas reducen el riesgo de ser pausado, ya que consisten solo en texto preestablecido y botones.

Una vez que envíes la plantilla, espera la aprobación de WhatsApp antes de pasar al siguiente paso.

Paso 2: Enviar la OTP usando la API

Una vez aprobada, puedes activar la OTP usando la API /sendTemplateMessage de Wati. Esta API permite que tu sistema envíe el mensaje de autenticación previamente aprobado a los usuarios.

Punto final (Endpoint) de la API:

https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage

Nota: Los comerciantes que utilizan la API de Wati para enviar mensajes OTP de autenticación pueden habilitar el respaldo por SMS (SMS fallback) para asegurar la entrega de la OTP y mantener las operaciones comerciales sin problemas incluso si los mensajes de WhatsApp fallan.

Uso de la API de envío de mensajes de plantilla V3

¿Se pueden enviar plantillas de AUTENTICACIÓN (Copiar código) a través del punto final POST /api/ext/v3/messageTemplates/send?

Sí. Algunas cosas que debes saber al enviar plantillas de autenticación (códigos OTP) a través de este punto final:

  • Nombre del parámetro: Usa #{{1}} para el valor de la OTP/código.

  • Caducidad del código: 90 minutos es el tiempo máximo de caducidad permitido por Meta.

  • Configuración de la plantilla: Las plantillas de autenticación deben crearse usando el formato de plantilla de autenticación preestablecido de Meta, o seleccionarse de la biblioteca de plantillas; no pueden crearse como plantillas de formato libre.

Para conocer los parámetros de solicitud completos, el formato de respuesta y los códigos de error para enviar plantillas de mensajes (incluidas las de autenticación), consulta la referencia de la API de envío de plantillas de mensajes V3.

Configurar el respaldo por SMS si falla la OTP de WhatsApp

Sigue estos pasos para configurar SMS como respaldo si falla un mensaje OTP de WhatsApp:

Paso 1: Actualizar al plan Wati Business

El respaldo por SMS 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 automático para campañas fallidas.

Paso 3: Crear una plantilla de OTP para WhatsApp

En Wati, crea la plantilla de mensaje que se utilizará para la OTP de autenticación de WhatsApp.

Paso 4: Crear una plantilla de OTP para SMS

Crea una plantilla de SMS equivalente y asígnala a la plantilla de OTP de WhatsApp que creaste en el paso 3.

Paso 5: Enviar la OTP de WhatsApp usando 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 respaldo por SMS a través de Twilio si la entrega de WhatsApp falla.

Consejo: Para saber más sobre las plantillas de autenticación, consulta la guía oficial de Meta.

Preguntas frecuentes (FAQs)

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 para la OTP, un texto de verificación preestablecido y un botón como "Copiar código" o "Autocompletado con un toque".

2. ¿Qué elementos deben incluirse en una plantilla de autenticación?

Debe contener un mensaje de verificación con el marcador de posición para la OTP. Los campos opcionales incluyen un aviso de seguridad y un aviso de caducidad. También debe incluir un botón como "Copiar código" o "Autocompletado con un toque".

3. ¿Pueden las plantillas de autenticación incluir URLs, archivos multimedia o emojis?

No. Las URLs, los archivos multimedia y los emojis no son compatibles con 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.

Envío de OTP a través de la API de Wati

5. ¿Cómo envío mensajes OTP usando Wati?

Una vez que tu plantilla de autenticación esté aprobada, puedes enviar OTPs usando 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

7. ¿Puedo enviar plantillas de AUTENTICACIÓN usando el punto final POST /api/ext/v3/messageTemplates/send?

Sí. Puedes enviar plantillas de autenticación, incluidos códigos OTP, utilizando el punto final /api/ext/v3/messageTemplates/send. Usa #{{1}} como parámetro para el valor de la OTP o código. El tiempo máximo de caducidad del código permitido por Meta es de 90 minutos. Las plantillas de autenticación deben usar el formato preestablecido de Meta o ser seleccionadas de la biblioteca de plantillas; no pueden crearse como plantillas de formato libre.

Para conocer los parámetros de solicitud, formatos de respuesta y códigos de error completos, consulta la referencia de la API de envío de plantillas de mensajes V3.

Disponibilidad y configuración de respaldo

8. ¿Qué planes de Wati admiten plantillas de autenticación?

Son compatibles con los planes Growth, Pro y Business. En los planes heredados, son compatibles con los planes Standard y Professional.

9. ¿Qué es el respaldo por SMS y quién puede usarlo?

El respaldo por SMS asegura la entrega de la OTP enviando un SMS si la OTP de WhatsApp falla. Está disponible solo en el plan Wati Business.

10. ¿Cómo habilito el respaldo por SMS en Wati?

Conecta tu cuenta de Twilio en Wati en Más → Integraciones y habilita el SMS automático para campañas fallidas. También debes crear plantillas de OTP tanto para WhatsApp como para SMS y vincularlas para que el respaldo funcione automáticamente.

Did this answer your question?