Alguém clica no seu anúncio Click-to-WhatsApp na Meta e envia uma mensagem. A Whatsable não cria o anúncio. A primeira mensagem recebida traz o clique e o anúncio, o referral, para você salvá-los. Esta página é o mapa: onde esse referral chega, o que é cada campo e por que você deve salvar ctwa_clid e source_id por conta própria antes que as mensagens seguintes no mesmo chat os percam.
Não. Um anúncio Click-to-WhatsApp roda no Meta Ads. A Whatsable não cria o anúncio.
A Whatsable encaminha o referral da primeira mensagem recebida, no nível superior, ao n8n, ao Zapier, ao Make e a um webhook que você criou. Você salva ctwa_clid e source_id por conta própria porque as mensagens seguintes no mesmo chat costumam omiti-los. A Whatsable não os salva para você.
Anúncios no Status também podem enviar um referral; ctwa_clid pode ser omitido.
Esta é a sequência, do início ao fim:
Whatsable
incoming: true ao criá-lo.referral para essa URL.Esse é o ciclo básico para qualquer destino. Os detalhes de para onde apontar mudam um pouco de ferramenta para ferramenta:
No painel da Whatsable, abra Desenvolvedor, adicione uma URL de endpoint e ative mensagens recebidas. A primeira mensagem recebida de Click-to-WhatsApp faz um POST do referral para essa URL. Veja https://whatsable.app/integrations/webhook
O n8n recebe o mesmo referral da primeira mensagem. Mapeie o referral de nível superior nessa mensagem, salve ctwa_clid e source_id e grave os dois em uma planilha ou CRM. Documentação de configuração: https://whatsable.app/integrations/n8n
O Zapier recebe o mesmo referral da primeira mensagem. Mapeie o referral de nível superior e salve ctwa_clid e source_id por conta própria. Documentação: https://whatsable.app/integrations/zapier
O Make recebe o mesmo referral da primeira mensagem. Mapeie o referral de nível superior e salve ctwa_clid e source_id por conta própria. Documentação: https://whatsable.app/integrations/make
Uma Agent Skill da Whatsable não é um evento separado. Ela vê o mesmo payload do webhook, incluindo o referral, só se estiver em um webhook que você criou. Instalar uma Skill, por si só, não entrega o referral. Veja https://whatsable.app/vibe-code
Sim na primeira mensagem recebida. Depois, costuma sumir.
| Quando | Presente / ausente |
|---|---|
| Primeira mensagem recebida após o toque no anúncio ou publicação de CTWA | Sim, normalmente |
| Mensagens seguintes, mesmo chat | Costuma estar ausente. Salve imediatamente |
| Conversa comum | Ausente |
| Anúncios no Status do WhatsApp | O referral pode estar presente; ctwa_clid pode ser omitido |
referral de nível superior no payload da Whatsable (ou messages[].referral da Cloud API, se esse for o envelope que você recebe).
| Campo | Significado | Presente / ausente |
|---|---|---|
referral | Contêiner da atribuição de CTWA/publicação. | Primeira mensagem recebida de CTWA/publicação; omita conversas comuns e a maioria dos follow-ups |
referral.source_type | ad ou post. | Com referral |
referral.source_id | ID do anúncio ou da publicação na Meta. | Com referral. Salve |
referral.source_url | URL do anúncio ou da publicação. | Com referral |
referral.headline | Título do anúncio ou da publicação. | Com referral |
referral.body | Texto do corpo do anúncio ou da publicação. | Com referral |
referral.media_type | image ou video. | Com referral |
referral.image_url | URL do criativo de imagem. | Quando media_type é imagem (as URLs podem expirar) |
referral.video_url | URL do criativo de vídeo. | Quando media_type é vídeo |
referral.thumbnail_url | URL da miniatura do vídeo. | Criativos de vídeo |
referral.ctwa_clid | ID do clique para o CAPI da Meta. | Costuma vir com o referral do anúncio; o Status pode omitir. Salve |
referral.welcome_message | Objeto opcional. Mensagem de boas-vindas quando a Meta a inclui. | Opcional. Incluído só quando a Meta o envia com o clique no anúncio. |
ctwa_clid e source_id?Você. A Whatsable encaminha o referral da primeira mensagem recebida. Você salva ctwa_clid e source_id por conta própria porque as mensagens seguintes no mesmo chat costumam omiti-los. A Whatsable não os salva para o cliente.
Anúncios no Status também podem enviar um referral; ctwa_clid pode ser omitido. Ainda assim é um referral.
Grave esses campos em uma planilha ou CRM e depois mostre em relatórios qual criativo e qual plataforma geraram o lead no WhatsApp.
A primeira mensagem recebida chega ao n8n, Zapier, Make ou a um webhook que você criou. Você salva o source_id no contato por conta própria, para a próxima pessoa que abrir o chat ver qual anúncio da Meta o iniciou.
A mesma primeira mensagem recebida acrescenta ctwa_clid e source_id. Você salva esses dois por conta própria e depois agrupa a semana por anúncio.
O Gerenciador de Anúncios viu o clique. O WhatsApp viu o chat. O referral da primeira mensagem recebida faz a ligação, mas só se você o salvou.