Deliver Bot

Bot de automacao de mensagens via WhatsApp para empresas, com painel web, envio em lote, multiplos usuarios, filiais, campanhas e controle operacional.

Este repositorio publico funciona como vitrine tecnica do projeto. O codigo-fonte principal permanece privado por seguranca e por conter regras de negocio e detalhes internos de operacao.

Sobre o Projeto

O Deliver Bot foi desenvolvido para automatizar comunicacoes repetitivas com clientes via WhatsApp.

A proposta e reduzir o trabalho manual de equipes que precisam enviar mensagens uma por uma, acompanhar respostas, organizar contatos e manter controle sobre diferentes unidades, filiais ou operadores.

Com a plataforma, uma empresa consegue conectar numeros de WhatsApp por QR Code, gerenciar contatos, criar campanhas, enviar mensagens em lote e acompanhar a operacao por um painel web.

Principais Funcionalidades

• Envio de mensagens via WhatsApp
• Envio em lote para multiplos contatos
• Bot WhatsApp individual por filial ou unidade
• Conexao por QR Code
• Gestao de clientes e contatos
• Gestao de usuarios com perfis de acesso
• Painel de campanhas com status e metricas
• Historico de mensagens enviadas e recebidas
• Dashboard operacional
• Controle de sessoes dos bots
• Deteccao de numero duplicado entre bots
• Setup inicial protegido por chave de ambiente
• Execucao local com Docker Compose

Casos de Uso

• Avisos automaticos para clientes
• Confirmacoes de entrega
• Campanhas promocionais
• Reengajamento de contatos
• Notificacoes operacionais
• Atendimento inicial via mensagem
• Comunicacao padronizada por equipe, unidade ou filial

Stack Tecnica

Frontend

• React
• Vite
• TailwindCSS
• Zustand
• React Router
• Axios

Backend

• Python
• FastAPI
• SQLAlchemy
• SQLite
• JWT
• HTTPX

Servico WhatsApp

• Node.js
• Express
• Baileys
• QRCode
• Pino

Infraestrutura

• Docker
• Docker Compose
• Nginx

Arquitetura

Frontend React/Vite
        |
        | REST API
        v
Backend FastAPI + SQLite
        |
        | HTTP interno
        v
Servico WhatsApp Node.js + Baileys
        |
        v
WhatsApp Web

Seguranca

• Variaveis sensiveis ficam fora do repositorio publico
• Sessoes WhatsApp nao sao versionadas
• Autenticacao baseada em JWT
• Controle de acesso por perfil de usuario
• Setup inicial protegido por segredo
• Banco local persistido fora do codigo-fonte

Status

MVP funcional em evolucao, com foco em automacao de mensagens, gestao de bots por unidade e painel operacional para empresas.

Roadmap

• Relatorios avancados
• Melhorias nas metricas de campanhas
• Fluxos automaticos de resposta
• Integracoes com sistemas externos
• Backup automatizado
• Evolucao para infraestrutura cloud

Aviso Legal

Este projeto utiliza integracao com WhatsApp por meio de biblioteca nao oficial. O uso e de responsabilidade do operador e deve respeitar os termos da plataforma.

Este projeto nao e afiliado, patrocinado ou endossado pelo WhatsApp, Meta Platforms, Inc. ou empresas relacionadas.

Autor

Lucas
GitHub: @cuLasss