> ## 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.

# Abrir e acompanhar um ticket

> Do formulário do seu sistema até a resposta ao cliente.

Escopos necessários: `tickets:write`, `tickets:read` e (opcional) `customers:read`.

**1. Descubra o departamento (opcional)**

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

Departamentos usam **ID numérico** (ex.: `"3"`).

**2. Crie o ticket**

```bash theme={null}
curl -X POST https://wisedesk-api.wiseapp360.com/api/v1/tickets \
  -H "X-API-Key: $WISEDESK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Pedido #4821 não foi entregue",
    "description": "Cliente informa que o prazo venceu ontem.",
    "client": "Maria Souza",
    "priority": "high",
    "departamento": "3",
    "tag": "logística"
  }'
```

A resposta traz o `id`, o `ticketcode` legível e o bloco `sla` com os prazos de primeira resposta e resolução, calculados pela política da empresa.

**3. Responda o cliente**

```bash theme={null}
curl -X POST https://wisedesk-api.wiseapp360.com/api/v1/tickets/{id}/messages \
  -H "X-API-Key: $WISEDESK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Olá, Maria! Já acionamos a transportadora e retornamos em até 2h." }'
```

Para notas que o cliente **não** deve ver, use `POST /tickets/{id}/comments`.

**4. Atualize o status**

```bash theme={null}
curl -X PATCH https://wisedesk-api.wiseapp360.com/api/v1/tickets/{id} \
  -H "X-API-Key: $WISEDESK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "completed" }'
```

Ao concluir, `resolvedAt` é preenchido e o SLA de resolução é fechado.

## Anexos

Envie arquivos de até 25 MB com `multipart/form-data`:

```bash theme={null}
curl -X POST https://wisedesk-api.wiseapp360.com/api/v1/tickets/{id}/attachments/upload \
  -H "X-API-Key: $WISEDESK_API_KEY" \
  -F "file=@comprovante.pdf"
```


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