Automações - Criar e Editar Automação

O que é

Esta é a tela onde você monta uma automação de verdade: escolhe em qual tipo de registro ela vai atuar, o que precisa acontecer para ela disparar e o que ela faz quando dispara. É a mesma tela para criar uma automação do zero, criar a partir de um dos modelos prontos oferecidos na listagem, ou editar uma automação que você já tem salva.

Você chega aqui de duas formas: clicando em Nova automação na listagem de Automações (com o formulário em branco ou já preenchido, se veio de um modelo pronto), ou clicando no ícone de lápis de uma automação existente para editá-la. Hoje o sistema oferece 9 tipos de registro (chamados de entidade alvo), 36 gatilhos possíveis e 25 ações possíveis ao todo - mas cada tela só mostra as combinações compatíveis com o tipo de registro escolhido e com os módulos que a sua agência tem contratados.

Como usar

1. Vá em Configurações > Automações e clique em Nova automação, no canto superior direito, ou no ícone de lápis de uma automação existente para editá-la.
2. Em Informações básicas, preencha:
   • Nome da automação - obrigatório, até 100 caracteres. É o que identifica a regra na listagem.
   • Descrição - opcional, até 500 caracteres, para lembrar depois o que essa automação faz.
   • Automação ativa - checkbox marcado por padrão. Desmarque para salvar a regra sem que ela dispare ainda.
3. Em Entidade alvo, escolha o tipo de registro que a automação vai observar: Cliente, Excursão, Reserva (passageiro), Pedido, Lead (CRM), Oportunidade (CRM), Venda de ingresso, Venda de passeio/experiência ou Conta a pagar. Trocar a entidade limpa o gatilho e a ação escolhidos, se eles não fizerem sentido para o novo tipo.
4. Em Quando isso acontecer (Gatilho), escolha o Tipo de gatilho. A lista muda de acordo com a entidade escolhida no passo anterior (por exemplo, só Reserva mostra "Check-in realizado" e "Viagem em X dias"). Alguns gatilhos abrem campos extras logo abaixo: "Etapa alterada" pede a etapa do funil, "Sem atividade" pede o número de dias parado, e "Tag adicionada"/"Tag removida" deixam escolher uma tag específica (ou deixar em branco para valer para qualquer tag).
5. Ainda nesse bloco, use os Filtros adicionais por tags da entidade (aparece assim que você escolhe entidade e gatilho) para restringir quando a regra dispara: exigir todas as tags de uma lista, exigir pelo menos uma delas, ou excluir registros que tenham alguma tag específica.
6. Em Executar esta ação, escolha o Tipo de ação. Se a ação escolhida tiver campos de configuração, eles aparecem logo abaixo (veja a lista completa em "O que você precisa saber antes").
7. Clique em Criar automação (ou Salvar alterações, na edição), no rodapé do formulário.

Modelos prontos

Ao abrir Nova automação a partir de um card de modelo, na tela de listagem, os campos já chegam preenchidos com nome, descrição, entidade, gatilho e ação sugeridos. Você pode alterar qualquer campo antes de salvar - o modelo é só um ponto de partida.

O que você precisa saber antes

