Automações

Uma automação é um fluxo que o SquadOS inicia sem alguém precisar apertar um botão. Um ou mais gatilhos dizem quando entrar; as ações e regras dizem o que fazer depois.

Use uma automação quando a resposta deve acontecer por evento ou horário, por exemplo:

• retomar uma conversa que ficou sem resposta;
• agir quando uma conversa muda de estado;
• reagir à aplicação de uma tag ou à entrada de um contato numa lista;
• executar uma rotina num horário;
• percorrer uma audiência e enviar uma campanha.

Automações ficam em CRM → Automações no menu lateral. Elas não são o agendamento nem o follow-up antigo de um agente: essas rotinas são montadas neste módulo.

Acesso e permissões

O acesso não depende apenas do nome do papel. Uma equipe pode receber permissões granulares:

Permissão	O que libera hoje
automations.view	Ver o módulo e a lista.
automations.write	Criar, abrir o editor, configurar, testar, salvar e ligar ou desligar. A seção Atividade também fica dentro dessa rota de edição.
automations.delete	Ver a ação de exclusão e apagar uma automação.

As permissões de escrita e exclusão pressupõem visualização. Dono e administrador mantêm acesso amplo; papéis e equipes personalizados podem ter combinações diferentes. Consulte Usuários e papéis.

Limitação atual: quem recebeu somente automations.view vê linhas clicáveis, mas não consegue abrir o editor nem a Atividade. A permissão de escrita é necessária para continuar além da lista.

O que a lista mostra

A lista exibe, para cada automação:

• Nome;
• Gatilho;
• Reentrada;
• Execuções (7 dias);
• Status e, quando aplicável, o interruptor de ativação;
• exclusão, para quem tem automations.delete.

O status Rascunho significa que ainda não existe uma versão salva. Uma automação com versão pode estar Ativa ou Desativada. Se o SquadOS a desligou após erros de configuração repetidos, a lista acrescenta Desativada automaticamente e mostra o motivo.

Uma automação pode ter vários gatilhos, mas a coluna Gatilho mostra somente o primeiro tipo salvo. Para conferir todos os pontos de entrada e seus filtros, abra o Editor; não use essa coluna como inventário completo do fluxo.

O que acontece ao criar

Clique em Nova automação e escolha um ponto de partida:

• Começar do zero cria um canvas vazio;
• Follow-up de conversa parada preenche um fluxo inicial editável.

A automação é criada imediatamente com um nome como Nova automação #3. O fluxo do ponto de partida ainda fica somente no editor. Se você sair antes de salvar, a linha continua na lista como Rascunho, sem versão nem gatilho publicado.

Você pode renomear pelo próprio título no topo ou em Configurações → Identificação.

As três seções do editor

O trilho do editor separa três assuntos:

Seção	Para que serve
Editor	Montar gatilhos, ações e regras; selecionar um nó abre sua configuração.
Configurações	Alterar nome, descrição, reentrada, ativação e exclusão.
Atividade	Ver execuções, testes, gatilho de entrada, status, custo, caminho percorrido, entrada e saída de cada nó.

No topo também ficam Desfazer, Refazer, AgentMaker, Testar, o status de ativação e Salvar. O AgentMaker propõe mudanças no grafo, mas você ainda revisa, aplica e salva; veja Criar automações com o AgentMaker.

Gatilhos e passos

O catálogo atual tem seis gatilhos:

1. Evento da conversa;
2. Conversa sem resposta;
3. Tag do contato;
4. Contato adicionado à lista;
5. Agendar;
6. Audiência.

Uma automação precisa de pelo menos um gatilho e cada gatilho precisa levar a um passo. Você pode adicionar vários gatilhos ao mesmo fluxo. Por padrão, um novo gatilho converge para o mesmo primeiro passo; use Dar um caminho próprio a este gatilho quando ele precisar seguir outro ramo.

O SquadOS recusa o salvamento quando dois gatilhos cobrem o mesmo evento e os mesmos filtros, quando um gatilho não tem saída ou quando algum caminho exige dados que aquele ponto de entrada não fornece.

Depois dos gatilhos, a paleta é dividida em:

Aba	O que reúne
Gatilhos	Os seis pontos de entrada.
Ações	Mensagens, e-mail, IA, tags, atribuição, transferência, contato, conversa e chamadas externas.
Regras	Condição, espera e encerramento do fluxo.

Clique num item para encaixá-lo no próximo ponto disponível ou arraste para escolher o ponto exato. Um item fica desabilitado quando não existe lugar válido para encaixá-lo.

Alterações locais, salvar e versões

O grafo não tem autosave no servidor. Enquanto você edita, o estado fica no canvas e aparece como Alterações não salvas. O mesmo navegador guarda uma cópia local de segurança, vinculada à organização e à automação, por até 14 dias. Ao reabrir, o SquadOS pode oferecer Restaurar ou Descartar essa cópia.

