NextChatAtendimentos e equipe
Protocolos, responsáveis, equipe e o relatório do gestor.
Nesta página
Nas empresas com atendimento, cada conversa ganha um atendimento com protocolo (NC-000123) quando o cliente escreve ou a equipe começa. Ele guarda quem é o responsável, o setor, a primeira resposta e quando foi finalizado.
| Rota | O que traz |
|---|---|
GET /attendances | Atendimentos: status=open ou closed, assignee (id ou none), sector, conversation, protocol (com ou sem NC-), from, to, limit, cursor |
GET /attendances/{id} | Um atendimento, com contato e responsável |
GET /conversations/{id}/attendance | O atendimento atual da conversa (ou null) |
GET /conversations/{id}/assignments | Histórico de responsáveis: quem assumiu, recebeu ou devolveu |
POST /conversations/{id}/attendance/close | Finaliza com {reason?}; o cartão do quadro Atendimentos vai para Concluído |
Responder e finalizar
# atendimentos em andamento
curl "$NEXTCHAT_API/attendances?status=open" -H "Authorization: Bearer $NEXTCHAT_API_KEY"
# enviar a mensagem
curl -X POST "$NEXTCHAT_API/conversations/ID_DA_CONVERSA/messages" \
-H "Authorization: Bearer $NEXTCHAT_API_KEY" -H "Content-Type: application/json" \
-d '{"client_id":"3f1c1e0e-5c1a-4a52-9a43-8f9a1a1b2c3d","text":"Sua guia já está disponível."}'
# finalizar o atendimento
curl -X POST "$NEXTCHAT_API/conversations/ID_DA_CONVERSA/attendance/close" \
-H "Authorization: Bearer $NEXTCHAT_API_KEY" -H "Content-Type: application/json" \
-d '{"reason":"Guia enviada"}'Equipe e relatório
GET /team lista as pessoas com papel, perfil de acesso, presença e setores; use os ids para transferir conversas. GET /sectors traz os setores com membros e filas, e GET /company/attendance as regras da empresa (quem responde primeiro assume, modo restrito ou liberal, finalização automática).
GET /reports/attendance devolve os totais do período (from, to, sector, user): atendimentos abertos e finalizados, tempo de primeira resposta e de resolução, por pessoa, setor e dia.
Endpoints
| Método | Caminho | Ação | Permissão |
|---|---|---|---|
| GET | /attendances | Listar atendimentos (protocolos) | attendances:read |
| GET | /attendances/{id} | Detalhar atendimento | attendances:read |
| GET | /conversations/{id}/attendance | Atendimento atual da conversa | attendances:read |
| GET | /conversations/{id}/assignments | Histórico de responsáveis | attendances:read |
| POST | /conversations/{id}/attendance/close | Finalizar atendimento | attendances:write |
| Método | Caminho | Ação | Permissão |
|---|---|---|---|
| GET | /team | Equipe | team:read |
| GET | /sectors | Setores | team:read |
| GET | /company/attendance | Regras de atendimento da empresa | team:read |
| Método | Caminho | Ação | Permissão |
|---|---|---|---|
| GET | /reports/attendance | Relatório do gestor | reports:read |