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

# Início Rápido

Comece a usar a API Tess AI em poucos minutos.

### **Criar uma Chave de API**

Para usar a API Tess AI, você precisará de uma chave de API. Você pode criar uma:

1. Indo diretamente para [#Tess AI → Tokens de Usuário](https://tess.im/dashboard/user/tokens)
2. Ou navegando pela interface:
   * Visite [#Tess AI](https://tess.im/)
   * Clique no Menu do Usuário
   * Selecione "Tokens de API"
   * Clique em "Adicionar Novo Token"

### **Configurar sua Chave de API (recomendado)**

Configure sua chave de API como uma variável de ambiente. Esta abordagem simplifica o uso da API eliminando a necessidade de incluir sua chave de API em cada requisição. Além disso, aumenta a segurança minimizando o risco de incluir inadvertidamente sua chave de API em seu código.

### **Headers obrigatórios**

Toda chamada autenticada da API precisa de:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
x-workspace-id: YOUR_WORKSPACE_ID
```

`x-workspace-id` é **obrigatório a partir de 01/09/2026**. Até lá, se omitido, usa o workspace selecionado (deprecated). Após a data, ausência → **422**. Veja [API Overview](/pt/api-overview) e [Errors](/pt/errors).

Exemplo:

```bash theme={null}
curl --request GET \
  --url 'https://api.tess.im/agents' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'x-workspace-id: YOUR_WORKSPACE_ID'
```

## **Próximos Passos**

Agora que você fez sua primeira chamada de API, você pode explorar:

* [Executar um Agente](https://docs.tess.im/pt/execute-agent)
* [Endpoints Disponíveis](https://docs.tess.im/pt/api-overview)
* [Limites de Taxa](https://docs.tess.im/pt/rate-limits)
* [Tratamento de Erros](https://docs.tess.im/pt/errors)
* [Conectar ao Zapier, Make, WhatsApp, n8n](https://docs.tess.im/pt/make)