← Todos os artigos

Usuário do sistema e token de acesso da API de Conversões: como gerar e manter seguro

Mais cedo ou mais tarde, toda configuração da API de Conversões pede a mesma coisa: um token de acesso. E mais ou menos na mesma época as pessoas percebem, nas configurações do negócio, um usuário misterioso chamado algo como "Conversions API System User" e se perguntam se podem excluí-lo.

Veja o que são os dois e como lidar com eles sem quebrar o seu rastreamento.

Por que a API de Conversões precisa de token

O pixel roda no navegador, então não precisa de senha — qualquer um pode enviar eventos de navegador. A API de Conversões é diferente: ela deixa um servidor enviar eventos direto para o seu conjunto de dados (pixel), inclusive dados de vendas. A Meta precisa saber que quem envia tem autorização. O token de acesso é essa autorização.

Os tokens da CAPI pertencem a um usuário do sistema — uma conta não humana dentro do seu portfólio empresarial da Meta, feita para integrações servidor a servidor. Diferente de um token pessoal, ele não depende da conta do Facebook de nenhum funcionário, então continua funcionando quando alguém sai da empresa ou troca a senha.

Opção 1: gerar o token no Gerenciador de Eventos (o mais fácil)

  1. Abra o Gerenciador de Eventos e selecione o seu conjunto de dados (pixel).
  2. Vá até a aba Configurações.
  3. Encontre a seção API de Conversões e, em "Configurar manualmente", clique em Gerar token de acesso.
  4. Copie o token e guarde num lugar seguro — você vai colá-lo na integração.

O link só aparece para quem tem acesso de desenvolvedor ao negócio. Se você não vê, peça a um administrador controle total do conjunto de dados.

Quando você faz isso, a Meta cria automaticamente um app da API de Conversões e um usuário do sistema da API de Conversões. É esse usuário que você verá depois nas configurações do negócio. Segundo a Meta, esse caminho não exige Análise do App nem pedidos extras de permissão.

Opção 2: criar o usuário do sistema você mesmo

Agências e desenvolvedores costumam preferir controlar isso de forma explícita:

  1. Vá em Configurações do negócio → Usuários → Usuários do sistema e adicione um.
  2. Clique em Atribuir ativos, escolha Conjuntos de dados (pixels), selecione o pixel e dê controle total.
  3. Clique em Gerar novo token, escolha o seu app e gere o token.

Esse caminho é útil quando uma integração envia eventos para vários pixels ou quando você quer um usuário com nome claro para cada cliente.

"Usuário do sistema da API de Conversões" — posso excluir?

Só se tiver certeza de que nada o usa. Excluir o usuário do sistema (ou tirar o acesso dele ao pixel) invalida na hora todos os tokens que ele emitiu. Qualquer integração que use esses tokens — o plugin do seu site, um conector de CRM, o servidor de uma agência — começa a receber erros, e os eventos param de chegar. A Meta não avisa a integração; ela simplesmente falha.

Antes de excluir, veja quais integrações estão conectadas no Gerenciador de Eventos, em Configurações do conjunto de dados e em Visão geral → Gerenciar integrações. Se você está fazendo uma limpeza depois de trocar de agência, revogue primeiro o acesso dela e acompanhe o volume de eventos por um dia antes de remover mais alguma coisa.

Quando o usuário do sistema não está atribuído ao pixel

Um problema comum depois da configuração manual: o token é válido, mas a Meta rejeita os eventos com erro de permissão. Geralmente significa que o usuário do sistema existe, mas o pixel nunca foi adicionado aos ativos dele. Corrija em Configurações do negócio → Usuários do sistema → (o usuário) → Atribuir ativos → Conjuntos de dados e tente de novo. Não precisa de token novo.

Como manter o token seguro

Dispensando o token

Tokens manuais funcionam bem para um pixel. Viram dor de cabeça quando você cuida de vários negócios ou clientes: portfólios diferentes, administradores diferentes, tokens espalhados por várias ferramentas.

No LeadMe, você não copia token nenhum. Clica em Conectar com o Facebook, escolhe a conta de anúncios e seleciona um pixel existente ou cria um novo. O LeadMe usa o login oficial da Meta para empresas, com permissões aprovadas, guarda o acesso no servidor e envia os eventos por você. Se preferir, ainda dá para colar um token manual — as duas opções funcionam.

Respostas rápidas

O token da API de Conversões expira?

Tokens de usuário do sistema são feitos para integrações de longa duração. Ao gerar o token nas configurações do negócio, pode ser que peçam para escolher um prazo de validade — para integração de servidor, escolha a opção mais longa, para o rastreamento não parar sem aviso. Se os eventos pararem de repente com erro de autenticação, o primeiro suspeito é um token expirado ou revogado.

Preciso de Análise do App para usar a API de Conversões?

Não para o seu próprio pixel: a documentação da Meta diz que o caminho pelo Gerenciador de Eventos não exige análise. Plataformas que enviam eventos em nome de outras empresas (como o LeadMe) passam por essa análise elas mesmas.

Posso usar um token para vários pixels?

Sim, se o usuário do sistema tiver acesso a todos. Mesmo assim, muitas equipes preferem um token por pixel ou por cliente, para facilitar a limpeza.

Relacionados: O que é a API de Conversões da Meta · Configurar a API de Conversões sem programador