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:
A resposta retornará o instanceId e o instanceToken — guarde esses valores, pois você vai usá-los em todas as chamadas seguintes:
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:
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:
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:
A API retorna HTTP 202 confirmando que a mensagem foi enfileirada:
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:
A partir de agora, toda mensagem recebida será enviada como um POST para essa URL com o payload:

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.