> 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/ctwa-offline-conversions.md). # Como adicionar eventos de mensagens (business messaging) ao seu dataset de site Este é o caminho para equipes que **já têm um dataset de site** e querem usá-lo também para CTWA, em vez de um dataset de mensagens separado. (Se você não tem um dataset apto para mensagens, a Patagon AI cria um para você automaticamente — veja [O dataset que suas conversões de CTWA precisam](/marketing-e-atribuicao/meta-ads/meta-conversions-api.md#o-dataset-que-suas-conversoes-de-ctwa-precisam).) Se você está rodando anúncios **Click-to-WhatsApp (CTWA)** e seu dataset foi criado originalmente para eventos **web** (ou é um dataset genérico), a Meta vai rejeitar as conversões CTWA mesmo depois de você conectar o dataset no Patagon e no Events Manager. O erro que aparece é: *"o identificador do conjunto de dados deve ter uma conta do WhatsApp Business associada"*. A correção **não** é trocar o dataset, pois seu dataset de site atual está ok. Você precisa **adicionar uma fonte de dados de Mensagens** que conecte sua Página do Facebook (e através dela, sua WABA) a esse mesmo dataset. Depois disso, o dataset terá sinais web e de mensagens, e as conversões CTWA serão aceitas. Você só precisa fazer isso uma vez por dataset. {% hint style="info" %} Esta é a parte específica de CTWA, complementar à configuração principal. Se ainda não fez, conclua primeiro [Como conectar a Meta e mapear conversões](/marketing-e-atribuicao/meta-ads/meta-conversions-api.md), pois esta página continua de lá. {% endhint %} ## Pré-requisitos * Você já conectou a Meta no Patagon (a parte "do lado do Patagon" em [Como conectar a Meta e mapear conversões](/marketing-e-atribuicao/meta-ads/meta-conversions-api.md)). * A Página do Facebook que você vai conectar é **a mesma à qual sua WABA está vinculada** em Configurações do Negócio Meta → Contas do WhatsApp. Se você conectar uma Página diferente, a Meta criará o vínculo com sucesso mas as conversões CTWA continuarão falhando. * Acesso de administrador no Meta Business Manager. ## Passo 1. Abra seu dataset no Events Manager Vá em [Meta Events Manager](https://business.facebook.com/events_manager) e abra o dataset que você selecionou no Patagon (o que recebe suas conversões CTWA). ![Abrir o dataset no Events Manager](/files/6c7kZ4p6qNavsscoAOrR) ## Passo 2. Conecte uma nova fonte de dados: escolha Mensagens No dataset, clique em **Adicionar eventos** (ou no botão verde **Criar**) → **Conectar uma nova fonte de dados**. Escolha **Mensagens** como tipo de fonte. Esse é o passo que a maioria dos clientes pula. Fontes de dados web e CRM não atendem ao requisito de WABA da Meta para CTWA; apenas Mensagens atende. ![Conectar uma nova fonte de dados: Mensagens](/files/As2pOiRVoiPlXY329mr5) ## Passo 3. Conecte uma Página do Facebook Para compartilhar dados de chats de negócio você precisa conectar uma Página do Facebook ou um perfil do Instagram. **Escolha Página do Facebook**, pois a Conta do WhatsApp Business é vinculada à Meta através da Página, não diretamente. ![Escolha Página do Facebook ou Instagram](/files/NxxKUqXZEZfMGMOyRaI1) ## Passo 4. Selecione a Página vinculada à sua WABA Escolha a Página do Facebook à qual sua WABA do Patagon está vinculada. Se não tiver certeza de qual é, vá em **Configurações do Negócio Meta → Contas do WhatsApp**, abra sua WABA e veja qual Página está associada ao número de telefone que o Patagon está usando. {% hint style="warning" %} A Página que você escolher **deve** ser aquela à qual sua WABA está conectada. Se você conectar uma Página diferente, a Meta vai criar o vínculo com sucesso mas as conversões CTWA continuarão falhando. {% endhint %} ![Selecione a Página do Facebook vinculada à sua WABA](/files/5bCVuR8hWfVr4jhyeHVk) ## Passo 5. Configurar com dados existentes: escolha seu dataset atual A Meta vai oferecer **criar um novo dataset** ou **configurar com dados existentes**. Escolha **Configurar com dados existentes** e selecione o **mesmo dataset** que você conectou no Patagon. Isso é o que combina seus eventos de mensagens no dataset que já recebe seus eventos web. Se você criar um novo dataset aqui, vai ter dois datasets desconectados e sua conexão do Patagon vai continuar enviando para o errado. ![Configurar com dados existentes: escolha seu dataset](/files/aW36DFVmMQBnzdoUYXnO) ## Passo 6. Conecte sua conta do Instagram (opcional) A Meta vai oferecer também conectar uma conta do Instagram. É opcional e só importa se você também roda anúncios Click-to-Instagram. Caso contrário, pule. ![Opcional: conectar Instagram](/files/FA62NNKNkmgGVG5LOyxV) ## Passo 7. Confirme o vínculo Você deve ver uma confirmação de que seus dados de eventos agora estão vinculados à sua Página e dataset. ![Vínculo concluído](/files/lb4QAl4wV8NhZSGvQ7Q0) ## Passo 8. Escolha o caminho: Integração direta Quando perguntarem como enviar os eventos, escolha **Integração direta**. O Patagon envia eventos diretamente para a API de Conversões da Meta, então você não precisa de uma integração com partner. ![Escolha Integração direta](/files/s7854Kc0m3x6AoYABPaC) ## Passo 9. Selecione os eventos que o Patagon vai enviar Selecione **Purchase** e **LeadSubmitted**. O Patagon envia `LeadSubmitted` para cada lead qualificado de CTWA, e `Purchase` se você configurou um mapeamento de evento de compra. Mantenha todos os parâmetros obrigatórios marcados, pois o Patagon preenche automaticamente. ![Selecione Purchase e LeadSubmitted](/files/F0NAWDZRFVN259QAfXKG) ## Passo 10. Revise e confirme Revise a lista de parâmetros para cada evento e clique em **Confirmar configuração**. Os parâmetros obrigatórios da Meta (action\_source, event\_name, event\_time, messaging\_channel, page\_id, além do Click to WhatsApp ID e do Page Scoped User ID) são exatamente os que o Patagon envia. ![Revisar configuração](/files/QAqprThbASAq4OSL90aa) ## Passo 11. Verifique se o dataset está vinculado De volta na aba **Configurações** do dataset, agora você deve ver sua Página do Facebook (e Instagram, se conectou) em **Dados vinculados**. Através dessa Página, sua WABA fica associada ao dataset. ![Dados vinculados ao dataset](/files/bBUNAgsorWqVZwCCTfdw) Envie uma conversão CTWA de teste do Patagon (ou aguarde o próximo lead qualificado). Em \~1 minuto ela deve aparecer no Events Manager → **Test events** ou **Visão Geral**, sem o erro de associação da WABA. --- # 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/ctwa-offline-conversions.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.