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

# Meta Ads Conversions

Reporta a Meta las conversiones de WhatsApp que comenzaron en un anuncio Click-to-WhatsApp mediante la API de Conversiones, para optimizar tus anuncios.

Cuando una conversación de WhatsApp que comenzó desde un anuncio de **Click-to-WhatsApp** (CTWA) de Meta alcanza un objetivo que tú defines, Dapta reporta esa conversión automáticamente a Meta a través de la **API de Conversiones (CAPI)**. Esto le da a Meta la señal que necesita para optimizar la entrega de tus anuncios hacia personas que realmente convierten — y hace que el reporte de tus campañas sea más preciso.

{% hint style="info" %}
Esta función solo se activa para conversaciones que comenzaron desde un **anuncio Click-to-WhatsApp**. Las conversaciones de WhatsApp normales no se cuentan.
{% endhint %}

## ¿Qué conversaciones se reportan a Meta?

Dapta reporta a Meta solo las conversaciones que comenzaron desde un anuncio Click-to-WhatsApp y que alcanzan el evento de conversión que tú elegiste, como Lead o Schedule. Al terminar la conversación, la IA revisa su análisis posterior a la conversación, decide si el objetivo se cumplió y envía un único evento por la API de Conversiones, evitando el doble conteo.

***

**📘 Lo que aprenderás en este documento:**

* **Parte 1:** Conectar tu credencial de Meta Ads — desde **Credenciales** o desde el propio agente
* **Parte 2:** Configurar tu Text Agent para enviar conversiones a Meta
* **Para tener en cuenta:** Cómo funcionan la atribución y la deduplicación

***

**✅ Antes de empezar — Requisitos:**

