True Conversionsby Nexopath

Conectando o ActiveCampaign

O ActiveCampaign se conecta via credenciais de API. Você fornece sua Account URL e API Key, e o True Conversions registra o webhook automaticamente.

Pré-requisitos

  • Uma conta ActiveCampaign com acesso de administrador.
  • Uma conta já criada no True Conversions.

Passo 1: Obter as Credenciais de API no ActiveCampaign

  1. Faça login na sua conta ActiveCampaign.
  2. Vá até Settings > Developer.
  3. Copie a API URL (ex.: https://suaconta.api-us1.com).
  4. Copie a API Key.

Passo 2: Conectar no True Conversions

  1. No painel do True Conversions, vá até Accounts e selecione a conta.
  2. Clique em CRM Integrations no menu lateral.
  3. No card do ActiveCampaign, cole sua Account URL e API Key.
  4. Clique em Connect ActiveCampaign.
  5. Uma mensagem de sucesso confirma a conexão.

O True Conversions automaticamente:

  • Valida suas credenciais de API.
  • Cria um campo personalizado GCLID nos contatos do ActiveCampaign (se ainda não existir). Esse campo armazena o Google Ads click ID para correspondência de conversões offline.
  • Registra um webhook na sua conta ActiveCampaign que monitora eventos de atualização de negócios (deal update).

Quais Eventos São Capturados

O True Conversions monitora eventos de negócio ganho (deal won). Quando o status de um negócio muda para "ganho" (status = 1) no ActiveCampaign, o webhook dispara e o True Conversions:

  1. Recebe os dados do negócio.
  2. Busca email, telefone, nome e GCLID do contato associado via API do ActiveCampaign.
  3. Normaliza e aplica hash no PII.
  4. Roteia a conversão para as plataformas de anúncios conectadas (Google Ads, Meta).

Outras mudanças de status (ex.: "aberto", "perdido") são ignoradas.

Campo GCLID

Para que o Google Ads Enhanced Conversions associe a conversão offline ao clique original no anúncio, o GCLID precisa estar armazenado no registro do contato no ActiveCampaign.

O True Conversions cria esse campo personalizado automaticamente quando você conecta. Para populá-lo:

  1. Instale a tag GTM do True Conversions no seu site (veja Primeiros Passos).
  2. Garanta que o envio do formulário ou automação passe o valor do gclid para o campo personalizado GCLID no contato do ActiveCampaign.

Se você usa um construtor de formulários ou ferramenta de landing page, adicione um campo oculto para gclid e mapeie-o para o campo personalizado GCLID do ActiveCampaign via sua integração de formulários (ex.: formulários nativos do ActiveCampaign, Zapier, Make).

Segurança

Sua API Key é criptografada com AES-256 antes de ser armazenada. Ela nunca é exposta no navegador ou em logs. A URL do webhook inclui um token secreto único para verificar que as requisições recebidas se originam da sua conta ActiveCampaign.

Desconectando

Clique em Disconnect no card do ActiveCampaign. Isso remove o registro da integração e as credenciais armazenadas do True Conversions. O webhook registrado no ActiveCampaign deixará de receber eventos. Para uma limpeza completa, você também pode deletar o webhook manualmente no ActiveCampaign em Settings > Developer > Webhooks.