Quickstart

Gere uma API key

Em Configurações → API Keys, clique em Gerar key com o preset Somente leitura. Copie a key (wd_live_...) — ela é exibida uma única vez.

Trate a key como uma senha: nunca a coloque em código front-end nem em repositórios.

Valide a key

O endpoint GET /v1/me mostra a empresa, os escopos e o limite da key.

curl https://wisedesk-api.wiseapp360.com/api/v1/me \
  -H "X-API-Key: $WISEDESK_API_KEY"

const res = await fetch("https://wisedesk-api.wiseapp360.com/api/v1/me", {
  headers: { "X-API-Key": process.env.WISEDESK_API_KEY },
});
console.log(await res.json());

import os, requests

res = requests.get(
    "https://wisedesk-api.wiseapp360.com/api/v1/me",
    headers={"X-API-Key": os.environ["WISEDESK_API_KEY"]},
)
print(res.json())

Resposta

{
  "key": {
    "id": "6f1c2a9e-…",
    "name": "Integração ERP",
    "prefix": "a1b2c3d4",
    "scopes": ["tickets:read", "customers:read", "kb:read", "agile:read", "analytics:read"],
    "expiresAt": null,
    "rateLimitPerMin": 120
  },
  "company": { "id": "3e0b…", "name": "Acme Ltda" },
  "environments": ["tickets", "agile"]
}

Liste seus tickets

curl "https://wisedesk-api.wiseapp360.com/api/v1/tickets?status=open&limit=10" \
  -H "X-API-Key: $WISEDESK_API_KEY"

Resposta

{
  "data": [
    {
      "id": "0b8e1c52-…",
      "ticketcode": "2026102100010001",
      "title": "Impressora parada",
      "status": "open",
      "priority": "high",
      "client": "Maria",
      "sla": { "status": "on_track" }
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}

Próximos passos

Abrir um ticket

Receita completa com criação, resposta e acompanhamento.

Conectar ao Claude

Use o servidor MCP para operar o WiseDesk por linguagem natural.

⌘I

Começando

Fundamentos

Receitas

Novidades

Próximos passos

Abrir um ticket

Conectar ao Claude

​Próximos passos

Abrir um ticket

Conectar ao Claude

Próximos passos