Pular para o conteúdo principal

bZapper — gateway de WhatsApp

O que é? Um gateway de WhatsApp multi-tenant via REST: conecte números, envie e receba todos os tipos de mensagem, gerencie grupos, rotacione chips com anti-ban, receba webhooks assinados e acompanhe tudo em tempo real — com SDKs oficiais em 5 linguagens.

Teste sem escrever código

No painel (admin) há um Playground: escolha a operação, ajuste o payload, envie de verdade e copie o exemplo pronto em cURL/Node/Python/PHP/Go/Java.

Quickstart (3 passos)​

# 1) Crie um número e conecte (QR no painel ou via API)
curl -X POST https://api.bzapper.com.br/instances \
  -H "Authorization: Bearer bz_live_..." -H "Content-Type: application/json" \
  -d '{"phone":"+5511999999999"}'

# 2) Envie sua primeira mensagem (o `to` pode ser E.164 ou JID)
curl -X POST https://api.bzapper.com.br/messages/text \
  -H "Authorization: Bearer bz_live_..." -H "Content-Type: application/json" \
  -d '{"to":"+5511888888888","body":"Olá do bZapper 👋"}'

# 3) Receba as respostas: cadastre um webhook (HMAC) ou ouça o SSE /stream

Autenticação: Authorization: Bearer <api_key> em toda chamada. Gere chaves no painel (ou POST /keys). Erros trazem um código neutro estável + mensagem traduzida — use sempre o code, nunca o texto.

Tudo que o bZapper faz​

💬 Enviar mensagens​

Texto, imagem, vídeo, documento, áudio/voz (ptt), sticker, localização, contato (vCard), enquete, reação (emoji), botões, lista e OTP (código de verificação), além de encaminhar. Recursos por envio: responder (quoted_message_id), menções em grupo, client_reference (sua correlação), e escolha de número (instance_id) ou pool (pool_id).

📥 Receber & conversar​

Webhooks (message.received, message.status, instance.status…) com assinatura HMAC-SHA256, retry e dedup — e SSE (/stream) pra status/QR ao vivo. Inbox: listar conversas, histórico paginado, arquivar/fixar/marcar lido. Veja Atendimento e afinidade de conversa.

👥 Grupos​

Listar, criar, ver info, entrar por convite, gerenciar participantes (adicionar/remover/promover/rebaixar), sair e pegar o link de convite.

🟢 Presença & contatos​

Enviar “digitando…/gravando…” (funciona em grupos), checar se um número está no WhatsApp (e obter o JID correto), bloquear/desbloquear.

📱 Números (instâncias)​

Criar, conectar (QR ou código), status, desconectar, logout, perfil white-label (nome/foto/recado), privacidade, proxy por número e filtros de entrada (broadcast/status/grupos).

🔄 Rotação anti-ban​

Pools com estratégias (round_robin, least_used, health_weighted), aquecimento de chip novo, health score vivo e afinidade de conversa (sticky). Entenda em Conceitos.

🧰 Plataforma​

API keys (papéis admin/agent), uso & métricas (enviadas, entregues, lidas, falhas, taxa de entrega, por tipo e por número), mídia servida por URL assinada, billing e i18n (6 idiomas).

Próximos passos​

Idiomas

Documentação em pt-BR, inglês, espanhol, italiano, alemão e francês — troque no seletor de idioma no topo.