API dos agentes (lote 02)
Integração por HTTP/JSON (TR 1.5.4.3 e 1.5.4.11). Autenticação por sessão; em produção, acesso de sistemas por chave de integração emitida pelo administrador. Integrações com SEI, WebGiz ou Moodle dependem de autorização e escopo próprios da Unimontes.
/api/agentes/{agente}/mensagensEnvia a mensagem do cidadão. Na primeira mensagem cria o atendimento e o protocolo.
{ "texto": "Como peço uma declaração?", "canal": "web", "atendimentoId": 12 }{ "atendimento": { "id": 12, "protocolo": "GS-20261115-00012", "status": "agente" }, "novas": [ ...mensagens ] }/api/atendimentos/{id}Lê o atendimento e o histórico (dono ou operador).
—
{ "atendimento": {...}, "mensagens": [ { "autor": "cidadao|agente|operador|sistema", "conteudo": "..." } ] }/api/atendimentos/{id}Ações: transferir, encerrar (cidadão); assumir, responder, devolver (operador).
{ "acao": "transferir" }{ "ok": true, "atendimento": {...}, "mensagens": [...] }/api/admin/atendimentosExportação estruturada (CSV) de atendimentos e mensagens. Restrito ao administrador.
?mes=2026-11
text/csv
/api/saudeVerificação de saúde para monitoramento de disponibilidade.
—
{ "ok": true, "banco": true, "provedores": { "google": true, ... } }