WhatsApp Ads e Meta Conversions API 2026: tracking sem cookies para Click-to-WhatsApp em Portugal

SendSeven Team, Editorial Team

O Meta Pixel perde dados com bloqueadores e iOS. A Conversions API (CAPI) recupera-os do lado do servidor. Aprenda a implementar os 4 eventos CAPI essenciais para Click-to-WhatsApp Ads sem depender de uma integração de plataforma com interface gráfica.

Este artigo aprofunda o aspeto técnico do guia pillar sobre Click-to-WhatsApp Ads. Se a sua equipa tem experiência em backend ou tem um programador, a CAPI é a diferença entre campanhas otimizadas e campanhas cegas.

Por que o Pixel sozinho não é suficiente em Portugal

O Meta Pixel é JavaScript que corre no browser do utilizador. Tem três problemas estruturais:

1. Bloqueadores de anúncios e browsers: uBlock Origin, Brave, Firefox Enhanced Tracking Protection — todos bloqueiam o Pixel. Em Portugal, a taxa de uso de bloqueadores é de 20-28 % em desktop.
2. iOS 14+ App Tracking Transparency (ATT): Os utilizadores de iPhone devem dar permissão explícita. A maioria recusa. Resultado: ~40 % dos eventos de iOS nunca chegam ao Pixel.
3. Conversas WhatsApp não rastreáveis pelo Pixel: Uma vez que o utilizador clica no CTWA e abre o WhatsApp, o Pixel não consegue rastrear o que acontece na conversa.

A Conversions API resolve os três problemas enviando os eventos do seu servidor (não do browser do utilizador).

Como funciona a Conversions API

O fluxo é: (1) utilizador clica no CTWA → (2) mensagem chega ao WhatsApp Cloud → (3) SendSeven reenvia o webhook para o seu servidor → (4) o seu backend mapeia o evento e envia-o para a Meta CAPI com os dados do utilizador hasheados.

Nota importante: A SendSeven não tem atualmente uma integração CAPI com interface gráfica que torne este processo automático. A implementação faz-se via Webhooks + REST API da SendSeven: recebe os eventos de conversa no seu servidor e envia você mesmo os payloads para a Meta. Se não tiver programadores, veja a secção «Alternativa sem CAPI» no final do artigo.

Os 4 eventos CAPI para CTWA

O fluxo técnico completo

Precisa de: conta SendSeven com Webhooks configurados, servidor backend (Node.js, Python, PHP), Pixel Meta com CAPI ativado e token de acesso CAPI.

Passo 1: Receber eventos CTWA via Webhook

Configure no SendSeven o URL do seu webhook para receber os eventos message de entrada. O payload inclui o número de telefone e, se a mensagem provém de um CTWA, o campo referral com o ID do anúncio:

// Payload webhook SendSeven (simplificado)
{
  "event": "message",
  "contact": {
    "phone": "+351912345678",
    "name": "João Silva"
  },
  "message": {
    "text": "Olá, vi o vosso anúncio de canalização...",
    "referral": {
      "source_id": "120202303456789",
      "source_type": "ad",
      "ctwa_clid": "ARAkLkA8yng..."
    }
  }
}

Passo 2: Hash SHA-256 dos dados do utilizador

const crypto = require('crypto');

function hashData(value) {
  const normalized = value.toLowerCase().trim();
  return crypto.createHash('sha256').update(normalized).digest('hex');
}

// Telefone: formato E.164, sem espaços
const hashedPhone = hashData('+351912345678');

Passo 3: Enviar o evento para a Meta CAPI

const PIXEL_ID = 'SEU_PIXEL_ID';
const CAPI_TOKEN = 'SEU_TOKEN_CAPI';

async function sendCapiEvent(eventName, userData) {
  const payload = {
    data: [{
      event_name: eventName,
      event_time: Math.floor(Date.now() / 1000),
      action_source: 'business_messaging',
      user_data: {
        ph: [hashData(userData.phone)],
      },
      ...(userData.ctwaClid && { referrer_url: userData.ctwaClid })
    }]
  };

  const url = `https://graph.facebook.com/v19.0/${PIXEL_ID}/events`;
  return fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ ...payload, access_token: CAPI_TOKEN })
  }).then(r => r.json());
}

Alternativa: CTWA sem CAPI (para não programadores)

Se não tiver um programador backend, pode continuar a executar CTWA sem a Conversions API. Perderá algum sinal de otimização, mas as campanhas continuarão a ser eficazes:

• Custom Audiences do WhatsApp: Meta pode criar audiências de retargeting de pessoas que interagiram com o seu número WhatsApp Business.
• Otimização manual: Use o relatório de conversas da SendSeven para identificar que criativos geram mais leads qualificados.
• Pixel básico no seu site: Se tiver uma página de destino antes do CTWA, o Pixel pode rastrear visitas e criar audiências semelhantes.

FAQ

A SendSeven tem uma integração nativa com a Meta Conversions API?

Não atualmente. A SendSeven oferece Webhooks em tempo real e uma API REST completa que lhe permitem construir a integração CAPI no seu próprio backend. Não existe um botão «Ativar CAPI» com interface gráfica na plataforma. Se isto for um requisito crítico, contacte-nos — é um produto que estamos a avaliar para uma versão futura.

O que é o ctwa_clid e por que é importante?

O ctwa_clid é um identificador único que a Meta inclui no payload do webhook quando a mensagem provém de um clique num anúncio CTWA. Usá-lo no payload CAPI melhora significativamente a atribuição: a Meta pode vincular diretamente a conversão ao anúncio específico.

O hash SHA-256 é obrigatório?

Sim. Os requisitos da Meta CAPI exigem que todos os dados identificativos do utilizador estejam hasheados com SHA-256 antes do envio. Enviar dados em texto simples viola os termos de serviço da Meta e as obrigações do RGPD.

Artigos relacionados:

• Pillar: CTWA e wa.me 2026 — Guia completo
• Custo real dos CTWA em Portugal
• Glossário: Meta Conversions API