Mensageria / integrações
WhatsApp Gateway
Gateway local em Rust que conecta uma sessão WhatsApp Web a uma API HTTP e a um painel web embutido — pareamento por QR, envio/recebimento de mensagens, contatos, chats e eventos em tempo real para integrar sistemas próprios.
Em uma frase: ponte operacional entre aplicações e WhatsApp Web, com UI de gestão e API para automação.
Principais capacidades
- ›Gateway WhatsApp Web com sessão persistente
- ›Pareamento por QR Code
- ›API HTTP para envio e consulta de mensagens
- ›Painel web embutido (dashboard, login, mensagens, contatos, settings)
- ›Eventos em tempo real via SSE
- ›Gestão de contatos e verificação de nomes
- ›Status de entrega (sent / delivered / read)
- ›Auto-reconnect e logout controlado
- ›Persistência local (SQLite + JSON)
- ›API key opcional para proteção da API
O que o projeto faz
A solução resolve a necessidade de sistemas internos (alertas, atendimento, operação de campo) enviarem e acompanharem mensagens WhatsApp sem depender só do aplicativo no celular — com sessão persistente, painel de operação e endpoints REST/SSE.
Sessão e pareamento
- ›Login por QR Code (fluxo de pareamento WhatsApp Web).
- ›Estados de conexão: desconectado, conectando, QR pendente, conectado, logout e erro.
- ›Persistência de sessão em SQLite no diretório de dados.
- ›Auto-reconnect configurável ao subir o serviço.
- ›Logout controlado pela UI/API.
Mensagens e chats
- ›Envio de texto para números/JIDs via API e painel.
- ›Histórico de mensagens por conversa (entrada e saída).
- ›Status de entrega: pendente, enviado, entregue, lido e falha.
- ›Listagem de chats com resumo operacional.
- ›Eventos em tempo real (SSE) para acompanhar status e novas mensagens.
Contatos
- ›Cadastro e manutenção de contatos no gateway.
- ›Verificação/resolução de nomes junto à sessão conectada.
- ›Persistência local em JSON para operação offline do painel.
Operação e integração
- ›Dashboard web embutido (status, login, mensagens, contatos, settings).
- ›API HTTP (Axum) para status, sessão, mensagens, chats, contatos e configuração.
- ›Proteção opcional por API key.
- ›CORS habilitado para consumo por outras aplicações.
- ›Configuração por arquivo JSON (bind, data dir, auto-reconnect, API key).
Para quem é
Times de produto, operação e engenharia que precisam acoplar WhatsApp a sistemas internos — alertas, atendimento assistido, notificações e integrações — com controle local da sessão e da API.
Tecnologias utilizadas
Software
- ›Rust
- ›Axum (HTTP) + Tokio
- ›Serde / JSON
- ›Server-Sent Events (SSE)
- ›Frontend estático (HTML/CSS/JS)
- ›Chrono / UUID
- ›env_logger
Protocolo e sessão
- ›Cliente WhatsApp Web (biblioteca whatsapp-rust / wacore)
- ›WebSocket para transporte da sessão
- ›SQLite (armazenamento de sessão)
- ›Persistência de mensagens e contatos em arquivos JSON
Integrações
- ›REST API
- ›CORS (consumo por aplicações externas)
- ›QR Code no browser para pareamento
Precisa de algo nessa linha?
Software, embarcados e integração ponta a ponta.