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

# Guia Rápido

> Envie sua primeira mensagem WhatsApp com a Bliper API em minutos

## Introdução

Este guia mostra como criar uma instância, conectar ao WhatsApp e enviar sua primeira mensagem usando a Bliper API.

<Note>
  Você precisará de uma conta no [Dashboard Bliper](https://app.bliper.ai) para obter seu `Client-Token`.
</Note>

## Passo 1: Obtenha seu Client-Token

Acesse o [Dashboard Bliper](https://app.bliper.ai), crie uma conta e copie seu **Client-Token** nas configurações. Esse token identifica sua conta e é usado em todas as requisições.

<Warning>
  Nunca exponha seu `Client-Token` em código front-end ou repositórios públicos.
</Warning>

## Passo 2: Crie uma Instância

Cada instância representa uma conexão com o WhatsApp. Crie a sua:

```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"
  }'
```

A resposta retornará o `instanceId` e o `instanceToken` — guarde esses valores, pois você vai usá-los em todas as chamadas seguintes:

```json theme={null}
{
  "instanceId": "abc123",
  "instanceToken": "tok_xxxxxxxxxxxx",
  "status": "pending"
}
```

<Warning>
  O `instanceToken` é exibido apenas uma vez. Salve-o com segurança.
</Warning>

## Passo 3: Obtenha o QR Code

Com a instância criada, gere o QR Code para parear seu WhatsApp:

```bash theme={null}
curl -X GET 'https://api.bliper.io/instances/SEU_INSTANCE_ID/token/SEU_INSTANCE_TOKEN/qr-code' \
  -H 'Client-Token: SEU_CLIENT_TOKEN'
```

```json theme={null}
{
  "value": "data:image/png;base64,iVBORw0KGgo..."
}
```

Decodifique o base64 e escaneie a imagem com seu WhatsApp em **Dispositivos conectados → Conectar dispositivo**.

<Tip>
  Prefere conectar pelo número de telefone? Use o endpoint de [Código de Pareamento](/api-reference/instance/phone-code) como alternativa ao QR Code.
</Tip>

## Passo 4: Verifique o Status da Conexão

Aguarde a conexão ser estabelecida e verifique o status:

```bash theme={null}
curl -X GET 'https://api.bliper.io/instances/SEU_INSTANCE_ID/token/SEU_INSTANCE_TOKEN/status' \
  -H 'Client-Token: SEU_CLIENT_TOKEN'
```

```json theme={null}
{
  "connected": true,
  "status": "CONNECTED",
  "instanceId": "abc123"
}
```

Os possíveis valores de `status` são: `PENDING`, `QR_CODE`, `CONNECTED`, `DISCONNECTED`.

## Passo 5: Envie sua Primeira Mensagem

Com a instância conectada, envie uma mensagem de texto:

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/SEU_INSTANCE_ID/token/SEU_INSTANCE_TOKEN/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Olá! Esta é minha primeira mensagem pela Bliper API."
  }'
```

A API retorna **HTTP 202** confirmando que a mensagem foi enfileirada:

```json theme={null}
{
  "zaapId": "e5acb33a-c8f8-4e8a-b491-123456789abc",
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

<Note>
  O número de destino deve estar no formato internacional, sem `+` ou espaços. Exemplo: `5511999999999` (55 = Brasil, 11 = DDD, 999999999 = número).
</Note>

## Passo 6: Configure um Webhook (Opcional)

Para receber mensagens e eventos em tempo real na sua aplicação, configure uma URL de webhook:

```bash theme={null}
curl -X PUT 'https://api.bliper.io/instances/SEU_INSTANCE_ID/token/SEU_INSTANCE_TOKEN/update-webhook-received' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "https://seusite.com/webhook/whatsapp"
  }'
```

A partir de agora, toda mensagem recebida será enviada como um POST para essa URL com o payload:

```json theme={null}
{
  "instanceId": "abc123",
  "messageId": "ABCDEF123456",
  "phone": "5511999999999",
  "fromMe": false,
  "type": "ReceivedCallback",
  "text": { "message": "Oi!" }
}
```

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Enviar Imagens" icon="image" href="/api-reference/messages/send-image">
    Envie imagens com legendas opcionais.
  </Card>

  <Card title="Gerenciar Grupos" icon="users" href="/api-reference/groups/create">
    Crie e gerencie grupos do WhatsApp.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks/overview">
    Configure todos os tipos de eventos disponíveis.
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/introduction">
    Consulte todos os endpoints disponíveis.
  </Card>
</CardGroup>