Quando uma venda é fechada no CRM, o Meta (Facebook e Instagram) não fica sabendo. Sem essa informação, o algoritmo dos anúncios continua otimizando por cliques e conversas, e não por quem de fato comprou. O app Pixel e API de Conversões do Meta leva essas vendas, e outros momentos do seu funil, do CRM até o Meta, para que os anúncios aprendam com quem realmente compra.
Onde encontrar (caminho até a tela):
- Pixel do Meta: Marketing › Pixel do Meta
- Ação nas automações: Automações › Gatilhos › (gatilho) › Enviar evento ao Meta
É um app da Loja de Apps e precisa estar ativo (veja Como ativar um app). A permissão para usar a página é Gerenciar pixels do Meta.
Como funciona, em resumo
- Você cadastra o pixel (o ID e o token da API de Conversões, que vêm do Gerenciador de Eventos do Meta).
- Em uma automação do CRM, você usa a ação Enviar evento ao Meta, escolhendo o pixel e o evento (por exemplo, Compra quando uma oportunidade é ganha).
- Quando a automação dispara, o sistema envia o evento ao Meta com os dados do contato protegidos por criptografia (hash), para o Meta casar a pessoa com o anúncio que ela viu.
- Você acompanha cada envio na aba Relatório.
Aba Pixels

A tabela mostra Nome, ID do pixel, o Token (só os últimos caracteres, por segurança), a Moeda e a Situação. Nas ações há três botões: enviar um evento de teste (o triângulo), editar e excluir.
Cadastrar um pixel

| Campo | Para que serve |
|---|---|
| Nome | Só para você identificar, por exemplo Loja SP. Mínimo de 2 caracteres |
| ID do pixel | Só números. Vem do Gerenciador de Eventos do Meta |
| Moeda | Três letras. O padrão é BRL |
| Token da Conversions API | Gerado no Gerenciador de Eventos › seu conjunto de dados › Configurações › Conversions API › Gerar token de acesso. Ao editar, deixe em branco para manter o token atual |
| Código de evento de teste (opcional) | Da aba Testar eventos do Meta. É usado só no botão de teste, nunca nos envios reais |
| Pixel ativo | Desligue para pausar o pixel sem excluí-lo |
Pode haver vários pixels na mesma conta, por exemplo um por loja ou por marca. Excluir um pixel faz as automações que o usam pararem de enviar eventos.
Testar antes de usar
Cadastre o código de evento de teste e clique no botão de teste para enviar um evento de verificação. Ele aparece na aba Testar eventos do Meta. Sem o código, o botão fica desativado.
Os eventos
| Evento | Quando faz sentido |
|---|---|
| Compra | Uma oportunidade foi ganha. É o único que leva o valor da venda |
| Lead | Um contato novo demonstrou interesse |
| Lead qualificado | O contato passou pela sua qualificação |
| Agendamento | Uma reunião ou visita foi marcada |
Esses quatro eventos já vêm prontos. Para outros momentos do seu funil, use os eventos personalizados.
Aba Eventos personalizados

O Meta aceita qualquer nome de evento. Cadastre aqui os seus para reutilizar nas automações sem digitar de novo: usar um nome diferente a cada disparo fragmenta os dados no Gerenciador de Eventos.
- Nome do evento: sem espaço nem acento, começando por letra, com letras, números e sublinhado (_). Exemplos:
OrcamentoAprovado,VisitaAgendada. O nome vai exatamente assim para o Meta. - Descrição: só para você lembrar. Não vai para o Meta.
- Disponível nas automações: desligue para tirar o evento da lista sem apagar.
- Não dá para cadastrar um nome igual a um dos eventos prontos (Compra, Lead, Lead qualificado, Agendamento) nem repetido.
Aba Relatório

Cada tentativa de envio fica registrada, com Data, Evento, Contato, Valor, Pixel, Situação e Motivo. Use o filtro Situação para ver só um tipo.
| Situação | O que significa |
|---|---|
| Enviado | O Meta recebeu o evento |
| Na fila | Aguardando o envio |
| Recusado | O Meta recusou. O Motivo mostra o porquê, por exemplo Invalid OAuth access token (token inválido ou vencido) |
| Sem dados | O contato não tinha informação suficiente (e-mail ou telefone) para o Meta identificar a pessoa. O evento não foi enviado |
| App inativo | O app estava desativado no momento do envio |
Enviado quer dizer que o Meta recebeu o evento, não que ele casou com uma pessoa. Quanto mais completos os dados do contato (telefone e e-mail), maior a chance de o Meta identificar quem foi.
Usar nas automações
Em Automações › Gatilhos, adicione a ação Enviar evento ao Meta (grupo Marketing) e escolha o Pixel e o Evento (os personalizados aparecem em um grupo separado). A ação só aparece em gatilhos de oportunidade e quando o app está ativo. Veja Automações do CRM.
- Compra: use o gatilho Mudou de status com a condição Situação é igual a Ganha.
- Lead: use o gatilho Oportunidade criada.
- Agendamento e Lead qualificado: use Mudou de etapa, com a etapa correspondente.
Perguntas frequentes
Preciso ter o pixel instalado no site?
Este app usa a API de Conversões, que envia os eventos direto do servidor, a partir do CRM. Ele complementa o pixel do site; não depende dele.
O relatório mostra Recusado com token inválido.
O token do pixel está errado ou expirou. Gere um novo no Gerenciador de Eventos e cole em Editar pixel.
Muitos eventos aparecem como Sem dados.
Os contatos não têm e-mail nem telefone utilizáveis. Complete o cadastro dos contatos.
O Meta recebeu, mas não vejo conversões nos anúncios.
O Meta leva um tempo para processar e só atribui quando consegue casar o contato com um anúncio que ele viu. Confira o Gerenciador de Eventos.
Posso usar vários pixels?
Sim. Cadastre cada um e escolha o pixel na ação da automação.
O código de evento de teste vai nos envios reais?
Não. Ele só é usado no botão de teste.