A API de Conversão da Meta (CAPI) é uma integração oficial que permite enviar eventos de conversão diretamente para a Meta.
Na prática, isso ajuda o algoritmo dos anúncios a entender quais leads realmente geraram resultado dentro da operação, como:
vendas concluídas
leads qualificados
pedidos criados
negócios ganhos
Com essas informações, a Meta consegue otimizar automaticamente a entrega das campanhas para pessoas com maior chance de conversão, indo além apenas do volume de cliques no anúncio.
Segundo a própria Meta, anunciantes que utilizam o CAPI registram, em média, uma redução de até 17,8% no custo por resultado.
Como o envio de eventos CAPI funciona na Clint
O CAPI funciona diretamente dentro de uma automação na Clint, através do nó de ação "Enviar evento CAPI" que permite enviar eventos de conversão para a Meta diretamente através das automações da plataforma.
Na prática, isso fecha o ciclo entre o anúncio que trouxe o lead (CTWA) e o resultado real gerado dentro da operação.
⚠️ O envio de eventos CAPI funciona apenas para contatos que vieram de anúncios Click to WhatsApp (CTWA).
Isso acontece porque a Meta precisa do identificador do clique do anúncio para conseguir associar a conversão à campanha correta.
Esse identificador é capturado automaticamente quando o contato inicia a conversa através do anúncio.
Por esse motivo, contatos que entraram na base por outros canais, como:
importação
formulário
integração externa
atendimento manual
API
não terão os eventos enviados para a Meta.
Passo a passo para configurar o envio de evento CAPI:
Depois de configurar sua jornada e definir em qual momento deseja informar uma conversão para a Meta, você pode adicionar o nó "Enviar evento CAPI" na automação responsável por essa etapa do processo.
Esse envio pode acontecer em diferentes momentos da operação, como:
quando um lead é qualificado
quando um negócio muda para ganho
quando um pedido é criado
quando uma venda é concluída
entre outros eventos da jornada
O nó "Enviar evento CAPI" pode ser utilizado em qualquer automação da plataforma. A automação não precisa, obrigatoriamente, começar com um gatilho de Click to WhatsApp (CTWA).
O que realmente importa é que o contato tenha origem em um anúncio CTWA em algum momento da jornada.
Após definir em qual etapa do fluxo o evento deve ser enviado para a Meta, siga o passo a passo abaixo para configurar a ação.
1) Abra a automação de sua escolha e clique no ícone de Ação > Adicionar ação > Integrações, e selecione a opçao "Enviar conversão para Meta Ads".
2) Será mostrado um modal de "Enviar conversão para Meta Ads" e selecione o Evento e selecione o negócio.
a) No campo Evento, escolha a conversão que será enviada. Os eventos ficam organizados em três grupos:
Conversão (Purchase, LeadSubmitted, QualifiedLead, InitiateCheckout, AddToCart, ViewContent),
Pedidos (OrderCreated, OrderShipped, OrderDelivered, OrderCanceled, OrderReturned) e
Engajamento (CartAbandoned, RatingProvided, ReviewProvided)
3) Na opção "Selecione o negócio" escolha qual negócio do contato vai alimentar o evento
Negócio referente à Automação
Negócio mais recente
Primeiro negócio
Negócio com última atualização
4) Em Origem do valor, escolha de onde o valor vai vir:
Valor do negócio (campo padrão de valor do CRM),
Campo personalizado (um campo numérico criado por você no negócio) ou
Valor fixo (um valor único digitado por você, ideal para preço tabelado)
Obs.: Dependendo do evento, não será mostrado o campo de valor.
5) Clique em Salvar para concluir a configuração da ação
6) Por último, não esqueça de salvar a sua automação e publicar.
Pronto! Seu nó de envio de evento CAPI está configurado e sua automação já passa a enviar conversões para a Meta.
Dicas e cuidados
O envio de eventos CAPI funciona apenas para contatos que vieram de anúncios Click to WhatsApp (CTWA). Caso o contato tenha entrado por outros canais, o evento não será enviado para a Meta.
Antes de utilizar o nó "Enviar evento CAPI", é necessário que a conta do Facebook esteja conectada à Clint. Quando a automação já possui um gatilho CTWA, essa conexão é reaproveitada automaticamente. Caso contrário, a conta deverá ser selecionada manualmente dentro do nó.
Os eventos que possuem campo de valor são: Purchase, InitiateCheckout,
AddToCart, OrderCreated e OrderShipped.
A moeda utilizada no envio é definida automaticamente com base na moeda configurada na Clint em: Configurações → Moeda
Se o contato não possuir telefone cadastrado, o evento não será enviado, pois esse dado é obrigatório para identificação da Meta.
Quando a origem do valor estiver configurada como "Valor do negócio" ou "Campo personalizado" e não existir um negócio associado no momento da execução, o evento será enviado sem valor. Para garantir um valor fixo em todos os envios, utilize a opção "Valor fixo".
Todo envio (sucesso ou erro) fica registrado no histórico da automação, incluindo o evento, o valor e o canal usado.