Chamados

GET/chamadoschamados:leitura

Parâmetros (query)

Nome	Descrição
`cliente_id`, `contrato_id`	Filtra por cliente ou contrato.
`situacao`	`aberto`, `pendente`, `pendente_terceiro`, `em_andamento`, `reaberto`, `solucionado`, `cancelado` ou `em_aberto` (todos que ainda não foram encerrados).
`pagina`, `por_pagina`	Paginação.

curl "$API/chamados?cliente_id=5&situacao=em_aberto" -H "Authorization: Bearer $CHAVE"

{
  "sucesso": true,
  "dados": [
    {
      "id": 300,
      "cliente_id": 5,
      "contrato_id": 10,
      "situacao": "aberto",
      "prioridade": "alta",
      "categoria": "TECNICO",
      "assunto": "Sem internet",
      "descricao": "Luz vermelha no roteador desde ontem.",
      "solucao": null,
      "aberto_em": "2026-10-13T12:00:00.000Z",
      "fechado_em": null,
      "agendado_para": null
    }
  ],
  "paginacao": { "pagina": 1, "por_pagina": 20, "total": 1, "total_paginas": 1 }
}

Antes de abrir um chamado novo, consulte os chamados em_aberto do cliente para não duplicar o atendimento.

GET/chamados/{id}chamados:leitura

curl "$API/chamados/300" -H "Authorization: Bearer $CHAVE"

GET/chamados/{id}/historicochamados:leitura

Tudo o que aconteceu no chamado, em ordem: mudanças de situação, comentários, solução e notificações.

{
  "sucesso": true,
  "dados": [
    { "id": 1, "acao": "Status alterado para EM_ANDAMENTO", "descricao": null, "autor": "Maria (técnica)", "ocorrido_em": "2026-10-13T13:00:00.000Z" },
    { "id": 2, "acao": "Comentário", "descricao": "Cliente pediu visita à tarde.", "autor": "API: Chatbot da Empresa X", "ocorrido_em": "2026-10-13T13:05:00.000Z" }
  ]
}

POST/chamadoschamados:escrita

O chamado entra na fila do provedor como qualquer outro, e a equipe recebe o aviso de chamado novo com origem API.

Corpo

Campo	Descrição
`cliente_id` *	Cliente do chamado.
`contrato_id`	Contrato relacionado (precisa ser do mesmo cliente).
`assunto` *	De 3 a 300 caracteres.
`descricao` *	De 3 a 5.000 caracteres.
`prioridade`	`baixa`, `normal` (padrão), `alta` ou `urgente`.
`categoria`	`TECNICO`, `FINANCEIRO`, `COMERCIAL`, `INSTALACAO`, `CANCELAMENTO` ou `OUTRO`.

curl -X POST "$API/chamados" \
  -H "Authorization: Bearer $CHAVE" -H "Content-Type: application/json" \
  -d '{
    "cliente_id": 5,
    "contrato_id": 10,
    "assunto": "Sem internet",
    "descricao": "Luz vermelha no roteador desde ontem. Cliente prefere visita pela manhã.",
    "prioridade": "alta",
    "categoria": "TECNICO"
  }'

Responde 201 com o chamado criado, no mesmo formato de /chamados/{id}.

PATCH/chamados/{id}chamados:escrita

Altera a situação, registra a solução, ajusta a prioridade ou adiciona um comentário. Os efeitos são os mesmos da tela do provedor: ao solucionar, o assinante é avisado; ao cancelar, o técnico designado é avisado.

Corpo (envie ao menos um campo)

Campo	Descrição
`situacao`	`em_andamento`, `pendente`, `pendente_terceiro`, `reaberto`, `solucionado` ou `cancelado`.
`solucao`	O que foi feito, de 3 a 5.000 caracteres.
`prioridade`	`baixa`, `normal`, `alta` ou `urgente`.
`comentario`	Anotação que entra no histórico do chamado.

curl -X PATCH "$API/chamados/300" \
  -H "Authorization: Bearer $CHAVE" -H "Content-Type: application/json" \
  -d '{"situacao": "solucionado", "solucao": "Conector refeito na caixa de atendimento."}'

Recusa possível

HTTP	Código	Significado
422	`requer_desfecho_equipamento`	Chamado de cancelamento com equipamento a recolher: o desfecho de cada aparelho (devolvido ou não) é registrado no sistema do provedor.

Listar chamados

Parâmetros (query)

Consultar um chamado

Histórico do chamado

Abrir chamado

Corpo

Atualizar, comentar e solucionar

Corpo (envie ao menos um campo)

Recusa possível