---
agentTools:
  projectIndex: https://docs.wiboor.com.br/llms.txt
  projectSearch: https://docs.wiboor.com.br/agentSearch?query=term1%20term2
---

# Autenticação

Gere o token de API no Wiboor e envie em todas as requisições

A API do Wiboor usa **Bearer Token**. Cada token pertence a um usuário: a API enxerga e altera o que esse usuário pode ver e fazer no Wiboor.

## Gere seu token

1. Entre na sua conta em [wiboor.com.br](https://wiboor.com.br/login).
2. Clique no botão do seu perfil (o último do painel lateral) e escolha **Token**.
3. Clique em **Gerar Token** e copie o token exibido.

> ⚠️ O token aparece uma vez só
>
> Guarde-o num lugar seguro, como o cofre de segredos do seu servidor. Se você gerar um token novo, o anterior deixa de funcionar na hora.

## Envie o token nas requisições

Inclua o token no header `Authorization` de todas as chamadas:

```bash Terminal
curl "https://api.azzimuti.com.br/v1/departments" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json"
```

| Header | Valor |
|---|---|
| `Authorization` | `Bearer SEU_TOKEN` |
| `Content-Type` | `application/json` (nas requisições com corpo) |

Na [referência da API](/reference/listar-todas-as-tarefas-com-filtros), cole o token no campo de autenticação para testar as chamadas direto na página.

> ⚠️ O token do Try It fica salvo neste navegador
>
> Para você não precisar colar de novo, o token digitado na referência fica guardado no navegador. Teste só num computador seu, nunca num compartilhado.

## Respostas de autenticação

| Status | Quando acontece |
|---|---|
| `401` | Token ausente, inválido ou revogado (por exemplo, depois de gerar um token novo) |
| `403` | O token é válido, mas o usuário não tem permissão para a ação. Exemplo: só quem solicitou a tarefa ou um gestor pode editá-la |

## Boas práticas

- Use o token só no seu backend. Nunca o coloque em código que roda no navegador ou no app do usuário.
- Crie um usuário de integração no Wiboor quando as tarefas precisarem aparecer como abertas pelo sistema, e não por uma pessoa.
- Ao trocar o token, atualize todos os sistemas que usam o anterior.