Guía de conexión
Margarita funciona sobre WhatsApp Business Platform (la API de Meta), no sobre WhatsApp Web ni la app normal. Antes de usarla hay que dejar lista la cuenta de Meta. Esta guía es todo lo que se necesita.
¿Prefieres no hacerlo tú?
Nosotros configuramos la app de Meta, la cuenta de WhatsApp Business, el número dedicado, el token permanente, el webhook firmado, las plantillas y una prueba de punta a punta. Precio: se cotiza aparte.
Pedir que me ayudenEntra a business.facebook.com y crea (o usa) tu portafolio comercial: ahí viven la cuenta de WhatsApp y el método de pago.
Ojo con esto: Verifica tu negocio si vas a enviar a volumen y agrega un método de pago válido. Sin método de pago, la cuenta no envía aunque todo lo demás esté listo.
En developers.facebook.com crea una app de tipo «Business» y agrégale el producto WhatsApp. De ahí salen el App ID y el App Secret (Configuración → Básica → Mostrar).
Ojo con esto: Copia el App Secret tal cual. Es el dato que valida que cada webhook viene de Meta.
Dentro del producto WhatsApp se crea (o se vincula) la cuenta de WhatsApp Business. De ahí sale el WABA ID que se captura en Margarita.
Ojo con esto: Nombre de la cuenta, zona horaria y categoría: revisa que el nombre sea el real del negocio; cambiarlo después implica nueva revisión.
Registra el número que va a enviar y recibir. Meta lo verifica por SMS o llamada. Al terminar, tendrás el Phone Number ID.
Ojo con esto: El número no debe estar en uso en la app normal de WhatsApp (ordinaria ni Business). Si ya lo usas ahí, primero hay que eliminarlo de esa app. El nombre visible debe cumplir las reglas de Meta.
En el portafolio comercial crea un usuario de sistema con los permisos de mensajería de WhatsApp y genera su token permanente.
Ojo con esto: Los tokens de prueba duran 24 horas: si usas uno, al día siguiente deja de enviar y parece que la herramienta se rompió.
En la app de Meta → WhatsApp → Configuración, registra la URL del webhook de tu instalación y el verify token que tú inventes. Después suscribe el campo «messages».
Ojo con esto: La URL es https://TU-DOMINIO/webhooks/meta/whatsapp y el verify token debe ser idéntico al que capturen en Margarita. Si no coincide, la verificación falla.
Las plantillas son la única forma de iniciar una conversación. Créala en Meta (categoría, idioma y variables) y espera la aprobación, que suele tardar minutos u horas.
Ojo con esto: Ejemplo de cuerpo: «Hola {{1}}, tenemos pendiente tu pago de {{2}}. ¿Cómo te ayudamos?». En Margarita se sincroniza sola.
En Admin → WhatsApp captura App Secret, token, WABA ID, versión de API y el número. Después sincroniza plantillas desde Admin → Plantillas.
Ojo con esto: Los tokens y el App Secret se guardan cifrados en la base.
Manda una plantilla a 1 o 3 personas autorizadas, pide que respondan y revisa que el mensaje entre, se asigne y quede en la bitácora.
Ojo con esto: Con esa prueba confirmas webhook, envío, recepción y asignación antes de operar en grande.
Todos estos los vimos pasar. Si algo no funciona, casi siempre es uno de ellos.
El webhook responde 401
El App Secret capturado no es el de la app (o quedó un valor de relleno). Meta entrega y el sistema rechaza: no llega ni un mensaje.
«Se envió» pero no llega
Casi siempre es el método de pago de Meta: sin él, la cuenta devuelve el error 131042 y el mensaje nunca sale.
No puedo iniciar conversación
Fuera de la ventana de 24 horas solo se puede iniciar con una plantilla aprobada. El texto libre solo funciona si el cliente escribió en las últimas 24 horas.
La plantilla fue rechazada
Suele pasar por categoría mal elegida o por contenido promocional en una plantilla declarada como servicio. Se corrige y se reenvía.
El número no se puede registrar
Todavía está en la app normal de WhatsApp. Hay que eliminarlo de ahí (y perder ese historial de app) antes de registrarlo en la API.
La calidad del número bajó
Demasiados envíos a gente que no pidió recibirlos, o muchos bloqueos. Se degrada el envío y, si sigue, la cuenta se restringe.
Incluye el alta en Meta, el número dedicado, el token permanente, el webhook firmado, la primera plantilla y la prueba de punta a punta. Precio: se cotiza aparte.
