Integrações & API

Integrando Talkify com Meta Ads, GA4 e CRMs: o guia técnico de webhooks e eventos

Como conectar Talkify ao seu stack de marketing e dados: CTWA, MQL/SQL, Conversions API, webhooks REST e integração com CRMs externos.

Equipe Talkify9 min de leitura

O stack de dados de uma operação WhatsApp + CRM

Uma operação séria precisa fechar o loop: anúncio → conversa → conversão → otimização de mídia. Talkify entrega isso nativamente, sem precisar de Zapier ou camada de integração.

Meta Ads (CTWA)

CTWA (Click-to-WhatsApp) identifica de qual anúncio cada conversa veio. Talkify captura o ad_title do payload do WhatsApp e enriquece com nome da campanha, conjunto de anúncios e criativos via Graph API.

  • Permissões mínimas: ads_read, ads_management
  • Conexão via OAuth no botão "Conectar com Facebook"
  • Token renovado automaticamente a cada 60 dias

Eventos MQL e SQL

EventoQuando dispara
talkify_mqlLead vai para o CRM (Marketing Qualified)
talkify_sqlNegociação entra em etapa marcada como SQL
talkify_deal_wonNegociação ganha
talkify_deal_lostNegociação perdida

Esses eventos vão para GA4 e Meta automaticamente — permitindo que o algoritmo otimize por leads que realmente fecham, não só por formulários preenchidos.

Server-side: Conversions API

Pixel client-side é bloqueado por AdBlockers e iOS. A Conversions API (CAPI) envia os mesmos eventos pelo servidor da Talkify direto para a Meta. Resultado: 30–40% mais sinais entregues, melhor match e CPL mais baixo.

Webhooks REST para CRMs externos

Configure um webhook em Configurações → Webhooks, escolha os eventos e a URL de destino. Exemplo de payload:

POST https://seu-crm.com/talkify-webhook
Content-Type: application/json

{
  "event": "lead.created",
  "occurred_at": "2026-06-11T14:23:11Z",
  "data": {
    "id": "lead_8f2a...",
    "name": "Joana Souza",
    "phone": "+5511999998888",
    "source": "widget",
    "campaign": "lancamento-junho",
    "score": 72
  }
}

Quick-start de integração

  1. Conecte sua conta Meta em Rastreamento & Atribuição.
  2. Conecte GA4 com Measurement ID + API Secret.
  3. Marque pelo menos 1 etapa do pipeline como SQL.
  4. Crie webhooks para seu CRM externo, se houver.
  5. Verifique em Debug View (GA4) e Test Events (Meta) por 24h.

Perguntas frequentes

Preciso de dev para integrar com Meta Ads?+

Não. O fluxo 'Conectar com Facebook' é OAuth: 3 cliques e está pronto.

Quais eventos vão para o GA4?+

talkify_lead, talkify_whatsapp_click, talkify_mql, talkify_sql, talkify_deal_won, entre outros.

O webhook é em tempo real?+

Sim, dispara em < 1 segundo após o evento. Retry exponencial em caso de falha.

Posso filtrar quais eventos quero receber?+

Sim, cada webhook escolhe os eventos de interesse.

Pronto para conversar para vender?

Crie sua conta gratuita e conecte o WhatsApp Oficial em minutos.