ActiveCampaign → OmniChat: disparo de campanha via webhook

Automação da ActiveCampaign (contato) → POST application/x-www-form-urlencoded → activecampaign-mkt-adapter → fila SQS → Campaign API OmniChat → WhatsApp.

Antes de configurar a automação na ActiveCampaign, obtenha a webhookUrl assinada da campanha na plataforma OmniChat.

Figura 0a: Tela de edição da campanha na OmniChat (audiência integrada)

Figura 0b: Botão Webhook no rodapé da edição da campanha

Figura 0c: Modal Webhook da campanha — selecionar ActiveCampaign

Figura 0d: URL do webhook gerada para a ActiveCampaign (hash ocultado nesta imagem)

Formato esperado da URL:

https://activecampaign-mkt-adapter.omni.chat/v1/webhook/{retailerId}/{campaignId}/{hash}

A URL contém um hash de autenticação exclusivo daquela campanha. Trate-a como um segredo: quem tem a URL consegue enfileirar disparos na campanha. Cada campanha tem a sua — não reaproveite a URL de uma campanha em outra. Por isso o trecho sensível aparece borrado nas capturas deste guia.

Figura 1: Lista de automações da ActiveCampaign

O gatilho define quando o contato entra na automação e, portanto, quando o disparo acontece. O padrão recomendado é tag adicionada, por ser o gatilho mais simples de acionar a partir de qualquer outro processo (import, automação anterior, integração, ação manual).

Figura 2: Configuração do gatilho “Tag é adicionada”

Outros gatilhos válidos, conforme o caso de uso: Envia um formulário, Inscreve-se em uma lista, Campo personalizado é alterado, Negócio entra em um estágio ou Webhook de entrada. O restante da configuração não muda.

Figura 3a: Painel “Adicione uma ação”

Figura 3b: Busca pela ação Webhook

Figura 4: Ação Webhook com a URL do adapter (hash ocultado nesta imagem)

Figura 5: Automação ativa com o nó de Webhook

Não há mapeamento manual de campos na ActiveCampaign. Essa é a principal diferença em relação à Emarsys: a ação Webhook posta automaticamente todos os campos do contato, em notação de colchetes (contact[first_name], contact[fields][perstag]). O adapter faz a tradução.

Campos vazios são descartados: a ActiveCampaign envia todos os campos do contato, inclusive os em branco, e o adapter os remove para que a mensagem não saia com espaço vazio no lugar do token.

retailerId e campaignId já fazem parte da webhookUrl (no path) — não precisam ser configurados em lugar nenhum na ActiveCampaign.

Qualquer variável extra de personalização da campanha vem de um campo personalizado do contato. Em Contatos > Campos (Gerenciar campos), cada campo tem uma Variável no formato %NOME% — essa é a perstag. O adapter recebe a perstag em minúsculas e a repassa como token de personalização com o mesmo nome.

Figura 6: Tela “Gerenciar campos” com as perstags dos campos personalizados

Nomes reservados. Uma perstag chamada fullNumber, retailerId, campaignId, contextId, context_info, context-info ou contextInfo é descartada. O mesmo vale para perstags que colidem com um campo nativo já traduzido (name, lastName, email, externalId, company_name): o valor nativo sempre vence. Ao criar um campo personalizado, evite esses nomes.

Quando a campanha transfere o atendimento para o Whizz, é possível enviar um contexto específico por contato: crie um campo personalizado de texto chamado Context Info (variável %CONTEXT_INFO%) e preencha-o no contato. O adapter usa esse texto como contexto do atendimento daquele disparo.

Figura 7: Contato com a tag de disparo e o histórico da automação (dados de contato ocultados nesta imagem)

A ação Webhook da ActiveCampaign não exibe o código de resposta HTTP na interface. Não há como ver o 202 pela tela da automação — a validação de ponta a ponta é feita pelo resultado na OmniChat.

O 202 cobre também os descartes: é intencional, para que a ActiveCampaign não suspenda o webhook por erro. Um contato sem telefone não gera erro visível na automação — ele simplesmente não recebe a mensagem.