Efficens Systems Contato
← Projetos

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.

Fale conosco