Skip to main content

Base URL

Todas as requisicoes devem ser feitas para:
https://api.bliper.ai

Autenticacao

A Bliper API utiliza autenticacao via header token. Inclua seu token em todas as requisicoes:
curl -X GET 'https://api.bliper.ai/session/status' \
  -H 'token: SEU_TOKEN_AQUI'
Nunca compartilhe ou exponha seu token. Ele da acesso completo a sua sessao WhatsApp.

Headers Obrigatorios

HeaderDescricao
tokenSeu token de autenticacao
Content-Typeapplication/json (para requisicoes com body)

Formato de Resposta

Todas as respostas seguem o formato padrao:
{
  "code": 200,
  "data": {
    // dados da resposta
  },
  "success": true
}

Campos da Resposta

CampoTipoDescricao
codenumberCodigo HTTP da resposta
dataobjectDados retornados pela API
successbooleanIndica se a requisicao foi bem sucedida

Codigos de Status

CodigoDescricao
200Sucesso
400Requisicao invalida (parametros incorretos)
401Nao autorizado (token invalido)
404Recurso nao encontrado
500Erro interno do servidor

Exemplos de Erro

token Invalido

{
  "code": 401,
  "data": {
    "Details": "Invalid token"
  },
  "success": false
}

Sessao Nao Conectada

{
  "code": 400,
  "data": {
    "Details": "Session not connected"
  },
  "success": false
}

Rate Limits

A API possui limites de requisicoes para garantir estabilidade:
  • Mensagens: 60 mensagens por minuto
  • Outras requisicoes: 120 requisicoes por minuto
Se voce atingir o limite, aguarde alguns segundos antes de tentar novamente.

Tipos de Eventos (Webhook)

Ao configurar seu webhook, voce pode escolher quais eventos receber:
EventoDescricao
MessageMensagens recebidas e enviadas
ReadReceiptConfirmacoes de leitura
HistorySyncSincronizacao de historico
ChatPresenceStatus de digitando/online

SDKs e Bibliotecas

Embora a API seja RESTful e funcione com qualquer linguagem, voce pode usar bibliotecas HTTP nativas:

cURL

Linha de comando

JavaScript

fetch ou axios

Python

requests

Proximos Passos

Conectar Sessao

Comece conectando sua sessao ao WhatsApp.