Suporte: seg. a sex., das 9h às 18h

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:

  1. Clique em Conectar API e entre com a sua conta do Facebook.
  2. 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.
  3. 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.

  1. 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.
  2. 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.
  3. 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.

  1. Clique em Conectar Meta Ads e entre com a conta da Meta que tem acesso às contas de anúncios da loja.
  2. Na seção Conta de anúncios, clique em Carregar contas e escolha a conta que a tela de Campanhas vai acompanhar.
  3. 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.