CRM - Automações
O que é
A página de Automações do CRM concentra as regras que disparam ações
sozinhas conforme os eventos do funil de vendas - criação de oportunidade,
mudança de etapa, fechamento (ganho ou perdido), tarefas vencidas e
oportunidades sem atividade. Cada regra é composta por um gatilho
(quando) e uma ação (o que fazer), com configurações específicas em
JSON salvas nos campos gatilho_config e acao_config.
O usuário normalmente chega aqui depois de configurar pipelines, etapas e tipos de tarefa, e quer reduzir o trabalho manual da equipe comercial: criar tarefas de follow-up automaticamente, alertar o vendedor quando uma oportunidade está parada, mandar e-mail ao ganhar uma venda ou cobrar tarefas atrasadas. A página só é acessível com o módulo CRM ativo e com a permissão Gerenciar automações CRM.
Como usar
- Vá em CRM > Configurações > Automações no sidebar.
- Leia o bloco azul Como funcionam as automações no topo para o resumo do conceito (gatilho dispara ação automática).
- Cada automação cadastrada aparece em um cartão com:
- Ícone de raio - verde quando ativa, cinza quando inativa.
- Nome e descrição configurados.
- Badge de status: Ativa (verde) ou Inativa (cinza).
- Resumo gatilho → ação com duas pílulas: gatilho em roxo (com ícone de sinal) e ação em azul (com ícone de play).
- Para ver as configurações brutas do gatilho e da ação, clique na seta para baixo no canto direito do cartão. O painel expansível mostra duas colunas: Configuração do Gatilho e Configuração da Ação, cada uma com o JSON formatado e, quando houver execuções, o contador "Executada N vez(es)".
- Para ativar ou desativar rapidamente, clique no botão de play (cinza, vira verde no hover) ou pause (cinza, vira vermelho). O sistema recarrega a lista com o toast "Automacao ativada com sucesso" ou "Automacao desativada com sucesso".
- Para editar, clique no ícone de lápis ao lado do toggle - leva ao formulário de edição com todos os campos preenchidos.
- Para excluir, clique no ícone de lixeira - um modal de confirmação pergunta "Tem certeza que deseja excluir esta automação?" antes de remover.
- Para criar uma automação nova:
- Use Nova Automação (botão azul no canto superior direito) para começar do zero, ou
- Clique em um dos cinco cartões do bloco Templates Prontos no final da página para abrir o formulário já pré-preenchido.
Gatilhos disponíveis
Da própria oportunidade:
- Oportunidade criada - toda vez que uma nova oportunidade entra no pipeline.
- Etapa alterada - quando a oportunidade muda de etapa (dá para escolher uma etapa específica).
- Oportunidade ganha / Oportunidade perdida - quando ela é marcada como ganha ou perdida.
- Tarefa vencida - quando uma tarefa do CRM passa do prazo sem ser concluída.
- Oportunidade sem atividade (X dias) - quando ela fica X dias parada na mesma etapa. Esse gatilho é verificado uma vez por dia, de manhã.
Da reserva ou da jornada ligada à oportunidade:
- Reserva criada ou vinculada à oportunidade - quando a reserva nasce ligada (criada pela oportunidade ou ligada automaticamente) ou quando alguém vincula uma reserva pela ficha.
- Contrato enviado ao cliente - quando o link do contrato sai por e-mail ou é compartilhado pelo WhatsApp. Só com o módulo de Contratos.
- Contrato assinado - quando o cliente assina o contrato da reserva ou da jornada, inclusive pela assinatura eletrônica. Só com o módulo de Contratos.
- Primeiro pagamento ou reserva confirmada - no primeiro pagamento da reserva ou da jornada, ou quando a reserva é confirmada.
- Reserva ou jornada cancelada - quando o pedido inteiro é cancelado (cancelar uma pessoa de um grupo não conta) ou a jornada vai para Cancelada.
- Jornada criada ou vinculada à oportunidade - quando a jornada é criada pelo botão "Criar jornada" da oportunidade ou vinculada pela ficha. Só com o módulo de Jornadas.
- Jornada confirmada - quando a jornada passa para Confirmado. Só com o módulo de Jornadas.
Esses gatilhos só agem quando a reserva ou a jornada está ligada à oportunidade. Veja "Reserva ou jornada sem vínculo" em Casos especiais.
Ações disponíveis
Cada automação faz uma ação. Para fazer duas coisas com o mesmo gatilho (por exemplo, mover o card e criar uma tarefa), crie duas automações com o mesmo gatilho. O formulário só mostra as ações que fazem sentido para o gatilho escolhido.
- Mover para etapa - leva a oportunidade para a etapa escolhida. Com Só avançar marcado (padrão nas automações novas), ela só anda para frente: não volta se já estiver numa etapa posterior e não mexe em oportunidade ganha ou perdida. Use sempre com os gatilhos de reserva e jornada, que podem chegar fora de ordem (o pagamento antes da assinatura, por exemplo).
- Marcar como ganha - fecha a oportunidade como ganha (vai para a etapa de ganho do funil).
- Marcar como perdida - fecha como perdida, com o motivo da perda
escolhido e uma descrição (aceita variáveis, como
Reserva {reserva} cancelada). Vale também para oportunidade que já estava ganha. - Criar tarefa - cria uma tarefa para o vendedor da oportunidade (ou outro responsável), com título, tipo, prazo e prioridade. Ex.: "Emitir boletos", prazo de 1 dia.
- Registrar nota - grava uma nota na linha do tempo da oportunidade.
- Notificar vendedor - cria um aviso no sino do painel para o vendedor da oportunidade (ou o usuário escolhido). Nada é enviado ao cliente. Opcionalmente manda também por e-mail. Para gatilhos que repetem todo dia, o mesmo aviso não se repete por 20 horas.
- Enviar e-mail / Enviar WhatsApp - mensagem para o vendedor, para o cliente ou para um destinatário fixo.
- Atribuir vendedor, Aplicar etiqueta e Criar oportunidade em outro funil (por exemplo, abrir o pós-venda quando a venda é ganha).
- Aplicar checklist - aplica um modelo de checklist na oportunidade (gatilhos oportunidade criada, etapa alterada, reserva vinculada e jornada vinculada). Se a oportunidade já tiver outro checklist, nada muda; modelo de outro pipeline não é aplicado. Veja CRM - Checklists da oportunidade.
Variáveis aceitas nos textos: {oportunidade}, {cliente},
{vendedor}, {valor}, {etapa}, {tarefa}, {reserva} (código da
reserva), {viagem}, {jornada} e {destino}.
Casos especiais
Reserva ou jornada sem vínculo
Os gatilhos que vêm da reserva ou da jornada só agem quando ela está ligada à oportunidade. A reserva fica ligada quando:
- é criada pelo botão da oportunidade;
- alguém vincula pelo card Oportunidade no CRM da ficha da reserva ou pelo card Reservas da oportunidade;
- a opção Vincular reservas às oportunidades automaticamente está ligada em CRM > Configurações Gerais e o cliente (ou o viajante) tem exatamente uma oportunidade aberta naquela viagem.
A jornada fica ligada quando é criada pelo botão Criar jornada da oportunidade ou vinculada pelo card de uma das duas fichas. Eventos que aconteceram antes do vínculo (um contrato já assinado, por exemplo) não disparam de novo.
Exemplo: funil de vendas acompanhando a reserva
Funil "Elaboração de Contrato > Assinatura de Contrato > Emissão Financeira > Ganho":
- Reserva criada ou vinculada > Mover para Elaboração de Contrato (Só avançar).
- Contrato enviado ao cliente > Mover para Assinatura de Contrato (Só avançar).
- Contrato assinado > Mover para Emissão Financeira (Só avançar), mais uma automação Criar tarefa "Emitir boletos" e outra Notificar vendedor.
- Primeiro pagamento > Marcar como ganha.
- Reserva ou jornada cancelada > Marcar como perdida, com o motivo.
Lista vazia
Quando ainda não há nenhuma automação cadastrada, no lugar da lista aparece um estado vazio com o ícone de raio cinza, o título Nenhuma automação configurada, a frase "Crie automações para agilizar o trabalho da sua equipe de vendas." e o botão azul Criar Primeira Automação, que leva direto para o formulário de criação sem template.
Criar a partir de template pronto
Os cinco cartões do bloco Templates Prontos levam para a rota de
criação com o parâmetro ?template=.... Ao abrir o formulário, os
campos Nome, Descrição, Ativo, Gatilho e Ação já
vêm preenchidos conforme o método getTemplate:
- Tarefa ao criar oportunidade - gatilho
oportunidade_criada+ açãocriar_tarefacom título "Follow-up: {oportunidade}", tipofollow_up, vencimento em 1 dia, prioridade média. - Alerta oportunidade parada - gatilho
sem_atividade(5 dias) + açãonotificarpara o vendedor por notificação interna e e-mail. - Mover etapa automaticamente - gatilho
sem_atividade(7 dias) + açãomover_etapa(vem desativada porque exige escolher a etapa de destino antes de salvar). - Email ao ganhar venda - gatilho
oportunidade_ganha+ açãoenviar_emailpara o vendedor com assunto e corpo de parabéns personalizados. - Alerta tarefa vencida - gatilho
tarefa_vencida+ açãonotificarpara o responsável da tarefa por notificação interna e e-mail.
Botões "Salvar e continuar" / "Salvar e criar novo"
O formulário de criação envia um parâmetro _action indicando o destino
após salvar:
- Salvar (sem
_actionou_action=save) - volta para a listagem com a mensagem "Automacao criada com sucesso!". - Salvar e continuar editando (
_action=save_and_continue) - vai para a tela de edição da automação recém-criada para refinamento. - Salvar e criar novo (
_action=save_and_create_new) - limpa o formulário para cadastrar a próxima automação em sequência.
Ordem das automações
Cada automação recebe ordem = max(ordem) + 1 no momento da criação. A
listagem usa orderBy('ordem')->orderBy('nome'), ou seja, as mais
antigas aparecem primeiro e o desempate é alfabético. A ordem não é
editável diretamente nesta tela - entre na edição da automação para
ajustar via formulário.
Erros comuns e como resolver
- "O campo gatilho é obrigatório." - Causa: você tentou salvar sem escolher o tipo de gatilho. Solução: selecione um dos gatilhos da lista (veja "Gatilhos disponíveis").
- "O valor selecionado para gatilho é inválido." - Causa: tentativa de enviar um gatilho fora da lista permitida (geralmente por manipulação manual da URL ou requisição). Solução: use apenas os valores listados na seção "Gatilhos disponíveis" deste artigo.
- "A ação ... não é compatível com o gatilho selecionado." - Causa: a combinação não faz sentido (ex.: "Marcar como ganha" com "Reserva ou jornada cancelada"). Solução: escolha o gatilho primeiro; o formulário só lista as ações compatíveis.
- A automação de reserva ou jornada não fez nada - Causa: a reserva ou a jornada não está ligada à oportunidade, ou o evento aconteceu antes do vínculo. Solução: vincule pela ficha (cards "Reservas", "Jornadas" ou "Oportunidade no CRM"); os próximos eventos passam a disparar.
- A oportunidade não voltou de etapa - Causa: Só avançar está marcado, que é o esperado para não desfazer o andamento. Solução: desmarque só se quiser que o gatilho também mova para trás.
- "O campo nome não pode ser maior que 100 caracteres." - Causa: nome com mais de 100 caracteres. Solução: encurte o nome - use a descrição (até 500 caracteres) para detalhes adicionais.
- Template "Mover etapa automaticamente" vem desativado - Causa: o
template define
ativo: falseporque depende de você escolher a etapa de destino antes que faça sentido rodar. Solução: configure o campo de etapa no formulário e marque Ativo antes de salvar. - Página retorna 403 ao acessar
/admin/crm/automacoes- Causa: perfil sem a permissão Gerenciar automações CRM ou módulo CRM inativo no plano. Solução: peça ao Proprietário para liberar a permissão em Configurações > Perfis ou contrate o módulo em Billing > Módulos.
Onde encontrar
- URL:
/admin/crm/automacoes - Caminho no menu: CRM > Configurações > Automações
- Permissão necessária: ver o CRM (para acessar o módulo) e Gerenciar automações CRM (para listar, criar, editar, ativar/desativar e excluir automações)
- Módulo necessário: crm
Veja também
Automações - Listagem (central)- versão unificada que cobre automações de todos os módulos (clientes, reservas, pedidos, etc.), não apenas oportunidades.CRM - Oportunidades- entidade observada pelos gatilhosoportunidade_criada,etapa_alterada,oportunidade_ganha,oportunidade_perdidaesem_atividade.CRM - Tarefas e follow-ups- destino das tarefas criadas pela açãocriar_tarefae origem do gatilhotarefa_vencida.CRM - Pipelines e Kanban- define as etapas usadas emetapa_alteradae como destino da açãomover_etapa.