API

Tudo o que a interface faz, a API também faz

API REST com respostas em JSON, autenticação por token de serviço, paginação por cursor e webhooks assinados. Ambiente de testes (sandbox) disponível para todos os planos.

(a) Autenticação

Token de serviço no cabeçalho

Gere um token por integração no painel de administração. Cada token tem escopo próprio, validade configurável e registro de uso na trilha de auditoria.

Base: https://api.savedesk.com.br
Limite: 600 requisições/minuto por token
Formato: JSON · UTF-8

curl -X POST https://api.savedesk.com.br/v1/chamados \
  -H "Authorization: Bearer $SAVEDESK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "titulo": "Sem acesso ao ERP",
    "categoria": "acesso",
    "solicitante": "[email protected]",
    "prioridade": "alta"
  }'

(b) Endpoints principais

GET/v1/chamadosLista chamados com filtros por fila, status e SLA.

POST/v1/chamadosAbre um chamado com categoria, solicitante e anexos.

PATCH/v1/chamados/{id}Atualiza status, responsável, prioridade ou notas.

GET/v1/conhecimentoBusca semântica em artigos da base de conhecimento.

GET/v1/cmdb/ativosConsulta ativos, relacionamentos e histórico de inventário.

POST/v1/fluxos/{id}/executarDispara um fluxo BPM com variáveis de entrada.

POST/v1/aprovacoes/{id}/decidirRegistra aprovação ou reprovação com justificativa.

GET/v1/gamificacao/rankingRetorna pontuação, níveis e conquistas dos agentes.

Eventos enviados em tempo real

chamado.criadochamado.resolvidosla.em_riscoaprovacao.pendentefluxo.concluidoativo.alterado

Solicitar acesso ao sandbox