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