> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/es/marketing-y-atribucion/meta-ads/meta-conversions-api.md). # Cómo conectar Meta y mapear conversiones Consulta las definiciones en el [sistema de calificación de leads de ILA](/es/optimizacion-del-agente/ila-rating-system.md). Cuando un lead califica en WhatsApp, Patagon AI puede enviar esa conversión de vuelta a tu plataforma publicitaria. Esto permite que el modelo de optimización de la plataforma aprenda de tus leads *calificados* en lugar de cada respuesta, mejorando con el tiempo el rendimiento de tus anuncios Click-to-WhatsApp (CTWA). **Meta** es la plataforma soportada hoy. Google Ads, TikTok Ads, LinkedIn Ads, Snapchat Ads y X Ads están próximamente. ## Requisitos previos * Una cuenta publicitaria de Meta activa * WhatsApp conectado y tu agente activo en Patagon AI * Acceso de administrador en Meta Business Manager ## 1. Conecta Meta 1. Ve a **Leads → Atribución → Configuración → Conectar Plataformas**. 2. En **Meta Business**, haz clic en **Conectar** y completa el flujo de OAuth. ![Conectar Plataformas](/files/65KB1UYvB5zh4E7Xfw9m) 3. En **Configurar Integración de Meta**, elige: * **Cuenta Publicitaria**: la cuenta que ejecuta tus campañas. * **Píxel / Conjunto de datos**: a dónde se enviarán las conversiones (generalmente tu dataset de Meta Conversions API). 4. Haz clic en **Guardar**. ![Configurar Integración de Meta](/files/wVHvlB1hkOjnkvTv5FrJ) {% hint style="info" %} La conexión de Meta se configura **por agente**, así que cada agente puede apuntar a su propia cuenta publicitaria y conjunto de datos. {% endhint %} ### El dataset que necesitan tus conversiones de CTWA Un **dataset** es donde Meta recopila los eventos de tus anuncios. (Meta antes los llamaba "píxeles" y la interfaz todavía dice "Datasets and pixels": es lo mismo.) Los eventos que recibe un dataset le dan un tipo: * Un **dataset de sitio web (website)** es para recorridos que **empiezan en tu sitio web**: alguien hace clic en tu anuncio, llega a una página y desde ahí abre WhatsApp — tus campañas **Landing → WhatsApp**. La conversión igual ocurre en la conversación de WhatsApp, pero como el recorrido empezó en la web, Patagon AI la envía a tu dataset de sitio web. * Un **dataset de mensajería (business messaging)** es para recorridos que van **directo a WhatsApp**, sin página de aterrizaje de por medio: alguien hace clic en un anuncio **Click-to-WhatsApp** y cae directamente en una conversación. Estas conversiones deben fluir a un dataset de mensajería para que Meta las atribuya correctamente. Así que lo que diferencia a los dos no es *dónde* ocurre la conversión —siempre es la conversación de WhatsApp— sino **cómo llegó la persona hasta ahí**. Para que Meta acepte tus conversiones de CTWA, tienen que caer en un dataset que pueda recibir **eventos de mensajería (business messaging)**. Hay dos formas de tener uno: | Tu situación | Cómo obtienes un dataset apto para mensajería | | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Ya tienes un dataset de sitio web** y quieres usarlo también para CTWA | Agrégale una fuente de datos de Mensajería, **una sola vez**, para que reciba **tanto** eventos web como de mensajería. Sigue [Cómo agregar eventos de mensajería (business messaging) a tu dataset de sitio web](/es/marketing-y-atribucion/meta-ads/meta-conversions-api/ctwa-offline-conversions.md). | | **No tienes un dataset de mensajería** | Cuando activas el toggle **WhatsApp Business Dataset**, Patagon AI **crea uno por ti** — llamado **` - Patagon Event Data`** y con Patagon AI como propietario. Mira [Cómo Patagon AI crea tu dataset de mensajería (business messaging)](/es/marketing-y-atribucion/meta-ads/meta-conversions-api/business-messaging-dataset.md). | {% hint style="info" %} Activa el toggle **WhatsApp Business Dataset** en tu integración de Meta para las campañas **Click-to-WhatsApp** (donde la gente llega a WhatsApp directamente desde el anuncio, sin página de aterrizaje). Patagon AI detecta automáticamente un dataset apto para mensajería existente y solo crea uno si no lo tienes. **Las campañas Landing → WhatsApp no necesitan esto**: usan tu dataset de sitio web. En la vista técnica de Meta, los dos tipos de dataset aparecen como `website` y `business_messaging`. {% endhint %} #### Conecta el dataset a tu cuenta publicitaria Tu dataset de CTWA tiene que estar conectado a la cuenta publicitaria que corre esas campañas; de lo contrario no aparecerá cuando crees u optimices una campaña CTWA. Si Patagon AI creó el dataset por ti, conéctalo una vez tú mismo, en Meta Business Manager: 1. Ve a **Business settings → Data sources → Datasets and pixels** y selecciona el dataset llamado **` - Patagon Event Data`**. Abre su pestaña **Connected assets**. ![Encuentra el dataset creado por Patagon en Datasets and pixels](/files/KOhBJwzL9qsCuIO95kA0) 2. Haz clic en **Connect assets**. ![Connect assets](/files/eBw2xlg2y0f09CXccsf5) 3. Elige **Ad accounts**, marca la cuenta publicitaria que usarás para tus campañas CTWA y haz clic en **Add**. ![Selecciona tu cuenta publicitaria y haz clic en Add](/files/HBBuVsoHZmEmKwrU6D1W) ## 2. Mapea conversiones Un mapeo le dice a Patagon AI qué evento dentro del producto debe disparar una conversión, y qué acción de conversión enviar a la plataforma publicitaria. 1. Ve a **Leads → Atribución → Configuración → Mapear Conversiones** y haz clic en **Agregar mapeo**. 2. En **Agregar Mapeo de Conversión**, elige: * **Evento de Patagon AI**: el disparador, según la calificación del lead: `Lead 3 Star`, `Lead 4 Star`, `Lead 5 Star`, `Lead 3+ Star` o `Lead 4+ Star`. * **Plataforma**: Meta. * **Cuenta**: la cuenta de Meta conectada. * **Acción de Conversión**: el evento estándar de Meta a registrar (ej. `Lead`, `Purchase`). 3. Haz clic en **Crear Mapeo**. Queda activo para cualquier nuevo lead que coincida con el disparador. ![Agregar Mapeo de Conversión](/files/XodCWo137qYzy8LfPIiu) {% hint style="warning" %} **Las conversiones CTWA usan un dataset de mensajería (business messaging)** (el action source `business_messaging` de Meta), y Meta solo acepta un conjunto limitado de eventos estándar para él. Al mapear conversiones para Click-to-WhatsApp, usa solo: `Lead`, `Purchase`, `AddToCart`, `ViewContent`, `InitiateCheckout`. {% endhint %} ## 3. Verifica que funcione Puedes confirmar las conversiones en dos lugares. **En Patagon AI**: ve a **Leads → Atribución → Configuración → Eventos**. Cada fila muestra la fecha, la plataforma, el evento de Patagon AI que la disparó, el nombre de la conversión y el estado: **Confirmado**, **Pendiente** o **Fallido**. Si una falla, usa la acción de reintento para reenviarla. ![Registro de Eventos de Conversión](/files/Z67RhNhgR9E7w6gJN2kt) **En Meta**: abre **Ads Manager → Events Manager → Conjuntos de datos**, selecciona el dataset conectado a Patagon AI y revisa la pestaña **Resumen**. Las conversiones aparecen en aproximadamente un minuto. ## Errores comunes | Mensaje de error | Qué significa | Solución | | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *event\_name "Lead" not valid for business\_messaging* | El evento no está permitido para eventos Click-to-WhatsApp en Meta. | Mapea un evento soportado por CTWA (`Lead`, `Purchase`, `AddToCart`, `ViewContent`, `InitiateCheckout`). Si persiste, contacta a soporte. | | *missing page\_id or whatsapp\_business\_account\_id* | Patagon AI no está enviando el ID de la Cuenta de WhatsApp Business con el evento. | Tu canal de WhatsApp puede no haber completado el embedded signup correctamente. Vuelve a ejecutar el asistente de conexión de WhatsApp. | | *the dataset must have a WhatsApp Business account associated* | El conjunto de datos no está vinculado a tu WABA. | Activa el toggle **WhatsApp Business Dataset** (paso 1), o sigue [Cómo agregar eventos de mensajería (business messaging) a tu dataset de sitio web](/es/marketing-y-atribucion/meta-ads/meta-conversions-api/ctwa-offline-conversions.md). | | *(#100) OAuthException: Invalid parameter* | El dataset no está vinculado a una cuenta publicitaria activa, o tu token no tiene acceso. | Verifica que el dataset esté habilitado en Events Manager, que tu cuenta publicitaria tenga acceso total a él, y que el token de OAuth tenga el alcance `ads_management`. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.patagon.ai/es/marketing-y-atribucion/meta-ads/meta-conversions-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.