> 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/marketing-e-atribuicao/meta-ads/meta-conversions-api.md). # Como conectar a Meta e mapear conversões Consulte as definições no [sistema de classificação de leads da ILA](/otimizacao-do-agente/ila-rating-system.md). Quando um lead é qualificado no WhatsApp, a Patagon AI pode enviar essa conversão de volta para sua plataforma de anúncios. Isso permite que o modelo de otimização da plataforma aprenda com seus leads *qualificados* em vez de cada resposta, melhorando o desempenho dos anúncios Click-to-WhatsApp (CTWA) com o tempo. A **Meta** é a plataforma suportada hoje. Google Ads, TikTok Ads, LinkedIn Ads, Snapchat Ads e X Ads estão em breve. ## Pré-requisitos * Uma conta de anúncios da Meta ativa * WhatsApp conectado e seu agente ativo na Patagon AI * Acesso de administrador no Meta Business Manager ## 1. Conecte a Meta 1. Vá em **Leads → Atribuição → Configurações → Conectar Plataformas**. 2. Em **Meta Business**, clique em **Conectar** e complete o fluxo de OAuth. ![Conectar Plataformas](/files/bpVbqLRQ6CbHR6Icin9b) 3. Em **Configurar Integração da Meta**, escolha: * **Conta de Anúncios** — a conta que roda suas campanhas. * **Pixel / Dataset** — para onde as conversões serão enviadas (geralmente seu dataset da Meta Conversions API). 4. Clique em **Salvar**. ![Configurar Integração da Meta](/files/dO2dvdDunGSWghOTT0RC) {% hint style="info" %} A conexão da Meta é configurada **por agente**, então cada agente pode apontar para sua própria conta de anúncios e dataset. {% endhint %} ### O dataset que suas conversões de CTWA precisam Um **dataset** é onde a Meta coleta os eventos dos seus anúncios. (A Meta costumava chamá-los de "pixels" e a interface ainda diz "Datasets and pixels": é a mesma coisa.) Os eventos que um dataset recebe lhe dão um tipo: * Um **dataset de site (website)** é para jornadas que **começam no seu site**: alguém clica no seu anuncio, chega a uma página e abre o WhatsApp a partir dela — suas campanhas **Landing → WhatsApp**. A conversão ainda acontece na conversa do WhatsApp, mas como a jornada começou na web, a Patagon AI a envia para o seu dataset de site. * Um **dataset de mensagens (business messaging)** é para jornadas que vão **direto para o WhatsApp**, sem página de destino no meio: alguém clica em um anúncio **Click-to-WhatsApp** e cai diretamente em uma conversa. Essas conversões precisam fluir para um dataset de mensagens para que a Meta as atribua corretamente. Ou seja, o que diferencia os dois não é *onde* a conversão acontece — é sempre a conversa do WhatsApp — mas **como a pessoa chegou lá**. Para que a Meta aceite suas conversões de CTWA, elas precisam cair em um dataset capaz de receber **eventos de mensagens (business messaging)**. Há duas formas de ter um: | Sua situação | Como conseguir um dataset apto para mensagens | | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Você **já tem um dataset de site** e quer usá-lo também para CTWA | Adicione uma fonte de dados de Mensagens a ele, **uma única vez**, para que receba **tanto** eventos web quanto de mensagens. Siga [Como adicionar eventos de mensagens (business messaging) ao seu dataset de site](/marketing-e-atribuicao/meta-ads/meta-conversions-api/ctwa-offline-conversions.md). | | Você **não tem um dataset de mensagens** | Quando você ativa o toggle **WhatsApp Business Dataset**, a Patagon AI **cria um para você** — chamado **` - Patagon Event Data`** e com a Patagon AI como proprietária. Veja [Como a Patagon AI cria seu dataset de mensagens (business messaging)](/marketing-e-atribuicao/meta-ads/meta-conversions-api/business-messaging-dataset.md). | {% hint style="info" %} Ative o toggle **WhatsApp Business Dataset** na sua integração da Meta para campanhas **Click-to-WhatsApp** (onde as pessoas chegam ao WhatsApp direto do anúncio, sem página de destino). A Patagon AI detecta automaticamente um dataset apto para mensagens existente e só cria um se você não tiver. **Campanhas Landing → WhatsApp não precisam disso** — elas usam seu dataset de site. Na visão técnica da Meta, os dois tipos de dataset aparecem como `website` e `business_messaging`. {% endhint %} #### Conecte o dataset à sua conta de anúncios Seu dataset de CTWA precisa estar conectado à conta de anúncios que roda essas campanhas — caso contrário, ele não aparecerá quando você criar ou otimizar uma campanha CTWA. Se a Patagon AI criou o dataset para você, conecte-o uma vez você mesmo, no Meta Business Manager: 1. Vá em **Business settings → Data sources → Datasets and pixels** e selecione o dataset chamado **` - Patagon Event Data`**. Abra a aba **Connected assets**. ![Encontre o dataset criado pela Patagon em Datasets and pixels](/files/JgJbJTCtcCmky9EjcMiL) 2. Clique em **Connect assets**. ![Connect assets](/files/NvSpDSMuTxKCZFmSlu4R) 3. Escolha **Ad accounts**, marque a conta de anúncios que você vai usar para suas campanhas CTWA e clique em **Add**. ![Selecione sua conta de anúncios e clique em Add](/files/sjbZNIZKw9bU9HnLCJt6) ## 2. Mapeie conversões Um mapeamento diz à Patagon AI qual evento dentro do produto deve disparar uma conversão e qual ação de conversão enviar para a plataforma de anúncios. 1. Vá em **Leads → Atribuição → Configurações → Mapear Conversões** e clique em **Adicionar mapeamento**. 2. Em **Adicionar Mapeamento de Conversão**, escolha: * **Evento da Patagon AI** — o gatilho, com base na avaliação do lead: `Lead 3 Star`, `Lead 4 Star`, `Lead 5 Star`, `Lead 3+ Star` ou `Lead 4+ Star`. * **Plataforma** — Meta. * **Conta** — a conta da Meta conectada. * **Ação de Conversão** — o evento padrão da Meta a registrar (ex. `Lead`, `Purchase`). 3. Clique em **Criar Mapeamento**. Ele fica ativo para qualquer novo lead que combine com o gatilho. ![Adicionar Mapeamento de Conversão](/files/MiYHqDq9MXGqpdQLdC7r) {% hint style="warning" %} **As conversões CTWA usam um dataset de mensagens (business messaging)** (o action source `business_messaging` da Meta), e a Meta só aceita um conjunto limitado de eventos padrão para ele. Ao mapear conversões para Click-to-WhatsApp, use apenas: `Lead`, `Purchase`, `AddToCart`, `ViewContent`, `InitiateCheckout`. {% endhint %} ## 3. Verifique se está funcionando Você pode confirmar as conversões em dois lugares. **Na Patagon AI** — vá em **Leads → Atribuição → Configurações → Eventos**. Cada linha mostra a data, a plataforma, o evento da Patagon AI que a disparou, o nome da conversão e o status — **Confirmado**, **Pendente** ou **Falhou**. Se uma falhar, use a ação de reenvio para reenviá-la. ![Registro de Eventos de Conversão](/files/OlD0iR0s025Pujq91192) **Na Meta** — abra **Ads Manager → Events Manager → Datasets**, selecione o dataset conectado à Patagon AI e veja a aba **Visão Geral**. As conversões aparecem em cerca de um minuto. ## Erros comuns | Mensagem de erro | O que significa | Como resolver | | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *event\_name "Lead" not valid for business\_messaging* | O evento não é permitido em eventos Click-to-WhatsApp pela Meta. | Mapeie um evento suportado por CTWA (`Lead`, `Purchase`, `AddToCart`, `ViewContent`, `InitiateCheckout`). Se persistir, entre em contato com o suporte. | | *missing page\_id or whatsapp\_business\_account\_id* | A Patagon AI não está enviando o ID da Conta do WhatsApp Business com o evento. | Seu canal do WhatsApp pode não ter concluído o embedded signup corretamente. Refaça o assistente de conexão do WhatsApp. | | *the dataset must have a WhatsApp Business account associated* | O dataset não está vinculado à sua WABA. | Ative o toggle **WhatsApp Business Dataset** (passo 1), ou siga [Como adicionar eventos de mensagens (business messaging) ao seu dataset de site](/marketing-e-atribuicao/meta-ads/meta-conversions-api/ctwa-offline-conversions.md). | | *(#100) OAuthException — Invalid parameter* | O dataset não está vinculado a uma conta de anúncios ativa, ou seu token não tem acesso. | Verifique se o dataset está habilitado no Events Manager, se sua conta de anúncios tem acesso total a ele e se o token OAuth tem o escopo `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/marketing-e-atribuicao/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.