Nó ActiveCampaign

O nó de workflow ActiveCampaign chama a ActiveCampaign API v3 para gerenciar contatos, deals, listas de e-mail, automações, tags e notas. É o nó de marketing mais completo da paleta — cobrindo CRM, e-mail marketing e automação em uma única integração.

ID do nó no editor: activecampaign_request
Base URL: https://YOUR_ACCOUNT.api-us1.com/api/3 (a região pode variar)
Auth: Api-Token: {{activecampaign_api_token}}

O que faz

• Envia requisições HTTP autenticadas para qualquer endpoint ActiveCampaign v3
• Suporta GET, POST, PUT, PATCH e DELETE
• Retorna status HTTP, data de resposta e headers de resposta
• Inclui 30+ templates de operação para contatos, contas, deals, listas, automações, tags e notas

Pré-requisitos

1. Uma conta ActiveCampaign
2. API URL e API token em Settings → Developer no ActiveCampaign
3. Chaves de integração em Configurações → Chaves de API:
   • activecampaign_api_url — ex.: https://youraccount.api-us1.com/api/3
   • activecampaign_api_token — seu API token

A região importa: URLs da API usam subdomínios regionais (api-us1, api-us2, api-eu1, etc.). Copie a URL exata das configurações de desenvolvedor do ActiveCampaign.

Como configurar

Passo 1 — Definir credenciais

1. No ActiveCampaign, acesse Settings → Developer
2. Copie API URL e API Key
3. No WhatsWave Configurações → Chaves de API, adicione:
   • Nome: activecampaign_api_url → Valor: https://youraccount.api-us1.com/api/3
   • Nome: activecampaign_api_token → Valor: seu API token

Headers padrão:

{
  "Api-Token": "{{activecampaign_api_token}}",
  "Content-Type": "application/json"
}

Passo 2 — Adicionar o nó

Arraste ActiveCampaign da paleta Marketing para o canvas do workflow.

Passo 3 — Escolher um template de operação

Contatos

Contas (empresas)

Deals (pipeline de CRM)

E-mail marketing e automação

Tags e notas

Passo 4 — Configurar campos da requisição

Exemplo — sincronizar contato do WhatsApp (POST /contact/sync):

• URL: {{activecampaign_api_url}}/contact/sync
• Method: POST
• Body:

{
  "contact": {
    "email": "{{contact.email}}",
    "firstName": "{{contact.name}}",
    "phone": "{{contact.phone}}"
  }
}

Exemplo — criar deal (POST /deals):

• URL: {{activecampaign_api_url}}/deals
• Method: POST
• Body:

{
  "deal": {
    "title": "WhatsApp lead — {{contact.name}}",
    "contact": "{{variables.ac_contact_id}}",
    "value": 500000,
    "currency": "brl",
    "group": "{{variables.ac_pipeline_id}}",
    "stage": "{{variables.ac_stage_id}}",
    "owner": "{{variables.ac_owner_id}}"
  }
}

O value do deal está em centavos (500000 = R$ 5.000,00). Obtenha IDs de pipeline/stage/owner pelos templates de listagem primeiro.

Exemplo — inscrever na automação:

• URL: {{activecampaign_api_url}}/contactAutomations
• Method: POST
• Body:

{
  "contactAutomation": {
    "contact": "{{variables.ac_contact_id}}",
    "automation": "{{variables.ac_automation_id}}"
  }
}

Passo 5 — Usar dados da resposta

Contact ID: {{activecampaign_1.data.contact.id}}
Deal ID: {{activecampaign_1.data.deal.id}}

Saídas do nó

Dicas e boas práticas

• Use contact/sync (upsert) em vez de create quando o e-mail já pode existir — evita duplicatas
• Execute Pipelines — listar e Estágios — listar uma vez manualmente para capturar IDs de pipeline/stage para criação de deals
• Armazene IDs de contato ActiveCampaign em campos customizados de contato WhatsWave
• List subscribe usa status: 1 (ativo); unsubscribe usa status: 2
• Valores de deal estão em centavos — multiplique reais por 100
• Configure webhooks do ActiveCampaign para atualizações de deal e aponte-os ao WhatsWave
• Para campos customizados, chame Campos — listar para obter IDs de campo e inclua-os nos payloads de create/update de contato
• Paginate com ?limit=100&offset=0 nos endpoints de listagem

Exemplos de casos de uso

Opt-in WhatsApp → lista + automação

1. Gatilho — contato envia palavra-chave "QUERO"
2. ActiveCampaign POST — sincronizar contato
3. Variable — salvar contact ID
4. ActiveCampaign POST — inscrever na lista
5. ActiveCampaign POST — inscrever na automação de boas-vindas

Lead qualificado → deal CRM

1. AI Agent marca lead como qualificado
2. ActiveCampaign POST — sincronizar contato
3. ActiveCampaign POST — criar deal no pipeline
4. Enviar mensagem — "Nossa equipe entrará em contato em breve"

Tag em leads quentes do WhatsApp

1. Gatilho — mensagem de alta intenção detectada
2. ActiveCampaign GET — encontrar contato por e-mail
3. ActiveCampaign POST — aplicar tag "hot-lead"
4. ActiveCampaign POST — adicionar nota com resumo da conversa

FAQ

Por que 404 nas chamadas de API?
activecampaign_api_url incorreto — verifique o subdomínio regional (api-us1 vs api-eu1).

Por que 403 Forbidden?
API token inválido ou revogado. Regenere nas configurações de Developer do ActiveCampaign.

Como encontro IDs de pipeline e stage?
Use os templates Pipelines — listar e Estágios — listar; os IDs estão nos arrays dealGroups e dealStages da resposta.

Posso enviar e-mails por este nó?
Este nó gerencia contatos e automações. O envio real de e-mail é disparado ao inscrever contatos em automações ou campanhas dentro do ActiveCampaign — não via envio direto de API do WhatsWave.

Qual a diferença do nó HubSpot?
O ActiveCampaign enfatiza automações de e-mail marketing e gestão de listas junto com deals de CRM. Escolha com base na sua plataforma principal.

Referência da API

Relacionados

• Visão geral de Marketing
• Variáveis no workflow
• Webhooks recebidos
• Nó HTTP