Manual de Uso — CRM Amazônia Premium

1. Visão geral

O CRM Amazônia Premium organiza leads que chegam pelo WhatsApp Business, automatiza partes da venda (sugestões com IA, templates de mensagem, cálculo de frete) e mantém o histórico financeiro e operacional de cada cliente em um só lugar.

Disponível em https://crm.amazoniapremium.com. Funciona em desktop e mobile (PWA). A tela inicial após o login é o Dashboard.

Quem usa

• Admin (Gustavo): tudo — usuários, templates, preços, configurações de horário, IA e auditoria.
• Manager (Gabriel, Maria Luiza): leads próprios e do time, templates, dashboard, relatórios.
• Salesperson (Mauricio): leads próprios, kanban, chat, templates aprovados, frete.

2. Login e senha

Primeiro acesso

1. Receber email com link de definição de senha.
2. Clicar no link (expira em 1 hora).
3. Escolher senha de no mínimo 8 caracteres com letras + números.
4. Pronto: o sistema cai direto no Dashboard.

Esqueci minha senha

1. Na tela de login, clicar em "Esqueci minha senha".
2. Digitar email cadastrado.
3. Email + WhatsApp chegam com link novo.
4. Definir senha nova. Link expira em 1 hora.

3. Painel principal

Depois do login, o sistema abre direto o Dashboard. A barra lateral esquerda tem o menu de navegação, agora reorganizado:

Menu (todos os perfis)

Seção "Preferências" — só admin novo

Topo da tela

• Busca: digite nome ou telefone, filtra os leads em tempo real.
• 📖 Manual de Uso: abre este documento em uma nova aba.
• ↻ Atualizar: recarrega dados do servidor.
• 🌙 / ☀️ Tema: alterna escuro / claro.

4. Kanban e funil

O funil opera com 6 estágios:

1. Novo: leads recém-chegados, antes da primeira qualificação.
2. Qualificação: identificando perfil (revenda / indústria / consumo) e volume estimado.
3. Proposta: cenário comercial enviado, esperando resposta.
4. Fechamento: cliente decidiu comprar, falta CNPJ ou pagamento.
5. Ganho: pedido faturado.
6. Perdido: descartado, com motivo registrado.

Cada coluna mostra: número de leads e soma de R$ esperado.

Como mover um lead

Desktop: arrastar o card de uma coluna pra outra.

Mobile: toca no card → botão "Mover" → escolhe estágio.

Navegação em tela pequena

Em monitor pequeno, o Kanban tem rolagem horizontal. Use a barra embaixo OU as setas ‹ › nas laterais. O mini-mapa no topo permite saltar direto pra qualquer estágio.

5. Trabalhando um lead

Clique em qualquer card pra abrir o detalhamento. As abas:

Aba "Chat"

Conversa do WhatsApp em tempo real. Você pode:

• Digitar mensagem livre: texto direto, sem template. Botão Enviar manda via WhatsApp Business.
• Enviar template: abre a Biblioteca de Mensagens em bottom sheet (mobile) ou modal centralizado (desktop), com busca e filtros por categoria.
• Sugerir resposta (IA): gera uma resposta automática considerando o contexto da conversa. Você revisa, edita e envia.
• Transcrever áudio: se o cliente mandar áudio, botão "🎙️ Transcrever" usa Whisper.

Aba "Dados"

Nome, telefone, empresa, CNPJ, estágio, responsável, valor esperado, data prevista de fechamento, consentimentos LGPD. Edita e salva.

Aba "Notas"

Anotações livres da equipe (não vão pro cliente). Útil pra registrar contexto de ligações ou decisões tomadas off-channel.

Aba "Tarefas"

Compromissos vinculados ao lead. Ex: "ligar dia 30", "enviar proposta atualizada". Pode atribuir a outro usuário do time.

Aba "Timeline"

Histórico completo: mensagens, mudanças de estágio, troca de responsável, notas adicionadas, ações da IA.

6. Biblioteca de Mensagens redesign

Antes chamava "Templates". Agora é a Biblioteca de Mensagens — visual reformulado em #/templates.

Indicadores no topo

4 cards mostram o estado da biblioteca:

• 💬 Cadastrados — total no sistema.
• ✅ Ativos em uso — aprovados, disponíveis pra envio.
• ⏳ Pendentes de revisão — recém-criados, aguardando aprovação do admin.
• ✈️ Envios este mês — quantas vezes templates foram disparados.

Filtros e busca

Chips coloridos por categoria (Saudação, Qualificação, Proposta, Fechamento, Follow-up, etc) com contador entre parênteses. Busca textual filtra por nome, "quando usar", categoria e corpo. Dropdown de ordenação: Mais recentes, Mais usados, Nome A-Z, Categoria.

