Toda campanha da Meta aprende com o que você diz a ela que é sucesso. Se o único sinal que chega ao Gerenciador de Anúncios é "alguém abriu uma conversa", o algoritmo vai buscar mais gente que abre conversa — inclusive quem nunca vai agendar. É por isso que tantas clínicas veem o custo por conversa cair e a agenda continuar vazia.
A API de Conversões resolve essa lacuna: ela devolve à Meta o que aconteceu depois do clique — o lead qualificado, a consulta agendada, o tratamento pago. Este guia explica o que ela é, por que clínicas que vendem pelo WhatsApp precisam dela, quais eventos importam e onde a maioria erra.
O que é a API de Conversões (e como difere do pixel)
O pixel da Meta é um código instalado no site: ele roda no navegador do visitante e registra o que acontece naquela página. A API de Conversões (em inglês, Conversions API, ou CAPI) faz o caminho inverso: é o seu sistema — servidor, CRM, sistema de gestão — que envia os eventos diretamente para a Meta, sem depender do navegador.
Segundo a documentação da Meta, os eventos enviados pela API são processados da mesma forma que os eventos do pixel para medição e otimização. A diferença é de onde vem o dado: o pixel só vê o que acontece no site; a API envia qualquer evento que o seu sistema conheça.
Por que clínicas que vendem pelo WhatsApp precisam dela
Numa clínica que anuncia com clique para WhatsApp, a jornada quase não passa por site nenhum. O paciente toca no anúncio, conversa, agenda, comparece e paga na recepção. Nenhuma dessas etapas acontece numa página com pixel.
- A venda acontece fora do site: o agendamento é marcado na conversa e o pagamento é registrado no financeiro da clínica;
- O pixel não enxerga conversa nem caixa: ele não tem como saber que aquele clique virou uma consulta;
- O navegador é cada vez menos confiável: bloqueadores, restrições de cookies e as regras de privacidade do iOS limitam o que um código no navegador consegue medir;
- Sem sinal de resultado, a campanha otimiza pelo que é fácil de medir — conversas — e não pelo que paga as contas.
Os eventos que importam no funil da clínica
Para conversas iniciadas em anúncios de clique para WhatsApp, Messenger ou Instagram, a Meta tem uma versão específica da API, para mensagens comerciais (Business Messaging). Nela, o evento é enviado com a origem "business_messaging", o canal (por exemplo, "whatsapp") e o identificador do clique no anúncio (ctwa_clid), que chega junto com a primeira mensagem. A lista de eventos aceitos é fechada; os que mais fazem sentido numa clínica:
| Etapa na clínica | Evento da Meta | O que ensina ao anúncio |
|---|---|---|
| Lead entrou pelo anúncio | LeadSubmitted | Quem responde ao anúncio (sinal de volume) |
| Lead foi qualificado | QualifiedLead | Quem tem perfil de paciente, não só curiosidade |
| Consulta agendada | InitiateCheckout | Quem chega a marcar horário |
| Tratamento pago | Purchase (com valor) | Quem gera receita — e quanto |
Por que otimizar por agendamento e pagamento, não por mensagem
Mensagem é um sinal barato e abundante. Por isso é o padrão — e por isso engana. Dois anúncios com o mesmo custo por conversa podem trazer públicos completamente diferentes: um atrai gente perguntando preço de clareamento por curiosidade, o outro atrai quem quer resolver o implante este mês.
Quando os eventos de agendamento e pagamento voltam para a Meta, a plataforma passa a ter como diferenciar os dois. Os relatórios mostram quais campanhas geram consulta e receita, e a campanha pode ser direcionada para o evento que realmente interessa. Na prática, é trocar a pergunta "quem conversa?" por "quem agenda e paga?".
Um alerta honesto: eventos de fundo de funil são menos frequentes. Numa clínica com pouco volume, pode fazer sentido acompanhar o pagamento nos relatórios e otimizar por um evento intermediário, como lead qualificado ou agendamento, até haver sinais suficientes.
Qualidade do evento: correspondência e deduplicação
A Meta precisa ligar cada evento a uma pessoa que viu o anúncio. Nas conversas de clique para WhatsApp, o ctwa_clid faz essa ligação de forma direta. Em eventos de site, entram dados do cliente, como telefone e e-mail, e a Meta mostra no Gerenciador de Eventos uma nota de qualidade da correspondência.
Outro cuidado é a duplicidade. Se o mesmo evento chega pelo pixel e pela API, a Meta usa o nome do evento e um identificador comum (event_id) para contar uma vez só — desde que os dois cheguem dentro de 48 horas. Sem esse identificador, a mesma venda pode ser contada duas vezes e o relatório fica inflado.
Privacidade e LGPD: dados embaralhados, não expostos
A documentação da Meta exige que dados pessoais como e-mail, telefone, nome, cidade e data de nascimento sejam normalizados e convertidos em hash (SHA-256) antes do envio. O hash transforma "5511999998888" numa sequência ilegível que serve para comparação, mas não para leitura. Identificadores técnicos, como o ctwa_clid, vão sem hash.
Isso não dispensa as obrigações da clínica: informar na política de privacidade que dados são compartilhados com plataformas de anúncio, enviar só o necessário e nunca incluir informação clínica, como diagnóstico ou procedimento sensível, nos eventos. Para o quadro completo, veja o guia de LGPD para clínicas odontológicas.
Como funciona no JL Sales
No JL Sales, a API de Conversões da Meta é alimentada automaticamente pelo CRM, pela agenda e pelo financeiro. Não há evento para disparar à mão: quando um lead é criado, a Meta recebe "LeadSubmitted"; quando ele chega à etapa de lead qualificado, "QualifiedLead"; quando a consulta é marcada, "InitiateCheckout", que a configuração usada pelo produto apresenta como agendamento no Gerenciador de Anúncios; e quando o pagamento é registrado no financeiro, "Purchase" com o valor.
Os eventos são enviados apenas para leads que vieram de anúncios de clique para WhatsApp, dentro de 90 dias do clique. Esses leads chegam ao CRM com campanha e anúncio identificados, com o nome real do anúncio no Gerenciador, e os painéis de marketing mostram custo por lead e custo por cliente por campanha e por anúncio. Veja também como ler as métricas dos anúncios da Meta.
Como medir o impacto e os erros mais comuns
Para saber se a mudança valeu, compare períodos equivalentes olhando custo por agendamento e custo por paciente pagante, não custo por conversa. Dê tempo à campanha para aprender com os novos eventos antes de concluir, e evite mudar criativo, verba e público ao mesmo tempo — senão não dá para saber o que causou a diferença.
- Enviar só o evento de mensagem e esperar que a campanha encontre pacientes;
- Registrar o agendamento ou o pagamento numa planilha fora do sistema, onde nenhum evento é gerado;
- Mandar o mesmo evento pelo pixel e pela API sem event_id, duplicando conversões;
- Enviar dados pessoais sem hash ou incluir informação de saúde no evento;
- Julgar o resultado em poucos dias, antes de a campanha ter sinais suficientes.