WhatsApp (Meta directo)
Esta integración conecta un número de WhatsApp Business a Gopersonal usando tu propia App de Meta y la Cloud API de WhatsApp. Los mensajes salen directo desde tu cuenta de Meta, y Meta te factura las conversaciones a vos.
Antes de empezar
Un Business Manager de Meta con una cuenta de WhatsApp Business (WABA) y un número registrado en la Cloud API.
Un usuario con permisos de administrador en ese Business Manager.
Un medio de pago cargado en la cuenta de WhatsApp Business. Sin un medio de pago, Meta no deja enviar plantillas de marketing.
1. Crear la App de Meta
1- Ingresar a developers.facebook.com y presionar Crear app.
2- Elegir el tipo Business (o el caso de uso Conectarse con clientes a través de WhatsApp) y asociarla a tu Business Manager.
3- En el panel de la App, en Agregar productos, agregar WhatsApp y seleccionar tu cuenta de WhatsApp Business.
2. Obtener los datos de la cuenta
En la App, ir a WhatsApp > Configuración de la API (API Setup). Ahí están:
WhatsApp Business Account ID: el identificador de tu cuenta de WhatsApp Business.
Phone Number ID: el identificador del número desde el que se van a enviar los mensajes. No es el número de teléfono: es un ID numérico largo que aparece debajo del número.
3. Generar un token permanente
1- Ir a Configuración del negocio del Business Manager (business.facebook.com/settings) > Usuarios > Usuarios del sistema.
2- Presionar Agregar, ponerle un nombre (por ejemplo gopersonal) y elegir el rol Administrador.
3- Con el usuario del sistema seleccionado, presionar Asignar activos y darle control total sobre:
la App que creaste en el paso 1;
la cuenta de WhatsApp Business.
4- Presionar Generar nuevo token, elegir la App, en vencimiento elegir Nunca y marcar los permisos:
whatsapp_business_messagingwhatsapp_business_management
5- Copiar el token. Meta lo muestra una sola vez.
4. Copiar el App Secret
En la App, ir a Configuración de la app > Básica y en Clave secreta de la app presionar Mostrar. Con este dato Gopersonal verifica que los avisos que llegan de Meta (entregas, lecturas, bajas) son legítimos.
5. Agregar la integración en Gopersonal
1- Ir a la sección Integraciones, presionar Agregar y seleccionar WhatsApp.
2- Completar los datos:
Name
Nombre de la integración, para uso interno. Sirve para distinguir cuentas si tenés varias.
WhatsApp Business Account ID
El del paso 2.
Phone Number ID
El del paso 2.
Access Token
El token permanente del paso 3.
App Secret
La clave secreta del paso 4.
Display Name
Nombre con el que se identifica el número en el selector de remitente de broadcasts y journeys.
3- Guardar. Al guardar, Gopersonal suscribe automáticamente tu App a la cuenta de WhatsApp Business para poder recibir los avisos de Meta.
6. Configurar el webhook en Meta
El webhook es lo que le permite a Gopersonal saber si un mensaje se entregó, se leyó o falló, y detectar cuando un cliente se da de baja. Sin este paso los mensajes se envían igual, pero los reportes no muestran entregas ni lecturas y las bajas no se registran.
1- En Gopersonal, abrir la integración recién creada. Al final aparece el bloque Webhook de WhatsApp con dos datos para copiar:
URL de devolución de llamada
Token de verificación
2- En la App de Meta, ir a WhatsApp > Configuración y en Webhook presionar Editar.
3- Pegar la URL de devolución de llamada y el Token de verificación y presionar Verificar y guardar.
4- En Campos del webhook, presionar Administrar y suscribirse al campo messages.
Plantillas
Los mensajes de WhatsApp se envían con plantillas aprobadas por Meta. Se crean y se aprueban en el WhatsApp Manager (business.facebook.com/wa/manage/message-templates), no en Gopersonal.
En la configuración de un broadcast o journey, al elegir esta integración como remitente se listan las plantillas aprobadas de la cuenta. Ver WhatsApp en broadcasts.
Límites de envío
Meta limita cuántos contactos distintos pueden recibir mensajes de un número por día. Un número nuevo arranca en 250 contactos por día y el límite sube a medida que se envía con buena calidad. El límite y la calidad del número se ven en el WhatsApp Manager.
Bajas
Si un cliente responde STOP, BAJA o toca el botón para dejar de recibir promociones, queda dado de baja del canal WhatsApp y no se le vuelven a enviar mensajes de marketing. Para esto el webhook tiene que estar configurado (paso 6).
Problemas frecuentes
"El access token de la integración de WhatsApp expiró o no tiene permisos": se usó el token temporal de 24 horas, o al usuario del sistema le falta algún permiso o activo asignado. Generá un token permanente (paso 3) y actualizalo en la integración.
No aparecen plantillas en el selector: solo se listan las plantillas aprobadas. Revisá su estado en el WhatsApp Manager y usá el botón de actualizar en la configuración.
Meta no verifica el webhook: revisá que la URL y el token estén copiados completos, sin espacios.
Los reportes no muestran entregas ni lecturas: falta suscribirse al campo
messages(paso 6), o la App no está en modo Live.
Last updated