# Gatilhos das automações: o que pode iniciar uma automação na WavUps CRM

> O gatilho é o acontecimento que inicia uma automação na WavUps CRM. São 24 gatilhos em seis grupos: **Atendimento com IA**, **Leads**, **Pipeline**, **Agenda**, **Faturas** e **Instagram**. Os de tempo, como **Negócio parado na etapa** e **Fatura vencida sem pagamento**, são verificados a cada 15 minutos.

Fonte: Central de ajuda da WavUps CRM — https://crm.wavups.com/docs/automacoes/gatilhos (atualizado em 8 de outubro de 2026)

## Como escolher o gatilho

No construtor, o bloco **Quando** mostra todos os gatilhos agrupados. Clique no que representa o acontecimento e, se ele tiver opções, preencha-as logo abaixo. Cada automação tem um gatilho só; para reagir a dois acontecimentos diferentes, crie duas automações.

![Bloco Quando com os gatilhos dos grupos Atendimento com IA, Leads e Pipeline.](https://crm.wavups.com/images/docs/automacoes-gatilhos.png)

O gatilho também define **quais dados a automação recebe** (lead, negócio, conversa, agendamento...). Isso decide quais [condições](https://crm.wavups.com/docs/automacoes/condicoes), [ações](https://crm.wavups.com/docs/automacoes/acoes) e variáveis ficam disponíveis. Por exemplo: **Lead criado** traz só o lead, então ações que precisam de uma conversa, como **Enviar mensagem no WhatsApp**, ficam desabilitadas.

## Todos os gatilhos

| Gatilho | Dispara quando | Opções | Dados disponíveis |
| --- | --- | --- | --- |
| **Atendimento gerado pela IA** | A IA registra um atendimento (lead atendido). | Nenhuma. | atendimento, conversa, lead, negócio |
| **Conversa precisa de humano** | A conversa passa para o estado 'Precisa de humano'. | Nenhuma. | conversa, lead, negócio |
| **Contato sem resposta** | A conversa passa para o estado 'Sem resposta'. | Nenhuma. | conversa, lead, negócio |
| **Lead criado** | Um lead é cadastrado por qualquer origem (WhatsApp, Instagram, formulário, anúncio, API, importação ou manualmente). | Nenhuma. | lead |
| **Lead alterado** | A situação, a temperatura, o tipo ou o responsável do lead muda. | **Quais mudanças disparam a automação** (obrigatório): Situação, Temperatura, Tipo e/ou Responsável. | lead, negócio |
| **Etiqueta adicionada ao lead** | Uma etiqueta é adicionada ao lead. | **Etiquetas**: em branco dispara com qualquer etiqueta. | lead, negócio |
| **Negócio criado** | Um negócio é criado em um pipeline. | **Pipeline** e **Etapa** (em branco: qualquer). | negócio, lead |
| **Negócio movido de etapa** | Um negócio muda de etapa. | **Pipeline**, **Saindo da etapa** e **Entrando na etapa** (em branco: qualquer). | negócio, lead |
| **Negócio ganho ou perdido** | O status do negócio muda (ganho, perdido ou reaberto). | **Pipeline** e **Novo status**: Ganho, Perdido ou Aberto (em branco: qualquer). | negócio, lead |
| **Negócio parado na etapa** | Um negócio aberto fica X dias na mesma etapa. Dispara uma vez a cada entrada do negócio na etapa. | **Pipeline** (obrigatório), **Etapa** (em branco: qualquer) e **Dias parado na etapa** (1 a 365). | negócio, lead |
| **Previsão de fechamento vencida** | A data prevista de fechamento de um negócio aberto passa. | **Pipeline** (em branco: qualquer). | negócio, lead |
| **Agendamento criado** | Um agendamento é criado. | **Tipos de agendamento**: Evento, Tarefa e/ou Lembrete (em branco: qualquer tipo). | agendamento, lead, negócio, conversa |
| **Agendamento reagendado ou editado** | A data, o horário ou o título de um agendamento muda. | Nenhuma. | agendamento, lead, negócio, conversa |
| **Agendamento excluído** | Um agendamento é excluído. | Nenhuma. | agendamento, lead, negócio, conversa |
| **Status do agendamento mudou** | O agendamento é cancelado, concluído ou volta para agendado. | **Novo status**: Agendado, Concluído ou Cancelado (em branco: qualquer). | agendamento, lead, negócio, conversa |
| **Antes do agendamento** | X minutos antes do início de um agendamento ativo. | **Minutos antes do início** (obrigatório). | agendamento, lead, negócio, conversa |
| **Agendamento não concluído** | X minutos depois do início, se o agendamento ainda não foi concluído nem cancelado. | **Minutos depois do início** (obrigatório). | agendamento, lead, negócio, conversa |
| **Fatura criada** | Uma fatura é criada na WavUps CRM. As parcelas geradas pelo gateway de pagamento não disparam de novo, e faturas importadas do gateway (pela sincronização ou criadas direto no gateway) também não disparam. | Nenhuma. | fatura, lead, negócio, conversa |
| **Fatura editada** | O valor, o vencimento ou a descrição de uma fatura ou parcela muda. | Nenhuma. | fatura, lead, negócio, conversa |
| **Status da fatura mudou** | Uma fatura ou parcela muda de status, inclusive quando o gateway de pagamento avisa que ela foi paga, venceu ou foi estornada. | **Novo status**: um ou mais (em branco: qualquer). Para "paga", marque Recebida, Confirmada e Recebida em dinheiro. | fatura, lead, negócio, conversa |
| **Fatura excluída** | Uma fatura é excluída (as parcelas excluídas junto com ela não disparam de novo). | Nenhuma. | fatura, lead, negócio, conversa |
| **Fatura perto do vencimento** | X dias antes do vencimento de uma fatura ou parcela aguardando pagamento, às 9h. | **Dias antes do vencimento** (obrigatório). | fatura, lead, negócio, conversa |
| **Fatura vencida sem pagamento** | X dias depois do vencimento, se a fatura ou parcela ainda não foi paga, às 9h. | **Dias depois do vencimento** (obrigatório). | fatura, lead, negócio, conversa |
| **Menção em story** | A conta integrada é mencionada em um story. | Nenhuma. | Instagram, lead |

> **Negócio e conversa "do lead"**
> Quando o gatilho não é de negócio (por exemplo, **Atendimento gerado pela IA**), o negócio usado pela automação é o negócio **aberto** mais recente do lead. Se o lead não tiver negócio aberto, as ações e condições de negócio não têm o que usar.

## Gatilhos de tempo

Seis gatilhos não dependem de alguém fazer algo, e sim do relógio: **Negócio parado na etapa**, **Previsão de fechamento vencida**, **Antes do agendamento**, **Agendamento não concluído**, **Fatura perto do vencimento** e **Fatura vencida sem pagamento**. A WavUps CRM verifica esses casos **a cada 15 minutos**, então o disparo pode acontecer até 15 minutos depois do momento exato.

- **Antes do agendamento:** use intervalos a partir de 15 minutos para mais precisão (por exemplo, 60 minutos antes).
- **Negócio parado na etapa:** dispara uma vez por entrada na etapa. Se o negócio sair e voltar para a mesma etapa, a contagem recomeça.
- **Agendamento não concluído:** considera só agendamentos que começaram nos últimos 7 dias e ainda estão com status agendado.
- **Gatilhos de fatura:** disparam a partir das **9h (horário de Brasília)** do dia, para a mensagem nunca chegar ao cliente de madrugada, e só para faturas **Aguardando pagamento** ou **Vencidas**.

## Gatilhos de faturas

Os gatilhos de **Faturas** trazem a fatura para a automação, com o lead e o negócio dela. Nas mensagens, use as variáveis `{{invoice.invoiceNumber}}`, `{{invoice.formattedAmount}}` (valor em reais), `{{invoice.dueDate}}` (vencimento), `{{invoice.statusLabel}}`, `{{invoice.publicUrl}}` (página da fatura na WavUps CRM) e `{{invoice.invoiceUrl}}` (link de pagamento do gateway).

- **Parcelas:** quando a cobrança é parcelada no gateway, cada parcela vence e é paga separadamente, então os gatilhos de status, edição e vencimento disparam por parcela. Para reagir só à fatura principal, adicione a condição **Fatura ou parcela** é **Fatura**.
- **Faturas sem gateway:** elas não mudam para **Vencida** sozinhas. Use **Fatura vencida sem pagamento**, que olha a data de vencimento e funciona com ou sem gateway.
- **Link de pagamento:** quando a fatura é criada com cobrança no gateway, a cobrança nasce junto com ela. Por isso o gatilho **Fatura criada** já recebe o link de pagamento em `{{invoice.invoiceUrl}}` e a página da fatura em `{{invoice.publicUrl}}`: dá para mandar o link ao cliente no mesmo momento em que a fatura é criada. Fatura sem gateway não tem `{{invoice.invoiceUrl}}`; use `{{invoice.publicUrl}}`.
- **Faturas importadas:** as faturas trazidas do gateway pela sincronização (ou criadas direto no painel do gateway) entram como histórico e **não** disparam **Fatura criada**. Os outros gatilhos de fatura, como mudança de status e vencimento, valem para elas normalmente.

## Gatilhos do Instagram

O gatilho **Menção em story** funciona com a conta do Instagram integrada em **Integrações**.

## Na prática

### Lembrar o cliente antes da consulta

**Situação:** Uma clínica perde horários porque os pacientes esquecem da consulta.

**Como a WavUps CRM ajuda:** Gatilho **Antes do agendamento** com 1440 minutos (um dia) + ação **Enviar template de WhatsApp** com `{{scheduling.startDate}}` numa variável do template.

### Recuperar quem faltou

**Situação:** O cliente não aparece e ninguém marca o agendamento como concluído ou cancelado.

**Como a WavUps CRM ajuda:** Gatilho **Agendamento não concluído** com 30 minutos + ação **Criar lembrete de follow-up** para o responsável do lead ligar e reagendar.

### Mandar o link de pagamento na hora

**Situação:** Uma escola cria a fatura da matrícula e o responsável do aluno quer pagar no mesmo dia.

**Como a WavUps CRM ajuda:** Gatilho **Fatura criada** + ação **Enviar template de WhatsApp** com `{{invoice.invoiceUrl}}` (ou `{{invoice.publicUrl}}`) numa variável do template. O cliente recebe o link assim que a fatura é criada.

### Cobrar a fatura vencida

**Situação:** Clientes esquecem boletos e ninguém percebe até o fim do mês.

**Como a WavUps CRM ajuda:** Gatilho **Fatura vencida sem pagamento** com 1 dia + ação **Enviar template de WhatsApp** com `{{invoice.invoiceUrl}}` numa variável do template, e **Notificar usuários** para o responsável do lead acompanhar.

### Previsão de fechamento que passou

**Situação:** Negócios com data prevista vencida continuam no funil como se estivessem em dia.

**Como a WavUps CRM ajuda:** Gatilho **Previsão de fechamento vencida** + ação **Notificar usuários** para o dono do negócio atualizar a previsão ou encerrar.

## Perguntas frequentes

### Posso usar dois gatilhos na mesma automação?

Não. Cada automação tem um gatilho. Para dois acontecimentos, crie duas automações (o **Duplicar** ajuda a copiar as ações).

### O gatilho "Lead criado" funciona para leads importados?

Sim. Ele dispara para leads cadastrados por qualquer origem: WhatsApp, Instagram, formulário, anúncio, API, importação ou manualmente.

### Por que a automação de "Negócio parado" demorou para rodar?

Os gatilhos de tempo são verificados a cada 15 minutos. Além disso, a automação precisa estar **Ativa** e o negócio, aberto.

### Qual a diferença entre "Negócio movido de etapa" e "Negócio parado na etapa"?

**Negócio movido de etapa** dispara no momento em que o negócio muda de etapa. **Negócio parado na etapa** dispara quando ele fica X dias sem sair da etapa.

### Como disparar uma automação quando a fatura for paga?

Use **Status da fatura mudou** e marque **Recebida**, **Confirmada** e **Recebida em dinheiro** em **Novo status**. Pagamentos confirmados pelo gateway também disparam.

### O gatilho "Fatura criada" já tem o link de pagamento?

Sim, quando a fatura é criada com cobrança no gateway: a cobrança nasce junto com a fatura, então `{{invoice.invoiceUrl}}` já vem preenchido. A página da fatura, em `{{invoice.publicUrl}}`, existe para toda fatura.

### Faturas importadas do gateway disparam "Fatura criada"?

Não. Faturas trazidas pela sincronização com o gateway, ou criadas direto no gateway, são histórico e não disparam **Fatura criada**. Mudanças de status e os gatilhos de vencimento continuam valendo para elas.

### O gatilho "Lead alterado" dispara quando mudo o telefone do lead?

Não. Ele só observa a situação, a temperatura, o tipo e o responsável do lead, conforme você marcar em **Quais mudanças disparam a automação**.

## Veja também

- [Como criar uma automação na WavUps CRM (passo a passo)](https://crm.wavups.com/docs/automacoes/criar-automacao)
- [Condições das automações: como filtrar quando a automação roda](https://crm.wavups.com/docs/automacoes/condicoes)
- [Ações das automações: tudo o que a WavUps CRM pode fazer sozinha](https://crm.wavups.com/docs/automacoes/acoes)