Essa cópia local não é uma versão publicada, não sincroniza entre navegadores e não substitui Salvar.

Ao clicar em Salvar ou usar Ctrl+S, o SquadOS:

1. abre uma confirmação;
2. valida o grafo;
3. destaca os nós que precisam de correção, se houver erro;
4. cria uma nova versão salva e passa a apontar as próximas execuções para ela.

Não existe um botão separado chamado Publicar. Se a automação estiver ativa, a versão nova vale imediatamente para as próximas execuções. Se estiver desativada, a versão fica salva, mas não dispara até você ligar. Execuções que já estavam na fila, rodando ou aguardando continuam na versão com que começaram; a confirmação informa quantas estão nessa situação.

Nome, descrição, reentrada e ativação são propriedades da automação, não do grafo. Alterá-las em Configurações grava esses valores diretamente; elas não esperam o botão Salvar do canvas.

Ativação e reentrada

O interruptor só fica disponível depois da primeira versão salva. Enquanto a automação estiver desativada, nenhum gatilho cria execução, mas você ainda pode editar, salvar e testar.

Em Configurações → Reentrada, escolha:

• Uma vez por conversa — a mesma conversa entra no máximo uma vez; é o padrão;
• Uma vez por contato — o contato entra uma única vez, mesmo por conversas diferentes;
• Sempre — cada evento compatível pode criar outra execução para o mesmo contato.

Use Sempre com cuidado: cada nova execução percorre o fluxo novamente e nós de IA voltam a consumir créditos.

Testar antes de ligar

Testar pode executar o Canvas atual, mesmo sem salvar. Quando já existe uma versão no ar, você também pode escolher Versão no ar. Se houver vários gatilhos, escolha qual deles simular; conforme o tipo, o diálogo pede uma conversa, um contato ou um payload de exemplo.

O teste não é totalmente inerte:

• ações de envio são simuladas;
• nós de IA executam de verdade e consomem créditos;
• Obter conversa do contato pode abrir uma conversa real, embora não envie mensagem;
• o resultado vira uma execução marcada como Teste na seção Atividade.

Use um alvo controlado e confira o caminho e a saída de cada nó. Veja os detalhes em Execuções e testes.

Proteções de saída

As proteções não são nós que você precisa adicionar. Toda ação de saída verifica descadastro e o teto de frequência quando existe um contato. Uma mensagem enviada na conversa também verifica adiamento, se o cliente está aguardando resposta e a janela de 24 horas da Meta quando o canal é WhatsApp Oficial ou Instagram Direct.

Proteção	Resultado quando bloqueia
Descadastro	O contato não recebe a saída. Não pode ser ignorado pelo fluxo.
Conversa adiada	O passo é pulado e a automação não escreve enquanto o adiamento estiver vigente.
Cliente aguardando resposta	A automação não escreve por cima de uma resposta pendente da equipe.
Teto de frequência	Por padrão, no máximo 3 saídas automáticas por contato em 24 horas, somando todas as automações da organização.
Janela de 24 horas da Meta	Texto livre não sai fora da janela. Em Enviar mensagem, um modelo aprovado pode servir como alternativa; sem ele, o passo é pulado.

Um bloqueio aparece como passo pulado na Atividade, não como falha da automação. A única proteção que o fluxo pode dispensar é Cliente aguardando resposta: desmarcar O contato responder nas condições de saída de um passo Aguardar libera essa guarda para os caminhos que obrigatoriamente passam por ele. Descadastro, adiamento, teto e janela Meta continuam valendo.

Desativação automática

Um erro de configuração isolado não desliga imediatamente a automação. Quando o mesmo passo falha cinco vezes consecutivas com o mesmo código de configuração, o SquadOS desativa a automação. Uma execução bem-sucedida fecha o alerta aberto e interrompe essa sequência.

Entre os motivos classificados estão passo incompleto, conteúdo vazio depois de preencher variáveis, configuração ou canal ausente, envio recusado, URL de webhook bloqueada ou repetidamente indisponível e falta de contato ou conversa exigidos pelo grafo.

Abra a automação para ler a faixa Esta automação precisa de ajuste, corrija o passo indicado, salve se o grafo mudou e use Religar automação quando o aviso oferecer essa ação.

Excluir

Excluir uma automação apaga junto suas versões e todo o histórico de execuções. A operação não pode ser desfeita; a confirmação mostra o nome e exige automations.delete.

Por onde continuar

• Criando uma automação — do ponto de partida à primeira versão ativa.
• Gatilhos da automação — tipos, filtros e contextos de entrada.
• Ações — efeitos disponíveis no fluxo.
• Regras: condição, espera e encerramento — ramificação e tempo.
• Analisar com IA — classificação e dados estruturados.
• Variáveis — dados disponíveis em cada ponto.
• Execuções e testes — diagnóstico por execução.