Sua primeira chamada

URL base https://developers.wasync.app/api/v1.

Liste as conexões que você pode usar

curl https://developers.wasync.app/api/v1/connections \
  -H "Authorization: Bearer $WASYNC_API_KEY"

Só aparecem conexões com licença ativa. Cada uma traz um provider com valor qr ou cloud_api, um id (um cuid — o identificador estável que você deve guardar junto ao registro do seu próprio cliente) e um status. Usa whatsapp.read.

Confira a sua capacidade antes de prometê-la

curl https://developers.wasync.app/api/v1/account \
  -H "Authorization: Bearer $WASYNC_API_KEY"

{
  "slots": {
    "total": 30,
    "used": 28,
    "available": 2,
    "nextExpiry": "2027-08-08T09:00:00.000Z"
  },
  "connections": {
    "total": 28,
    "connected": 27,
    "needsReconnect": 1
  }
}

slots.available mostra se você pode cadastrar mais um número agora, e nextExpiry é a data antes da qual você precisa faturar o seu próprio cliente — assim, um slot nunca expira na mão de quem já pagou a você. connections.needsReconnect conta os números que, neste momento, esperam que o dono escaneie um QR; assine os eventos de conexão para ser avisado assim que esse número mudar, em vez de consultar o tempo todo. Usa whatsapp.read.

Um slot é capacidade, não um número de telefone. Se você exclui uma conexão, o slot volta para o seu conjunto com o tempo que ainda restava nele — o próximo número que você conectar o aproveita automaticamente. É isso que permite transferir um slot pago de um cliente que está saindo para um novo, sem pagar duas vezes.

Conecte um número

Uma única chamada cria a conexão e devolve um QR code para escanear. Ela funciona em um workspace novinho, sem nenhuma conexão — com uma chave, não há nada para clicar antes em um portal.

curl -X POST https://developers.wasync.app/api/v1/connections \
  -H "Authorization: Bearer $WASYNC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"label":"Support line"}'

{
  "connection": {
    "id": "conn_8f3a21",
    "status": "connecting",
    "qr": "data:image/png;base64,iVBORw0KGgo…"
  }
}

Usa whatsapp.manage. As conexões criadas assim são números qr; os números cloud_api são cadastrados pelo Meta Embedded Signup. Este endpoint vale apenas para workspaces independentes — um portal Bitrix24 recebe 403 forbidden_portal_kind, porque nele as conexões são criadas pelo administrador do portal dentro do WASync. Envie um Idempotency-Key: criar uma conexão consome um slot pago, e uma nova tentativa depois de um timeout, sem essa chave, faz você comprar dois. Erros e idempotência traz os quatro casos que você precisa tratar.