WS WSAPI

Quickstart

Em 3 minutos você vai disparar uma mensagem de WhatsApp pela WS API. O fluxo tem três passos: criar conta, conectar uma instância, fazer o POST.

1. Crie a conta e a instância

No painel, crie uma instância. Você vai receber um instanceId e um token de 32 caracteres hexadecimais. Anota os dois — eles serão usados em toda chamada.

2. Conecte o WhatsApp

Pegue o QR Code da instância criada — pelo painel ou via API:

terminal
curl https://api.wsapi.app/v1/instance/qrcode?instanceId=$INSTANCE_ID \
  -H "Authorization: Bearer $TOKEN"

# resposta
{
  "state": "qr",
  "base64": "data:image/png;base64,iVBORw0..."
}

Renderize base64 num <img> e escaneie com o WhatsApp do número que você quer usar.

3. Dispare a primeira mensagem

terminal
curl -X POST "https://api.wsapi.app/v1/message/send-text?instanceId=$INSTANCE_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "5547999198263",
    "message": "Olá, mundo!"
  }'

# 200 OK · ack: ✓✓ · ~180ms

Próximos passos