---
title: "API de Conversões da Meta (CAPI): para que serve | Grupo Marfre"
description: "API de Conversões da Meta (CAPI): o servidor envia à Meta os eventos que o pixel perde. Veja cookie, hash, deduplicação e por que ela não esquenta pixel novo."
canonical: https://grupomarfre.com.br/gestao-de-trafego/conversoes-pelo-servidor-meta/
alternate_html: https://grupomarfre.com.br/gestao-de-trafego/conversoes-pelo-servidor-meta/
language: pt-BR
last_updated: 2026-10-27
type: guia
---
# API de Conversões da Meta (CAPI): para que serve

**Resposta rápida:** A API de Conversões (CAPI) envia eventos como compra e contato do servidor direto para a Meta, sem depender do navegador. Ela complementa o pixel, não o substitui. Serve para cobrir evento que o navegador perde e mandar e-mail e telefone em hash, que sobem a nota de qualidade do evento. Junto com ela, o servidor pode gravar o cookie de clique.

A API de Conversões (CAPI) é o canal em que o seu servidor, e não o navegador do cliente, avisa a Meta que alguém comprou, agendou ou chamou no WhatsApp. O pixel continua no site. A API roda ao lado dele e cobre o que o navegador deixa passar.

Ela não é um truque para "esquentar" conta nem aumenta venda por si só. O que ela faz é reforçar o sinal que a Meta recebe: o evento sai do servidor, sem depender do navegador, e pode levar e-mail e telefone em hash, que sobem a nota de qualidade do evento.

## O que a API de Conversões faz que o pixel sozinho não faz?

Ela envia o evento do servidor para a Meta, sem passar pelo navegador. O pixel é um script que roda na tela do visitante, então depende de o navegador deixar o script rodar e guardar o cookie. A API não tem essa dependência, porque o evento sai do sistema que registrou a venda.

Na prática, os dois trabalham juntos:

1.  O pixel registra o que acontece na página, no navegador.
2.  A API envia o mesmo evento a partir do servidor (compra confirmada, lead gravado, pedido pago).
3.  A Meta recebe as duas versões e usa uma só, se elas forem identificadas como o mesmo evento (veja a seção de deduplicação).

