Transforme atendimentos em dados de conversão para otimizar campanhas e melhorar a performance dos anúncios.
Quando um lead chega via anúncio da Meta (Click to WhatsApp), o Sacflow captura automaticamente os metadados desse anúncio na primeira mensagem do atendimento. Esses dados podem ser enviados de volta para a Meta (via Conversions API ou processo similar), informando se o lead foi qualificado e qual foi o valor da venda. Isso melhora a otimização do algoritmo de anúncios do cliente.
Este artigo documenta o passo a passo completo, baseado na reunião de onboarding técnico com Miguel Faria (Rápido Chapuri).
1.
2.
3.
4.
5.
Use uma ferramenta de teste de webhook (ex: webhook.cool) para gerar uma URL temporária e visualizar a estrutura do payload antes de apontar para o endpoint definitivo (ex: N8N).
No painel do Sacflow, vá em Novo Webhook, dê um nome e cole a URL de destino (a de teste ou a definitiva). A partir da criação, todo atendimento encerrado passa a disparar um evento para essa URL.
Em Ver Registros é possível acompanhar os logs de disparo do webhook.
Ao encerrar um atendimento, o Sacflow envia o payload completo daquele atendimento para o endpoint configurado. Esse payload inclui todos os dados da conversa.
Dentro do atendimento, em Ver Detalhes, é possível checar a etiqueta de origem (se veio de anúncio ou não). Contatos vindos de anúncio da Meta chegam com um metadado próprio, incluindo o Source ID do anúncio.
Também é possível visualizar todos os contatos vindos de anúncio (Meta Ads) direto no relatório do Sacflow: ícone de monitor acima da engrenagem, em Atendimentos, rolar até a seção de origens e localizar Meta Ads.
Dentro do JSON do webhook, procure o array logs.
Para testar com um caso real, procure um atendimento que tenha vindo de anúncio.
No mesmo array de logs, busque por "session started by referral". Esse evento indica que a sessão começou a partir de um clique em anúncio (Click to WhatsApp).
Logo abaixo desse log, há o objeto referral_data, que contém:
Obs: o payload traz o ID do anúncio, mas não necessariamente o nome da campanha. Para identificar a campanha é preciso cruzar esse ID no Gerenciador de Anúncios da Meta.
O fluxo recomendado é:
1.
2.
3.
4.
Como o payload traz todas as mensagens trocadas no atendimento, é possível usar um agente de IA dentro do N8N com um prompt do tipo:
"Leia todas essas mensagens e extraia se o negócio foi fechado ou não, e qual foi o valor do negócio."
Esse resultado (qualificado ou não, valor da venda) é o dado que será enviado de volta para a API da Meta.
Com os dados extraídos (Source ID / CTWA + resultado da conversa), o cliente monta a chamada para a API da Meta informando se aquele lead se converteu e qual foi o valor. Isso fecha o ciclo de retroalimentação do algoritmo de anúncios.
Abaixo, um exemplo real de payload de webhook de um atendimento encerrado que veio de anúncio (Empresa Testes), com os campos que importam destacados.
O primeiro item do array logs já confirma a origem:
{
"type": "SESSION_STARTED_BY_REFERRAL",
"referral_data": {
"source_url": "https://fb.me/diwZalcR11O",
"source_id": "120243160728860676",
"source_type": "ad",
"headline": "Empresa Testes",
"media_type": "video",
"video_url": "...",
"thumbnail_url": "...",
"ctwa_clid": "AfiSG640fhmJi4NkGhzFAZ-rzDQc8q-miSoj8P030e0tNaeLfTMMPlqGgWPXT-8tL4k4XRZ-WxGvhiJBfRLbgEEiJ1FgwzFcPu81MkalTWVevpvcDiK8lgzZb802j5VfrE32GJ67VQ",
"welcome_message": {
"text": "Oi! Como podemos ajudar?"
}
}
}Campos que devem ser extraídos para retroalimentar a Meta:
| Campo | Onde fica | Para que serve |
|---|---|---|
| source_id | referral_data.source_id | ID do anúncio que originou o lead |
| ctwa_clid | referral_data.ctwa_clid | Click ID exigido pela Conversions API da Meta para associar o lead ao clique no anúncio |
| source_type | referral_data.source_type | Confirma que a origem é "ad" |
| headline | referral_data.headline | Nome/título do anúncio (não é o nome da campanha) |
Note que esse log (SESSION_STARTED_BY_REFERRAL) é sempre o primeiro item do array logs quando o atendimento vem de anúncio. Nos demais logs do mesmo atendimento aparecem eventos operacionais (etiqueta de origem, transferência de fila, aceite do atendimento, encerramento), que não são relevantes para a retroalimentação da Meta.
O restante do payload (ticket.messages) traz todas as mensagens trocadas na conversa, é esse trecho que deve ser processado pelo agente de IA no N8N para extrair se o negócio foi fechado e qual foi o valor.