El conector de WhatsApp Business permite que el asistente de IA y los workflows de tu organización envíen mensajes de WhatsApp directamente con la API oficial de Meta, sin servicios intermediarios. Es un conector de organización: lo da de alta un administrador en el área de Conectores, y el número de teléfono desde el que se envía pertenece a la organización.

Dos reglas de WhatsApp que conviene entender antes de empezar:

  • Texto libre solo dentro de la ventana de 24 horas: puedes enviar cualquier texto a una persona que te haya escrito en las últimas 24 horas.
  • Plantillas para iniciar conversaciones: fuera de esa ventana, solo se pueden enviar plantillas pre-aprobadas por Meta. Por eso el conector tiene dos herramientas de envío separadas.

Parte 1 — Prepara el lado de Meta (administrador, una vez)

No necesitas una cuenta de WhatsApp Business previa para empezar: Meta te crea una de prueba al dar de alta la aplicación.

  1. Entra en developers.facebook.com con una cuenta de Facebook y crea una cuenta de desarrollador (gratuita).
  2. Crea una aplicación de tipo Business y añádele el producto WhatsApp. Meta aprovisiona automáticamente una cuenta de WhatsApp Business de prueba con un número de prueba.
  3. En WhatsApp → API Setup encontrarás los dos datos que Yellow necesita:
    • El identificador del número de teléfono (Phone number ID — un número largo, no el teléfono).
    • Un token de acceso. El de esa página es temporal (24 horas), suficiente para probar. Para uso real, crea un system user en el Business Manager (Configuración del negocio → Usuarios → Usuarios del sistema), asígnale la aplicación y genérale un token permanente con el permiso whatsapp_business_messaging.
  4. Con el número de prueba puedes enviar mensajes a un máximo de 5 números destinatarios que verifiques por SMS desde la misma página — ideal para probar sin coste.

Para pasar a producción más adelante: un número de teléfono propio que no esté activo en el WhatsApp normal, la revisión del nombre visible, y las plantillas que quieras aprobadas por Meta. Meta cobra por conversación iniciada por la empresa (las conversaciones de servicio — responder dentro de las 24 horas — son gratuitas).

Parte 2 — Da de alta el conector en Yellow

  1. En el área de organización, abre Conectores → Nuevo conector → Catálogo → WhatsApp Business.
  2. Introduce el ID del número de teléfono de la Parte 1.
  3. Pega el token en el campo de credencial (se guarda de forma segura y no se vuelve a mostrar; para cambiarlo, pega uno nuevo).
  4. Guarda y usa Probar la conexión — lee el perfil del número para confirmar que el token y el número son correctos.
  5. Activa Disponible en workflows y rutinas si quieres que los workflows envíen mensajes.

Las herramientas

Herramienta Qué hace Cuándo se puede usar
whatsapp_send_message texto libre dentro de la ventana de 24 h
whatsapp_send_template plantilla aprobada (con parámetros) siempre; inicia conversaciones
whatsapp_get_business_profile lee el perfil del número la prueba de conexión

Con el número de prueba, la plantilla hello_world ya viene aprobada — la manera más rápida de ver llegar un mensaje.

Resolución de problemas

  • «token expired» o similar — el token temporal de 24 h ha caducado; genera uno permanente con un system user (Parte 1, paso 3).
  • El destinatario no recibe nada (número de prueba) — su teléfono debe estar en la lista de destinatarios verificados de la página API Setup.
  • «template not found» — el nombre o el idioma de la plantilla no coincide con ninguna plantilla aprobada de la cuenta.
  • Error en texto libre — probablemente estás fuera de la ventana de 24 h; usa una plantilla.

Relacionados