> For the complete documentation index, see [llms.txt](https://academy.gopersonal.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.gopersonal.ai/integraciones/whatsapp-meta.md).

# 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.

{% hint style="info" %}
Si no querés crear una App en Meta ni manejar tokens, usá la integración [WhatsApp (Zernio)](https://academy.gopersonal.ai/integraciones/whatsapp-zernio.md): el número se conecta con el login de Meta y listo.
{% endhint %}

## 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](https://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

{% hint style="warning" %}
El token temporal que muestra la pantalla de API Setup **vence a las 24 horas**. No lo uses en la integración: generá un token de un usuario del sistema, que no vence.
{% endhint %}

1- Ir a **Configuración del negocio** del Business Manager ([business.facebook.com/settings](https://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_messaging`
* `whatsapp_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:

| Campo                            | Qué va                                                                                          |
| -------------------------------- | ----------------------------------------------------------------------------------------------- |
| **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`**.

{% hint style="warning" %}
Para que Meta mande los avisos de mensajes reales, la App tiene que estar **publicada** (modo **Live**). Se cambia desde el selector de modo en la parte superior del panel de la App.
{% endhint %}

## 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](https://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](https://academy.gopersonal.ai/guia-de-usuario/broadcasts/nuevo-broadcast/whatsapp.md).

## 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.
