Visão Geral
A API do SAC (Sistema de Atendimento ao Cliente) fornece endpoints completos para gerenciar tickets de suporte, mensagens, anexos e respostas rápidas. Esta API permite criar, atualizar, listar e gerenciar todo o fluxo de atendimento ao cliente.Base URL
Autenticação
A maioria dos endpoints requer autenticação via JWT token. Endpoints públicos estão claramente indicados.Headers Obrigatórios
Recursos Principais
1. Tickets de Suporte
- Criar e gerenciar tickets
- Upload de anexos
- Sistema de mensagens
- Tags e categorização
- Status e priorização
2. Fast Response (IA com OpenAI) 🧠
- Respostas automáticas inteligentes
- Análise de contexto e similaridade
- Processamento em lote
- Níveis de confiança
- Integração com email
3. Respostas Rápidas
- Templates predefinidos
- Categorias organizadas
- Contador de uso
- Gestão de conteúdo
4. Relatórios e Métricas 📊
Sistema completo de relatórios com cache de 2h para análise de performance do SAC.5. Operações em Lote
- Atualização múltipla de status
- Exclusão em massa
- Mensagens em lote
- Fast Response em massa
Status de Tickets
Os tickets podem ter os seguintes status:Limites e Restrições
Anexos
- Tamanho máximo: 10MB por arquivo
- Tipos permitidos:
- Imagens:
image/jpeg,image/png,image/gif,image/webp - Documentos:
application/pdf,text/plain - Planilhas:
text/csv,application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
- Imagens:
Paginação
- Limite padrão: 10 itens por página
- Limite máximo: 100 itens por página
Tratamento de Erros
A API retorna erros padronizados no seguinte formato:Códigos de Status HTTP
Rate Limiting
A API implementa rate limiting para proteção contra abuso:- Limite: 100 requisições por minuto por IP
- Headers de resposta:
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset
Exemplos de Uso
Criar um Ticket
Listar Tickets
Suporte
Para dúvidas ou problemas com a API, entre em contato:- Email: tech@waffle.com.br
- Documentação: https://docs.waffle.com.br