Introdução

O LiteZap é uma API de WhatsApp não oficial e open source (Apache-2.0), escrita em Go sobre a biblioteca whatsmeow. Você conecta um número escaneando um QR code e passa a enviar e receber mensagens por uma API REST simples.

O mesmo binário roda de três formas:

No seu PC: o servidor escuta só em 127.0.0.1 e usa a conexão (e o IP) da sua máquina.
No seu servidor: VPS ou máquina própria, com Docker ou systemd, atrás de um proxy reverso com TLS.
Na nuvem LiteZap (em construção): um projeto pré-instalado só seu, com upgrades, backups e IPs gerenciados.

Como funciona

Um processo por número: um crash afeta só aquele número, que volta sozinho sem novo QR.

litezap serve é o supervisor: expõe a API, guarda tudo em SQLite (data/litezap.db), mantém a fila de envio e controla o ciclo de vida das instâncias.
Cada número conectado é uma instância com seu próprio processo litezap worker. O supervisor faz heartbeat a cada 10 segundos, reinicia o worker com backoff se ele cair e abre um circuit breaker se ele cair demais.
Os workers encerram sozinhos se o supervisor morrer, mesmo à força. No próximo serve, as instâncias voltam sem novo QR e a fila continua de onde parou.

O que já funciona (marco 4 e app local v1)

Instâncias e pareamento

Criar, listar, parar, reiniciar, desconectar e apagar. Pareamento por QR (JSON ou PNG) ou por código no telefone.

Envio com fila persistente

Texto, imagem, vídeo, áudio e voz, documento e reação. Idempotência, modo síncrono e até 5 tentativas.

Recebimento e histórico

Chats e mensagens recebidas ficam num log local, com paginação por cursor e mídia baixada sob demanda.

Anti-ban e proxy

Ritmo, rampa, janela de envio, verificação de número e proxy HTTP/SOCKS5 por instância.

Webhooks e SSE

Eventos com envelope único, webhooks assinados com retry por 24h e dead-letter, e streams SSE ao vivo.

MCP para IA

Claude, ChatGPT e outros clientes usam o WhatsApp por 40 ferramentas MCP, pela mesma fila anti-ban.

Painel e app local

Painel web em /app/ e app de bandeja: pareie, converse e configure sem terminal. Ou Docker/systemd no servidor.

Também disponíveis: grupos e comunidades, perfil e privacidade, status, canais, etiquetas, plataforma para parceiros e o atendente IA embutido. O que ainda está em construção está no roadmap. Vindo de outra API? Veja Migrar da Z-API.

Próximos passos

QuickstartDo zero à primeira mensagem.

ConceitosInstâncias, tokens, fila, rampa e janela.

Self-hostedDocker, systemd, TLS e segurança.

Referência da APITodas as rotas, com exemplos.