WhatsApp

GetMyBot conecta WhatsApp a través de la WhatsApp Cloud API (Meta Graph API). Tras la conexión, el bot recibe los mensajes entrantes de WhatsApp y les aplica tus reacciones, y los operadores pueden mantener conversaciones en los diálogos. Para una visión general del multicanal, véase la página Canales.

Conexión de un canal de WhatsApp

Para conectar se necesitan cinco credenciales de tu aplicación de Meta (WhatsApp Cloud API). Todas son obligatorias:

  • Phone number ID — el identificador del número de WhatsApp Business.
  • WABA ID — el identificador de la WhatsApp Business Account.
  • Access token — el token de acceso de la aplicación de Meta.
  • Verify token — una cadena arbitraria que inventas tú mismo. Se usa al verificar el webhook en Meta (véase abajo).
  • App secret — el secreto de la aplicación de Meta. Se necesita para comprobar la firma HMAC de los webhooks entrantes (cabecera X-Hub-Signature-256).

Pasos en la interfaz:

  1. Abre Bots → «Añadir canal» → WhatsApp.
  2. Rellena los cinco campos de arriba y, si lo deseas, un nombre de canal (opcional).
  3. Pulsa «Verificar» — GetMyBot valida las credenciales a través de Meta.
  4. Pulsa «Conectar».

Configuración del webhook en Meta

Tras la conexión, el canal obtiene una Callback URL con la forma {dirección}/ch/{channelID} (en la interfaz, el icono de webhook 🔗). Debe indicarse junto con tu Verify token en la aplicación de Meta: WhatsApp → Configuration → Webhook.

Cómo funciona:

  1. Meta envía a la Callback URL una solicitud de verificación y compara el verify_token transmitido con tu Verify token. Si coinciden, el webhook se considera confirmado.
  2. Después Meta envía a esa dirección eventos (mensajes entrantes, estados de entrega, veredictos de moderación de plantillas).
  3. Cada solicitud entrante va firmada con la cabecera X-Hub-Signature-256; GetMyBot comprueba la firma con el App secret — por eso esa credencial se requiere al conectar.

La ventana de sesión de 24 horas

WhatsApp limita la correspondencia por iniciativa propia: los mensajes libres solo se pueden enviar a un usuario dentro de las 24 horas siguientes a su último mensaje entrante. Cada nuevo mensaje entrante del usuario renueva la ventana.

Fuera de la ventana de 24 horas no se puede enviar un mensaje libre — la única forma de volver a escribir al usuario (re-engagement) es una plantilla de mensaje aprobada. Por eso las plantillas son la herramienta clave para difusiones y recordatorios en WhatsApp.

Plantillas de mensajes

Una plantilla de mensaje (message template) es un mensaje previamente acordado con Meta que se puede enviar fuera de la ventana de sesión. La gestión de plantillas se hace en la interfaz de GetMyBot.

Dónde gestionar las plantillas

Bots → en el canal de WhatsApp, el icono «Plantillas de mensajes» (📄) → el diálogo «Plantillas del canal de WhatsApp». El diálogo tiene botones:

  • «Crear plantilla» — componer una nueva plantilla.
  • «Sincronizar» — traer el catálogo de plantillas desde Meta (actualizar estados y lista).

Categorías de plantillas

  • MARKETING (Marketing) — promociones, anuncios, difusiones.
  • UTILITY (Servicio) — notificaciones sobre acciones del usuario (estados de pedido, recordatorios).
  • AUTHENTICATION (Autenticación) — códigos de confirmación.

Campos de la plantilla

  • Nombre — letras latinas minúsculas, dígitos y _, hasta 512 caracteres.
  • Idioma — una locale de Meta.
  • Categoría — una de las tres de arriba.

Para las categorías Marketing y Servicio, además:

  • Encabezado — ninguno / texto / imagen / vídeo / documento. Para un encabezado multimedia se sube un archivo de ejemplo.
  • Cuerpo — obligatorio, hasta 1024 caracteres. Las variables se indican con {{1}}, {{2}}, … estrictamente en orden de 1 a N, sin huecos.
  • Pie — hasta 60 caracteres.
  • Botones — hasta 10: respuesta rápida, enlace (hasta 2), teléfono (1), copiar código (1).
  • Para cada variable {{n}} hay que indicar un valor de ejemplo — es un requisito de Meta para la moderación.

Para la categoría Autenticación, el cuerpo lo fija la propia Meta; se configuran: la vigencia del código (1–90 minutos), la recomendación de seguridad y el texto del botón de copiar el código.

Moderación

El botón «Crear» envía la plantilla a la moderación de Meta de inmediato — no hay un paso aparte de «enviar a revisión». El veredicto llega de forma asíncrona (a través del webhook), y la lista de plantillas se actualiza automáticamente. Estados:

  • PENDING (En revisión)
  • APPROVED (Aprobado)
  • REJECTED (Rechazado) — con indicación del motivo
  • así como PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

Se pueden editar las plantillas en los estados APPROVED, REJECTED, PAUSED. El nombre y el idioma no se pueden cambiar; en las plantillas aprobadas la categoría también está bloqueada.

Uso de una plantilla en una reacción

Enviar una plantilla es una acción de reacción:

  1. En el constructor de reacción abre «Acciones» → «Añadir acción» → «Enviar plantilla de WhatsApp».
  2. La acción solo está disponible si el bot tiene conectado un canal de WhatsApp con soporte de plantillas.
  3. Solo se puede seleccionar una plantilla aprobada (APPROVED).
  4. Se rellenan los parámetros: los valores de las variables {{n}} en el cuerpo, el encabezado de texto, el encabezado multimedia por enlace, los parámetros de los botones URL. En los parámetros se pueden usar sustituciones de variables.

El canal de envío real lo determina el canal del evento: si el evento llegó desde WhatsApp, la plantilla saldrá por WhatsApp.

Diálogos y adjuntos

Un operador puede responder en un diálogo de WhatsApp y enviar adjuntos — imagen, vídeo o documento — teniendo en cuenta la ventana de 24 horas (fuera de la ventana no está disponible la correspondencia libre). Los medios entrantes de los suscriptores se cargan a través de un proxy y se muestran en el diálogo.

Tarificación

GetMyBot lleva el registro de las conversaciones de WhatsApp (conversations) por categoría — marketing / utility / authentication / service. En la versión actual esto es solo un registro para observabilidad (record-only): no se descuenta saldo por las conversaciones.

Qué sigue

  • Canales — multicanal y matriz de capacidades.
  • Reacciones: lo básico — cómo construir el comportamiento del bot.
  • Difusiones — envío masivo (en WhatsApp — a través de plantillas aprobadas).