Documentação

Documentação da API de WhatsApp

Uma API REST para enviar e receber mensagens de WhatsApp por instâncias gerenciadas. Autentique, faça o primeiro envio e conecte webhooks. Referência completa e interativa no painel.

Autenticação

Toda requisição usa dois cabeçalhos, obtidos no painel em Configurações e API:

  • x-api-key sua chave de API
  • x-api-secret seu segredo de API

Base URL

https://api.zapzapapi.com/api/v1/{instanceId}

Troque {instanceId} pelo ID da instância (visível no painel). Endpoints de gestão de conta e instâncias usam /api/v1/instances e /api/v1/account.

Primeiro envio

Depois de conectar um número por QR code no painel, envie uma mensagem de texto:

POST /send/text

curl -X POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET" \
  -d '{"number":"5511999999999","text":"Olá!"}'

Envio humanizado por padrão

Todo envio exibe o digitando automático antes de entregar, com duração proporcional ao texto, o que reduz o risco de bloqueio. A resposta continua síncrona. Para desligar em uma requisição, envie "digitando": false no corpo. Compatível com Edge Functions do Supabase (timeout de 60s).

O que dá para fazer

A API cobre mais de 140 endpoints. Categorias principais:

Conta e InstânciasEnviar MensagensConversasContatos e PerfilGruposNewsletters e CanaisCampanhasChamadasWhatsApp BusinessConfiguraçõesWebhooks e EventosFila AsyncChatbot e IACRM e LeadsIntegração ChatwootFluxos
Referência completa e interativa no painel

Pegue suas chaves de API

Crie sua conta, conecte um número em minutos e comece a enviar. R$15 por número ativo/mês, com crédito grátis pra testar.