Skip to main content

​
Guia Rápido - 5 Minutos

Este guia vai te ensinar a criar sua primeira instância WhatsApp e enviar sua primeira mensagem usando a Wapizap API.

​
Pré-requisitos

Conta criada em dashboard.wapizap.com
API Key gerada no painel

​
Passo 1: Obter sua API Key

  1. Acesse o Dashboard Wapizap
  2. Vá em Configurações → API Keys
  3. Clique em Gerar Nova API Key
  4. Copie e guarde sua chave em local seguro
Importante: Sua API Key é exibida apenas uma vez. Guarde-a em local seguro e nunca compartilhe publicamente.
# Sua API Key terá este formato:
sk_live_1234567890abcdefghijklmnopqrstuvwxyz

​
Passo 2: Criar sua Primeira Instância

Uma instância representa uma conexão WhatsApp. Vamos criar uma: 
curl -X POST https://api.wapizap.com/api/v2/instances \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_live_SEU_TOKEN_AQUI" \
  -d '{
    "name": "minha-primeira-instancia",
    "webhookUrl": "https://seu-webhook.com/wapizap"
  }'

​
Resposta de Sucesso

{
  "success": true,
  "data": {
    "id": "inst_abc123xyz",
    "name": "minha-primeira-instancia",
    "status": "disconnected",
    "qrCode": "data:image/png;base64,iVBORw0KGgoAAAANS...",
    "pairingCode": "K24J8N3R",
    "createdAt": "2026-01-14T10:30:00Z"
  }
}
Guarde o id da instância (inst_abc123xyz). Você vai precisar dele para enviar mensagens!

​
Passo 3: Conectar ao WhatsApp

Existem 2 formas de conectar:
  1. Copie o campo qrCode da resposta anterior
  2. Cole em um visualizador de imagem base64 ou salve como arquivo .png
  3. No WhatsApp do seu celular:
    • Vá em Configurações → Aparelhos conectados
    • Toque em Conectar um aparelho
    • Escaneie o QR code exibido
O QR code expira em 60 segundos. Se expirar, faça uma nova requisição ao endpoint /instances/{id}/qrcode

​
Verificar Status da Conexão

Após escanear o QR code ou inserir o código, verifique se conectou: 
curl -X GET https://api.wapizap.com/api/v2/instances/inst_abc123xyz/status \
  -H "Authorization: Bearer sk_live_SEU_TOKEN_AQUI"
Resposta quando conectado: 
{
  "success": true,
  "data": {
    "status": "connected",
    "phone": "5511999999999",
    "profilePicture": "https://...",
    "profileName": "Meu WhatsApp"
  }
}
Pronto! Sua instância está conectada e pronta para enviar mensagens 🎉

​
Passo 4: Enviar sua Primeira Mensagem

Agora vamos enviar uma mensagem de texto: 
curl -X POST https://api.wapizap.com/api/v2/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_live_SEU_TOKEN_AQUI" \
  -d '{
    "instanceId": "inst_abc123xyz",
    "to": "5511999999999",
    "type": "text",
    "text": "Olá! Esta é minha primeira mensagem via Wapizap API 🚀"
  }'

​
Resposta de Sucesso

{
  "success": true,
  "data": {
    "id": "msg_xyz789abc",
    "instanceId": "inst_abc123xyz",
    "to": "5511999999999",
    "type": "text",
    "text": "Olá! Esta é minha primeira mensagem via Wapizap API 🚀",
    "status": "sent",
    "timestamp": 1705233000,
    "key": {
      "remoteJid": "[email protected]",
      "fromMe": true,
      "id": "3EB0XXXXX"
    }
  }
}

​
Formato do Número

Importante: O número deve estar no formato internacional sem símbolos:
❌ Incorreto✅ Correto
+55 11 99999-99995511999999999
(11) 99999-99995511999999999
119999999995511999999999
Formato: [código do país][DDD][número] Exemplos:
  • Brasil: 5511999999999
  • Portugal: 351912345678
  • EUA: 14155551234

​
Próximos Passos

Agora que você já sabe o básico, explore mais funcionalidades:

Enviar Mídias

Aprenda a enviar imagens, vídeos, áudios e documentos

Gerenciar Grupos

Crie grupos, adicione participantes e gerencie permissões

Configurar Webhooks

Receba notificações em tempo real de mensagens recebidas

API Reference Completa

Explore todos os 60+ endpoints disponíveis

​
Precisa de Ajuda?

Discord

Comunidade ativa

FAQ

Perguntas frequentes

​
Limites de Taxa (Rate Limits)

Para garantir estabilidade, a API tem os seguintes limites:
EndpointLimite
Criar instância10 por hora
Enviar mensagens30 por minuto por instância
Listar chats60 por minuto
Outros endpoints120 por minuto
Precisa de limites maiores? Entre em contato pelo suporte ou faça upgrade do seu plano.