Pular para o conteúdo principal

Verificar status da conexão

GET /v1/numbers/{id}/status retorna o estado de conexão em tempo real de um número do WhatsApp.
curl "https://pilotstatus.com.br/v1/numbers/wa_abc/status" \
  -H "x-api-key: ps_your_token_here"
Resposta:
{
  "id": "wa_abc",
  "state": "OPEN"
}
Este endpoint reflete o mesmo estado de conexão exibido na página Números do painel (assim como GET /v1/numbers/{id}/connect).

Quando usar

  • GET /v1/numbers não força uma atualização em massa do estado de conexão — chame este endpoint por número quando precisar de uma verificação atualizada.
  • Faça polling após exibir um QR code / código de pareamento para detectar quando o cliente conclui a conexão (ou use o webhook number.connected em vez disso).

Estados

stateSignificado
OPENConectado ao WhatsApp.
CONNECTINGConexão em andamento.
CLOSEDesconectado — gere um novo QR com GET /v1/numbers/{id}/connect.
Trate state === "OPEN" como o indicador definitivo de “pronto para enviar”.