📖 Histórico Completo Recuperado & Manual de Uso
Este documento registra na íntegra todas as fases de criação da sua Plataforma Omnicanal & CRM (OmniCRM), os diagnósticos técnicos, as decisões de engenharia e um manual prático passo a passo para você aprender a mexer com total facilidade.
🔍 1. Diagnóstico: Onde Estava a Conversa e o Projeto?
Toda a conversa que você teve ontem à noite e na madrugada estava 100% salva no seu disco rígido dentro do banco de dados de sessões do Antigravity IDE:
C:\Users\Pedro Arthur\.gemini\antigravity-ide\conversations\8ed5cfe0-4b86-4b33-bc39-83c17ad48545.db (17.3 Megabytes com 466 passos executados).
⚠️ Por que ela sumiu da barra lateral do Antigravity IDE?
O Antigravity IDE armazena a lista de conversas que aparecem na barra lateral esquerda dentro de um arquivo de estado chamado state.vscdb.
-
Fechamento Inesperado / Crash às 15:44: O aplicativo registrou uma finalização inesperada (
crash_15596_...log) momentos antes de você abrir esta nova sessão. - Índice em Memória Não Salvo: Como o processo finalizou antes de você encerrar a conversa pelo menu normal, o resumo da sessão não foi sincronizado na lista de títulos da barra lateral, fazendo parecer que a conversa havia desaparecido.
-
Restauração Realizada: Nós acessamos o registro do banco interno (
state.vscdb), reconstruímos o cabeçalho protobuf da sessão8ed5cfe0-4b86-4b33-bc39-83c17ad48545intitulada "Omnichannel CRM & Atendimento Integrado" e restauramos a indexação, além de exportar todo este histórico em texto para você.
🏗️ 2. As 5 Fases de Construção do OmniCRM
Fase 1: Pesquisa Técnica e Modelagem do Banco Relacional
Marco 1Você enviou 4 fotos com 5 sistemas de referência: WaTidy CRM, WhaScale CRM, WhatChimp, Pancake.vn e IM+. Foi feita engenharia reversa completa de como cada um funciona:
| Software | Tipo de Engenharia | Vantagens | Limitações |
|---|---|---|---|
| WaTidy / WhaScale | Extensão Chrome (Injeção JS no WhatsApp Web) | Rápido de usar, opera em cima do WhatsApp Web oficial | Fica preso ao Chrome de uma só máquina, não é omnicanal real |
| WhatChimp | Plataforma Web via Meta Cloud API oficial | Suporte a múltiplos números e segurança de API | Cobrança cara da Meta (paga por conversa iniciada após 1.000 msgs) |
| Pancake.vn | Plataforma Web Omnicanal Server-Side | Unifica WhatsApp, Telegram, Instagram, CRM Kanban | Serviço fechado por assinatura mensal recorrente |
| IM+ | Agregador de Protocolos e Web Containers | Interface limpa com múltiplas abas de mensageria | Não tem funil de vendas nem recursos avançados de CRM |
Decisão de Engenharia: Criamos a plataforma no Paradigma B (Web Omnicanal Server-Side) com banco relacional SQLite de 14 tabelas em schema.sql, garantindo velocidade local máxima e sem custos de nuvem.
Fase 2: Construção da Plataforma Web & Diagnóstico Notebook vs PC
Marco 2Você mencionou no áudio que tentou fazer pelo notebook e não conseguiu o que queria, precisando vir para o computador principal.
No notebook, a execução concorrente de servidores ASGI (FastAPI), WebSockets em tempo real e modelos locais de Inteligência Artificial sofria com contenção de portas, limite de memória RAM e suspensão de processos em segundo plano pelo gerenciador de energia do Windows para economizar bateria. No PC desktop, com armazenamento NVMe e portas dedicadas, o sistema opera de forma contínua e sem throttling.
Entregas da Fase 2:
- Servidor backend assíncrono em Python com FastAPI (
app.py) rodando na porta local 8050. - WebSockets para atualização instantânea (mensagens chegam e aparecem na tela sem dar F5).
- CRM Kanban completo com arrastar e soltar (Drag-and-Drop) entre as colunas do funil.
- Respostas rápidas via atalho
/(ex:/pix,/ola,/catalogo). - Assistente de IA Local integrado ao Ollama sem gastar nenhum centavo com tokens.
Fase 3: Multi-Atendentes, Assinatura em Negrito e Áudios de Voz
Marco 3No áudio seguinte, você solicitou que vários funcionários pudessem atender na mesma plataforma e que cada mensagem enviada mostrasse quem estava falando:
✍️ Assinatura em Negrito
Cada mensagem enviada ganha prefixo automático do atendente ativo: *Pedro (Técnico):* ou *Carlos (Vendedor):*. Há um botão de toggle no chat para ligar/desligar com 1 clique.
🔄 Transferência de Conversas
Botão "Transferir" no cabeçalho do chat permite encaminhar o cliente para outro atendente ou devolver para a Fila Geral com registro de sistema.
🎙️ Simulação de Áudio de Voz
Gravação de áudio direto pelo microfone do navegador ou envio de áudios pré-gravados que são entregues ao cliente como áudio gravado na hora.
⚡ Inicializador 1-Clique
Arquivo INICIAR_OMNICRM.bat criado na pasta do projeto para ligar o servidor e abrir o navegador automaticamente.
Fase 4: Sincronização de Histórico Antigo e Importação de Chats WhatsApp
Marco 4Você informou que precisava que conversas antigas e registros de garantia dos seus clientes não fossem perdidos ao conectar o sistema.
-
Sincronizador Direto: Módulo
seed_history_and_avatars.pyque popula contatos da agenda, avatares reais e histórico com garantia vinculada. -
Importador de Conversas Exportadas (.txt): No celular, você vai em Exportar conversa e envia o arquivo
.txtno botão Sincronizar do topo do OmniCRM. O sistema lê mensagens de meses inteiros e cataloga no banco de dados com datas reais. -
Fotos de Perfil Reais: O sistema faz download e armazena localmente em
uploads/avatars/, evitando links temporários da Meta que expiram em 24h.
Fase 5: Tags Coloridas, WhatsApp Web Ilimitado e Backups no OneDrive
Marco 5No último áudio enviado antes desta sessão, você fez 5 solicitações fundamentais que foram implementadas:
🏷️ Sistema de Etiquetas / Tags
Classificação visual de contatos com cores (Cliente VIP, Lead Quente, Dúvida Técnica, Aguardando PIX) com filtros por tag na lista de conversas.
👥 Separação Grupos vs Pessoal
Abas "Individuais" e "Grupos" para que você nunca confunda uma conversa privada com grupos de clientes ou fornecedores.
🟢 WhatsApp Gratuito & Ilimitado
Operação direta via protocolo WhatsApp Web Multi-Device. Zero custos por mensagem da Meta Cloud API (100% livre e sem limite de 1.000 mensagens).
🔄 Desconectar e Reconectar
Botão para desconectar o WhatsApp a qualquer instante, permitindo testar com seu número pessoal e depois trocar para o da loja sem dor de cabeça.
💾 Backups Automáticos no OneDrive
Módulo backup_manager.py que gera arquivo .zip de todo o banco e fotos, sincronizando direto na sua pasta C:\Users\Pedro Arthur\OneDrive\OmniCRM_Backups.
📥 Exportar Conversa em 1 Clique
Botão no topo do chat para baixar o histórico completo de qualquer conversa em arquivo de texto formatado (.txt).
📘 3. Manual Prático: Como Usar o OmniCRM
🚀 Passo 1: Como Iniciar o OmniCRM no Windows
Para ligar toda a plataforma, você não precisa abrir terminal ou digitar comandos complexos.
- Abra a pasta do projeto:
C:\Users\Pedro Arthur\.gemini\antigravity-ide\scratch\omnichannel_crm - Dê dois cliques no arquivo
INICIAR_OMNICRM.bat. - O script vai ligar o servidor Python na porta 8050 e abrir automaticamente seu navegador em
http://localhost:8050.
💬 Passo 2: Como Atender Clientes e Usar Atalhos Rápidos
- Trocar de Atendente: Clique na sua foto no canto inferior esquerdo da tela para alternar entre Pedro (Técnico), Carlos (Vendedor), Mariana (Suporte) ou cadastrar novos.
- Assinatura em Negrito: Verifique o botão
✍️ *Seu Nome (Cargo)*acima da caixa de digitação. Ele fica verde quando ativado. - Respostas Rápidas: Na caixa de digitação, digite uma barra
/e surgirá um menu pop-up com respostas como chave PIX, catálogo e saudações. Clique para preencher na hora! - Gravação de Áudio: Clique no ícone de Microfone para gravar um áudio real da sua voz e enviar para o cliente.
- Exportar Conversa: Clique em "📥 Exportar (.txt)" no topo do chat para baixar o histórico daquela conversa.
📊 Passo 3: Funil de Vendas (CRM Kanban)
Clique no segundo ícone da barra lateral esquerda (as três colunas) para abrir o Funil de Vendas.
- Etapas do Funil: Primeiro Contato → Qualificação / Diagnóstico → Proposta / Orçamento Enviado → Aguardando Pagamento → Venda Fechada / Entregue.
- Arrastar e Soltar: Segure o card do cliente com o mouse e arraste para a coluna desejada. O status atualiza na hora e sincroniza em tempo real com todos os outros computadores conectados!
- Valor da Negociação: No painel direito do cliente, você pode digitar o valor em R$ (ex: 450,00) e o funil soma o total daquela coluna automaticamente.
🏷️ Passo 4: Como Usar Etiquetas (Tags) e Separar Grupos
- Abas de Chat: No topo da lista de conversas, use os botões Todas, Individuais e Grupos. Conversas de grupo possuem ícone de pessoas e mostram o nome do grupo claramente.
- Filtrar por Tag: Use o seletor de Tags no topo da lista para ver rapidamente apenas os clientes com etiqueta Cliente VIP, Lead Quente ou Aguardando PIX.
- Colocar Tag no Cliente: Abra a conversa, olhe o painel direito "Perfil do Lead", clique em "+ Tag" e escolha a etiqueta.
💾 Passo 5: Gerenciamento de Backups & OneDrive
Seus dados são o coração da sua empresa. O OmniCRM possui um sistema de backup blindado.
- Clique no botão 💾 Backups na barra lateral.
- Clique em "Gerar Backup Agora (.zip)". O sistema faz uma cópia segura do banco
crm.dbe de todas as fotos da pastauploads/. - Sincronização com Nuvem: O arquivo é salvo simultaneamente na pasta local e na sua pasta do OneDrive em:
C:\Users\Pedro Arthur\OneDrive\OmniCRM_Backups. Assim, o Microsoft OneDrive sincroniza os dados na nuvem da Microsoft automaticamente!