> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiseapp360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Da API key à primeira chamada em menos de 2 minutos.

**1. 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.

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

**2. Valide a key**

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

```bash cURL theme={null}
curl https://wisedesk-api.wiseapp360.com/api/v1/me \
  -H "X-API-Key: $WISEDESK_API_KEY"
```

```javascript Node.js theme={null}
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());
```

```python Python theme={null}
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())
```

```json Resposta theme={null}
{
  "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"]
}
```

**3. Liste seus tickets**

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

```json Resposta theme={null}
{
  "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](/guias/receitas/abrir-ticket)**
>
> Receita completa com criação, resposta e acompanhamento.

> **[Conectar ao Claude](/mcp/instalacao)**
>
> Use o servidor MCP para operar o WiseDesk por linguagem natural.


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