Skip to main content
POST
/
session
/
connect
Conectar Sessao
curl --request POST \
  --url https://api.example.com/session/connect

​
Descricao

Conecta ao servidor do WhatsApp. Se nao houver sessao existente, sera iniciado um processo de QR Code que pode ser obtido via endpoint /session/qr. Voce pode se inscrever em diferentes tipos de eventos para receber via webhook.

​
Eventos Disponiveis

EventoDescricao
MessageMensagens recebidas e enviadas
ReadReceiptConfirmacoes de leitura
HistorySyncSincronizacao de historico
ChatPresenceStatus de digitando/online

​
Request

​
Headers

token: SEU_TOKEN
Content-Type: application/json

​
Body

{
  "Subscribe": ["Message", "ReadReceipt"],
  "Immediate": false
}
CampoTipoObrigatorioDescricao
SubscribearrayNaoLista de eventos para receber via webhook
ImmediatebooleanNaoSe false, aguarda 10 segundos para verificar login bem sucedido

​
Response

​
Sucesso (200)

{
  "code": 200,
  "data": {
    "details": "Connected!",
    "events": "Message,ReadReceipt",
    "jid": "[email protected]",
    "webhook": "https://seusite.com/webhook"
  },
  "success": true
}

​
Sessao ja conectada

{
  "code": 200,
  "data": {
    "details": "Already connected"
  },
  "success": true
}

​
Exemplo cURL

curl -X POST 'https://api.bliper.ai/session/connect' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "Subscribe": ["Message", "ReadReceipt"],
    "Immediate": false
  }'

​
Fluxo de Conexao

  1. Chame POST /session/connect
  2. Se retornar Connected!, a sessao ja existe
  3. Se precisar escanear QR, chame GET /session/qr
  4. Escaneie o QR Code com o WhatsApp
  5. Verifique o status com GET /session/status
Se Immediate for false, a API aguarda 10 segundos para verificar se o login foi bem sucedido. Recomendado para novas conexoes.