Quickstart

Envie sua primeira mensagem em 5 minutos

Pre-requisitos

Voce precisa de: um client HTTP (curl, Postman, etc) e um celular com WhatsApp

1

Crie um Device

Cada device representa uma sessao do WhatsApp. Crie um usando sua Admin Key:

bash
curl -X POST https://api.zapway.cloud/devices \
  -H "X-Admin-Key: adm_seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{"name": "Meu Bot"}'

Resposta:

json
{
  "success": true,
  "data": {
    "id": "dev_abc123",
    "name": "Meu Bot",
    "apiKey": "sk_live_abc123...",
    "state": "offline"
  }
}

Importante: Guarde o apiKey retornado — voce vai usar como X-Device-Key

2

Abra uma Sessao

Inicie a sessao do WhatsApp para gerar o QR code:

bash
curl -X POST https://api.zapway.cloud/devices/dev_abc123/session/open \
  -H "X-Device-Key: sk_live_abc123..."

Resposta:

json
{
  "success": true,
  "data": {
    "state": "pairing"
  }
}
3

Escaneie o QR Code

Acesse o QR code gerado no navegador:

text
GET https://api.zapway.cloud/devices/dev_abc123/session/qr.png

Abra o WhatsApp no celular > Aparelhos conectados > Conectar aparelho > Escaneie o QR code exibido

4

Envie uma Mensagem

Agora que a sessao esta ativa, envie sua primeira mensagem:

bash
curl -X POST https://api.zapway.cloud/devices/dev_abc123/send/text \
  -H "X-Device-Key: sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "text": "Ola! Mensagem enviada via ZapWay!"
  }'

Resposta:

json
{
  "success": true,
  "data": {
    "waMessageId": "3EB0...",
    "state": "pending"
  }
}