Eventos de conversão na Meta
Desde 19/09/2026, o JL Sales envia para a Meta, pela API de Conversões (CAPI), o que acontece com cada paciente que chegou por um anúncio que leva ao WhatsApp. Antes, a Meta sabia só que a pessoa clicou e mandou mensagem. Agora ela também sabe quem virou lead qualificado, quem agendou e quem pagou.
Com esse retorno, a Meta passa a entregar os anúncios para pessoas parecidas com as que realmente fecham, e não só para as que mandam "oi".
Tudo isso é automático do nosso lado. A única parte que cabe a você fica na Meta: conectar o conjunto de dados à sua conta de anúncios e escolher o evento na campanha.
Como funciona
- Anúncio: o paciente clica no anúncio e abre o WhatsApp.
- JL Sales: a conversa e o lead avançam no funil.
- API de Conversões: o JL Sales envia o evento para o conjunto de dados do seu WhatsApp.
- Meta: a campanha otimiza para o evento que você escolheu.
Os eventos que enviamos
| Evento na Meta | Quando enviamos | Observação |
|---|---|---|
Lead enviado (LeadSubmitted) | O lead é criado no JL Sales a partir da conversa do anúncio. | O evento de maior volume. Bom para campanhas novas. |
Lead qualificado (QualifiedLead) | O lead entra numa etapa do funil que conta como conversão. Por padrão, é a etapa do tipo Ganho. | Para que outras etapas também contem como conversão, fale com o suporte. |
Iniciar finalização de compra (InitiateCheckout) | Um agendamento é criado para o lead. | Na Meta, significa "agendou". O nome vem da lista fixa da Meta, que não tem um evento "Agendamento" para WhatsApp. |
Compra (Purchase) | Um pagamento de tratamento é confirmado no financeiro. | Vai com o valor em R$. É o evento de maior valor, mas também o mais raro. |
O identificador do clique no anúncio, a sua conta do WhatsApp Business e o telefone (e o e-mail, quando houver) do lead, criptografados em SHA-256. O único valor enviado é o da Compra. Nenhum dado clínico (procedimento, diagnóstico, nome do paciente) sai da plataforma.
Só enviamos eventos de quem chegou por um anúncio Click-to-WhatsApp, até 90 dias depois do clique. Lead orgânico, indicação ou contato que a clínica iniciou não gera evento. Esse limite é da própria Meta: sem o identificador do clique, ela não consegue ligar o evento a um anúncio.
Conectar o conjunto de dados
A Meta exige que os eventos de WhatsApp cheguem no conjunto de dados da própria conta do WhatsApp Business (WABA). Não serve o Pixel do site nem o conjunto de dados da conta de anúncios.
O JL Sales cria esse conjunto de dados automaticamente no primeiro evento, dentro do mesmo portfólio empresarial (Business Manager) que é dono do número de WhatsApp. Ele nasce ligado ao WhatsApp, mas não à sua conta de anúncios. Enquanto essa ligação não for feita, os eventos chegam normalmente, mas o Gerenciador de Anúncios não mostra o conjunto de dados para você escolher na campanha.
Encontrar e conferir o conjunto de dados
- Acesse business.facebook.com com um usuário administrador do portfólio que é dono do número de WhatsApp.
- Abra o Gerenciador de Eventos (menu ☰ → Gerenciador de Eventos).
- Na lista de Fontes de dados, procure o conjunto de dados com o nome da sua conta do WhatsApp Business. Na dúvida, o suporte informa o número (ID) exato.
- Na aba Visão geral, confira se aparecem os eventos que enviamos.
Os eventos só aparecem depois que um lead vindo de anúncio avança no funil. Uma conta sem anúncios de WhatsApp ativos pode ficar dias sem eventos.
Conectar à conta de anúncios
- Abra as Configurações do negócio (business.facebook.com/settings).
- Vá em Fontes de dados → Conjuntos de dados (em algumas contas aparece como Pixels) e selecione o conjunto de dados do WhatsApp.
- Clique em Ativos conectados (ou Contas de anúncios conectadas) → Adicionar ativos.
- Marque a conta de anúncios que roda as campanhas de WhatsApp e salve.
- Ainda no conjunto de dados, em Pessoas, dê acesso a quem cria as campanhas (gestor de tráfego ou agência).
Se a conta de anúncios pertence ao portfólio da agência e o WhatsApp ao da clínica, o dono do WhatsApp precisa primeiro compartilhar o conjunto de dados com o portfólio parceiro: no conjunto de dados, clique em Atribuir parceiros e informe o ID do portfólio da agência. Depois, a agência faz a conexão com a conta de anúncios dela, como no passo a passo acima.
Usar os eventos nas campanhas
Com o conjunto de dados conectado, dá para escolher o evento como meta de otimização ao criar ou editar uma campanha que leva ao WhatsApp. Os nomes das opções podem variar um pouco conforme a versão do Gerenciador de Anúncios.
Opção A: campanha de Cadastros
Para otimizar para lead qualificado ou lead enviado.
- No Gerenciador de Anúncios, crie uma campanha com o objetivo Cadastros (Leads).
- No conjunto de anúncios, em Local da conversão, escolha Apps de mensagem → WhatsApp, com o seu número.
- Em Meta de desempenho, escolha Maximizar o número de conversões.
- Em Conjunto de dados, selecione o conjunto de dados do WhatsApp.
- Em Evento de conversão, escolha Lead qualificado (
QualifiedLead) ou Lead enviado (LeadSubmitted).
Opção B: campanha de Vendas
Para otimizar para agendamento ou compra.
- Crie uma campanha com o objetivo Vendas.
- No conjunto de anúncios, em Local da conversão, escolha Apps de mensagem → WhatsApp.
- Em Meta de desempenho, escolha Maximizar o número de conversões ou, para usar o valor em R$ da Compra, Maximizar o valor das conversões.
- Selecione o conjunto de dados do WhatsApp e o evento Compra (
Purchase) ou Iniciar finalização de compra (InitiateCheckout, que significa "agendou").
Qual evento escolher
| Situação | Recomendação |
|---|---|
| Campanha nova ou verba baixa | Lead qualificado ou Lead enviado. A Meta precisa de volume para aprender: em torno de 50 eventos por semana por conjunto de anúncios. |
| Muitos leads, mas poucos agendam | Iniciar finalização de compra (agendou). Troca quantidade por qualidade. |
| Volume alto de tratamentos pagos | Compra, de preferência maximizando o valor das conversões. |
Quando o evento atual tiver volume estável, teste o próximo num conjunto de anúncios novo, sem mexer no que já está performando.
Ver os resultados no relatório
No Gerenciador de Anúncios, vá em Colunas → Personalizar colunas, busque pelos nomes dos eventos (Lead qualificado, Compra etc.) e adicione as colunas de resultado, custo por resultado e, na Compra, valor de conversão. Assim você vê o custo por agendamento e o retorno de cada anúncio.
O que a clínica precisa manter no JL Sales
A Meta só aprende com o que a clínica registra. Sem registro, não há evento:
- Mover o lead no funil. O "Lead qualificado" só é enviado quando o lead entra numa etapa de conversão. Lead que fica parado não gera o evento.
- Registrar o agendamento na plataforma. Agendamento feito só na agenda de papel ou em outro sistema não gera "agendou".
- Confirmar o pagamento no financeiro com o valor correto. É esse valor que chega na Meta como Compra.
- Manter o WhatsApp conectado ao JL Sales pelo canal oficial (API da Meta).
Perguntas frequentes
Não aparece nenhum evento no Gerenciador de Eventos
- Não há anúncio Click-to-WhatsApp ativo, ou os leads recentes vieram de fora de anúncios.
- Os leads não avançaram no funil ou não foram agendados na plataforma.
- Você está olhando outro conjunto de dados, como o Pixel do site. Confira o nome e o ID com o suporte.
O conjunto de dados não aparece na hora de criar a campanha
Ele ainda não está conectado à conta de anúncios, ou a conta de anúncios está em outro portfólio e o conjunto de dados não foi compartilhado com ele. Confira também se o local da conversão escolhido é Apps de mensagem → WhatsApp.
A Meta não deixa escolher Compra ou Agendamento
A Meta pode limitar a otimização por eventos de fundo de funil para anunciantes da área de saúde, por política própria. Nesse caso, o evento continua chegando e aparecendo no relatório, mas a campanha fica restrita a metas mais amplas. Não é falha da integração. Se aparecer um aviso de restrição no Gerenciador de Eventos, envie um print para o suporte.
Preciso criar evento personalizado ou instalar algo?
Não. Os eventos são padrão da Meta e são enviados pelo servidor do JL Sales. Não há pixel, código ou aplicativo para instalar.
Os eventos de antes de 19/09/2026 foram enviados?
Não. O envio vale para o que acontece a partir de 19/09/2026.
Abra um chamado informando o nome da clínica, o número de WhatsApp e o ID da conta de anúncios. O suporte confere se os eventos estão saindo e informa o ID exato do conjunto de dados.