A venda que vem de anúncio Click-to-WhatsApp, segundo a documentação da Meta (28/09/2026), só aparece na Meta se o identificador do clique que chega no webhook for guardado e o evento voltar pela API de Conversões para mensagens. O passo a passo está em [como fazer a venda do WhatsApp aparecer na Meta](https://grupomarfre.com.br/gestao-de-trafego/venda-do-whatsapp-na-meta/).

## Por que o cookie gravado pelo servidor importa no Safari?

Porque o Safari encurta a vida do cookie escrito por JavaScript, e o pixel depende desse tipo de cookie. Segundo o WebKit (webkit.org, 02/10/2026), o cookie escrito por JavaScript dura 7 dias no Safari, e só 24 horas quando a visita chega com fbclid ou gclid na URL.

Esse é justamente o visitante que veio do anúncio. Se ele volta no dia seguinte para comprar, o pixel pode já ter perdido a identificação do clique.

O cookie gravado pelo servidor, no próprio domínio do site, não sofre esse corte, segundo a mesma fonte. Por isso vale incluir, junto com a API, o servidor gravando o cookie de clique. Mais detalhes em [Safari e cookies: por que o anúncio perde atribuição](https://grupomarfre.com.br/gestao-de-trafego/safari-e-cookies/).

## Que dados do cliente a API envia, e por que em hash?

Ela envia e-mail e telefone do cliente em hash SHA-256, depois de normalizados. O hash transforma o dado em um código, e o e-mail ou o telefone não trafegam em texto aberto. A normalização padroniza o formato antes do cálculo, para que o mesmo e-mail sempre gere o mesmo hash.

Isso mexe na nota de qualidade do evento, a EMQ, que aparece por evento no Gerenciador de Eventos. O alvo de mercado é 7 ou mais nos eventos principais, e o pixel sozinho costuma ficar entre 3 e 6. A nota sobe com e-mail e telefone em hash normalizados e com a deduplicação correta. Veja [como subir a nota da EMQ](https://grupomarfre.com.br/gestao-de-trafego/qualidade-de-correspondencia-emq/).

Exemplo fictício e resumido aos campos que esta seção comenta, de um evento de compra enviado pelo servidor, com marcadores no lugar do hash:

```json
{
  "event_name": "Purchase",
  "event_time": 1767225600,
  "event_id": "pedido-10482",
  "action_source": "website",
  "user_data": {
    "em": ["<e-mail em hash SHA-256>"],
    "ph": ["<telefone em hash SHA-256>"]
  },
  "custom_data": { "currency": "BRL", "value": 89.90 }
}
```

O `event_time` é o horário do pedido em segundos (formato Unix), e o evento não pode ter mais de 7 dias quando chega à Meta. O campo que merece atenção é o `event_id`. Ele é a chave da deduplicação.

## Como a deduplicação evita contar a compra duas vezes?

Enviando o mesmo `event_id` no navegador e no servidor. Segundo a documentação da Meta, quando pixel e API de Conversões enviam o mesmo evento, os dois precisam levar o mesmo event\_id. Sem isso, a compra conta duas vezes e o custo por compra parece metade do real.

Três cuidados:

- **Um id por transação.** O ideal é que o `event_id` nasça do id do pedido, como no exemplo acima, e não de um número sorteado a cada envio.
- **Dois eventos de servidor iguais não se deduplicam.** A Meta não junta dois envios do servidor idênticos, então um webhook reenviado vira compra a mais.
- **Ganho alto não prova nada.** Se as compras atribuídas quase dobram ao ligar a API sozinha, isso não prova contagem em dobro: pixel bloqueado também produz ganho alto, porque a API passa a mostrar o que o navegador perdia. Na régua do Grupo Marfre, o número só vale depois de conferir a deduplicação.

O diagnóstico completo, para quando a conta já mostra venda em dobro, está em [deduplicação de eventos](https://grupomarfre.com.br/gestao-de-trafego/deduplicacao-de-eventos/).

## A API de Conversões esquenta um pixel novo?

Não. Não existe "esquentar" pixel novo com histórico, porque a API de Conversões rejeita evento com mais de 7 dias. Mandar as vendas do último ano para um pixel recém-criado não funciona.

O histórico passa de um pixel para outro por público, não por evento: uma lista de clientes ou um público semelhante criado a partir dela. Para a base nova de eventos, o caminho é o pixel funcionando no dia zero e a API enviando em tempo real. Se o pixel ainda não está confirmado, comece por [Pixel da Meta: como saber se está funcionando](https://grupomarfre.com.br/gestao-de-trafego/pixel-da-meta/).

## Como conferir se a configuração está certa?

Abra o Gerenciador de Eventos, no conjunto de dados, e leia três pontos:

1.  **Fonte do evento:** o mesmo evento deve aparecer como recebido pelo navegador e pelo servidor.
2.  **Nota de qualidade (EMQ):** compare os eventos principais com o alvo de 7 ou mais.
3.  **Aba de diagnóstico:** na régua do Grupo Marfre, ela mostra o que a contagem não mostra, como evento de servidor sem dado de cliente, fbclid vencido e fbclid modificado.

Se o evento de servidor chega sem e-mail e telefone, a API está ligada, mas sem o ganho de qualidade que justifica a configuração.

## Perguntas frequentes

### Preciso da API de Conversões se já tenho o pixel?

O pixel continua necessário. A API entra como complemento, para cobrir o que o navegador perde e enviar dados do cliente em hash. Quanto mais o seu público usa Safari ou bloqueadores, maior tende a ser a diferença.

### A API de Conversões resolve o bloqueio do Safari?

Reduz a perda, mas não elimina. O cookie gravado pelo servidor no próprio domínio escapa do corte de 24 horas e de 7 dias do Safari. Quem não chega ao site ou não deixa dado nenhum continua fora da conta.

### Posso enviar uma compra da semana passada pela API?

Até 7 dias de idade, sim. Passado esse limite, a API de Conversões rejeita o evento. Por isso a API serve para envio em tempo real, e não para reconstruir histórico.

### Ligar a API de Conversões dobra as minhas vendas?

Não. As vendas são as mesmas, o que muda é quantas a Meta consegue ver. Um aumento próximo de 100% nas compras atribuídas, sozinho, não diz se a Meta passou a ver vendas que o pixel bloqueado perdia ou se está contando a mesma compra duas vezes. Conferir a deduplicação separa os dois casos.

## Leia também

### [Pixel da Meta: o que é e como saber se está funcionando](https://grupomarfre.com.br/gestao-de-trafego/pixel-da-meta/)

Pixel da Meta: o que ele faz e como saber se está funcionando, com os testes que enganam (headless, última hora) e como provar falha com duas fontes.

### [Deduplicação de eventos: por que a compra está contando em dobro](https://grupomarfre.com.br/gestao-de-trafego/deduplicacao-de-eventos/)

Deduplicação de eventos na Meta: como usar o mesmo event\_id no pixel e na API de Conversões para a compra não contar em dobro e o CPA não parecer metade.

### [Qualidade da correspondência de eventos (EMQ): como subir a nota](https://grupomarfre.com.br/gestao-de-trafego/qualidade-de-correspondencia-emq/)

Qualidade da correspondência de eventos (EMQ): o que é, qual nota buscar (7+), como subir com e-mail e telefone em SHA-256 e usar a aba de diagnóstico.

### [Safari e cookies: por que o anúncio perde atribuição](https://grupomarfre.com.br/gestao-de-trafego/safari-e-cookies/)

Safari e cookies no anúncio: cookie por JavaScript dura 7 dias e só 24 horas com fbclid ou gclid. Veja o que muda com o cookie do servidor no próprio domínio.

### [Como fazer a venda do WhatsApp aparecer na Meta](https://grupomarfre.com.br/gestao-de-trafego/venda-do-whatsapp-na-meta/)

Como fazer a venda do WhatsApp aparecer na Meta: guarde o identificador do clique do webhook e devolva o evento pela API de Conversões para mensagens.

### [Atribuição na Meta em 2026: o que mudou no "clique"](https://grupomarfre.com.br/gestao-de-trafego/atribuicao-na-meta-2026/)

Atribuição na Meta em 2026: desde março, em conversão de site e loja física, clique é só clique no link; curtida e comentário viraram engage-through de 1 dia.

---

## Sobre o Grupo Marfre

Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota.

- Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil
- WhatsApp: (31) 93618-7272, https://wa.me/5531936187272
- E-mail: contato@grupomarfre.com.br
- Instagram: https://instagram.com/marfregrupo
- Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação
- Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/
- Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/
- Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização
- Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja
- Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso
- Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt

Página HTML equivalente: https://grupomarfre.com.br/gestao-de-trafego/conversoes-pelo-servidor-meta/