Como funciona a integração com o Facebook (Meta)
Atualizado em 11/11/2026
A integração com o Facebook conecta a loja à Meta, a empresa dona do Facebook e do Instagram. Ela envia os eventos da loja (visitas, carrinhos, etapas do checkout e compras) para a Meta, que usa esses dados para medir o resultado dos anúncios e melhorar a entrega das campanhas.
Você a encontra em Marketing & SEO > Integrações > Facebook.
A integração tem quatro partes, cada uma com a própria tela no menu da integração: Pixel, API de Conversão, API de Catálogo e Meta Ads (Campanhas). A primeira tela, Visão geral, lista as quatro com um selo de estado e o botão Configurar, então é por ela que você confere de relance o que já está funcionando.
- Selo verde — a parte está ligada e completa ("Ativo" ou "Ativa").
- Selo amarelo — a parte foi configurada, mas falta algo para funcionar, como "Autorização vencida", "Falta o pixel", "Falta o catálogo" ou "Falta a conta de anúncios".
- Selo cinza — a parte está desligada ou ainda não foi configurada.
O ID do Pixel vem do Gerenciador de Eventos da Meta. A API de Conversão, a API de Catálogo e o Meta Ads se conectam pela tela de autorização da própria Meta, sem copiar nenhum token.
Pixel
O Pixel é o rastreamento que roda no navegador do cliente. É ele que registra cada passo da visita e permite, por exemplo, criar públicos de quem viu um produto mas não comprou.
- Carregar o Pixel na loja — liga o Pixel. Desligado, a loja deixa de enviar eventos à Meta pelo navegador.
- ID do Pixel — o número que aparece ao lado do nome do pixel no Gerenciador de Eventos. A tela guarda só os números, então espaços ou letras coladas junto são descartados.
- Enviar os eventos da visita — desligado, o Pixel registra só a visita de página, sem a busca, o produto visto, o carrinho e a compra. Na prática, deixe ligado: são esses eventos que permitem medir vendas e montar públicos.
Logo abaixo, a seção Eventos enviados mostra quais eventos o Pixel envia, agrupados em navegação, funil e checkout.
A tela não deixa ligar o Pixel com o ID do Pixel vazio. Nesse caso, ela não grava nada e mostra o aviso "Informe o ID do Pixel para ativar." ao lado do campo.
API de Conversão
Aqui está a parte que mais gera dúvida, então vale entender o porquê. O navegador é um mensageiro que às vezes não entrega: bloqueadores de anúncio, as proteções de privacidade do iPhone e a remoção de cookies fazem o Pixel falhar em parte das visitas. Quando isso acontece, a Meta não sabe que a venda veio dela e para de otimizar bem as campanhas.
A API de Conversão envia os eventos pelo servidor da loja, por um caminho que o navegador não bloqueia. Os dados do cliente são protegidos por hash (embaralhados) antes do envio. Ela reforça os eventos mais importantes (cadastro, contato, etapas do checkout e compra), que a seção Eventos enviados da tela lista.
Para conectar:
- Clique em Conectar API e entre com a sua conta do Facebook.
- Na tela de autorização da Meta, escolha o portfólio empresarial e o pixel da loja e confirme. De volta ao painel, o botão passa a se chamar Reconectar, para trocar de conta ou liberar outro pixel.
- Clique em Carregar pixels, escolha o pixel da loja na lista e grave.
- Enviar os eventos pelo servidor — liga a API. Desligada, os eventos chegam à Meta só pelo Pixel do navegador.
- Pixel — o pixel que recebe os eventos do servidor. Ele já vem com o ID da tela Pixel, e o ideal é manter o mesmo: com o mesmo pixel nos dois caminhos, a Meta reconhece o evento do navegador e o do servidor como um só. O Carregar pixels lista pelo nome os pixels do portfólio que você liberou na tela de autorização da Meta. Se a lista não carregar, clique em Reconectar e autorize de novo: as conexões feitas antes da lista não liberam a leitura dos pixels.
A tela não deixa ligar a API sem a conexão ("Clique em Conectar API antes de ativar.") nem sem um pixel ("Informe o ID do Pixel para ativar."). Se a Meta recusar a autorização depois, a loja desliga a API sozinha e avisa para clicar em Conectar API de novo.
Token colado (versão antiga)
As lojas que conectaram antes do Conectar API colaram um token gerado no Gerenciador de Eventos, e ele continua funcionando. Para essas lojas, a tela mostra o campo Forma de conexão, com as opções Aplicativo Braavo! (recomendado) e Token colado (versão antiga). Ao trocar para o aplicativo, o token colado fica guardado, e você pode voltar a ele quando quiser.
- Token de acesso — gerado no Gerenciador de Eventos, nas configurações do pixel, na seção da Conversions API. Por segurança, o campo sempre aparece vazio: depois de gravado, a tela mostra só "Chave gravada, terminada em" e os últimos caracteres do token. Para trocar, cole o novo token; deixar o campo em branco mantém o token atual.
Os eventos enviados pelo token vão para o pixel informado na tela Pixel. Por isso, preencha primeiro o ID do Pixel: sem ele, o selo da API de Conversão fica amarelo, com "Falta o pixel". A tela também não deixa ligar a API sem um token gravado, e mostra "Informe o token para ativar a integração.".
O Token aparece uma única vez, no momento em que é gerado. Copie e guarde com cuidado, porque depois a Meta não mostra o valor de novo.
Usar o Pixel e a API de Conversão juntos é a recomendação da própria Meta. Quando um bloqueador impede o Pixel, a API garante que a compra ainda seja contabilizada, e a Meta reconhece o mesmo evento pelos dois caminhos sem contar em dobro.
Atenção: a loja já sai com Pixel e API de Conversão funcionando em conjunto, então evite ligar o Conversions API Gateway (Gateway da API de Conversões) por fora, no Gerenciador da Meta. Ele reenvia os mesmos eventos com outra identificação, a Meta não consegue casar os dois envios e os números aparecem em dobro nos relatórios.
API de Catálogo
Os anúncios dinâmicos são aqueles que mostram automaticamente os produtos da loja para quem demonstrou interesse. Eles usam o catálogo da Meta, que o feed de produtos atualiza inteiro algumas vezes por dia. A API de Catálogo complementa o feed: quando um produto esgota, ela avisa a Meta na hora e o marca como fora de estoque, sem esperar a próxima leitura do feed.
- Clique em Conectar API e, na tela de autorização da Meta, libere o portfólio dono do catálogo da loja. Depois de conectado, o botão passa a se chamar Reconectar, para trocar de conta ou renovar a autorização.
- Na seção Catálogo, clique em Carregar catálogos e escolha o catálogo na lista. O nome da empresa dona aparece na frente, porque o mesmo nome de catálogo costuma se repetir entre portfólios.
- Confira se Atualizar o catálogo da Meta na hora está ligado (a conexão já o liga) e grave.
A tela não deixa ligar a API sem a conexão ("Clique em Conectar API antes de ativar.") nem sem o catálogo escolhido ("Escolha o catálogo para ativar."). Se a lista de catálogos não carregar por falta de permissão, clique em Reconectar: a nova autorização libera a lista.
Atenção: se a Meta recusar a autorização (por vencimento ou por uma permissão retirada), a plataforma desliga a API de Catálogo sozinha. Quando o selo mostrar "Autorização vencida" ou a integração aparecer desligada sem você ter mexido, clique em Reconectar: a nova autorização liga a API de Catálogo de novo. Sem ela, os anúncios dinâmicos podem mostrar itens esgotados até a próxima leitura do feed.
Meta Ads (Campanhas)
Esta parte traz o investimento, os cliques e as conversões das campanhas para a tela Marketing & SEO > Campanhas, para você acompanhar o resultado dos anúncios sem sair do painel. A Braavo só lê os números das campanhas, e essa autorização é separada das conexões do Pixel, da API de Conversão e da API de Catálogo: conectar uma não conecta as outras.
- Clique em Conectar Meta Ads e entre com a conta da Meta que tem acesso às contas de anúncios da loja.
- Na seção Conta de anúncios, clique em Carregar contas e escolha a conta que a tela de Campanhas vai acompanhar.
- Confira se Acompanhar as campanhas no painel está ligado (a conexão já o liga) e grave.
Assim como no catálogo, a tela não deixa ligar sem a conexão ("Clique em Conectar Meta Ads antes de ativar.") nem sem a conta escolhida ("Escolha a conta de anúncios para ativar."). Quando a autorização vence, o selo fica amarelo, com "Autorização vencida", e basta clicar em Reconectar.