v1.0.6 · construído sobre Baileys

Centenas de sessões de WhatsApp.
Uma API só.

Flash API é uma API REST em Node.js que abre e administra múltiplas instâncias independentes de WhatsApp — cada uma com sua própria API key, webhook e canal em tempo real — com persistência em PostgreSQL e Redis.

🟢 Node.js 20+
Baileys WhiskeySockets
🐘 PostgreSQL 16+
🟥 Redis 7+
🐳 Docker ready
sessao.sh
Multi-sessão de verdade

Cada cliente, sua própria instância de WhatsApp

Toda sessão criada vive isolada — apikey própria, estado próprio, webhook próprio. A Flash API só orquestra a ponte entre cada uma delas e o WhatsApp.

conectada
aguardando QR
conectando
desconectada
Recursos

O que já vem pronto

Tudo o que uma integração de mensageria em produção precisa, sem depender da API oficial paga do WhatsApp Business.

Arquitetura

Camadas simples, responsabilidades claras

Rotas → services → models → banco. Redis cuida da sessão e da fila; PostgreSQL guarda o que precisa durar.

Integração
App · CRM · Bot
Express API
Auth · Rotas
Services
Baileys · WS
Protocolo
WhatsApp Web
PostgreSQL — sessões, mensagens, contatos, grupos Redis — cache, filas, sessão do painel Webhook / WebSocket — eventos em tempo real
Autenticação em 2 níveisGLOBAL_API_KEY para administração, apikey por sessão para mensageria.
Painel ManagerDashboard EJS para acompanhar sessões sem tocar na API diretamente.
Proxy por sessãoHTTP, HTTPS, SOCKS4 ou SOCKS5, configurável individualmente.
Instalação

No ar em três passos

Manual, com npm, ou tudo de uma vez com Docker Compose subindo API + PostgreSQL + Redis juntos.

# clona o repositório
git clone https://github.com/clsshbr2/FlashApi.git
cd FlashApi

# sobe API + PostgreSQL + Redis
docker compose up -d
⚠️ Troque as senhas, GLOBAL_API_KEY e SENHA_MANAGER_ADMIN antes de ir para produção.
# 1. clone e entre na pasta
git clone https://github.com/clsshbr2/FlashApi.git
cd FlashApi

# 2. instale as dependências
npm install

# 3. configure o ambiente
cp .env.example .env

# 4. suba o servidor
npm start        # produção
npm run dev      # desenvolvimento, com hot-reload
1
Pré-requisitos: Node.js 20+, PostgreSQL 16+ e Redis 7+ (ou apenas Docker).
2
Crie uma sessão com POST /api/session/create_sessao usando sua GLOBAL_API_KEY.
3
Conecte com PUT /api/session/conectar_sessao, escaneie o QR Code e comece a enviar mensagens.
Referência

Uma rota para cada necessidade

Base URL padrão http://localhost:3000. Toda resposta segue o formato { success, message, data }.

Perguntas frequentes

Antes de começar

Sua próxima integração de WhatsApp
começa com um git clone.

Código aberto, licença MIT, pronto para rodar em Docker hoje mesmo.