Automações - Listagem

O que é

A página de Automações é o ponto central para configurar ações que o Viagilize executa sozinho quando algo acontece em uma entidade do sistema. Cada automação combina três peças: a entidade que será observada (cliente, excursão, reserva, pedido, lead, oportunidade, venda de ingresso, venda de passeio ou conta a pagar), o gatilho que dispara a regra (pedido pago, cliente criado, aniversário, contrato assinado, tag adicionada, etc.) e a ação a ser executada (criar tarefa, enviar e-mail, aplicar tag, notificar, etc.).

O usuário normalmente chega aqui depois de configurar os fundamentos da operação (clientes, excursões, pagamentos) e quer reduzir trabalho manual: mandar e-mail toda vez que uma venda for ganha, criar tarefa para o gerente quando um cliente vira VIP, marcar reservas atrasadas como "Inadimplente" no cliente, e por aí vai. As automações respeitam os módulos contratados - gatilhos e ações de módulos não habilitados ficam ocultos automaticamente.

Como usar

1. Vá em Configurações > Automações no sidebar.
2. Use o filtro Filtrar por entidade (logo abaixo do bloco azul de explicação) para listar apenas automações de um tipo específico - por exemplo, só as de Cliente ou só as de Oportunidade (CRM).
3. Cada automação aparece em um cartão com:
   • Nome e descrição configurados.
   • Status: badge verde Ativa ou cinza Inativa.
   • Entidade alvo (badge índigo) - ex.: Cliente, Reserva (passageiro), Pedido.
   • Resumo gatilho → ação com ícones (gatilho roxo, ação azul).
4. Para ver as configurações brutas do gatilho e da ação, clique na seta para baixo à direita do cartão. O painel expansível mostra o JSON pretty-printed de cada parte.
5. Para ativar ou desativar sem abrir a tela de edição, clique no ícone de play (cinza, vira verde) ou pause (cinza, vira vermelho). O sistema retorna ao listado com a mensagem "Automação ativada com sucesso" ou "Automação desativada com sucesso".
6. Para criar uma nova, clique em Nova automação (botão FAB índigo no topo direito) ou escolha um dos Templates prontos no bloco final da página - cada template pré-preenche entidade, gatilho e ação compatíveis.

Templates prontos disponíveis

A lista de templates só mostra os compatíveis com os módulos da agência (método getTemplatesDisponiveis). Os cards atuais cobrem:

• Tarefa ao criar oportunidade (CRM) - cria tarefa de follow-up quando uma nova oportunidade entra no pipeline.
• Alerta oportunidade parada (CRM) - notifica o vendedor quando uma oportunidade fica 5+ dias sem atividade.
• E-mail ao ganhar venda (CRM) - envia e-mail de parabéns ao vendedor quando a oportunidade é marcada como ganha.
• Cliente marcado como VIP cria tarefa para o gerente (Tags) - quando um cliente recebe a tag VIP, gera tarefa de alta prioridade para contato personalizado.
• Cliente sem pagar há mais de 7 dias vira Inadimplente (Tags) - quando uma reserva ganha a tag "Atrasado", aplica a tag "Inadimplente" no cliente vinculado (configurar o ID da tag manualmente).

Casos especiais

Automação com badge de módulo faltando

Se uma automação foi criada quando o módulo estava ativo e depois o módulo foi removido do plano, o cartão exibe um badge âmbar com triângulo de alerta mostrando o nome do módulo ausente (ex.: addon: crm). A automação não dispara nesse estado. Para resolver, contrate o módulo novamente ou exclua/edite a automação para usar gatilho e ação suportados pelo plano atual.

Lista vazia

Quando ainda não há nenhuma automação cadastrada, a área da lista mostra um ícone de raio cinza, a mensagem "Nenhuma automação configurada" e o botão Criar primeira automação, que leva direto para a tela de criação sem template.

Filtro com entidade inválida

Se a URL trouxer ?entidade=algum_valor_invalido, o controller ignora silenciosamente (Automacao::entidadeValida()) e devolve a lista completa. O badge "Filtros ativos" da <x-filter-bar> continua refletindo o parâmetro recebido - limpe pelo botão da própria barra para voltar à listagem padrão.

Templates ocultos por módulo

A lista de templates esconde automaticamente itens que dependem de módulos não contratados. Se você espera ver um template e ele não aparece (por exemplo, "Tarefa ao criar oportunidade" sem o módulo CRM), verifique em Billing > Módulos se o módulo está ativo.

Erros comuns e como resolver

• "Esse template depende de um módulo que sua agência não tem contratado." Causa: você abriu um link de template (?template=...) cujo módulo não está ativo no plano. Solução: contrate o módulo em Billing > Módulos ou use um template diferente, listado no bloco "Templates prontos".
• "Automação removida com sucesso." mas a automação reaparece após recarregar - Causa: cache do navegador ou outra aba aberta com a listagem antiga. Solução: dê F5 ou feche e reabra a página.
• Automação aparece como "Inativa" mesmo após clicar em ativar - Causa: o registro tem um módulo obrigatório ausente (badge âmbar visível). Solução: contratar o módulo ou editar a automação para usar gatilho/ação compatíveis.

Onde encontrar

• URL: /admin/automacoes
• Caminho no menu: Configurações > Automações
• Permissão necessária: ver as automações (para listar), gerenciar as automações (para criar, editar, ativar/desativar e excluir)
• Módulo necessário: nenhum - a página é core. Gatilhos e ações específicas exigem os módulos correspondentes (crm, ingressos, passeios-experiencias, gestao-financeira, contratos-digitais, fidelidade).

Veja também

• Automações CRM - versão anterior focada apenas em leads e oportunidades, mantida para referência histórica.
• Notificações Automáticas
  • comunicação fixa do sistema (confirmação de reserva, lembrete de viagem, NPS), distinta das automações configuráveis desta página.