Skip to main content

​
O que é um gatilho

O gatilho é o evento que dá início à automação. Cada automação tem exatamente um gatilho.

​
Lista completa de gatilhos

​
Novo contato criado

Dispara quando um contato entra no workspace pela primeira vez — seja via mensagem recebida no WhatsApp ou criado manualmente. Caso de uso: enviar mensagem de boas-vindas para todos os novos leads.
Quer que o lead novo já entre direto na fila do departamento certo (Vendas, Suporte, Financeiro…)? Isso ainda não acontece automaticamente no primeiro contato. Hoje, você monta esse direcionamento dentro do fluxo desta automação, usando as ações Atribuir atendente ou Rotear para departamento. Veja a diferença completa em Atribuição e roteamento de atendentes.

​
Mensagem recebida

Dispara a cada mensagem recebida de qualquer contato. Configurações adicionais:
  • Filtrar por instância específica (número de WhatsApp)
  • Executar somente uma vez por contato (onlyOnce)
Caso de uso: responder automaticamente fora do horário comercial.

​
Palavra-chave recebida

Dispara apenas quando a mensagem recebida contém uma palavra ou frase específica. Configurações:
  • Lista de palavras-chave (ex: preço, orçamento, quero comprar)
  • Match case-insensitive
Caso de uso: quando alguém digitar “preço”, enviar a tabela de valores.

​
Mensagem veio de anúncio

Dispara apenas quando a conversa começou por um clique em um anúncio do WhatsApp (Click-to-WhatsApp). Ideal para separar leads de mídia paga dos contatos orgânicos que chegam no mesmo número. A identificação usa os metadados da Meta (não o texto), então funciona mesmo que o lead apague a mensagem pré-preenchida. Você pode filtrar por ID do anúncio, tipo de origem (anúncio pago ou publicação orgânica) e instância. Caso de uso: qualificar automaticamente só quem veio de anúncio, aplicar a tag lead-anuncio e rotear para Vendas.
Este gatilho tem um guia completo com todos os filtros e o selo Via Anúncio no chat: veja Veio de anúncio (Click-to-WhatsApp).

​
Sem resposta (X horas)

Dispara quando o lead parou de responder: a última mensagem da conversa é sua e, passadas X horas, ele não respondeu nada. Se o lead responder dentro desse prazo, a automação não dispara. Configurações:
  • Quantidade de horas de espera antes de considerar que o lead sumiu
Caso de uso: reengajar quem sumiu — 4 horas depois da sua última mensagem, enviar um follow-up e aplicar a tag sem-resposta para o time acompanhar. É o que o modelo pronto Recuperação de não-resposta já faz.

​
Tag adicionada ao contato

Dispara quando uma tag específica é adicionada a um contato. Configurações:
  • Qual tag deve ser adicionada para disparar
Caso de uso: quando a tag “proposta-enviada” for adicionada, aguardar 2 dias e perguntar se o cliente tem dúvidas.

​
Tag removida do contato

Dispara quando uma tag específica é removida de um contato.

​
Negócio criado

Dispara quando um novo card (negócio) é criado em qualquer pipeline — pelo Kanban, pela ficha do contato, por um formulário ou pela API. Configurações:
  • Pipeline específico (opcional — em branco dispara para qualquer pipeline)
Caso de uso: assim que um novo negócio entra no funil, enviar uma mensagem de boas-vindas ao lead e criar uma tarefa de primeiro contato para o atendente.
Se você criar o card já em uma etapa de ganho ou perda, o gatilho Negócio criado dispara mesmo assim — ele reage à criação, não à etapa.

​
Contato atualizado

Dispara quando os dados de um contato são editados na ficha do contato. Só dispara quando há uma mudança real em pelo menos um destes campos:
  • Nome
  • E-mail
  • Telefone
  • Observações (notas)
  • Tags
Salvar a ficha sem alterar nada não dispara o gatilho. Configurações:
  • Filtrar por campos específicos (opcional): a automação só dispara se um dos campos escolhidos mudar. Em branco, dispara para qualquer um dos campos acima.
Caso de uso: quando o e-mail de um contato for preenchido, enviar os dados atualizados para uma planilha ou para o seu sistema externo via webhook.
Isso não gera loop. Quando uma automação usa a ação Atualizar contato, a escrita é feita direto no banco — ela não passa pelo caminho que emite o gatilho “Contato atualizado”. Ou seja: uma automação alterar o contato nunca dispara outra automação de “Contato atualizado”. O gatilho só dispara quando uma pessoa edita a ficha manualmente. Além disso, o motor de automações tem proteção de deduplicação de 30 segundos por contato como defesa adicional.

​
Mudança de etapa no pipeline

Dispara quando um card é movido para uma etapa específica do pipeline. Configurações:
  • Pipeline de origem
  • Etapa de destino
Caso de uso: quando o card entrar em “Proposta Enviada”, enviar confirmação por WhatsApp.

​
Negócio ganho

Dispara quando um card é movido para uma etapa de ganho (ou marcado com status Ganho) no pipeline. Caso de uso: enviar mensagem de parabéns e iniciar o fluxo de onboarding do cliente.