* Un **Text Agent** activo conectado a WhatsApp en Dapta
* **Anuncios Click-to-WhatsApp** activos en tu cuenta de Meta Ads
* Acceso de administrador al **dataset de Events Manager** vinculado a esos anuncios (en [business.facebook.com/events\_manager2](https://business.facebook.com/events_manager2))

***

#### 🔐 Parte 1: Conectar tu credencial de Meta Ads

> Ve a **Credenciales** en el menú lateral → en la tarjeta **Meta Ads**, haz clic en **+** para abrir el diálogo **Integración con Meta Ads**. También puedes abrir el mismo diálogo sin salir de un Text Agent: en su panel **Conversiones de Meta Ads** (Parte 2), haz clic en **Agregar credencial**.

Necesitas dos valores. Ambos vienen de la **misma pantalla** en [Meta Events Manager](https://business.facebook.com/events_manager2):

**Paso 1:** Abre Meta Events Manager y selecciona el **dataset** conectado a tus anuncios.

**Paso 2:** Copia el **Dataset / Pixel ID** — aparece en la parte superior de la página, justo debajo del nombre del dataset. Es un número largo.

**Paso 3:** En ese mismo dataset, ve a **Settings** → **Conversions API** → haz clic en **"Generate access token"**. Copia el token inmediatamente.

> ⚠️ **Trata el token de la API de Conversiones como una contraseña.** Dapta lo almacena de forma segura y no lo volverá a mostrar después de guardar. No se requiere inicio de sesión con Facebook, OAuth ni App Review — estás usando tu propio token de Events Manager.

| Campo                               | Dónde encontrarlo                                                                                       |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Dataset / Pixel ID**              | Events Manager → selecciona tu dataset → se muestra en la parte superior, debajo del nombre del dataset |
| **Token de la API de Conversiones** | Mismo dataset → **Settings** → **Conversions API** → **"Generate access token"**                        |

**Paso 4:** En el diálogo **Integración con Meta Ads**, ponle un **Nombre** a la credencial — una etiqueta para reconocer la conexión. La credencial pertenece a todo el espacio de trabajo, así que todos sus miembros ven este nombre en la página **Credenciales** y en el panel de cada agente. Pega el **ID del conjunto de datos / píxel** y el **Token de la API de Conversiones**, y haz clic en **Guardar**.

***

#### ⚙️ Parte 2: Configurar tu Text Agent

> Abre tu **Text Agent** → ve a la pestaña **Análisis de conversación** → despliega el panel **Conversiones de Meta Ads**.

La credencial es el interruptor. El panel solo muestra la configuración de conversiones cuando tu espacio de trabajo tiene una credencial de Meta Ads — hasta entonces ofrece **Agregar credencial** y nada más. No hay un interruptor de encendido/apagado aparte. Los miembros que no pueden editar el agente ven **Aún no hay una credencial de Meta Ads en este espacio de trabajo.** en lugar del botón.

**Paso 1:** Conecta la credencial, o confirma que ya está. Si el panel muestra **Agregar credencial**, haz clic, completa el mismo diálogo de la Parte 1 y haz clic en **Guardar**. Una vez conectada, el panel muestra el nombre de la credencial con una marca de verificación.

> 💡 Si el panel dice **No pudimos comprobar tus credenciales de Meta Ads.**, haz clic en **Inténtalo de nuevo** — la consulta falló; no significa que no tengas credencial.

**Paso 2:** Elige el **Evento de conversión** que mejor describe tu objetivo. Elegir un evento es lo que activa las conversiones para este agente. Selecciona **uno** de la lista:

* **Lead** — el contacto expresó interés o envió su información
* **Contacto** (Contact) — el contacto se comunicó para obtener más información
* **Agendamiento** (Schedule) — el contacto agendó una cita
* **Registro completado** (CompleteRegistration) — el contacto completó un proceso de registro
* **Solicitud enviada** (SubmitApplication) — el contacto aplicó a un producto o servicio

> 💡 **Consejo:** Estos son los eventos estándar de generación de leads de Meta — le indican a Meta qué tipo de acción del usuario optimizar. Solo estos cinco eventos están disponibles, para que la optimización de tus anuncios se enfoque en resultados de generación de leads y no se mezcle con señales de e-commerce.

**Paso 3:** (Opcional) Completa el campo **Cuándo contarlo como conversión**. Es una instrucción corta que le dice a la IA de Dapta cuándo una conversación finalizada califica como el evento que seleccionaste. El campo empieza vacío: si lo dejas vacío, Dapta aplica su regla incorporada para el evento que elegiste; escribe tu propia regla cuando tu caso de uso necesite una definición más específica.

Los cambios en este panel se guardan automáticamente: el evento apenas lo eliges y la regla cuando haces clic fuera del campo. No hay botón **Guardar**.

**Para desactivarlo:** borra el campo **Evento de conversión**. El agente deja de reportar conversiones y la regla que escribiste se conserva — al elegir un evento de nuevo se reactiva con la misma regla.

**Para quitar la credencial:** haz clic en **Quitar** junto al nombre de la credencial y confirma con **Quitar credencial**. Esto elimina la credencial de todo el espacio de trabajo y borra el evento y la regla de este agente. Los demás agentes y flujos conservan su configuración, pero dejan de reportar conversiones a menos que tu espacio de trabajo tenga otra credencial de Meta Ads activa.

***

#### 💡 Para tener en cuenta

**Cómo funciona la detección de conversiones:** Solo las conversaciones que comenzaron desde un anuncio Click-to-WhatsApp llevan el identificador de clic que Meta requiere. Cuando termina una conversación que califica, la IA de Dapta revisa su análisis posterior a la conversación — el resumen, las variables y la evaluación — frente a tu regla. Si el objetivo se cumplió, se envía **un** evento de conversión a Meta por esa sesión de conversación; un mecanismo de deduplicación evita el doble conteo, aunque la sesión se procese más de una vez. Si el mismo contacto inicia después una nueva sesión desde otro clic en un anuncio, esa sesión puede reportar su propia conversión.

**Atribución:** Dapta envía cada evento con el identificador de clic del anuncio que inició la conversación. La ventana de atribución se define en la configuración de tus anuncios en Meta, no en Dapta.

**Ver qué anuncio inició cada conversación:** En tu **Inbox**, las conversaciones que provienen de un anuncio Click-to-WhatsApp muestran un pequeño **distintivo de Facebook**. Puedes filtrar el inbox por anuncio para revisar las conversaciones que generó cada campaña.

***

{% content-ref url="/pages/oI6sTdGOQeNtnhGHkqgJ" %}
[Conecta tu Agente con WhatsApp](/dapta-docs-es/agentes-de-texto/canales/conecta-tu-agente-con-whatsapp.md)
{% endcontent-ref %}


---

# 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.dapta.ai/dapta-docs-es/integraciones/meta-ads-conversions.md?ask=<question>&goal=<endgoal>
```

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