# WiseDesk Developers

> API pública e servidor MCP do WiseDesk — helpdesk e gestão ágil.

- [WiseDesk para desenvolvedores](https://docs.wiseapp360.com/index.md): Integre tickets, cadastros, base de conhecimento e o Agile do WiseDesk aos seus sistemas e agentes de IA.
- [Quickstart](https://docs.wiseapp360.com/quickstart.md): Da API key à primeira chamada em menos de 2 minutos.
- [Autenticação](https://docs.wiseapp360.com/guias/autenticacao.md): Toda requisição é autenticada com uma API key da sua empresa.
- [Escopos](https://docs.wiseapp360.com/guias/escopos.md): Controle exatamente o que cada API key pode fazer.
- [Rate limits](https://docs.wiseapp360.com/guias/rate-limits.md): Limites de requisições por API key.
- [Erros](https://docs.wiseapp360.com/guias/erros.md): Códigos HTTP e formato das respostas de erro.
- [Paginação e filtros](https://docs.wiseapp360.com/guias/paginacao.md): Como percorrer listas grandes.
- [URL base e OpenAPI](https://docs.wiseapp360.com/guias/ambientes.md): Endereço da API e especificação OpenAPI.
- [Abrir e acompanhar um ticket](https://docs.wiseapp360.com/guias/receitas/abrir-ticket.md): Do formulário do seu sistema até a resposta ao cliente.
- [Transformar ticket em task](https://docs.wiseapp360.com/guias/receitas/ticket-para-task.md): Leve um incidente do helpdesk para a sprint do time de produto.
- [Changelog](https://docs.wiseapp360.com/changelog.md): Novidades da API pública e do servidor MCP.
- [Identidade da API key](https://docs.wiseapp360.com/api-reference/autenticação/identidade-da-api-key.md): Retorna a company, os escopos, a expiração e o limite de requisições da key. Útil para validar a configuração e descobrir quais recursos estão disponíveis.
- [Listar tickets](https://docs.wiseapp360.com/api-reference/tickets/listar-tickets.md): Lista paginada de tickets da company, com filtros por status, prioridade, departamento e busca.
- [Criar ticket](https://docs.wiseapp360.com/api-reference/tickets/criar-ticket.md): O SLA é calculado automaticamente pela política vigente.
- [Obter ticket](https://docs.wiseapp360.com/api-reference/tickets/obter-ticket.md)
- [Atualizar ticket](https://docs.wiseapp360.com/api-reference/tickets/atualizar-ticket.md): Atualiza status, prioridade, responsável, departamento etc.
- [Histórico de atividades do ticket](https://docs.wiseapp360.com/api-reference/tickets/histórico-de-atividades-do-ticket.md)
- [Listar mensagens do ticket](https://docs.wiseapp360.com/api-reference/tickets/listar-mensagens-do-ticket.md)
- [Responder ticket](https://docs.wiseapp360.com/api-reference/tickets/responder-ticket.md): Adiciona uma mensagem na conversa do ticket.
- [Listar comentários internos do ticket](https://docs.wiseapp360.com/api-reference/tickets/listar-comentários-internos-do-ticket.md)
- [Adicionar comentário interno](https://docs.wiseapp360.com/api-reference/tickets/adicionar-comentário-interno.md): Comentários internos não são visíveis ao cliente.
- [Listar anexos do ticket](https://docs.wiseapp360.com/api-reference/tickets/listar-anexos-do-ticket.md): Arquivos enviados retornam URL assinada temporária.
- [Anexar link ao ticket](https://docs.wiseapp360.com/api-reference/tickets/anexar-link-ao-ticket.md)
- [Enviar arquivo para o ticket (até 25 MB)](https://docs.wiseapp360.com/api-reference/tickets/enviar-arquivo-para-o-ticket-até-25-mb.md)
- [Dashboard de tickets e SLA](https://docs.wiseapp360.com/api-reference/analytics/dashboard-de-tickets-e-sla.md): Volume por status/prioridade, SLA cumprido/violado e tendência no período.
- [Visão geral dos projetos](https://docs.wiseapp360.com/api-reference/analytics/visão-geral-dos-projetos.md): Progresso, sprint ativa e saúde de cada projeto.
- [Velocity por sprint](https://docs.wiseapp360.com/api-reference/analytics/velocity-por-sprint.md): Pontos comprometidos x entregues nas últimas sprints.
- [Throughput](https://docs.wiseapp360.com/api-reference/analytics/throughput.md): Tasks concluídas por período.
- [Dashboard do projeto](https://docs.wiseapp360.com/api-reference/analytics/dashboard-do-projeto.md): Indicadores agregados de um projeto Agile.
- [Listar clientes](https://docs.wiseapp360.com/api-reference/clientes/listar-clientes.md): Busca opcional por nome, e-mail ou documento.
- [Criar cliente](https://docs.wiseapp360.com/api-reference/clientes/criar-cliente.md)
- [Obter cliente](https://docs.wiseapp360.com/api-reference/clientes/obter-cliente.md)
- [Atualizar cliente](https://docs.wiseapp360.com/api-reference/clientes/atualizar-cliente.md)
- [Listar departamentos (filas de atendimento)](https://docs.wiseapp360.com/api-reference/departamentos/listar-departamentos-filas-de-atendimento.md)
- [Criar departamento](https://docs.wiseapp360.com/api-reference/departamentos/criar-departamento.md)
- [Obter departamento](https://docs.wiseapp360.com/api-reference/departamentos/obter-departamento.md)
- [Atualizar departamento](https://docs.wiseapp360.com/api-reference/departamentos/atualizar-departamento.md)
- [Listar clientes finais (usuários do portal)](https://docs.wiseapp360.com/api-reference/clientes-finais/listar-clientes-finais-usuários-do-portal.md)
- [Criar cliente final](https://docs.wiseapp360.com/api-reference/clientes-finais/criar-cliente-final.md): Gera o token de acesso ao portal.
- [Obter cliente final](https://docs.wiseapp360.com/api-reference/clientes-finais/obter-cliente-final.md)
- [Atualizar cliente final](https://docs.wiseapp360.com/api-reference/clientes-finais/atualizar-cliente-final.md)
- [Listar/buscar artigos](https://docs.wiseapp360.com/api-reference/base-de-conhecimento/listarbuscar-artigos.md): Busca por título e conteúdo.
- [Criar artigo](https://docs.wiseapp360.com/api-reference/base-de-conhecimento/criar-artigo.md)
- [Obter artigo](https://docs.wiseapp360.com/api-reference/base-de-conhecimento/obter-artigo.md)
- [Atualizar artigo](https://docs.wiseapp360.com/api-reference/base-de-conhecimento/atualizar-artigo.md)
- [Listar projetos](https://docs.wiseapp360.com/api-reference/agile-·-projetos/listar-projetos.md)
- [Criar projeto](https://docs.wiseapp360.com/api-reference/agile-·-projetos/criar-projeto.md)
- [Obter projeto](https://docs.wiseapp360.com/api-reference/agile-·-projetos/obter-projeto.md)
- [Atualizar projeto](https://docs.wiseapp360.com/api-reference/agile-·-projetos/atualizar-projeto.md)
- [Listar membros](https://docs.wiseapp360.com/api-reference/agile-·-projetos/listar-membros.md): Usuários da company — use o `id` (UserProfile) como responsável das tasks.
- [Listar labels do projeto](https://docs.wiseapp360.com/api-reference/agile-·-projetos/listar-labels-do-projeto.md)
- [Listar sprints do projeto](https://docs.wiseapp360.com/api-reference/agile-·-sprints/listar-sprints-do-projeto.md)
- [Criar sprint](https://docs.wiseapp360.com/api-reference/agile-·-sprints/criar-sprint.md)
- [Obter sprint](https://docs.wiseapp360.com/api-reference/agile-·-sprints/obter-sprint.md)
- [Atualizar sprint](https://docs.wiseapp360.com/api-reference/agile-·-sprints/atualizar-sprint.md)
- [Iniciar sprint](https://docs.wiseapp360.com/api-reference/agile-·-sprints/iniciar-sprint.md)
- [Concluir sprint](https://docs.wiseapp360.com/api-reference/agile-·-sprints/concluir-sprint.md): Tasks não concluídas voltam ao backlog.
- [Resumo da sprint](https://docs.wiseapp360.com/api-reference/agile-·-sprints/resumo-da-sprint.md): Pontos planejados/entregues, tasks por status e progresso.
- [Histórico de atividades da sprint](https://docs.wiseapp360.com/api-reference/agile-·-sprints/histórico-de-atividades-da-sprint.md)
- [Listar boards (kanbans) do projeto](https://docs.wiseapp360.com/api-reference/agile-·-boards/listar-boards-kanbans-do-projeto.md)
- [Criar board](https://docs.wiseapp360.com/api-reference/agile-·-boards/criar-board.md)
- [Atualizar board](https://docs.wiseapp360.com/api-reference/agile-·-boards/atualizar-board.md)
- [Mover task para uma coluna do board](https://docs.wiseapp360.com/api-reference/agile-·-boards/mover-task-para-uma-coluna-do-board.md)
- [Listar épicos](https://docs.wiseapp360.com/api-reference/agile-·-épicos-e-features/listar-épicos.md)
- [Criar épico](https://docs.wiseapp360.com/api-reference/agile-·-épicos-e-features/criar-épico.md)
- [Atualizar épico](https://docs.wiseapp360.com/api-reference/agile-·-épicos-e-features/atualizar-épico.md)
- [Listar features](https://docs.wiseapp360.com/api-reference/agile-·-épicos-e-features/listar-features.md)
- [Criar feature](https://docs.wiseapp360.com/api-reference/agile-·-épicos-e-features/criar-feature.md)
- [Atualizar feature](https://docs.wiseapp360.com/api-reference/agile-·-épicos-e-features/atualizar-feature.md)
- [Listar tasks](https://docs.wiseapp360.com/api-reference/agile-·-tasks/listar-tasks.md): Exige `projectId`. Filtros por sprint, backlog, status, prioridade, responsável, time, board e busca.
- [Criar task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/criar-task.md): O código (ex.: WD-42) é gerado automaticamente.
- [Criar task a partir de um ticket](https://docs.wiseapp360.com/api-reference/agile-·-tasks/criar-task-a-partir-de-um-ticket.md): Copia título/descrição e vincula o ticket.
- [Obter task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/obter-task.md)
- [Atualizar task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/atualizar-task.md): Status, responsáveis, story points, prazos etc.
- [Mover task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/mover-task.md): Muda status, sprint (null = backlog) e/ou ordem.
- [Arquivar task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/arquivar-task.md)
- [Restaurar task arquivada](https://docs.wiseapp360.com/api-reference/agile-·-tasks/restaurar-task-arquivada.md)
- [Histórico de atividades da task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/histórico-de-atividades-da-task.md)
- [Listar comentários da task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/listar-comentários-da-task.md)
- [Comentar na task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/comentar-na-task.md): Suporta menções; notifica os envolvidos.
- [Listar lançamentos de tempo](https://docs.wiseapp360.com/api-reference/agile-·-tasks/listar-lançamentos-de-tempo.md)
- [Lançar tempo trabalhado](https://docs.wiseapp360.com/api-reference/agile-·-tasks/lançar-tempo-trabalhado.md)
- [Definir labels da task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/definir-labels-da-task.md): Substitui o conjunto atual de labels.
- [Listar checklists da task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/listar-checklists-da-task.md)
- [Criar checklist na task](https://docs.wiseapp360.com/api-reference/agile-·-tasks/criar-checklist-na-task.md)
- [Criar label no projeto](https://docs.wiseapp360.com/api-reference/agile-·-tasks/criar-label-no-projeto.md)
- [Adicionar item ao checklist](https://docs.wiseapp360.com/api-reference/agile-·-tasks/adicionar-item-ao-checklist.md)
- [Atualizar/marcar item do checklist](https://docs.wiseapp360.com/api-reference/agile-·-tasks/atualizarmarcar-item-do-checklist.md)
- [Servidor MCP](https://docs.wiseapp360.com/mcp/visao-geral.md): Opere o WiseDesk por linguagem natural no Claude, ChatGPT, Cursor e VS Code.
- [Instalação](https://docs.wiseapp360.com/mcp/instalacao.md): Configure o servidor MCP do WiseDesk no seu assistente.
- [Tools, resources e prompts](https://docs.wiseapp360.com/mcp/tools.md): Tudo o que o servidor MCP expõe e o escopo exigido por cada item.
- [Exemplos de uso](https://docs.wiseapp360.com/mcp/exemplos.md): Fluxos reais que o assistente executa com o servidor MCP.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.