> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Automação de Status de Ordem de Serviço

# Automação de Status de Ordem de Serviço

Guia completo de configuração — **Groner OS**

---

## 1. O que é

Uma **automação de status de OS** dispara ações automáticas **quando uma Ordem de Serviço muda para um determinado status**. Em vez de a equipe atualizar o negócio, criar a obra ou avisar o cliente na mão, o sistema faz isso sozinho no momento em que a OS atinge o status configurado.

Exemplo clássico: *quando uma OS de **Instalação** é **Finalizada**, mover a Instalação do negócio para **Concluída** e avisar o cliente por WhatsApp.*

> **Importante — OS ≠ Instalação (obra).** A Ordem de Serviço e a Instalação são registros **diferentes**, cada um com seu status. Concluir a OS **não** mexe na obra automaticamente — a não ser que você configure uma automação pra isso (é justamente o que este guia ensina).

---

## 2. Onde configurar

**Configurações › Automações de OS** (menu de Configurações; visível apenas para administradores).

A tela lista todas as automações já cadastradas, com as colunas:

| Coluna | O que mostra |
| --- | --- |
| **Tipo de serviço** | Para qual tipo de OS a regra vale |
| **Status** | O status que dispara a regra |
| **Move o negócio p/** | Status do negócio aplicado (se houver) |
| **Move a instalação p/** | Status da obra aplicado (se houver) |
| **Cria** | Se cria Instalação e/ou Projeto de Engenharia |
| **Mensagem** | Trecho da mensagem enviada (se houver) |
| **Webhook** | Se dispara um webhook |

Use **+ Nova automação** para criar, ou o menu (⋮) de cada linha para **editar** / **excluir**.

---

## 3. Anatomia de uma automação

Toda automação tem **um gatilho** e **uma ou mais ações**.

### 3.1. Gatilho — "Quando…"

| Campo | Obrigatório | Descrição |
| --- | --- | --- |
| **Tipo de serviço** | ✅ | A regra só vale para OS deste tipo (ex.: *Instalação*, *Visita Técnica*). |
| **Status** | ✅ | A regra dispara quando a OS **muda para** este status. |

A automação dispara **na transição** — no instante em que a OS passa a ter aquele status. Se a OS já estava nesse status, mudar outro campo não redispara.

### 3.2. Ações — "Então…"

Marque quantas quiser. Todas as marcadas rodam quando o gatilho acontece.

#### a) Mover o negócio para o status *(opcional)*
Adiciona um status do **pipeline do negócio** (CRM). Útil pra manter o funil do vendedor em dia (ex.: OS finalizada → negócio em *"Instalado"*).

#### b) Mover a instalação (obra) para o status *(opcional)*
Move a **Instalação do mesmo negócio** para um dos status: **Pendente**, **Em andamento**, **Concluída** ou **Cancelada**.
> É a solução para o cenário "OS concluída mas instalação aparece pendente": configure *OS Finalizada → Instalação Concluída*.
> Só tem efeito se o negócio **já tiver** uma Instalação cadastrada.

#### c) Criar a Instalação do negócio *(opcional)*
Cria a **Instalação (obra)** do negócio, **se ainda não existir**. Ao ligar, aparecem dois campos:

* **Início em (dias)** — a data de início fica em *hoje + N dias* (0 = deixa vazio).
* **Previsão de conclusão em (dias)** — a previsão fica em *hoje + N dias* (0 = deixa vazio).

Se a Instalação **já existir**, a automação **não sobrescreve** — apenas preenche as datas que ainda estiverem vazias.

#### d) Criar o Projeto de Engenharia do negócio *(opcional)*
Cria o **Projeto de Engenharia** do negócio, **se ainda não existir**, já com o **status inicial padrão** cadastrado.
> Instalação e Projeto de Engenharia são **abas distintas** — dá pra criar as duas na mesma automação, marcando os dois toggles.
> Requer ao menos um *Status de Projeto de Engenharia* cadastrado no tenant; sem isso, a criação é ignorada.

#### e) Mensagem *(opcional)*
Texto enviado (WhatsApp) ao disparar. Aceita **variáveis** do negócio, ex.: `[[NomeProjeto]]`, `[[NomeCliente]]`. Deixe em branco para não enviar nada.

#### f) URL do webhook *(opcional)*
Um `POST` é enviado para a URL informada com os dados da OS — para integrar com sistemas externos (n8n, Zapier, ERP próprio, etc.).

---

## 4. Passo a passo — criar uma automação

1. **Configurações › Automações de OS** → **+ Nova automação**.
2. **Quando:** escolha o **Tipo de serviço** e o **Status** que dispara.
3. **Então:** marque as ações desejadas (mover negócio, mover instalação, criar instalação/projeto de engenharia, mensagem, webhook).
4. Se marcar **Criar a Instalação**, preencha os dias de início e previsão (ou deixe 0 para vazio).
5. **Salvar**.

A regra passa a valer imediatamente para as **próximas** mudanças de status (não reprocessa OS antigas).

---

## 5. Receitas prontas

**Fechar a obra ao finalizar a instalação**
* Quando: Tipo *Instalação* · Status *Finalizada*
* Então: Mover a instalação para **Concluída** · (opcional) mover o negócio para *"Instalado"* + mensagem ao cliente.