Campanhas com gatilho externo são ativadas automaticamente quando um evento do seu CRM ocorre — como a criação de um novo contato ou a atualização de um negócio. Isso permite que cada lead receba uma abordagem imediata sem depender de ação humana. Por exemplo, quando um deal é criado no HubSpot, a Nuvia pode disparar automaticamente uma sequência de boas-vindas via WhatsApp em segundos.
Neste artigo:
Disponível em: todos os planos.
Quem pode fazer: administradores e gestores com acesso ao módulo Campanhas.
Módulo: Menu lateral > Campanhas
O que você precisa antes de começar
Uma integração de CRM configurada na plataforma (HubSpot, Salesforce ou webhook customizado) — configure em Plataforma > Integrações
Ao menos uma inbox WhatsApp conectada
Ao menos um template WhatsApp aprovado pela Meta
Entender quais eventos do CRM você quer usar como gatilho (ex: criação de contato, atualização de negócio)
Para configurar integrações de CRM, consulte Como configurar webhooks de CRM.
Conceitos fundamentais
Conceito
| O que é
| Quando usar
|
Gatilho externo
| Um evento vindo de um sistema externo (CRM) que aciona a campanha automaticamente
| Quando você quer que a campanha reaja a eventos do CRM sem intervenção manual
|
Evento de CRM
| Ação registrada no CRM que dispara o webhook — como criação de contato, atualização de negócio
| Para definir em quais situações a campanha deve ser acionada
|
Filtros de contato
| Critérios adicionais aplicados sobre o evento para refinar quais contatos entram na campanha
| Quando nem todo evento deve acionar a campanha (ex: apenas contatos de um segmento específico)
|
Audiência dinâmica
| A audiência da campanha cresce conforme eventos ocorrem — não há lista fixa de contatos
| Entender que o total de contatos da campanha não é definido na criação, mas evolui ao longo do tempo
|
Criar uma campanha com gatilho externo
No menu lateral, clique em Campanhas
Clique em Nova campanha
Preencha o Nome da campanha (máximo de 100 caracteres)
Selecione o canal WhatsApp Business
Clique em Próximo
Configurar os eventos de ativação
Em Tipo de ativação, selecione Gatilho externo
A descrição exibida é: "Utilize um sinal ou um evento do funil para criar sua audiência"
Em Eventos de ativação, marque os eventos que devem acionar a campanha:
Contato criado — quando um novo contato é criado no CRM
Contato atualizado — quando os dados de um contato existente são alterados no CRM
Negócio criado — quando um novo deal/negócio é criado no CRM
Negócio atualizado — quando um deal/negócio existente é alterado no CRM
Você pode selecionar múltiplos eventos simultaneamente
💡 Dica: Selecionar Negócio criado é ideal para campanhas de boas-vindas automáticas. Selecionar Contato atualizado é útil para campanhas de reativação quando um campo específico do contato muda.
O que muda na interface
Ao selecionar gatilho externo, a interface se adapta:
A opção de selecionar lista ou funil como audiência não é exibida — a audiência é automaticamente definida como dinâmica
O preview de audiência exibe o placeholder "Audiência dinâmica — contatos entram conforme eventos ocorrem" em vez de um número fixo de contatos
O campo Contatos na tela de detalhes exibirá "Dinâmico"
Aplicar filtros sobre os eventos
Nem todo evento do CRM deve necessariamente acionar a campanha. Use filtros para refinar quais contatos entram:
Abaixo dos eventos selecionados, clique em Filtros avançados
Configure filtros por campos do contato:
Campos fixos: Nome, E-mail, Telefone, País
Campos customizados da empresa
Use operadores como: igual, diferente, contém, não contém, começa com, está vazio, não está vazio
Combine filtros com lógica AND/OR — crie grupos de condições aninhadas conforme necessário
O sistema avaliará esses filtros sobre cada contato associado ao evento de CRM. Apenas contatos que atendem aos critérios serão inscritos na campanha.
Configurar ajustes adicionais
Em Ajustes adicionais:
Ignorar horário comercial — ative se os eventos de CRM podem acontecer a qualquer hora e você quer envio imediato (por padrão, envios são feitos apenas entre 08h–18h, segunda a sexta)
Clique em Próximo e confirme no dialog de confirmação.
⚠️ Importante: Após confirmar, a campanha é criada com status Rascunho. Os eventos de gatilho e os filtros de audiência ficam imutáveis — não é possível alterá-los depois.
Montar a sequência e lançar
O Passo 3 — Sequência de mensagens — funciona da mesma forma que em campanhas manuais:
Clique em Adicionar Etapa
Configure cada etapa: Conexão (inbox), Tipo de envio (Template ou Texto), conteúdo, delay e atribuição de conversa
Após configurar as etapas, clique em Lançar campanha
A campanha muda para status Ativa e passa a escutar os eventos de CRM configurados
Para detalhes sobre como configurar etapas, consulte Como criar e lançar uma campanha.
O que acontece quando um evento é disparado
Quando um evento do CRM ocorre (ex: contato criado no HubSpot), o sistema executa a seguinte sequência:
O webhook envia o evento para a Nuvia
O sistema identifica todas as campanhas ativas que monitoram aquele tipo de evento
Para cada campanha encontrada:
Verifica se o contato atende aos filtros configurados
Verifica se o contato já está inscrito na campanha (evita duplicidade)
Verifica se o contato já completou a campanha anteriormente
Verifica se o contato já possui uma conversa ativa na plataforma (se sim, pula o enrollment)
Se aprovado em todas as verificações, um enrollment é criado e a primeira etapa é enqueued para envio
Dados do evento disponíveis para variáveis
Os dados enviados pelo CRM junto com o evento ficam armazenados no enrollment (external_data). Esses dados podem ser usados para personalizar variáveis nos templates da campanha, permitindo mensagens contextualizadas com informações do negócio ou da interação que gerou o evento.
Limites e regras
Regra
| Valor
|
Eventos de CRM suportados
| Contato criado, Contato atualizado, Negócio criado, Negócio atualizado
|
Múltiplos eventos por campanha
| Sim — você pode selecionar mais de um evento
|
Deduplicação
| Um contato só pode ser inscrito uma vez por campanha. Se o mesmo evento ocorrer novamente para o mesmo contato, ele não será reinscrito
|
Contato com conversa ativa
| Se o contato já possui uma conversa ativa na plataforma, o enrollment é ignorado
|
Imutabilidade
| Eventos de gatilho e filtros de audiência não podem ser alterados após a criação da campanha
|
Horário comercial
| Aplica-se normalmente — mensagens fora do horário ficam em fila, a menos que Ignorar horário comercial esteja ativado
|
Contatos já completos
| Se um contato já completou o ciclo da campanha, ele não será reinscrito por um novo evento
|
Erros comuns e soluções
Problema
| Causa provável
| Solução
|
Campanha ativa mas nenhum contato inscrito
| Os eventos de CRM não estão chegando à plataforma
| Verifique se a integração de CRM está configurada e ativa em Plataforma > Integrações. Confirme que o webhook está apontando para o endpoint correto
|
Evento foi disparado mas contato não foi inscrito
| O contato não atende aos filtros configurados, já está inscrito ou já completou a campanha
| Verifique os filtros aplicados na campanha. Confira se o contato já não foi processado anteriormente
|
Contato inscrito mas mensagem não enviada
| Fora do horário comercial ou contato sem número de WhatsApp válido
| Verifique o status do enrollment na campanha. Aguarde a próxima janela de horário comercial ou ative Ignorar horário comercial
|
Evento de CRM duplicado inscrevendo o mesmo contato
| Não acontece — o sistema deduplica por contato
| Se perceber duplicidade, verifique se existem múltiplas campanhas ativas monitorando o mesmo evento
|
Perguntas frequentes
Posso usar o mesmo evento em várias campanhas?
Sim. Múltiplas campanhas ativas podem monitorar o mesmo tipo de evento. Quando o evento ocorre, todas as campanhas elegíveis processam o contato independentemente. Cuidado para não enviar mensagens duplicadas ao prospect por campanhas diferentes.
O que acontece se eu pausar a campanha?
Novos eventos de CRM não serão processados enquanto a campanha estiver pausada. Enrollments já existentes ficam preservados — ao reativar, eles retomam do ponto onde pararam, mas eventos que ocorreram durante a pausa são perdidos.
Posso configurar gatilho externo junto com lista de contatos?
Não. Ao selecionar gatilho externo, a audiência é automaticamente definida como dinâmica. Não é possível combinar gatilho externo com lista fixa ou funil na mesma campanha.
Como sei se a integração de CRM está funcionando?
Acesse Plataforma > Integrações e verifique o status da conexão com o CRM. Após configurar a campanha, crie um contato ou negócio de teste no CRM e verifique se o enrollment é criado na campanha.
Posso filtrar eventos por dados do negócio (deal)?
Os filtros aplicáveis são sobre campos do contato associado ao evento. Filtros diretos por campos do negócio (ex: valor do deal, etapa do pipeline) dependem de como o CRM envia os dados via webhook. Os dados do evento ficam disponíveis no campo external_data do enrollment.
Quantas campanhas podem monitorar o mesmo evento simultaneamente?
Não há limite. Todas as campanhas ativas com o evento configurado processarão o contato quando ele ocorrer. O processamento é independente entre campanhas.
Se a integração de CRM cair, os eventos são enfileirados?
Não. Eventos de CRM que não chegam à plataforma durante uma indisponibilidade da integração são perdidos. É recomendável monitorar a saúde da integração em Plataforma > Integrações e configurar alertas no lado do CRM.