​
Negócio perdido

Dispara quando um card é marcado como Perdido. Caso de uso: enviar uma pesquisa de motivo de perda ou agendar um follow-up de reativação para daqui a 30 dias.

​
Webhook recebido

Dispara quando um sistema externo envia uma requisição POST para o endpoint único da automação. Como usar:
  1. Configure o gatilho como Webhook recebido
  2. O Vistum gera uma URL única (ex: /api/automations/webhook-in/TOKEN)
  3. Configure seu sistema externo (checkout, n8n, Zapier, etc.) para fazer POST nessa URL
Filtro por evento: o filtro diz ao Vistum para só disparar quando um campo do payload tiver um valor específico. Como ele se comporta depende da plataforma escolhida no gatilho:
  • Plataforma reconhecida (Hotmart, Kiwify, Eduzz, Perfect Pay…): o filtro certo já vem aplicado. Só a compra aprovada dispara — reembolso, cancelamento e boleto não pago são ignorados sozinhos. Configurar o filtro na mão é opcional: faça isso apenas se quiser disparar em um evento diferente do padrão.
  • Webhook genérico: não há filtro padrão — todo evento que chegar dispara a automação. Aqui o filtro na mão é necessário se você não quiser que reembolso e cancelamento caiam no mesmo fluxo da venda.
Eventos que não batem com o filtro ficam registrados como filtrados e não disparam a automação. Veja Reembolso e cancelamento abaixo. Caso de uso: quando um formulário for preenchido no site, criar o lead no Vistum e disparar a automação.

​
Escutar vários eventos de uma vez

O mesmo gatilho de webhook pode reagir a mais de um evento ao mesmo tempo. Assim, uma única automação dispara em qualquer um dos eventos que você escolher — por exemplo, em “Compra aprovada” OU “Pagamento atrasado”. No filtro de evento, os eventos aparecem como etiquetas (chips): clique para adicionar cada evento que deve disparar a automação e clique no x da etiqueta para remover. Se você deixar mais de um evento selecionado, basta um deles acontecer para a automação rodar.
Isso é útil quando a reação é a mesma para vários status. Ex.: em “Compra aprovada” e em “Pagamento atrasado” você quer avisar o mesmo time ou mover o card — em vez de manter duas automações, você seleciona os dois eventos no mesmo gatilho.
Cada automação tem um token único. Se o token for comprometido, você pode rotacioná-lo em Configurações do webhook da automação.

​
Reembolso e cancelamento

O Vistum ainda não tem um gatilho dedicado de “pagamento reembolsado”. Até lá, você reage a reembolso e cancelamento com uma segunda automação de gatilho Webhook recebido, apontando o filtro de evento para o evento de reembolso do seu checkout.
Você não precisa disso para impedir que um reembolso dispare a sua automação de venda: com a plataforma selecionada, o Vistum já filtra isso por padrão. Os passos abaixo servem para quando você quer reagir ao reembolso.
1

Crie uma segunda automação com o gatilho Webhook recebido

Em Automações → Nova Automação, selecione o gatilho Webhook recebido e a mesma plataforma da automação de venda. O Vistum gera uma URL única.
2

Cole a URL no checkout

No painel do seu checkout (Hotmart, Kiwify, etc.), cadastre essa URL como destino de webhook e marque os eventos de reembolso/cancelamento.
3

Aponte o filtro para o evento de reembolso

Nas configurações do gatilho, defina o filtro de evento com o evento de reembolso da plataforma — por exemplo PURCHASE_REFUNDED na Hotmart ou myeduzz.invoice_refunded na Eduzz.Como você definiu um filtro, ele substitui o padrão de compra aprovada: essa automação passa a reagir só ao reembolso.
4

Monte a ação de reação

No fluxo, adicione as ações que quer executar nesse caso, por exemplo:
  • Mover o negócio do contato para uma etapa “Reembolsado”
  • Adicionar a tag reembolso
  • Enviar uma mensagem de confirmação ao cliente
  • Avisar o time por webhook de saída
5

Ative e teste

Ative a automação e faça um reembolso de teste no checkout (ou reenvie o evento pelo painel do checkout) para confirmar que dispara.
Os campos recebidos no webhook ficam disponíveis nas ações com o prefixo webhook. — {{webhook.status}}, {{webhook.product}}, {{webhook.amount}}, {{webhook.date}} (data do evento) e {{webhook.paymentLink}} (link de pagamento) aparecem na lista de sugestões, no grupo Webhook. Veja todas em Usar variáveis nas mensagens.

​
Acompanhar a execução

Toda vez que um gatilho dispara, a execução fica registrada. Para acompanhar:
  1. Acesse Histórico no menu lateral
  2. Filtre por automação e por status (sucesso / erro / filtrado / dedup)
  3. Clique em uma execução para ver o passo a passo e as variáveis recebidas
Execuções com status dedup não são erros — significam que a automação foi bloqueada de propósito para evitar repetição em curto intervalo. Execuções filtrado significam que o webhook chegou, mas não bateu com o filtro de evento configurado.