> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversión de Meta

> Reporta eventos de conversión a la API de Conversiones de Meta para medir el retorno de tus anuncios Click-to-WhatsApp.

El nodo **Conversión de Meta** envía un evento de conversión (por ejemplo, una compra o un lead) a la **API de Conversiones de Meta** desde tu flujo. Así Meta sabe qué anuncios Click-to-WhatsApp generan resultados y puedes medir su retorno de inversión.

> [card] [Documentación de Meta](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging)
>
> Conversions API para Business Messaging.

***

## Cuándo usarlo

Colócalo en el punto del flujo donde ocurre la conversión. Casos comunes:

* Confirmación de una compra o un pago
* Registro de un lead calificado
* Agendamiento de una cita o demostración
* Suscripción o inicio de una prueba

## Requisitos

* Canal de WhatsApp conectado mediante **WhatsApp Cloud API** (no aplica a sandbox ni a otros proveedores).
* Conversaciones que lleguen desde un anuncio **Click-to-WhatsApp**. El identificador del clic debe estar guardado en la memoria de la conversación. Consulta [Meta Ads](https://docs.jelou.ai/guides/integraciones/marketing/meta-ads.md) para ver cómo se guarda.
* El reporte de conversiones activo en el canal (viene desactivado por defecto). Para activarlo, ve a la edición del canal de WhatsApp y usa el switch **Conversiones de Meta (CAPI)**.

***

## Configuración

### General

| Campo | Obligatorio | Detalle |
| - | - | - |
| **Evento** | Sí | Evento de conversión que se reporta a Meta. El selector admite búsqueda. |
| **Moneda** | Solo en `Purchase` | `USD`, `COP`, `MXN`, `PEN`, `ARS`, `CLP`, `BRL` o `EUR`. |
| **Valor** | Solo en `Purchase` | Número mayor o igual a 0, o una variable como `{{$memory.total}}`. |
| **Parámetros adicionales** | No | Pares clave/valor con información extra del evento. Máximo 10. |

Eventos disponibles: `AddPaymentInfo`, `AddToCart`, `AddToWishlist`, `CompleteRegistration`, `Contact`, `CustomizeProduct`, `Donate`, `FindLocation`, `InitiateCheckout`, `Lead`, `Purchase`, `Schedule`, `Search`, `StartTrial`, `SubmitApplication`, `Subscribe` y `ViewContent`.

> [!NOTE]
>
> Meta solo exige moneda y valor en el evento `Purchase`. En los demás eventos son opcionales, pero si completas el valor debe ser válido.

### Avanzado

| Campo | Obligatorio | Detalle |
| - | - | - |
| **ID de Click-to-WhatsApp** | Sí | Identificador del clic en el anuncio. Acepta variables, por ejemplo `{{$memory._referral.ctwa_clid}}`. |

El evento se envía con el canal de WhatsApp Cloud API del proyecto y se firma como **JELOU**.

***

## Salidas

| Salida | Cuándo se activa |
| - | - |
| **Reportado** | El evento se reportó correctamente a Meta. |
| **Error** | Falló el reporte del evento. |

El nodo no tiene una salida por defecto: conecta ambas salidas para controlar qué ocurre en cada caso.

## Estado del nodo

El nodo muestra **Listo para reportar** cuando la configuración está completa y **Falta configurar** cuando falta algún dato. Estos son los errores más comunes:

* El **ID de Click-to-WhatsApp** está vacío.
* El evento es `Purchase` y falta la moneda o el valor.
* Una fila de parámetros adicionales tiene solo la clave o solo el valor.

> [!TIP]
>
> Usa la salida **Error** para guardar el fallo en una variable o avisar a tu equipo, y así no perder conversiones sin darte cuenta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.