Automações de OS — regras por mudança de status
O que é / Para que serve
As Automações de OS executam ações automaticamente quando uma Ordem de Serviço muda de status. Cada automação tem:
- um Status que dispara (o status da OS que aciona a regra);
- Condições (opcionais) — filtros que a OS precisa atender;
- uma ou mais Ações — o que fazer, em ordem.
Exemplo típico: "Ao Faturar → criar Ordem de Compra". Sempre que uma OS entra em Faturado, a automação roda.
Antes de começar
- Criar / editar / excluir automações: apenas admin ou owner.
- Ver a lista e o Histórico de execução: qualquer membro.
- O botão de entrada (Automações) aparece só para admin/owner na página do ERP.
Passo a passo — chegar na tela
- Vá em Menu lateral > ERP (Ordens de Serviço).
- No topo direito, clique em Automações (ícone de raio).
- A página tem duas abas: Automações (a configuração) e Histórico de execução (os logs).
📷 Captura: página de Automações com as abas Automações e Histórico de execução e o botão Nova automação.
Passo a passo — criar uma automação
- Na aba Automações, clique em Nova automação.
- Em Geral, preencha:
- Nome (ex.: "Ao faturar → criar Ordem de Compra").
- Status que dispara (ex.: Faturada).
- Ativa — automações inativas nunca executam.
- Em Condições (opcional), clique em Adicionar condição para restringir quando a regra roda. Deixe vazio para executar sempre.
- Em Ações, clique em Adicionar ação e escolha o tipo. Você pode adicionar várias — elas executam de cima para baixo.
- Clique em Criar automação.
Para ativar/desativar rapidamente, use o botão de alternância (toggle) na lista, sem precisar abrir a automação.
Configuração — condições
Cada condição é composta por Campo, Operador e Valor. Campos disponíveis:
- Status, Valor total, ID do serviço, ID do responsável, ID do vendedor, ID do cliente e Forma de pagamento.
Operadores: igual a, diferente de, maior que, maior ou igual, menor que, menor ou igual, contém, não contém.
Quando há mais de uma condição, você define a Junção: E (todas precisam bater) ou OU (qualquer uma). A junção é aplicada da esquerda para a direita, sem agrupamento — ou seja, não é possível montar "(A e B) ou C". Sem condições, a automação sempre executa.
Dica: os campos de ID (serviço, cliente) usam seletores com busca — você escolhe pelo nome, não digita o ID.
Configuração — tipos de ação
| Ação | O que faz |
|---|---|
| Criar Projeto | Cria um projeto vinculado à OS. Você pode escolher Gestor do projeto (usa o responsável da OS se vazio), Nome do projeto e um Modelo de projeto (opcional). |
| Criar Ordem de Compra | Cria uma OC vinculada à OS (status inicial Pendente, marcada como criada pelo Sistema). |
| Onboarding do Cliente | Garante o cliente no CRM, cria/localiza o contato principal e concede acesso ao portal do cliente. Requer e-mail do cliente na OS (sem e-mail, o acesso ao portal é ignorado). |
| Criar Tarefa | Cria uma tarefa dentro do projeto vinculado à OS. Configure Título, Descrição e Vence em (dias). |
| Sincronizar com Conta Azul | Lança a venda da OS no Conta Azul. Requer a organização conectada ao Conta Azul. |
Tokens disponíveis em Nome do projeto, Título e Descrição de tarefa:
{{os_number}} (número da OS), {{os_title}} (título da OS), {{client_name}} (nome do cliente) e {{client_company_name}} (razão social).
Ordem das ações e casos especiais
- As ações rodam em sequência, de cima para baixo. Uma ação que falha não interrompe as demais.
- Criar Tarefa precisa de um projeto já vinculado à OS. Se você quer criar projeto e tarefa na mesma automação, coloque Criar Projeto antes de Criar Tarefa. A tarefa é criada na primeira fase do projeto.
- Ações são idempotentes quando faz sentido: se a venda já foi sincronizada no Conta Azul, se o projeto já foi criado ou se o cliente já tem acesso, a ação é registrada como Ignorada, não como erro.
Histórico de execução (logs)
- Na página de Automações, abra a aba Histórico de execução.
- Cada linha mostra Hora, Ação, Status (Sucesso / Erro / Ignorada), a OS e uma Mensagem.
- Use Carregar mais para ver execuções mais antigas.
Esse histórico é a principal forma de saber se uma automação rodou e qual foi o resultado.
Integrações com outros módulos
As automações são o elo entre a OS e o resto do Strice:
- Projetos / Tarefas: ações Criar Projeto e Criar Tarefa.
- Ordens de Compra: ação Criar Ordem de Compra — veja Ordens de Compra.
- Clientes / Portal do cliente: ação Onboarding do Cliente.
- Conta Azul: ação Sincronizar com Conta Azul.
O gatilho é sempre a mudança de status da OS — veja como mudar o status em Ordens de Serviço.
Dicas e limitações
- Não há botão de teste/simulação. Você só observa o resultado no Histórico de execução depois de uma mudança de status real.
- Condições misturando E e OU são avaliadas da esquerda para a direita, sem parênteses/agrupamento.
- Criar Tarefa usa apenas a primeira fase do projeto vinculado.
- Sincronizar com Conta Azul falha (e é registrada como Erro) se a organização não estiver conectada ao Conta Azul.
- Excluir uma automação mantém os registros de execução anteriores no histórico.
Perguntas frequentes
Quando a automação dispara? No momento em que a OS muda para o status configurado (por arraste no Kanban ou edição).
Uma ação falhou. As outras da mesma automação também param? Não. Cada ação é isolada; a falha de uma não interrompe as demais.
O que significa "Ignorada" no histórico? Que a ação não precisou ser feita (ex.: já sincronizada, projeto já existente, cliente já com acesso) ou faltou um pré-requisito.
Como criar projeto e tarefa juntos? Numa mesma automação, coloque Criar Projeto antes de Criar Tarefa (a tarefa precisa de um projeto vinculado).
Consigo testar antes de valer para valer? Não há simulação. Recomenda-se testar com uma OS de teste e conferir o Histórico de execução.