manuais-e-documentacao-itguys/documentacao zammad/Nivel_1/man_zammad_ticket_lifecycle.md

103 lines
4.5 KiB
Markdown

# MANUAL TÉCNICO - CICLO DE VIDA DO TICKET E TRIAGEM - ZAMMAD
**Código:** ITGSUP 0001/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
Padronizar o atendimento no Zammad, cobrindo abertura, classificação, uso de tags, fusão de chamados duplicados e encerramento.
## 3. PRÉ-REQUISITOS
* [ ] Acesso ao Zammad com perfil de **Agente**.
* [ ] Navegador compatível (Chrome/Edge/Firefox).
## 4. PASSO A PASSO (EXECUÇÃO)
### Etapa 1: Abertura de Ticket (Telefone/Manual)
Para chamados recebidos via telefone ou balcão, o agente deve registrar manualmente.
1. Clique no botão **+** (Verde) no canto inferior esquerdo.
2. Selecione **Nova Ligação** ou **Novo Email**.
3. Preencha os campos obrigatórios:
* **Cliente:** Digite o nome ou email (O Zammad buscará no banco).
* **Título:** Resumo curto do problema.
* **Texto:** Descrição detalhada.
* **Grupo:** A fila de atendimento (ex: `Service Desk`, `Infraestrutura`).
* **Proprietário:** Se for atender agora, selecione **seu usuário**. Caso contrário, deixe `-`.
![Tela de Abertura de Ticket](assets/zammad_ticket_creation.png)
### Etapa 2: Classificação e Tags
A classificação correta garante que as SLAs e automações funcionem.
1. No painel direito do ticket, ajuste:
* **Prioridade:** `1 baixa`, `2 média` ou `3 alta`.
* **Estado:** `aberto` (em análise), `pendente` (aguardando cliente/fornecedor) ou `fechado`.
2. **Uso de Tags (Etiquetas):**
* Digite no campo **Etiquetas** para categorizar o problema.
* **Padrões:** `impressora`, `rede`, `vpn`, `acesso`, `erro_critico`.
* ⚠️ **IMPORTANTE:** Tags são usadas para relatórios mensais. Seja preciso.
### Etapa 3: Fusão de Tickets (Merge)
Se um usuário abrir vários tickets para o mesmo problema, funda-os para manter o histórico limpo.
1. Abra o ticket **mais recente** (que será absorvido).
2. Clique na aba **Ticket** (topo da janela de edição).
3. Selecione **Mudar Cliente / Fundir**.
4. Digite o número do ticket **Principal** (o mais antigo).
5. Confirme a fusão.
* O ticket atual será fechado e todo o histórico será movido para o ticket Principal.
![Menu de Fusão de Tickets](assets/zammad_ticket_merge.png)
### Etapa 4: Dividir Ticket (Split)
Se um ticket tratar de dois assuntos diferentes, separe-os.
1. No ticket original, clique no botão **Split** (ícone de tesoura) próximo à resposta específica.
2. Selecione "Mover para novo ticket".
3. Defina o novo título e clique em **Enviar**.
## 5. SOLUÇÃO DE PROBLEMAS (TROUBLESHOOTING)
!!! warning "Pânico: O que fazer quando tudo der errado"
Instruções para cenários de erro operacional.
**Problema 1: Fusão incorreta (Uni tickets de clientes diferentes)**
* **Causa:** Erro humano na seleção do número do ticket principal.
* **Solução:**
1. Não há botão "Desfazer" nativo.
2. Use a função **Dividir Ticket** (Split) manualmente nas mensagens que vieram do cliente errado.
3. Mova-as para um novo ticket corrigindo o cliente.
**Problema 2: Cliente duplicado no banco de dados**
* **Causa:** Cliente abriu chamado por canais diferentes (Email vs Telegram) sem vinculação.
* **Solução:**
1. Acesse **Gerenciar Clientes** (Admin).
2. Busque os dois perfis.
3. Copie o ID secundário e cole no campo "Alias" ou "Email Secundário" do perfil principal.
4. Apague o perfil duplicado (vazio) ou desative-o.
**Problema 3: Ticket "Sumiu" da minha visão**
* **Causa:** Filtros de "Minhas Tarefas" ou o ticket foi movido para um Grupo que você não tem acesso.
* **Solução:**
1. Use a **Busca Global** (Lupa no topo) e digite o número do ticket ou nome do cliente.
2. Se não tiver acesso, aparecerá "Acesso Negado". Solicite ao Admin do grupo.
## 6. DADOS TÉCNICOS
| Campo | Valor | Descrição |
| :--- | :--- | :--- |
| **Tags Proibidas** | `urgente`, `socorro` | Não use tags subjetivas. Use Prioridade. |
| **Timeout de Edição** | 30 min | O Zammad avisa se outro agente estiver editando. |
| **Upload Limite** | 10 MB | Limite padrão de anexo por ticket. |
## 7. VALIDAÇÃO FINAL
- [ ] O ticket foi criado com o cliente correto?
- [ ] O Grupo e Proprietário estão definidos?
- [ ] Tags foram adicionadas conforme o assunto?