Meta Conversions API
Meta Conversions API
O módulo Meta Conversions API ajuda você a registrar conversões que acontecem durante a conversa (como compra, lead ou avaliação) e enviar essas informações para a Meta. Isso melhora a atribuição e a otimização das campanhas.

Como acessar
No menu lateral, clique em Bot.
Acesse Fluxos.
Abra um fluxo existente ou crie um novo.
No construtor, localize o módulo Meta Conversions API na lista de módulos.
Arraste o módulo para o diagrama e abra a configuração.

Se você estiver conhecendo o construtor agora, vale revisar primeiro a tela de gerenciamento de fluxos no módulo Fluxos e depois voltar para concluir a configuração deste módulo.
Conhecendo a tela
Cabeçalho do módulo
No topo da janela, você vê o nome do módulo e etiquetas dos canais suportados (WhatsApp, Instagram e Messenger). Logo abaixo, há uma explicação curta sobre o envio de conversões.
Bloco de orientação
Você encontra um bloco informativo explicando, em passos simples, como a conversão acontece desde o clique no anúncio até o envio do evento.
Esse bloco ajuda a validar se você está configurando o módulo no momento certo do fluxo.
Também existe um link para a documentação oficial da Meta, abrindo em nova guia.
Evento de conversão
Aqui você escolhe qual tipo de evento será enviado. A lista vem organizada por grupos para facilitar a seleção.
Evento de conversão
Selecione a ação que aconteceu na conversa (ex.: compra, início de checkout, pedido entregue, lead qualificado, avaliação)
Dados customizados (JSON)
Nesta área, você informa os dados que acompanham o evento, como valor, moeda e outros detalhes relevantes.
Dados customizados
Estruture os dados da conversão no formato esperado, incluindo valores importantes para a análise (ex.: moeda e valor)
Exemplo
Geração automática de exemplos do payload para o evento selecionado.
Saídas no diagrama (OK e ERRO)
No cartão do módulo dentro do diagrama, existem duas saídas:
OK: segue para o próximo passo quando o envio funciona.
ERRO: segue para um caminho de tratamento quando o envio falha.
Ações principais
1️⃣ Selecionar o evento de conversão
🎯 Propósito Definir exatamente qual ação do cliente será enviada para a Meta.
✅ Como fazer na tela
Abra o módulo Meta Conversions API no diagrama.
No campo Evento de conversão, clique para abrir a lista.
Escolha o evento que representa a ação do cliente.
📌 Resultado esperado O evento escolhido fica visível no módulo e será usado no envio da conversão.
2️⃣ Gerar um exemplo automático de dados
🎯 Propósito Preencher rapidamente uma estrutura inicial de dados para acelerar a configuração.
✅ Como fazer na tela
Primeiro selecione um Evento de conversão.
Clique no botão Exemplo ao lado de Dados personalizados.
Ajuste os valores exibidos conforme a necessidade do seu fluxo.
📌 Resultado esperado O editor recebe um modelo pronto de dados, que você pode adaptar antes de salvar.
3️⃣ Configurar e salvar dados personalizados
🎯 Propósito Garantir que o evento seja enviado com os detalhes corretos da conversão.
✅ Como fazer na tela
No editor Dados personalizados, informe os dados da conversão.
Quando necessário, use variáveis do fluxo para preencher valores dinâmicos.
Revise as informações e salve a configuração do módulo.
📌 Resultado esperado O módulo fica pronto para enviar o evento com os dados definidos por você.
4️⃣ Tratar sucesso e falha no fluxo
🎯 Propósito Controlar o que acontece após o envio da conversão, tanto em caso de sucesso quanto de erro.
✅ Como fazer na tela
No diagrama, conecte a saída OK para o próximo passo desejado.
Conecte a saída ERRO para um caminho de tratamento (ex.: aviso interno ou nova tentativa).
Teste o fluxo para validar os dois caminhos.
📌 Resultado esperado O fluxo continua de forma previsivel, com caminho definido para sucesso e para falha.
Antes de usar o módulo Meta Conversions API, é necessário que o identificador do conjunto de dados esteja disponível para o número de WhatsApp conectado.
O que precisa existir antes: canal de WhatsApp configurado e apto para uso.
Onde configurar: Canais > WhatsApp > Número > Conversions API.
Como voltar para concluir: após validar a configuração do canal, retorne para Bot > Fluxos, abra o fluxo e finalize o módulo.

Dicas úteis
Escolha sempre o evento que mais representa a ação real do cliente na conversa.
Para eventos com valor financeiro, revise moeda e valor antes de salvar.
Use o botão Exemplo como ponto de partida, depois adapte para sua realidade.
Conecte sempre as duas saídas do módulo para evitar fluxo sem tratamento de erro.
Resumo
O módulo Meta Conversions API envia eventos de conversão da conversa para a Meta.
Você define o tipo de evento e os dados personalizados em uma única configuração.
O botão Exemplo acelera o preenchimento inicial dos dados.
As saídas OK e ERRO permitem controlar o próximo passo do fluxo com segurança.
Com os pré-requisitos do canal em dia, a configuração fica simples e pronta para operação.
Last updated