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

# Criar Instância

> Cria uma nova instância do WhatsApp

## Descrição

Cria uma nova instância do WhatsApp na sua conta Bliper. A resposta retorna o `instanceId` e o `instanceToken`, que devem ser salvos e utilizados em todas as requisições subsequentes da instância.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "name": "Minha Instância",
  "receivedCallbackUrl": "https://seu-servidor.com/webhook/received",
  "deliveryCallbackUrl": "https://seu-servidor.com/webhook/delivery"
}
```

| Campo                 | Tipo   | Obrigatório | Descrição                                    |
| --------------------- | ------ | ----------- | -------------------------------------------- |
| `name`                | string | Sim         | Nome identificador da instância              |
| `receivedCallbackUrl` | string | Não         | URL de callback para mensagens recebidas     |
| `deliveryCallbackUrl` | string | Não         | URL de callback para confirmações de entrega |

## Response

### Sucesso (200)

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

## Exemplo cURL

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Minha Instância",
    "receivedCallbackUrl": "https://seu-servidor.com/webhook/received",
    "deliveryCallbackUrl": "https://seu-servidor.com/webhook/delivery"
  }'
```

<Note>
  Salve o `instanceId` e o `instanceToken` retornados na resposta. Eles são necessários para todas as outras requisições da instância.
</Note>