Skip to main content

​
Introdução

Este guia mostra como criar uma instância, conectar ao WhatsApp e enviar sua primeira mensagem usando a Bliper API.
Você precisará de uma conta no Dashboard Bliper para obter seu Client-Token.

​
Passo 1: Obtenha seu Client-Token

Acesse o Dashboard Bliper, crie uma conta e copie seu Client-Token nas configurações. Esse token identifica sua conta e é usado em todas as requisições.
Nunca exponha seu Client-Token em código front-end ou repositórios públicos.

​
Passo 2: Crie uma Instância

Cada instância representa uma conexão com o WhatsApp. Crie a sua: 
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: 
{
  "instanceId": "abc123",
  "instanceToken": "tok_xxxxxxxxxxxx",
  "status": "pending"
}
O instanceToken é exibido apenas uma vez. Salve-o com segurança.

​
Passo 3: Obtenha o QR Code

Com a instância criada, gere o QR Code para parear seu WhatsApp: 
curl -X GET 'https://api.bliper.io/instances/SEU_INSTANCE_ID/token/SEU_INSTANCE_TOKEN/qr-code' \
  -H 'Client-Token: SEU_CLIENT_TOKEN'

{
  "value": "data:image/png;base64,iVBORw0KGgo..."
}
Decodifique o base64 e escaneie a imagem com seu WhatsApp em Dispositivos conectados → Conectar dispositivo.
Prefere conectar pelo número de telefone? Use o endpoint de Código de Pareamento como alternativa ao QR Code.

​
Passo 4: Verifique o Status da Conexão

Aguarde a conexão ser estabelecida e verifique o status: 
curl -X GET 'https://api.bliper.io/instances/SEU_INSTANCE_ID/token/SEU_INSTANCE_TOKEN/status' \
  -H 'Client-Token: SEU_CLIENT_TOKEN'

{
  "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: 
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: 
{
  "zaapId": "e5acb33a-c8f8-4e8a-b491-123456789abc",
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
O número de destino deve estar no formato internacional, sem + ou espaços. Exemplo: 5511999999999 (55 = Brasil, 11 = DDD, 999999999 = número).

​
Passo 6: Configure um Webhook (Opcional)

Para receber mensagens e eventos em tempo real na sua aplicação, configure uma URL de webhook: 
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: 
{
  "instanceId": "abc123",
  "messageId": "ABCDEF123456",
  "phone": "5511999999999",
  "fromMe": false,
  "type": "ReceivedCallback",
  "text": { "message": "Oi!" }
}

​
Próximos Passos

Enviar Imagens

Envie imagens com legendas opcionais.

Gerenciar Grupos

Crie e gerencie grupos do WhatsApp.

Webhooks

Configure todos os tipos de eventos disponíveis.

Referência da API

Consulte todos os endpoints disponíveis.