• A automação não é retroativa. Ela só passa a valer para eventos que acontecerem depois de criada e ativa. Pedidos já pagos, reservas já confirmadas ou clientes já cadastrados antes da automação existir não disparam a regra.
• Se duas automações usam o mesmo gatilho e a mesma entidade, as duas rodam. O sistema não escolhe só uma: todas as automações ativas e compatíveis com aquele evento são executadas, uma depois da outra, na ordem em que aparecem na listagem. Se uma delas falhar, isso não impede as demais de rodarem normalmente.
• Nem toda ação tem campo de configuração na tela hoje. Das 25 ações disponíveis em Tipo de ação, só 8 abrem um formulário com campos ao serem escolhidas: Criar tarefa, Enviar e-mail, Mover para etapa, Enviar notificação, Chamar webhook, Aplicar tag(s), Remover tag(s) e Definir tags. As outras 17 - como Enviar WhatsApp, Aplicar desconto, Gerar cupom de desconto, Criar cobrança, Adicionar pontos e Promover para nível - são salvas sem nenhum campo extra abaixo do seletor. Sem os dados que elas precisam (a mensagem, o valor, o destino), essas ações não fazem nada quando a automação dispara, e não aparece nenhum aviso avisando disso na hora de salvar.
• "Definir tags (substitui todas)" é destrutiva. Ela remove TODAS as tags atuais do registro e coloca no lugar só as que você marcou aqui. Se não marcar nenhuma tag, o resultado é apagar todas as tags existentes do registro.
• Existe um limite para automações que disparam outras automações. Se a ação de uma automação aciona o gatilho de uma segunda (por exemplo, aplicar uma tag que é justamente o gatilho de outra regra), o sistema segue essa corrente até 3 níveis antes de parar sozinho, para evitar loop.
• Gatilhos e ações de um módulo que sua agência não contratou não aparecem para escolher. E se um módulo usado por uma automação já criada for cancelado depois, a automação continua salva mas para de disparar - ela aparece marcada com um aviso na listagem até você contratar o módulo de novo ou trocar a configuração.
• "Aplicar desconto" só atua em pedidos ainda não pagos, cancelados ou reembolsados. Em qualquer outro pedido, a ação não faz nada.

Casos especiais

Editando uma automação com módulo faltando

Se a automação que você está editando depende de um módulo que não está mais contratado (por exemplo, uma regra de CRM criada quando o módulo estava ativo), a tela mostra um aviso no topo do formulário. Enquanto isso, a automação continua salva mas não dispara. Para resolver, contrate o módulo novamente ou troque a entidade, o gatilho ou a ação para algo que não dependa dele.

Filtro adicional por tags em qualquer gatilho

Independente do gatilho escolhido, o bloco de filtros por tags fica disponível para refinar quando a regra dispara. Por exemplo: uma automação com gatilho "Pedido pago" pode ser configurada para só disparar se o pedido tiver a tag "Grupo grande", usando o filtro "Exigir pelo menos uma destas tags".

Erros comuns

• "O campo nome é obrigatório." - Causa: você tentou salvar sem preencher o nome da automação. Solução: escolha um nome curto que identifique a regra.
• "O campo gatilho é obrigatório." / "O campo ação é obrigatório." - Causa: você trocou a entidade alvo depois de escolher gatilho e ação, e o sistema limpou os dois porque não eram compatíveis com o novo tipo de registro. Solução: escolha novamente o gatilho e a ação para a entidade atual.
• "Esse modelo depende de um módulo que sua agência não tem contratado." - Causa: você abriu um link de modelo pronto cujo módulo não está ativo no seu plano. Solução: contrate o módulo em Billing ou monte a automação manualmente com gatilhos e ações que não dependam dele.
• A automação foi salva mas nunca dispara - Causa mais comum: a ação escolhida é uma das que não têm campo de configuração na tela (veja "O que você precisa saber antes") e está sem os dados que precisa para funcionar. Solução: troque para uma das 8 ações configuráveis, ou confirme no nome/descrição que os dados esperados (telefone, valor, mensagem) já existem por outro caminho no registro.

Onde encontrar

• URL: /admin/automacoes/create
• Caminho no menu: Configurações > Automações > Nova automação (ou o ícone de lápis de uma automação existente, para editar)
• Permissão necessária: gerenciar automações
• Módulo necessário: nenhum - a tela é core. Gatilhos e ações específicas exigem os módulos correspondentes (CRM, Ingressos, Passeios e Experiências, Gestão Financeira, Contratos Digitais, Fidelidade, Mensagens no WhatsApp).

Veja também

• Automações - Listagem - onde acompanhar, ativar, desativar e excluir as automações depois de criadas.
• Automações CRM - versão anterior focada só em leads e oportunidades, com exemplos prontos para esse contexto.