ActiveCampaign
Disparar mensagens no WhatsApp a partir dos eventos da sua automação de marketing.
Cada evento gerado pelo webhook do ActiveCampaign pode disparar uma mensagem no WhatsApp.
O que é o ActiveCampaign
O ActiveCampaign é uma plataforma de automação de marketing e relacionamento com clientes: e-mails, listas e funis de contatos.
Para que serve a integração
Quando algo acontece nas suas automações do ActiveCampaign, como um contato entrar em uma lista, a SM Click envia uma mensagem no WhatsApp. Assim o WhatsApp passa a fazer parte do seu funil de marketing.
Requisitos
Uma instância ativa na SM Click, para enviar as mensagens. Ela está disponível no plano Gamma ou pode ser adquirida separadamente no gerenciamento da assinatura.
Antes de começar, você vai criar a URL na SM Click e depois configurar o webhook no ActiveCampaign — nessa ordem.
Passo 1 — Criar a integração na SM Click
No menu Integrações → Nativas, clique em Webhooks com a logo do ActiveCampaign.
Na tela seguinte, escolha um nome e preencha:
| Campo | O que é |
|---|---|
| Campo de Telefone | O nome do campo que carrega o telefone no payload do ActiveCampaign |
| Instância que enviará as mensagens | A instância conectada que vai disparar |
| ID do Template | Só para instância da API Oficial. Deixe vazio nas demais |
Para preencher Instância que enviará as mensagens, acesse a Home da SM Click, localize a instância, clique em Copiar token e cole o valor nesse campo.
Depois crie as regras — as mensagens ou arquivos a enviar. Clique em Salvar Integração.
Passo 2 — Copiar a URL
Com a integração salva, copie a URL gerada.
Passo 3 — Configurar o webhook no ActiveCampaign
Cole essa URL no webhook do ActiveCampaign.
Escolha os eventos que devem disparar o envio.
A variável do telefone precisa bater
Este é o ponto em que a integração mais falha.
A variável que coleta o telefone no ActiveCampaign precisa ser configurada de forma
idêntica na SM Click. Por padrão ela é contact[phone] — então é exatamente isso que
deve constar no campo Telefone das configurações da integração aqui.
Se a variável no ActiveCampaign se chama de um jeito e na SM Click de outro, a plataforma não encontra o número — e a mensagem não é enviada.
No relatório isso aparece como “Campo do Telefone informado na integração não existe no Payload enviado pelo Webhook do Active Campaign”. Se estiver em dúvida sobre o nome, dispare o evento uma vez e copie a chave direto do Payload.
O nome é comparado exatamente como veio, incluindo os colchetes de contact[phone].
Aqui não vale caminho com ponto: a chave é procurada no primeiro nível do payload, como o
ActiveCampaign a envia.
Usar os dados do evento na mensagem
Qualquer campo do payload pode entrar no texto entre chaves. Se o ActiveCampaign manda
contact[first_name], escrever:
Olá {contact[first_name]}, vi que você se inscreveu na nossa lista.
envia a mensagem com o nome preenchido. Vale para qualquer chave do primeiro nível do payload.
Uma URL por evento
Para organizar, dá para criar um link diferente na SM Click para cada evento do webhook. Assim cada situação tem sua própria mensagem, personalizada.
Texto ou arquivo
Cada regra é de um dos dois tipos:
Texto — a mensagem, com ou sem variáveis.
Arquivo — imagem, áudio ou documento. A plataforma reconhece o tipo e envia da forma correspondente: imagem como imagem, áudio como mensagem de voz, o resto como anexo.
Várias regras na mesma integração são executadas na ordem, e o relatório mostra o resultado de cada uma.
Envio por API Oficial
Na API Oficial não se envia texto livre para quem não falou com você antes — é preciso um template aprovado.
Preencha o ID do Template na integração. As variáveis do template são preenchidas pelo
nome da chave do payload, e a variável chamada mensagem (ou message) recebe o texto
da primeira regra, já com as chaves substituídas.
Sem o ID do template, a integração envia texto comum — que na API Oficial só funciona dentro da janela de 24 horas.
Quando o envio for realizado por template, não preencha o campo Mensagem, pois o conteúdo já está configurado no template.
Acompanhando
O relatório tem duas partes, e cada uma responde uma pergunta diferente:
| Parte | O que mostra |
|---|---|
| Payload | O conteúdo que o webhook enviou, como veio |
| Resultado | A mensagem montada e o status do envio |
Quando algo não chega ao cliente, o Payload diz se o evento sequer chegou, e o Resultado diz se a mensagem foi montada e o que aconteceu ao enviá-la.
O relatório da integração mostra o que foi recebido e enviado.
E o conteúdo recebido do webhook fica visível para conferência.
Quando não sai mensagem
O relatório registra o motivo. Os que aparecem:
| O que o relatório diz | O que fazer |
|---|---|
| Integração desabilitada | Ative a integração na tela dela |
| Instância desconectada | Reconecte o canal → Instância desconectada |
| Campo do Telefone não existe no Payload | A chave não bate. Confira no Payload |
| Não foi possível validar o número informado | O valor não é um telefone válido |
| Template não encontrado | O ID do template está errado ou o template foi apagado |
| Tipo de configuração inválido | A regra não é texto nem arquivo. Recadastre |
Se não aparece nenhum registro no relatório, o evento não chegou a chamar a URL — o problema está na configuração do webhook do lado do ActiveCampaign.
Testando
Vale disparar o evento uma vez antes de colocar em produção. O teste mostra o payload real, e é o payload real que decide se a chave do telefone bate.
Relacionado
WordPress
Mesmo modelo de webhook, com formulário.
Como funcionam as integrações
O que é comum a todas.
Atualizado em