Active Campaign
O ActiveCampaign é uma plataforma de automação de marketing e CRM. Com ele você consegue:
Gerenciar contatos (e-mail, telefone, campos personalizados).
Organizar listas e tags para segmentação.
Automatizar jornadas (envio de e-mails, nutrição, follow-ups).
Acompanhar vendas (pipelines, negócios, tarefas).
Na integração com a Ozia, você usa a API do ActiveCampaign para criar, atualizar e consultar contatos durante um fluxo, mantendo sua base sempre sincronizada.
Pré-requisitos
Acesso ao ActiveCampaign com permissão para ver a URL da API e a API Key (normalmente em Settings › Developer).
Acesse o construtor de chatbot para configurar integrações e editar o fluxo.
Uma variável de e-mail no seu fluxo (ex.:
{{email}}) ou o e-mail digitado pelo usuári
1. Adicionar conta ActiveCampaign
No construtor de chatbot, acesse Integrações → ActiveCampaign.
Clique em Add Active Campaign account.
Name → insira um nome para identificar a conta (ex.:
ActiveCampaign_Principal).URL → cole a URL da API disponível no seu perfil ActiveCampaign.
API key → cole a chave da API obtida no seu perfil.
Para gerar uma nova chave, clique em here no painel do ActiveCampaign.
Clique em Salvar.

Configurando o bloco
Informe diretamente o endereço de e-mail do contato ou utilize a variável que armazena esse e-mail no fluxo. Esse dado será usado para localizar, criar ou atualizar as informações do contato na sua base de dados do ActiveCampaign.

Create Contact (Criar Contato)
Selecione a ação Create Contact.
Mapeie os campos:
Email (obrigatório):
{{email}}.Nome/Sobrenome/Telefone (opcional):
{{nome}},{{sobrenome}},{{telefone}}.Tags (opcional): em texto, separadas por vírgula. Ex.:
lead, campanha_outubro, instagram.Campos personalizados (opcional): informe campo → valor. Ex.:
empresa → {{empresa}},origem → whatsapp.
Salvar e seguir o fluxo (ex.: enviar confirmação ao usuário).

Boas práticas:
Padronize tags (minúsculas, sem acentos) para facilitar segmentação.
Ao inserir mais de uma tag, utilize vírgulas para separá-las, sem adicionar espaços extras.
B) Update Contact (Atualizar contato)
Uso: para alterar dados de um contato existente (ex.: adicionar tag, atualizar telefone).
Selecione Update Contact.
Informe o e-mail que identifica o contato:
{{email}}.Mapeie os campos a atualizar:
Ex.:
telefone → {{telefone}},nome → {{nome}}.Tags: informe as tags que deseja adicionar (separadas por vírgula). Observação: dependendo da implementação, atualizar tags pode acrescentar ou substituir. Se o bloco permitir, escolha “acrescentar” para não perder tags antigas.
Adicione/atualize campos personalizados conforme necessário.
Salve.

Boas práticas:
Atualize apenas os campos necessários para evitar sobrescrever dados válidos.
C) Retrieve Contact (Consultar contato)
Uso: para buscar dados do contato e tomar decisões no fluxo (ex.: se já tem tag X, pular etapa).
Selecione Retrieve Contact.
Informe o e-mail:
{{email}}.(Opcional) Adicione um campo personalizado (“field”) já configurado no ActiveCampaign e selecione o que quer retornar.
Salve os resultados em variáveis do fluxo (ex.:
{{ac_tags}},{{plano}},{{stage}}) para usar em condições/ramificações.
Exemplo de uso (Retrieve):
Buscar o campo personalizado plano e, se
{{plano}} == "premium", seguir por um caminho VIP do fluxo.

Atualizado