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

# Conversão da Meta

> Reporte eventos de conversão à API de Conversões da Meta para medir o retorno dos seus anúncios Click-to-WhatsApp.

O nó **Conversão da Meta** envia um evento de conversão (por exemplo, uma compra ou um lead) à **API de Conversões da Meta** a partir do seu fluxo. Assim, a Meta sabe quais anúncios Click-to-WhatsApp geram resultados e você pode medir o retorno do investimento.

> [card] [Documentação da Meta](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging)
>
> Conversions API para Business Messaging.

***

## Quando usar

Coloque-o no ponto do fluxo em que a conversão acontece. Casos comuns:

* Confirmação de uma compra ou de um pagamento
* Registro de um lead qualificado
* Agendamento de uma consulta ou demonstração
* Assinatura ou início de um período de teste

## Requisitos

* Canal de WhatsApp conectado via **WhatsApp Cloud API** (não se aplica a sandbox nem a outros provedores).
* Conversas que cheguem de um anúncio **Click-to-WhatsApp**. O identificador do clique deve estar salvo na memória da conversa. Consulte [Meta Ads](https://docs.jelou.ai/pt/guias/integracoes/marketing/meta-ads.md) para ver como ele é salvo.
* O reporte de conversões ativo no canal (vem desativado por padrão). Para ativá-lo, abra a edição do canal de WhatsApp e use o switch **Conversões da Meta (CAPI)**.

***

## Configuração

### Geral

| Campo | Obrigatório | Detalhe |
| - | - | - |
| **Evento** | Sim | Evento de conversão reportado à Meta. O seletor permite busca. |
| **Moeda** | Somente em `Purchase` | `USD`, `COP`, `MXN`, `PEN`, `ARS`, `CLP`, `BRL` ou `EUR`. |
| **Valor** | Somente em `Purchase` | Número maior ou igual a 0, ou uma variável como `{{$memory.total}}`. |
| **Parâmetros adicionais** | Não | Pares chave/valor com informações extras do evento. Máximo de 10. |

Eventos disponíveis: `AddPaymentInfo`, `AddToCart`, `AddToWishlist`, `CompleteRegistration`, `Contact`, `CustomizeProduct`, `Donate`, `FindLocation`, `InitiateCheckout`, `Lead`, `Purchase`, `Schedule`, `Search`, `StartTrial`, `SubmitApplication`, `Subscribe` e `ViewContent`.

> [!NOTE]
>
> A Meta só exige moeda e valor no evento `Purchase`. Nos demais eventos eles são opcionais, mas, se você preencher o valor, ele deve ser válido.

### Avançado

| Campo | Obrigatório | Detalhe |
| - | - | - |
| **ID do Click-to-WhatsApp** | Sim | Identificador do clique no anúncio. Aceita variáveis, por exemplo `{{$memory._referral.ctwa_clid}}`. |

O evento é enviado pelo canal de WhatsApp Cloud API do projeto e assinado como **JELOU**.

***

## Saídas

| Saída | Quando é ativada |
| - | - |
| **Reportado** | O evento foi reportado com sucesso à Meta. |
| **Erro** | O reporte do evento falhou. |

O nó não tem uma saída padrão: conecte as duas saídas para controlar o que acontece em cada caso.

## Estado do nó

O nó mostra **Pronto para reportar** quando a configuração está completa e **Falta configurar** quando algum dado está faltando. Estes são os erros mais comuns:

* O **ID do Click-to-WhatsApp** está vazio.
* O evento é `Purchase` e falta a moeda ou o valor.
* Uma linha de parâmetros adicionais tem apenas a chave ou apenas o valor.

> [!TIP]
>
> Use a saída **Erro** para guardar a falha em uma variável ou avisar sua equipe, e assim não perder conversões sem perceber.


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