Skip to main content
POST
/
session
/
pairphone
Parear por Telefone
curl --request POST \
  --url https://api.example.com/session/pairphone

Descricao

Gera um codigo de pareamento que pode ser usado para vincular o WhatsApp sem precisar escanear o QR Code. O usuario digita o codigo no aplicativo do WhatsApp para completar a autenticacao. Este metodo e util quando:
  • O usuario nao pode escanear QR Code
  • A camera nao esta disponivel
  • Preferencia por pareamento manual

Pre-requisitos

  1. Ter chamado /session/connect primeiro
  2. Status Connected: true e LoggedIn: false

Request

Headers

token: SEU_TOKEN
Content-Type: application/json

Body

{
  "Phone": "5511999999999"
}
CampoTipoObrigatorioDescricao
PhonestringSimNumero do telefone com codigo do pais (sem +)

Response

Sucesso (200)

{
  "code": 200,
  "data": {
    "PairingCode": "ABC1-DEF2"
  },
  "success": true
}

Ja Logado

{
  "code": 400,
  "data": {
    "Details": "Already logged in"
  },
  "success": false
}

Exemplo cURL

curl -X POST 'https://api.bliper.ai/session/pairphone' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "Phone": "5511999999999"
  }'

Fluxo de Pareamento

  1. Chame POST /session/connect
  2. Chame POST /session/pairphone com o numero do telefone
  3. Exiba o codigo de pareamento para o usuario
  4. Usuario abre WhatsApp > Dispositivos Conectados > Conectar Dispositivo
  5. Usuario digita o codigo exibido
  6. Faca polling em GET /session/status ate LoggedIn: true

Instrucoes para o Usuario

Exiba estas instrucoes junto com o codigo:
  1. Abra o WhatsApp no seu celular
  2. Toque em Menu (tres pontos) > Dispositivos conectados
  3. Toque em Conectar um dispositivo
  4. Escolha Conectar com numero de telefone
  5. Digite o codigo: ABC1-DEF2
O codigo de pareamento expira apos aproximadamente 60 segundos. Gere um novo se expirar.
Faca polling do status a cada 5 segundos para detectar quando o pareamento foi concluido.