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

# Instância

> Entenda o conceito de instância e como a autenticação funciona na API Bliper

## Descrição

Uma instância representa uma conexão individual com o WhatsApp. Cada instância possui seu próprio `instanceId` e `instanceToken`, que são usados para autenticar todas as requisições relacionadas àquela conexão.

## Autenticação

A API Bliper utiliza dois níveis de autenticação:

* **Client-Token**: token da sua conta Bliper, enviado no header `Client-Token`. Necessário para criar instâncias.
* **instanceId + instanceToken**: identificadores únicos da instância, embutidos diretamente na URL de cada requisição.

## Estrutura da URL

Todos os endpoints de instância seguem o padrão:

```
https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/action
```

Substitua `{INSTANCE_ID}` e `{INSTANCE_TOKEN}` pelos valores obtidos ao criar a instância.

## Obtendo instanceId e instanceToken

O `instanceId` e o `instanceToken` são retornados na resposta do endpoint de criação de instância (`POST /instances`). Guarde esses valores com segurança, pois eles serão necessários para todas as operações subsequentes.

```json theme={null}
{
  "instanceId": "abc123",
  "instanceToken": "tok_...",
  "name": "Minha Instância"
}
```

<Note>
  Guarde o `instanceId` e o `instanceToken` em um local seguro. Eles são necessários para todas as requisições da instância.
</Note>