Documentação
Configuração de Categorias¶
Categorias (também chamadas de SubQueues) permitem classificar tickets dentro de uma fila, facilitando a organização, filtragem e geração de relatórios.
Use categorias para detalhar o tipo de solicitação sem precisar criar múltiplas filas.
O que são Categorias?¶
Categorias são etiquetas que podem ser associadas aos tickets para classificação adicional.
Exemplos Práticos¶
Fila: Suporte Técnico
- Problema de Login
- Erro no Sistema
- Dúvida de Uso
- Solicitação de Acesso
- Bug Reportado
Fila: Financeiro
- Faturamento
- Reembolso
- Alteração de Dados
- Segunda Via
- Contestação
Fila: Vendas
- Novo Cliente
- Renovação
- Upgrade
- Orçamento
- Demonstração
Criando Categorias¶
Passo a Passo¶
- Acesse Painel > Configurações > Categorias
- Clique em Nova Categoria
- Preencha os campos:
| Campo | Descrição | Obrigatório |
|---|---|---|
| Título | Nome da categoria | Sim |
| Ativo | Se a categoria está disponível | Sim |
- Clique em Salvar
Boas Práticas de Nomenclatura¶
Bom:
✓ Problema de Conexão
✓ Erro ao Salvar Dados
✓ Solicitação de Novo Usuário
Evite:
✗ Outros
✗ Geral
✗ N/A
✗ Teste
Categorias muito genéricas como "Outros" dificultam a análise posterior dos tickets.
Associando Categorias a Filas¶
Uma categoria pode ser usada em múltiplas filas.
Associar ao Criar/Editar Fila¶
- Acesse a edição da fila
- No campo Categorias, selecione as categorias desejadas
- Salve a fila
Múltiplas Filas¶
Categoria: "Problema de Login"
Associada a:
├── Suporte Técnico
├── Atendimento Geral
└── Suporte Premium
Resultado:
- Usuários podem selecionar esta categoria em qualquer uma das filas
- Relatórios podem filtrar por categoria em todas as filas
Usando Categorias nos Tickets¶
Ao Criar Ticket¶
- Selecione a fila
- No campo Categoria, escolha a opção apropriada
- Complete os demais campos
Ao Editar Ticket¶
- Abra o ticket
- Altere a categoria no campo correspondente
- A alteração fica registrada no histórico
A mudança de categoria cria um registro no histórico do ticket (Follow-up).
Filtros e Busca¶
Filtrar por Categoria¶
Na listagem de tickets:
- Localize o filtro Categoria
- Selecione uma ou mais categorias
- A lista será atualizada automaticamente
Pesquisa Avançada¶
Combine filtros para buscas mais precisas:
Fila: Suporte Técnico
Categoria: Bug Reportado
Status: Aberto
Prioridade: Alta
Período: Última semana
Relatórios por Categoria¶
Analise métricas segmentadas por categoria:
Métricas Disponíveis¶
- Volume de tickets por categoria
- Tempo médio de resolução por categoria
- Distribuição percentual
- Tendência ao longo do tempo
Exemplo de Análise¶
| Categoria | Tickets | % Total | Tempo Médio |
|---|---|---|---|
| Problema de Login | 45 | 30% | 2h |
| Erro no Sistema | 38 | 25% | 4h |
| Dúvida de Uso | 35 | 23% | 1h |
| Solicitação de Acesso | 22 | 15% | 30min |
| Outros | 10 | 7% | 3h |
Use esses dados para identificar problemas recorrentes e planejar melhorias.
Categorias e Formulários¶
Campos Dinâmicos¶
Algumas categorias podem exigir informações específicas. Configure formulários personalizados:
Categoria: Bug Reportado
Campos Adicionais:
- Versão do Sistema
- Navegador
- Passos para Reproduzir
- Print da Tela
Categoria: Solicitação de Acesso
Campos Adicionais:
- Sistema Desejado
- Justificativa
- Aprovador
Desativando Categorias¶
Categorias não utilizadas podem ser desativadas:
- Edite a categoria
- Desmarque a opção Ativo
- Salve
Categorias desativadas não aparecem para seleção, mas permanecem nos tickets existentes.
Excluindo Categorias¶
A exclusão de categorias é permanente e pode afetar relatórios históricos.
Antes de excluir:
- Verifique se há tickets usando a categoria
- Reclassifique os tickets para outra categoria
- Então exclua a categoria
Organização Hierárquica¶
Embora o sistema não suporte subcategorias nativas, você pode simular hierarquia na nomenclatura:
Suporte > Hardware > Impressora
Suporte > Hardware > Monitor
Suporte > Software > Windows
Suporte > Software > Office
Ou usando prefixos:
[HW] Impressora
[HW] Monitor
[SW] Windows
[SW] Office
Importação em Massa¶
Para criar muitas categorias, use importação via API:
POST /api/subqueues/
Content-Type: application/json
{
"title": "Nova Categoria",
"organization": 1,
"is_active": true
}
Boas Práticas¶
Planejamento¶
- Mapeie antes de criar: Liste todas as categorias necessárias
- Limite a quantidade: Entre 5-15 categorias por fila
- Seja específico: Evite categorias muito amplas
- Revise periodicamente: Ajuste conforme o uso
Manutenção¶
- Analise o uso: Verifique categorias nunca utilizadas
- Consolide similares: Una categorias com baixo volume
- Atualize nomes: Melhore nomenclaturas confusas
- Documente: Mantenha um guia de categorias para a equipe
Exemplo de Guia de Categorias¶
## Guia de Categorias - Suporte Técnico
### Problema de Login
Use quando: Cliente não consegue acessar o sistema
Exemplos: Senha incorreta, usuário bloqueado, esqueceu senha
### Erro no Sistema
Use quando: Sistema apresenta comportamento inesperado
Exemplos: Tela em branco, mensagem de erro, travamento
### Dúvida de Uso
Use quando: Cliente tem dúvida sobre funcionalidade
Exemplos: Como fazer X, onde encontrar Y, explicar Z
### Solicitação de Acesso
Use quando: Cliente precisa de novo acesso ou permissão
Exemplos: Novo usuário, liberar módulo, alterar perfil
Integração com API¶
Listar Categorias¶
GET /api/subqueues/
Criar Categoria¶
POST /api/subqueues/
{
"title": "Nova Categoria",
"is_active": true
}
Associar a Ticket¶
PATCH /api/tickets/{id}/
{
"subqueue": 5
}
Próximos Passos¶
Precisa de ajuda? Entre em contato com nosso suporte ou consulte a base de conhecimento.
Nesta página
- Configuração de Categorias
- O que são Categorias?
- Criando Categorias
- Associando Categorias a Filas
- Usando Categorias nos Tickets
- Filtros e Busca
- Relatórios por Categoria
- Categorias e Formulários
- Desativando Categorias
- Excluindo Categorias
- Organização Hierárquica
- Importação em Massa
- Boas Práticas
- Integração com API
- Próximos Passos