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 envia um webhook message.received 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 as mensagens de entrada via Webhook

Configure no SendSeven o URL do seu webhook para receber os eventos message.received. O payload inclui a mensagem, a conversa, o contacto com o número de telefone e o método de contacto. Não inclui dados do anúncio: nem o objeto referral, nem o ID do anúncio, nem o ctwa_clid. Uma mensagem de entrada, em forma simplificada:

// Payload webhook SendSeven (simplificado)
{
  "type": "message.received",
  "data": {
    "message": {
      "text": "Olá, vi o vosso anúncio de canalização..."
    },
    "conversation": {
      "id": "CONVERSATION_ID"
    },
    "contact": {
      "name": "João Silva",
      "phone": "+351912345678"
    }
  }
}

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',
      messaging_channel: 'whatsapp',
      user_data: {
        ph: [hashData(userData.phone)],
        // ctwa_clid do seu próprio tracking, se existir (não vem do webhook da SendSeven):
        ...(userData.ctwaClid && { ctwa_clid: userData.ctwaClid }),
      }
    }]
  };

  const url = `https://graph.facebook.com/v26.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: O painel de análises da SendSeven para conversas iniciadas a partir de anúncios conta as conversas por anúncio, separando Facebook e Instagram, sem dados de receita nem de ROI. Assim vê que anúncios geram mais conversas e ajusta o orçamento manualmente.
• 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. A SendSeven não envia eventos para a Meta. Oferece Webhooks em tempo real e uma API REST completa que pode usar como fonte de dados para construir a integração CAPI no seu próprio backend. Não existe um botão «Ativar CAPI» com interface gráfica na plataforma.

O que é o ctwa_clid e por que é importante?

O ctwa_clid é um identificador único que a Meta inclui no objeto referral do seu webhook de WhatsApp 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. A SendSeven não o transmite nem por webhook nem pela API. As contagens por anúncio estão no painel das análises dedicado às conversas iniciadas a partir de anúncios e no endpoint GET /api/v1/analytics/ctwa/ad-breakdown. Para uma configuração CAPI baseada no Click ID precisa, por isso, de uma via de tracking própria fora da SendSeven, por exemplo uma landing page ou um formulário antes do WhatsApp, ou as ferramentas da Meta.

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