Lista (tabela 7 colunas)

Em mobile, a tabela vira cards verticais com a mesma informação.

Drawer de edição (admin/manager)

Clique em "✏ Editar" → abre painel lateral com 2 abas:

• Editar: textarea com o corpo da mensagem + dropdown "Inserir variável" com 22 placeholders amigáveis (clica e o nome técnico vai pra posição do cursor).
• Informações: use_case (quando usar), categoria, status, lista de personalizações com nome amigável + exemplo. Embaixo, seção colapsável "▸ Informações técnicas" mostra code, UUID, ordem e placeholders crus.

Embaixo, preview ao vivo em formato de bolha verde WhatsApp, com placeholders substituídos por exemplos. O botão Salvar só fica habilitado quando há mudanças (mostra contador).

Placeholders disponíveis

Enviar um template (do detalhe do lead) novo

1. Na aba Chat → "Enviar template".
2. Abre o bottom sheet em mobile (slide-up de baixo, 90% da viewport, com handle de swipe pra fechar) ou modal em desktop (centralizado, 600×80vh).
3. Busca rápida no topo + chips de categoria pra filtrar.
4. Cards mostram nome amigável + preview com placeholders já resolvidos pra esse lead específico (preço, nome, saudação).
5. Toque/clique no card. Se faltar alguma variável ad-hoc (ex.: {rastreamento_codigo}), aparece o passo "Preencher variáveis" no mesmo sheet.
6. O texto cai no composer. Você pode editar antes de enviar.
7. Clicar em Enviar →. WhatsApp manda pro cliente.

7. IA: sugerir e analisar

Sugerir resposta (Sonnet)

Na conversa do lead, botão "💡 Sugerir resposta" gera uma proposta de texto considerando todo o histórico. Você sempre revisa e edita antes de mandar.

Analisar lead (Opus)

Botão "🔍 Analisar lead" gera diagnóstico completo: perfil estimado, estágio sugerido, risco de churn, próxima ação recomendada.

8. Calculadora de Frete

Menu lateral → 🚚 Calculadora de Fretes. Cota Melhor Envio para Rodoviário e Aéreo.

1. Origem fixa: CD Belém (66010-000).
2. Selecionar embalagem (caixa 15kg, 20kg ou pacote 1kg).
3. Digitar CEP destino + quantidade.
4. Botão "Cotar". Resultado mostra valor + prazo para cada modal.
5. "Copiar para template" preenche os campos {rodoviario_valor}, {rodoviario_prazo}, etc.

9. Tabela de Preços (admin)

Menu lateral → 🏷️ Preços. Só admin.

Modo visualização (padrão)

Tabela comercial com 11 produtos: foto, nome, embalagem, valor (verde), descrição. Busca por nome.

Modo edição

Botão "⚙️ Modo edição" no topo. Aparece a tabela técnica com:

• Placeholder: nome usado nos templates (preco_media_cx).
• Valor: editável diretamente.
• Fonte: sheet (veio da planilha), manual (digitado), override (substituiu valor da planilha).
• Atualizado: quando o valor foi setado.

Sincronizar com planilha

Botão "🔄 Sincronizar" puxa preços da planilha Amazonia_Premium_Itens_V3_auditada (aba Itens - Catálogo). Substitui valores manuais e sobrescreve overrides.

Edição manual

Editar valor → contador aparece no botão Salvar → clicar Salvar. Valor fica como override até a próxima Sincronização (que sobrescreve).

10. Tarefas

Menu lateral → ✓ Tarefas. Lista todas as tarefas atribuídas a você. Filtros: status (pendente, concluído), tipo (ligação, reunião, follow-up).

Para criar tarefa: dentro do lead → aba Tarefas → "Nova tarefa". Pode também vincular a outro usuário do time.

11. Dashboard redesign

Menu lateral → 📊 Dashboard. Página inicial após login. Dividido em 4 linhas verticais densas — decisão em menos de 10 segundos.

Linha 1 — 6 indicadores com comparativos ↗↘

Comparativos: ↗ verde quando subiu, ↘ vermelho quando caiu, cinza quando neutro.

Linha 2 — três blocos

• Pipeline (50%): tabela com 6 linhas (uma por estágio ativo), com QTD, valor R$, total no rodapé. Clique numa linha → abre a Lista filtrada por esse estágio.
• Atividades hoje (25%): checklist com Tarefas para fazer, Ligações, Mensagens, Reuniões, Follow-ups, Não lidos. Itens clicáveis levam pra área correspondente.
• Resumo executivo (25%): KPIs compactos — Leads ativos, Negócios em andamento, Conversões mês, Taxa de conversão, Em pipeline R$, SLA vencido. Conversões mês também tem comparativo vs mês passado.

