manuais-e-documentacao-itguys/documentacao zammad/Nivel_2_man_zammad_slas_esc...

80 lines
3.3 KiB
Markdown

# MANUAL TÉCNICO - GESTÃO DE SLAS E ESCALONAMENTOS - ZAMMAD
**Código:** ITGINF 0003/26 | **Classificação:** INTERNO
**Responsável:** João Pedro Toledo Gonçalves | **Data:** {{DATA_ATUAL}}
## 1. HISTÓRICO DE REVISÃO
| Data | Versão | Descrição | Autor |
| :--- | :--- | :--- | :--- |
| {{DATA_ATUAL}} | 1.0 | Criação Inicial | João Pedro Toledo Gonçalves |
## 2. OBJETIVO
Configurar Acordos de Nível de Serviço (SLA) para garantir tempos de resposta e solução, configurando calendários e regras de escalonamento.
## 3. PRÉ-REQUISITOS
* [ ] Grupos criados.
* [ ] Definição do horário de expediente (ex: 08h-18h).
## 4. PASSO A PASSO (EXECUÇÃO)
### Etapa 1: Criar Calendário (Horário de Trabalho)
O SLA só conta durante o horário comercial definido no calendário.
1. Acesse **Admin** > **Gerenciar** > **Calendários**.
2. Clique em **Novo Calendário**.
3. Nome: `Comercial Padrao`.
4. Fuso Horário: `America/Sao_Paulo`.
5. Defina os horários (ex: Seg-Sex, 08:00 às 18:00).
6. **Feriados:** Importe ou adicione feriados manualmente para pausar o SLA nessas datas.
![Configuração de Calendário](assets/zammad_calendar_setup.png)
### Etapa 2: Configurar SLA
1. Acesse **Admin** > **Gerenciar** > **SLAs**.
2. Clique em **Novo SLA**.
3. **Filtrar por:** Escolha as condições (ex: `Grupo` é `Service Desk` E `Prioridade` é `3 alta`).
4. **Tempos (em horas/minutos):**
* **Tempo de primeira resposta:** Meta para o agente dizer "Olá".
* **Tempo de atualização:** Meta para responder ao cliente após uma réplica.
* **Tempo de solução:** Meta para fechar o ticket.
5. **Calendário:** Selecione o `Comercial Padrao`.
### Etapa 3: Visualizar Escalonamentos
Quando um SLA vence, o ticket fica vermelho ("escalated").
1. Crie uma **Visão Geral** (Overview) para tickets escalados:
* Acesse **Admin** > **Gerenciar** > **Visões Gerais**.
* Condição: `Escalation at` `before (absolute)` `now`.
* Isso mostrará todos os tickets estourados em tempo real.
## 5. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
!!! warning "Pânico: SLA não funciona"
O relógio do SLA está errado ou não aparece?
**Problema 1: SLA não aplicou no ticket**
* **Causa:** As condições do SLA não bateram com o ticket.
* **Exemplo:** O SLA exige `Prioridade 3`, mas o ticket é `Prioridade 2`.
* **Solução:** Abra o ticket e verifique seus atributos. O Zammad recalcula o SLA instantaneamente ao salvar.
**Problema 2: SLA contando no fim de semana**
* **Causa:** Calendário não vinculado ou mal configurado.
* **Solução:**
1. Vá na config do SLA e garanta que o **Calendário** correto está selecionado (padrão é 24/7 se vazio).
**Problema 3: "Tempo de solução" não reseta**
* **Conceito:** O SLA de solução conta desde a CRIAÇÃO do ticket. Ele não reseta a cada resposta. Apenas o "Tempo de Atualização" reseta.
## 6. DADOS TÉCNICOS
| Tipo SLA | Definição |
| :--- | :--- |
| **First Response** | Tempo até o primeiro artigo público do agente. |
| **Update Time** | Tempo até o agente responder uma réplica do cliente. |
| **Solution Time** | Tempo até o estado mudar para Closed. |
## 7. VALIDAÇÃO FINAL
- [ ] Crie um ticket de teste que atenda aos filtros do SLA.
- [ ] Verifique se o painel lateral mostra "SLA in X minutes".