Começando rápido

Poucos passos do cadastro ao envio da primeira mensagem. Os exemplos usam curl, nesta versão a documentação é HTTP puro; SDKs entram depois.

1 · Crie uma conta e uma instância

Cadastre-se no painel e crie uma instância, ela representa um número de WhatsApp. Ao criar, você recebe um Instance ID e um token de API (zd_live_...), que autentica as chamadas daquela instância.

2 · Conecte seu número via QR Code

No painel, gere o QR Code da instância e leia-o no WhatsApp do celular em Aparelhos conectados → Conectar aparelho. A conexão fica ativa enquanto o celular tiver internet.

Nota

O QR Code expira em cerca de 60 segundos. Se expirar, gere um novo no painel.

3 · Envie sua primeira mensagem

Com o número conectado, mande um texto. O to vai no formato internacional, só dígitos: 55 + DDD + número. O token identifica a instância que envia, não precisa de header de instância.

A resposta é assíncrona: a API aceita e enfileira (202), devolvendo um messageId.

Requisição

cURL

curl -X POST https://api.zapdev.com.br/v1/messages/text \
  -H "Authorization: Bearer zd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999990000",
    "text": "Olá! Sua mensagem chegou. 👋"
  }'

202 Accepted

{
  "data": { "id": "msg_3Hb9aZ2kQ", "status": "queued" }
}

4 · Receba eventos por webhook

Configure uma URL pública para receber mensagens e status em tempo real. A ZapDev faz um POST com o payload do evento na sua URL.

Veja todos os eventos e como validar a assinatura em Webhooks.

Payload recebido

POST https://seu-app.com/webhook

{
  "event": "message.received",
  "instanceId": "ins_8f2a91",
  "timestamp": "2026-07-11T14:30:00Z",
  "data": {
    "from": "5511988887777",
    "type": "text",
    "text": "Oi, queria saber o horário"
  }
}

5 · Pronto para produção

Você conectou um número, enviou uma mensagem e está recebendo eventos. Próximos passos:

• Leia Autenticação e proteja seu token.
• Entenda Idempotência para não duplicar envios em retries.
• Conheça os limites em Rate limit.