Linha 3 — Gráfico de mensagens novo

Gráfico de linha com 2 séries: Recebidas (in, azul) e Enviadas (out, verde). Pills no canto superior direito alternam entre [24h] [7d] [30d]. Tooltip mostra os números exatos ao passar o mouse.

Linha 4 — Próximas tarefas

Até 5 tarefas pendentes mais próximas do vencimento. Cada linha: tarefa + nome do lead + responsável + horário (vermelho se vencida) + prioridade (🔴/🟡/🟢). Botão "Ver todas →" leva pra #/tasks.

12. Relatórios e Auditoria

Relatórios (todos os perfis)

• Funil: número de leads em cada estágio + ticket médio + tempo médio por estágio.
• Vendedores: ranking por leads atendidos, conversão, ticket.
• Perdas: motivos de "lost" agrupados.
• SLA: leads sem resposta há mais de X horas, por vendedor.

Auditoria (admin only)

Menu Preferências → 📜 Auditoria. Histórico de tudo que aconteceu: logins, edições de leads, mudanças de estágio, envios de mensagem, troca de senhas. Filtros por ação, ator e período.

13. Configurações (admin) novo

Menu Preferências → ⚙️ Configurações. Só admin.

Horário comercial

Define a janela em que o sistema permite envio de mensagens automaticamente. Padrão: 06:00 – 22:00 no fuso de Belém (UTC-3).

• Mudar início e fim no formato HH:MM.
• Validação: fim deve ser maior que início, e a janela deve ter pelo menos 4 horas.
• Fora do horário, o sistema retorna erro 422 OUTSIDE_BUSINESS_HOURS e exige confirmação extra (botão "Enviar mesmo assim") — só manager+ vê esse botão.

Tipos de envio isentos

Algumas categorias de mensagem podem ser configuradas para enviar a qualquer hora (ex: confirmação de pagamento, transacional). A lista é editável.

Audit log de configurações

Toda mudança aqui fica registrada na Auditoria com o ator, valor antigo e valor novo.

14. LGPD e DNC

"Não Contactar" (DNC) é regra de compliance. Se um lead pedir pra não receber mais mensagens:

1. Aba Dados → marcar "Não Contactar".
2. Sistema bloqueia QUALQUER envio para esse lead.
3. Solicitação fica registrada no audit log.

15. Novidades desta versão

Lista das mudanças mais notáveis desde a versão anterior (29/05/2026).

Dashboard novo (S28)

• 6 cards na linha 1 com comparativos ↗↘ vs ontem / mês passado.
• Novos indicadores: Leads novos hoje, Tempo médio de resposta.
• Gráfico real de mensagens recebidas vs enviadas (24h/7d/30d).
• Skeleton loader enquanto carrega.
• Pause em background pra economizar tráfego.

Bottom sheet de templates (S26)

• Substitui o select nativo do antigo modal.
• Busca + chips de categoria + cards com preview resolvido.
• Animação slide-up em mobile, modal centralizado em desktop.

Biblioteca de Mensagens (S24)

• Tela #/templates totalmente redesenhada.
• 4 KPIs no topo, chips por categoria, drawer lateral com preview live.
• "Inserir variável" — dropdown com 22 placeholders amigáveis.
• Informações técnicas escondidas dentro de seção colapsável.

Configurações de horário comercial (S22)

• Tela #/configuracoes para admin definir a janela.
• Padrão mudou de 08:00–22:00 para 06:00–22:00.
• Fuso oficial: America/Belem.

Funil consolidado (S29)

• Pipeline mostra apenas os 6 estágios ativos.
• Os 9 antigos (Abertura, Argumentação, Diferenciais, Proposta enviada, Negociação, Aguardando pagamento, Fechado Ganho) ficam preservados como inativos para histórico.

Sidebar reorganizada (S25)

• Dashboard primeiro no menu.
• Seção "Preferências" só para admin (Auditoria, IA, Usuários, Configurações).
• "Calculadora de Frete" → "Calculadora de Fretes" (plural).
• Home pós-login: Dashboard (não mais Kanban).

Fixes UX importantes

• S27: composer mobile não cobre mais a última mensagem; auto-scroll ao abrir conversa.
• S23: "Inserir no chat" funciona corretamente; rascunho do composer persiste no iOS.
• Bug placeholders: {greeting} agora é dinâmico (Bom dia/Boa tarde/Boa noite por hora real de Belém). {remetente_primeiro_nome} tem fallback para email se o nome não estiver cadastrado.

16. Suporte

Bug, ideia ou dúvida: avisar Gustavo direto via WhatsApp.

Manual versão 2.0 — atualizado em 30/05/2026, cobrindo as releases S22 a S29.