Referência

API do Losambo

Uma API pequena por cima do WAHA. Cada endpoint Losambo faz uma ou mais chamadas WAHA por si e acrescenta contas, OTP, limites e faturação.

URL base

https://losambo-api.beeznoo.ao/v1

Autenticação

Authorization: Bearer lsb_live_…

Todos os endpoints

Losambo	O que faz	Por baixo · WAHA
POST /numbers	Criar e iniciar número	POST /api/sessions
GET /numbers/{id}/qr	QR para associar	GET /api/{s}/auth/qr
POST /numbers/{id}/pairing-code	Código em vez de QR	POST /api/{s}/auth/request-code
GET /numbers/{id}/health	Estado, quota e bloqueios	GET /api/sessions/{s} · /capping · /timelock
POST /numbers/{id}/restart	Reiniciar ligação	POST /api/sessions/{s}/restart
DELETE /numbers/{id}	Desassociar e apagar	POST /api/sessions/{s}/logout · DELETE
POST /otp/send	Enviar código	check-exists → startTyping → sendText
POST /otp/reverse	Verificação inversa (link wa.me)	webhook message
POST /otp/verify	Validar código	— (só Losambo)
POST /messages	Texto, imagem, ficheiro	sendText · sendImage · sendFile
GET /contacts/{phone}	Tem WhatsApp?	GET /api/contacts/check-exists

POST

/v1/otp/send

Gera um código de 6 dígitos, confirma que o número tem WhatsApp, mostra “a escrever…” e envia. O código fica guardado só como hash e expira em 5 minutos.

Corpo do pedido

to obrigatório: Número em formato internacional, ex. +2449XXXXXXXX.
app: Nome mostrado na mensagem.
via: Número a usar. Sem valor, o Losambo escolhe o número com mais quota livre.
fallback: "reverse" devolve um link de verificação inversa se o número estiver limitado.

Erros

404 not_on_whatsapp — o destinatário não tem WhatsApp.

409 number_not_working — o número está desligado (estado diferente de WORKING).

429 number_capped — quota de novas conversas esgotada (CAPPED).

402 subscription_inactive — a subscrição da conta não está ativa; toda a API fica desativada.

JavacurlNode

var res = losambo.otp().send(
  OtpSend.builder()
    .to("+2449XXXXXXXX")
    .app("MinhaLoja")
    .fallback("reverse")
    .build());

202 Accepted

{
  "id": "otp_8f2c",
  "status": "sent",
  "via": "minhaloja-01",
  "expires_in": 300
}

Sequência no WAHA

GET /api/contacts/check-exists
GET /api/sessions/{s}/capping
POST /api/startTyping
POST /api/sendText
POST /api/stopTyping

Eventos de webhook

Repassamos os eventos do WAHA com a mesma forma e acrescentamos eventos próprios do Losambo.

message

Mensagem recebida.

message.ack

Enviada, entregue ou lida.

session.status

WORKING, SCAN_QR_CODE, FAILED…

otp.verified

Código confirmado (envio ou inverso).

number.capping

Número chegou a um aviso de quota.