AgoraVAP!

1. Apresentação do AgoraVAP!

O AgoraVAP! é um sistema, versão web e app, de gestão comercial desenvolvido para equipes de vendas B2B. Ele não é um sistema transacional como ERP ou CRM.

A plataforma permite centralizar diariamente os registros feitos pelos agentes de vendas, de seus contatos realizados, cotações, pedidos fechados e perdas. Assim, oferece visibilidade em tempo real da performance aos próprios profissionais e ao líder da equipe.

A versão 4.0 adiciona os módulos de Campanhas, Promoções, Ranking de Clientes e Top 10 Clientes, permitindo ao Líder criar ações de relacionamento e ao Vendedor registrar resultados e acompanhar seus principais clientes diariamente.

Atualizações recentes adicionam o módulo Carteira de Clientes (com importação em massa via agenda, CSV ou VCF) e o novo nível de acesso Master, que enxerga a carteira de todos os vendedores da empresa.

Também foi adicionado o perfil SDR (prospecção por telefone): uma profissional que liga para listas externas de empresas, qualifica o interesse e transfere o lead ao vendedor, que passa a acompanhá-lo na própria Carteira e no CRM. Veja o capítulo 5.2 — Perfil SDR.

2. Módulos e Funcionalidades

2.1 Módulo Lançar

Ponto de entrada diário do profissional. Permite registrar contatos, cotações, pedidos e perdas por data selecionável. Datas futuras não são permitidas.

• Data do lançamento — Seletor de calendário; a data selecionada é exibida no formato DD/MM/AA sobre o campo. Editar um lançamento anterior é só selecionar a data acima (datas futuras são bloqueadas).
• Contatos Efetivos do Dia — Carteira · Prosp. Int. · Vis. Ativos · Vis. Inativos · Prosp. Ext. · Outras Externas · Inválidos
• Cotações e Pedidos — Qtd. Cotações · Valor Total (R$) · Qtd. Pedidos · Valor Total dos Pedidos (R$)
• Cotações Perdidas — Dividido em 4 grupos, cada um com uma cor própria para facilitar a leitura (Carga · Passeio · Óleo · Variadas), e em cada grupo os 3 campos lado a lado: Perdas por Preço (R$) · Perdas por Estoque (R$) · Perdas Outras Causas (R$)
• Meta Mensal (R$) — Campo somente leitura, numa linha própria logo antes do botão de registrar; exibe a meta do mês cadastrada no módulo Administrativo
• Relatório das 2 Principais Vendas Perdidas por Dia — Acima do Top 10 Clientes. O vendedor registra manualmente até 42 linhas com Data (formato DD/MM/AAAA, digitado com máscara automática) · Cliente · Produtos · Razão (texto livre, até 24 caracteres, opcional) · Venda Perdida (R$), usando o botão "+ Adicionar Linha". Datas futuras são bloqueadas. Ao salvar, a lista é reordenada automaticamente por data (mais recente primeiro) — o mesmo acontece a cada novo login ou troca de dia. O total acumulado em R$ aparece no canto superior direito, atualizado em tempo real. Cada linha pode ser removida individualmente pelo ✕. No fim do mês, use "Zerar Lista" para reiniciar o relatório.
  A lista não zera sozinha na virada do mês — as 42 linhas são um limite corrido, não um limite mensal. Se "Zerar Lista" não for usado, as linhas de meses anteriores continuam ocupando o limite e, ao chegar em 42, o botão "+ Adicionar Linha" fica bloqueado até alguém zerar. Nenhum dado é perdido automaticamente; o Dashboard e os Relatórios de impressão já filtram certinho pelo mês selecionado, mesmo com linhas antigas na lista.
• Top 10 Clientes — Tabela de 10 linhas com acumulado de pedidos e vendas por cliente. Colunas: Cliente · Ped. Ant · Ped. Hoje · Vendas Ant (R$) · Vendas Hoje (R$). Ao salvar, os valores "Hoje" são somados aos "Ant" e a lista é reordenada por Vendas decrescente. O botão "Zerar Lista" reinicia todos os acumulados.
  Os acumulados não têm recorte de mês — é uma soma contínua desde a última vez que "Zerar Lista" foi usado, não um ranking automático "do mês". Se a lista não for zerada, os valores de setembro somam em cima do que já tinha em agosto.

2.2 Módulo Histórico

Exibe todos os registros lançados com três modos de filtro de data:

• Dia único — filtra por um dia específico
• Período — campos "De" e "Até" para filtrar um intervalo de datas
• Mês — seleciona um mês inteiro de uma vez

Combinado com filtros de Tipo e Profissional (Líder). Registros ordenados do mais recente para o mais antigo.

2.3 Módulo Dashboard

Consolida os registros do mês selecionado em KPIs e gráficos em tempo real. Líderes e Masters visualizam o ranking completo com barra de progresso.

• Seletor de Mês — Dropdown com os últimos 12 meses (mês atual + 11 anteriores), disponível para todos os perfis. Todo o Dashboard (cards, gráficos, ranking e a lista de Vendas Perdidas) passa a refletir o mês escolhido, não só o mês atual.
• Vendas do Mês — Quantidade de pedidos + receita total
• Pedidos/Cotações — Pedidos ÷ Cotações (R$) × 100
• Ticket Médio — Receita total ÷ número de pedidos
• Total Perdido — Soma de todas as perdas do mês selecionado
• Filtro por Vendedor — Select dropdown (Líder/Master/SuperAdmin) — filtra os 3 gráficos, os 4 cards e também a lista de Vendas Perdidas para um vendedor individual
• Vendas vs. Cotações — Gráfico de linhas com 31 dias e linha de meta tracejada; título mostra o mês por extenso (ex: "Agosto - 2026") e o vendedor filtrado, ou "Todos"
• Motivos de Perda — Rosca com 12 fatias: 4 grupos de Cotações Perdidas (Carga, Passeio, Óleo, Variadas), cada um dividido em Preço/Estoque/Outras. As 4 famílias de cor batem com as do card de Lançar; a legenda mostra só os 4 grupos e pode ser clicada para esconder/mostrar um grupo inteiro
• Contatos por Origem — Barras horizontais com 7 origens
• Vendas Perdidas (Líder/Master/SuperAdmin) — Listagem do mês selecionado, respeitando também o Filtro por Vendedor, com as mesmas colunas do relatório (Data, Vendedor, Cliente, Produtos, Razão, Valor). Ordenável por Data, Vendedor ou Valor, com os totais "R$ perdidos no mês" e "Quantidade de perdas" no topo — puxa da mesma lista que cada vendedor já preenche em Lançar > Relatório das 2 Principais Vendas Perdidas por Dia
• Card "SDR — Prospecção por telefone" (Líder/Master/SuperAdmin) — Aparece logo depois de "Motivos de Perda / Contatos por Origem", só em empresas que têm SDR cadastrada (ou que já tiveram: quem lançou como SDR e depois mudou de perfil continua aparecendo no seletor como "ex-SDR", só com os lançamentos que fez como SDR). Mostra, no mês selecionado: Internos de Prospecção (do Lançar), Leads novos, Transferidos (e % sobre os leads novos), Vendas (com clientes distintos e conversão acumulada) e Valor vendido informado pela SDR. Com mais de uma SDR, um seletor filtra por pessoa. Abaixo, o alerta lista os leads transferidos há 7 dias ou mais sem nenhum registro do vendedor no CRM. Os lançamentos da SDR não entram nos totais, no ranking nem no filtro de vendedores do Dashboard — têm card próprio.
• Relatórios (impressão) (Líder/Master/SuperAdmin) — Botão "Relatórios" abre um modal com duas opções: Toda a equipe (KPIs, Ranking do mês, os 3 gráficos, Ranking de Clientes e a lista de Vendas perdidas do mês ordenada do maior valor para o menor) ou Vendedor específico (mesmos KPIs e gráficos, só que daquele vendedor, mais "Vendas x meta" e a lista de vendas perdidas dele, também ordenada por valor). O relatório sempre segue o mês e o vendedor que estiverem selecionados no Dashboard no momento — se um vendedor estiver filtrado, o modal já abre em "Vendedor específico" com ele marcado. O botão "Gerar e imprimir" abre uma nova aba com o relatório pronto para impressão ou salvar como PDF.

2.4 Módulo Campanhas Líder

Permite criar e acompanhar campanhas de relacionamento com clientes, com etapas automáticas e integração com WhatsApp.

• Tipos — Simples (3 etapas), VIP (3 etapas com oferta exclusiva), Flash (2 etapas)
• Etapas automáticas — Datas calculadas proporcionalmente entre início e fim da campanha
• WhatsApp — Botão abre o app com mensagem pré-preenchida da etapa
• Imagem da promoção — Somente Master e SuperAdmin veem a arte em tamanho real e o botão "Baixar imagem"; Líder e demais perfis veem apenas uma miniatura de consulta (com a marca "SOMENTE CONSULTA"; toque nela para ampliar, sem baixar), e a arte chega ao cliente pelo WhatsApp da Carteira/CRM, personalizada. Os passos abaixo valem para Master/SuperAdmin. Se a campanha tiver uma Promoção vinculada (mesmo nome no campo "Campanha" ao criar a promoção) com imagem cadastrada, cada etapa pendente mostra uma miniatura da imagem e um botão "Baixar imagem". O WhatsApp não permite anexar imagem automaticamente por link, então o envio é feito em 2 etapas — baixar a imagem e anexar manualmente no WhatsApp. Passo a passo completo:
  1. Clique em "Baixar imagem", ao lado da miniatura da etapa. A imagem é salva no computador/celular (um alerta confirma o download).
  2. Se o download não cair automaticamente (mais comum em iPhone), toque e segure a miniatura na tela e escolha "Salvar imagem".
  3. Clique em "WhatsApp" — abre o app já com o texto da etapa pré-preenchido.
  4. Escolha o contato ou grupo para onde vai mandar a mensagem. Atenção: como o link não indica um número específico, essa primeira tela é só de seleção de contato/conversa (igual à tela de "Encaminhar") — nela não existe o botão de anexar (📎 ou "+"). Depois de escolher o contato, você entra na conversa de verdade, e é só ali que o botão de anexar aparece, ao lado do campo de digitar.
  5. Anexe a imagem baixada no passo 1 usando o clipe/anexo do WhatsApp (geralmente na pasta Downloads ou na Galeria).
  6. Envie a mensagem com a imagem anexada.
  7. Volte ao AgoraVAP! e clique em "Marcar enviado" para concluir a etapa e liberar a próxima.
  A ordem entre baixar a imagem e abrir o WhatsApp não é obrigatória — pode inverter, contanto que a imagem já esteja salva no aparelho na hora de anexar.
• Trocar imagem só nesta etapa — Cada etapa tem a opção de receber uma imagem própria, diferente da imagem da Promoção vinculada. Ao anexar, essa etapa passa a mostrar a imagem personalizada; as demais etapas da campanha continuam com a imagem da Promoção normalmente, e a Promoção em si não é alterada. Para voltar a usar a imagem da Promoção nessa etapa, clique em "Usar imagem da promoção"
• Marcar enviado — Registra a etapa como concluída com data e hora
• Contadores — Participantes e negócios gerados ajustados com + e −

2.5 Módulo Promoções

O Líder publica promoções vinculadas a campanhas. O Vendedor visualiza em leitura e registra diariamente o valor vendido por promoção.

• Líder — Cria promoção com nome, canal, responsável, campanha, produtos, validade, valor e uma peça de mídia: imagem (qualquer formato, redimensionada e salva automaticamente) ou vídeo curto (recomendado até ~45s, limite de 25MB; o vídeo é enviado ao Firebase Storage e só a URL é salva na promoção)
• Líder — Vê total vendido por promoção e breakdown por vendedor ao expandir o card
• Líder — Interromper promoção — Botão ao lado de "Apagar promoção" pausa a promoção sem excluí-la: ela some da lista do Vendedor e do pop-up de boas-vindas, mas o histórico de vendas registradas continua intacto. O botão vira "Retomar promoção" enquanto pausada, e um selo "⏸ Pausada" aparece no card. Use quando quiser interromper temporariamente uma promoção para retomar depois, sem perder os dados já lançados.
• Líder/Master — Minhas vendas acumuladas (R$) — Como Líder e Master também podem ter metas próprias, o card de gestão de cada promoção ganhou, ao lado dos botões "Interromper"/"Apagar", um campo para lançar as próprias vendas daquela promoção: "Minhas vendas acumuladas (R$)" (somente leitura) + campo "Nova venda (R$)" + botão "Adicionar" — mesmo mecanismo usado pelo Vendedor. O nome do Líder/Master passa a aparecer junto no "Vendas por vendedor" do mesmo card, somado normalmente com o resto da equipe.
• Assistir à mídia — Nos cards de Promoções (Líder e Vendedor), promoções com imagem mostram a miniatura (clique para ampliar — disponível só para Master e SuperAdmin; os demais perfis tocam na miniatura de consulta para ampliá-la, ainda com a marca e sem baixar); promoções com vídeo mostram uma miniatura escura com ícone de play — clique para assistir com controles normais, em um modal compartilhado com a visualização de imagem
• Master/SuperAdmin — Miniaturas de consulta — Ao publicar uma promoção com imagem, o app gera automaticamente uma miniatura de baixa resolução com a marca "SOMENTE CONSULTA": é a única versão que Vendedor, Líder e SDR veem (nas listas e no pop-up); tocando na miniatura ela abre ampliada, com a marca, sem baixar. Para promoções antigas, aparece um aviso no topo da lista de gestão com o botão "Gerar miniaturas". Isso depende do acesso do Storage (CORS) estar configurado — sem ele, o app não consegue ler as imagens para gerar miniaturas nem as imagens personalizadas por cliente. O Master também ganha o botão "Baixar imagem" no detalhe da promoção.
• Pop-up de boas-vindas — Ao criar a promoção, o Líder pode ativar o toggle "Pop-up de boas-vindas". Promoções marcadas aparecem automaticamente para Vendedor, Líder e Master, uma vez por dia (no primeiro login), mostrando a promoção mais recente e ainda válida com essa marcação. Se for vídeo, o pop-up abre pausado (autoplay com som é bloqueado por navegadores mobile) — é preciso dar play manualmente, e o botão de fechar (✕) só é liberado depois que o vídeo termina de tocar. Se for imagem, o botão de fechar já aparece normalmente. Se a promoção mais recente tiver imagem e estiver vinculada a uma Campanha com outras promoções (também com imagem) ativas na mesma campanha, até 3 delas aparecem juntas em um carrossel, alternando automaticamente a cada poucos segundos.
• Vendedor — Em cada card de promoção ativa, dois campos: "Já registrado hoje" (somente leitura, mostra o total acumulado do dia) e "Nova venda (R$)" (editável, sempre vazio). Cada clique em "Adicionar" soma o valor digitado ao total do dia — não substitui o valor anterior.
• Vendedor — Acumulado do período: soma de todos os seus dias desde o início da promoção
• Vendedor — Enviar por WhatsApp — Cada card de promoção tem um botão que abre o WhatsApp com uma mensagem já pronta, montada automaticamente a partir do nome, itens, preço e validade da promoção. Este botão envia só o texto. A arte da promoção não é baixada daqui (o card mostra apenas uma miniatura de consulta): para mandar a imagem a um cliente, use o botão WhatsApp (ou o ✉️, se o cliente tiver e-mail) do cliente na Carteira ou no CRM, que gera a imagem personalizada com o nome dele e registra o contato no histórico.
  • O WhatsApp pode perguntar se você deseja abrir o WhatsApp Desktop ou Web ao clicar em "Enviar por WhatsApp" — é um comportamento do próprio link "clique para conversar" do WhatsApp, não um erro do AgoraVAP!. Para não ser mais perguntado, marque a opção "sempre permitir" que o navegador exibir.
  • Como o link não indica um número específico, a primeira tela que abre é só de seleção de contato/conversa (igual à tela de "Encaminhar" do WhatsApp) — nela não existe o botão de anexar (📎 ou "+"). Escolha o contato, e só depois — já dentro da conversa de verdade — o botão de anexar aparece normalmente ao lado do campo de digitar, caso queira anexar algum arquivo.
  • Não é possível anexar imagem ou vídeo da promoção automaticamente na mensagem — nenhum link de WhatsApp (wa.me, web.whatsapp.com etc.) suporta isso. Por isso o fluxo continua sendo baixar o arquivo e anexá-lo manualmente na conversa, como já acontece no módulo Campanhas.

2.6 Ranking de Clientes

O Vendedor registra manualmente seus clientes com o valor de pedidos do período. O Líder vê o consolidado da equipe com medalhas.

• Vendedor (aba Promoções, seção inferior) — Informa: nome do cliente, valor R$, mês e ano
• Vendedor — Vê seus próprios lançamentos e o ranking geral do período
• Líder (aba Campanhas, seção inferior) — Ranking consolidado com 🥇🥈🥉 e seletor de período
• Tempo real — Ao Vendedor lançar, o Líder vê imediatamente

2.7 Módulo Carteira de Clientes

Cada vendedor mantém sua própria carteira de clientes dentro do AgoraVAP!, com busca, filtros, cadastro manual, importação em massa e um histórico de relacionamento integrado ao módulo CRM.

• Campos do cliente — Nome, Telefone, E-mail (opcional — habilita o botão ✉️ de envio de promoção por e-mail), Segmento (6 opções), Responsável, Cidade, Bairro, Data da Última Compra (formato DD/MM/AAAA com máscara automática) e Observações. Resultado do Último Contato e Data do Último Contato só ficam disponíveis para edição enquanto o cliente não tem nenhum lançamento no histórico do CRM — assim que o primeiro lançamento é feito, esses dois campos somem da edição e passam a ser calculados automaticamente (veja abaixo)
• Status Ativo/Inativo — Calculado automaticamente: um cliente fica Inativo quando a Data da Última Compra está há mais de 6 meses; sem necessidade de marcar manualmente
• Busca e filtros — Por nome/responsável, Segmento, Status (Ativo/Inativo) e Resultado do Último Contato
• Adicionar / Editar / Excluir — Cadastro manual pelo formulário, ou clique em Editar na lista
• Histórico de Relacionamento (CRM) — Dois atalhos na coluna Ações de cada cliente: 🕘 Histórico abre o módulo CRM já filtrado nos lançamentos daquele cliente (do mais recente para o mais antigo), com um aviso "Histórico de: [nome]" mostrando todo o histórico dele, sem recorte de mês. Para sair desse modo, basta abrir a aba CRM novamente pelo menu superior (ela sempre volta à visão geral) ou navegar para outro módulo. O botão "+ Novo Lançamento", usado dentro desse histórico, já abre o lançamento vinculado a esse mesmo cliente, com Empresa/Responsável/Telefone/Segmento pré-preenchidos — igual ao atalho 📝 Lançar da Carteira, que faz o mesmo diretamente da lista. O "Resultado do Último Contato" mostrado na lista passa a refletir automaticamente o lançamento mais recente do histórico assim que existir um, e quando esse resultado é "Vendeu" a Data da Última Compra é atualizada sozinha
• Botão E-mail (✉️) — Aparece na Carteira (e na lista do CRM, em lançamentos ligados a um cliente da Carteira) só quando o cliente tem e-mail cadastrado. Havendo promoção ativa, abre a mesma janela "Enviar promoção a [cliente]": escolha a promoção, toque em "Baixar imagem" e depois em "Abrir e-mail". O app de e-mail do seu aparelho abre com assunto, "A/C [cliente]", nome da promoção, validade e a sua assinatura (nome, WhatsApp comercial, se cadastrado, e e-mail). Anexe a imagem baixada antes de enviar. O remetente é a conta de e-mail configurada no seu aparelho. O registro "Promo via E-mail" é gravado no histórico ao abrir o e-mail (registra a intenção de envio; o app não confirma que o e-mail saiu). O mesmo cliente pode receber a promoção por WhatsApp e por e-mail: cada canal gera o seu registro. O botão "Baixar imagem" sozinho não grava registro. A imagem que você anexa leva a marca d'água diagonal com o nome do cliente e o seu. Resumo: toque no ✉️, escolha a promoção, toque em Baixar imagem, depois em Abrir e-mail, anexe a imagem e envie.
• Botão WhatsApp — Abre conversa direta com o cliente a partir do telefone cadastrado e registra automaticamente um lançamento no histórico dele (módulo CRM), Tipo Acompanhamento e Resultado Promo via Whats, em nome do vendedor logado, com Empresa/Responsável/Telefone/Segmento do cadastro e sem Próximo Contato. Havendo promoção ativa, o clique abre antes a janela "Enviar promoção a [cliente]": escolha a promoção (a primeira já vem marcada) e o AgoraVAP! monta a imagem personalizada daquele cliente — a arte original com uma marca d'água diagonal (nome do cliente e do vendedor) e uma faixa embaixo, "Preparada para [cliente] · Vendedor(a): [seu nome] · WhatsApp [seu WhatsApp comercial]". Toque em "Baixar imagem" (se não baixar, toque e segure a prévia e salve), depois em "Abrir WhatsApp" — a conversa já abre com o cliente e o texto pronto — "A/C [nome completo do cliente]" (se o nome estiver em branco, usa o Responsável) o nome da promoção e a validade, pois preços e itens já vão na imagem — e anexe a imagem. "Só mensagem" envia apenas a saudação, sem promoção. O nome da promoção fica gravado no campo Local do lançamento ("Promoção: ..."). Se a imagem não puder ser preparada, o envio só do texto continua funcionando; avise o Master. O registro acontece ao abrir o WhatsApp (uma vez por promoção escolhida); o botão "Baixar imagem" sozinho não registra — sem promoção ativa, no momento do clique: o WhatsApp não informa ao AgoraVAP! se a mensagem foi realmente enviada, então ele indica a intenção de contato. Cliques repetidos no mesmo cliente, na mesma promoção e no mesmo canal (WhatsApp ou e-mail) em até 1 minuto geram um único registro; promoções ou canais diferentes geram registros separados. O "Resultado do Último Contato" da lista passa a mostrar "Promo via Whats" até que um novo lançamento seja feito. Os botões "Enviar por WhatsApp" de Promoções e das etapas de Campanhas não registram nada, pois não têm cliente específico
• Importar Contatos — Botão que abre um modal com três formas de importação em massa:
  • Agenda do celular — Usa a agenda de contatos do próprio aparelho (só funciona em Chrome/Android; não disponível em iPhone/Safari)
  • Planilha/CSV — Envie um arquivo .csv com colunas de Nome e Telefone (aceita variações como WhatsApp, Celular, Fone)
  • Arquivo VCF — Envie um arquivo .vcf exportado de qualquer agenda de contatos (Google, iPhone, Outlook etc.)
  Em qualquer uma das três formas, o sistema mostra uma prévia com os contatos encontrados antes de importar — todos vêm marcados por padrão, e dá pra desmarcar individualmente. Só o Nome é obrigatório: contatos sem telefone, com telefone fixo, ou com um número em formato não reconhecido também são importados normalmente (o telefone entra do jeito que veio, para edição posterior). Contatos com o mesmo telefone já cadastrado na Carteira são ignorados automaticamente (a tela mostra quantos). Master e Super Admin veem ainda dois campos extras: "Importar para o vendedor" (escolhe para quem os contatos serão vinculados, em vez de sempre o próprio usuário logado) e "Observação" (opcional, aplica o mesmo texto às Observações de todos os clientes daquele lote — útil para marcar a origem, ex: "Migrado do ERP antigo")

2.8 Módulo CRM

Registro diário de acompanhamento, prospecção e follow-up de contatos comerciais, com totalização diária/mensal, um sistema de lembretes de "Próximo Contato", relatórios extensíveis e vínculo direto com a Carteira de Clientes.

• Campos do lançamento — Empresa, Responsável, Tipo (Acompanhamento, Prospecção ou Atualizar/Reativar — seleção única), Segmento (6 opções), Telefone, Local na Área de Saturação, Resultado (Agendado, Sem interesse, Não atendeu, Fez Cotação, Vendeu, Ctto Inválido, Cadastro, Promo via Whats ou Promo via E-mail) e Próximo Contato. O resultado Promo via Whats é preenchido automaticamente quando o vendedor usa o botão WhatsApp da Carteira ou da lista do CRM (💬), e o Promo via E-mail quando usa o botão ✉️ — o botão 💬 do CRM também abre a janela "Enviar promoção" quando há promoção ativa — e também pode ser escolhido manualmente. Nesses lançamentos, o campo Local mostra "Promoção: [nome]"; o Master pode filtrar por esse resultado (e ver a contagem por vendedor nos gráficos) para acompanhar quem envia promoções pelo app
• Vínculo automático com a Carteira — Se o texto digitado em Empresa bater com um cliente já cadastrado, o lançamento vincula automaticamente: aparece o aviso "🔗 Vinculado à Carteira de Clientes", e Responsável/Telefone/Segmento são preenchidos a partir do cadastro do cliente. Esse lançamento passa a contar no histórico do cliente (veja 2.7). Para registrar como lançamento avulso, fora da Carteira (por exemplo uma prospecção de empresa nova), clique em "Desvincular" no próprio aviso. Quando o Resultado é "Vendeu" e há vínculo, a Data da Última Compra do cliente é atualizada automaticamente
• Próximo Contato — Pode ser digitado ou escolhido num calendário; é a data usada pelo lembrete de pendências (veja abaixo)
• Totais e filtros — Contadores "Hoje" e "Este Mês" no topo (ambos respeitam os mesmos filtros de Vendedor e Resultado aplicados na tela, para os números ficarem sempre consistentes entre si); filtros por Mês, Resultado e (Líder/Master/SuperAdmin) por Vendedor
• Gráfico "Resultado do Mês por Vendedor" — Visível para Líder/Master/SuperAdmin, mostra a distribuição de Resultados por vendedor no mês selecionado. Um seletor acima do gráfico alterna entre três visões: Prospecção (só lançamentos Tipo Prospecção — visão padrão ao abrir a tela), Manutenção de Carteira (Tipo Acompanhamento ou Atualizar/Reativar) e Tudo (todos os Tipos juntos). O card fica oculto quando não há nenhum lançamento no mês para a categoria selecionada
• 📊 Relatórios — Botão que abre um modal com relatórios do CRM, com uma lista de tipos que cresce ao longo do tempo. Hoje com dois: Ativos/Inativos (período em meses configurável, padrão 3 — independente dos 6 meses fixos do status Ativo/Inativo da Carteira) e Resultados por Vendedor (por mês). Master e Super Admin filtram por vendedor no primeiro; Líder, Master e Super Admin no segundo. Botão "Baixar PDF" imprime o relatório aberto no momento
• Baixar PDF do mês — Gera um relatório para impressão com todos os lançamentos do mês/filtros selecionados, de qualquer Tipo

Pop-up de Pendências de Hoje

Todo dia, ao entrar no sistema, um pop-up de lembrete abre automaticamente logo depois do pop-up de promoções (mesmo em dias sem nenhuma promoção ativa), mostrando os lançamentos com Próximo Contato vencido ou marcado para hoje.

• O que "encerra" uma pendência — Um lançamento deixa de aparecer no lembrete assim que o Resultado é marcado como Vendeu, Sem interesse ou Ctto Inválido, mesmo que a data do Próximo Contato já tenha passado. O resultado Transferido (lead recebido de uma SDR) também encerra a pendência. Os demais resultados (Agendado, Não atendeu, Fez Cotação, Cadastro, Promo via Whats) continuam gerando lembrete até serem atualizados — mas só quando há Próximo Contato preenchido; os lançamentos automáticos de "Promo via Whats" nascem sem data e, por isso, não geram lembrete a menos que você edite o lançamento e informe uma data
• Sem pendências — Quando não há nada vencido, aparece a frase "Não há pendências agendadas para hoje" por 5 segundos, e o pop-up fecha sozinho
• Com pendências — A lista fica até 10 itens visíveis por vez, com rolagem para ver o restante; clicar num item abre o lançamento direto para edição; fecha pelo "✕" no canto superior direito
• Visão Líder/Master — Além da própria lista de pendências (mesmo comportamento acima), uma linha extra no rodapé do pop-up mostra "Hoje o time tem X pendências agendadas", somando a empresa toda
• Botão "🔔 Pendências de Hoje" — No painel CRM, reabre esse mesmo pop-up a qualquer momento, sem esperar o login do dia

Leads recebidos da SDR

Quando uma SDR transfere um lead para você, o cliente entra na sua Carteira (com as Observações já preenchidas com o histórico dos contatos dela) e aparece no seu CRM uma linha com o Resultado Transferido (azul claro), que mostra o resumo dos contatos 1 a 3. A partir daí o acompanhamento é seu: registre cada contato no CRM. O lançamento Vendeu num cliente que veio da SDR é o que mede a conversão dela — sem esse registro a venda não aparece no painel dela. As linhas de prospecção da própria SDR não aparecem no seu CRM.

3. Módulo Acesso

Código da Empresa

Na tela de login, o primeiro passo é informar o Código da Empresa (ex: dealer). O sistema aplica o logo e cores personalizadas e exibe os campos de e-mail e senha. O código é definido pelo Super Admin.

Como funciona o cadastro

O Líder ou Super Admin cadastra os profissionais pelo módulo Administrativo. Uma senha provisória é gerada automaticamente e exibida na tela para repasse ao profissional.

Restaurar usuário removido

Se um profissional foi removido e precisa ser recadastrado, basta informar o mesmo e-mail no formulário de cadastro. O sistema detecta automaticamente e restaura o acesso.

Primeiro acesso

No primeiro login, o profissional é direcionado para uma tela onde define seu nome completo e cria sua senha definitiva.

Critérios da senha

• Mínimo de 8 caracteres
• Pelo menos 1 letra maiúscula
• Pelo menos 1 número
• Pelo menos 1 caractere especial (!@#$%)

Recuperar senha

Na tela de login, clique em "Recuperar acesso". Um e-mail com link de redefinição será enviado.

Logout automático por inatividade

Após 4 minutos sem atividade, o sistema encerra a sessão automaticamente e retorna à tela de login.

4. Módulo Administrativo

Profissionais

Cadastre, edite ou remova profissionais. A edição permite alterar Nome, WhatsApp comercial, Meta e Perfil (Vendedor/Líder/SDR). O WhatsApp comercial (opcional) é o número da empresa, e não o pessoal do vendedor; ele sai na faixa da arte e na assinatura do e-mail de promoção. O Líder edita e remove Vendedores, SDRs e Líderes; os Masters são geridos por outro Master ou pelo SuperAdmin. O perfil SDR (prospecção por telefone) é cadastrado aqui como qualquer outro profissional, escolhendo "SDR" em Perfil. Depois do cadastro, o Líder ou o Master precisa abrir o app para a lista de vendedores ficar disponível à SDR na transferência de leads. Ao cadastrar, o profissional recebe automaticamente o companyId da empresa do Líder.

Download do histórico do mês anterior

No primeiro dia de cada mês, aparece um banner com duas etapas: download do histórico + confirmação de backup. O arquivo inclui duas colunas extras em relação à exportação manual — Profissional (nome) e Perfil (função) — e vem ordenado por profissional e data.

Metas Mensais

Defina a meta de cada profissional por mês — incluindo Líderes. Alimenta os gráficos do Dashboard e a linha tracejada no gráfico de Vendas.

Exportar Excel

Gera um arquivo CSV com até cinco seções consolidadas: Lançamentos, Campanhas, Promoções, Vendas por Promoção e Ranking de Clientes. O Líder escolhe quais módulos incluir via checkboxes antes de exportar. Abrível no Excel ou Google Sheets.

Logs do Sistema

A aba Logs exibe todas as ações e erros do sistema. Filtre por nível e profissional.

• INFO — operações normais
• WARNING — comportamentos inesperados
• ERROR — falhas recuperáveis
• CRITICAL — falhas graves

Uso do App

A aba Uso do App (Administrativo) mostra, por profissional e período, quanto tempo cada pessoa usou o AgoraVAP! e em quais abas. Fica visível para Líder (que acompanha profissionais, SDR e outros Líderes), Master e Super Admin.

• Tempo ativo — conta só com a aba aberta, a tela visível e movimento nos últimos 3 minutos; aba aberta e abandonada não conta. O registro começa na data de publicação desta função, sem dados anteriores.
• Resumo — dias com uso, sessões, tempo total e média por dia, tempo e número de acessos em cada aba e aparelho (celular ou computador). Escolha o profissional e o período (até 93 dias) e clique em "Ver relatório".
• Atividade já registrada no período — dias com lançamento, registros no CRM, "Promo via Whats", "Promo via E-mail" e clientes novos na Carteira. O Líder vê da Carteira só a própria, pois na Carteira ele é tratado como vendedor comum.
• Detalhe por dia — ao escolher um profissional, aparecem o primeiro e o último acesso e o tempo de cada dia, com a divisão por aba.
• Importante — mede só o que acontece dentro do AgoraVAP! (não inclui o que a pessoa faz no WhatsApp ou fora do app). A equipe deve ser informada de que o uso do app é acompanhado (LGPD).

5. Perfis de Acesso

• Vendedor / Profissional — Lança e consulta apenas seus próprios dados. Registra vendas por promoção e clientes no ranking. Gerencia a própria Carteira de Clientes. Abas: Lançar, Histórico, Dashboard, Promoções (inclui Ranking de Clientes), Carteira, Ajuda.
• SDR — Prospecção por telefone para gerar leads qualificados. Lança só os "Internos de Prospecção", registra os contatos dos leads (até 3 por lead) e transfere o lead qualificado ao vendedor. Não acessa Carteira, Histórico, Dashboard nem Administrativo, e não edita nem apaga o que lança. Abas: Lançar, Prospecção, Painel, Campanhas (só consulta), Promoções (só consulta), Ajuda. Detalhes no capítulo 5.2.
• Líder — Visualiza dados de toda a equipe, gerencia profissionais, metas e exportações. Cria e gerencia Campanhas e Promoções. Na Carteira de Clientes, porém, é tratado como um vendedor comum: só vê e gerencia a própria carteira, não a dos demais vendedores. Acessa todas as abas (exceto Super Admin).
• Master — Nível acima do Líder. Tem todo o acesso do Líder em todos os módulos, e é o único perfil (além do Super Admin) que enxerga e gerencia a Carteira de Clientes de todos os vendedores da empresa, com filtro por vendedor e botão "Limpar Carteira". A promoção de um usuário a Master só pode ser feita pelo Super Admin, para evitar autopromoções em cadeia.
• Super Admin — Perfil exclusivo ECS. Gerencia todas as empresas da plataforma e visualiza dados de qualquer empresa.

5.1 Módulo Super Admin

Acessível apenas pelo perfil Super Admin (ECS Consultoria). Gerencia todas as empresas da plataforma.

Gestão de Empresas

• + Nova Empresa — cadastra empresa com nome, código, logo (URL), cor e imagem de fundo
• Editar — altera dados e personalização visual da empresa
• Ver Dados — filtra Dashboard, Histórico e Administrativo pelos dados daquela empresa
• Excluir — remove o cadastro da empresa (dupla confirmação)

Visão Global

Cards com totais consolidados: empresas ativas, total de usuários e total de registros.

5.2 Perfil SDR — Prospecção por Telefone

A SDR faz o trabalho de abrir portas: parte de uma lista externa de nomes de empresas, liga, identifica quem tem potencial e transfere o lead qualificado ao vendedor. Dali em diante o lead é do vendedor, que registra tudo no CRM — e é isso que permite medir quantos leads viram venda.

5.2.1 O caminho do lead

• Fonte externa (lista de nomes) → a SDR liga (Contato 1).
• Sem interesse ou Sem potencial → fim do lead. Ctto Inválido (telefone errado) também encerra.
• Com potencial → segue: ela registra Empresa, Segmento, Bairro, Contato (Decisor ou Influenciador) e WhatsApp/Telefone com DDD, e agenda os próximos contatos (Contato 2 e Contato 3).
• Não qualificado → fim do lead. Qualificado → Transferido (com data e vendedor); se o vendedor ainda não pode ir, a SDR registra Aguardando e transfere depois.
• A transferência pode acontecer no Contato 1, 2 ou 3. O limite é de 3 contatos por lead; no 3º só é possível transferir (ou deixar Aguardando) ou encerrar.

Resultados que a SDR pode escolher: Agendado (retorno marcado — segue) · Não atendeu (segue) · Aguardando (lead qualificado, mas o vendedor ainda não pode ir — a SDR guarda o lead e depois registra Transferido; segue aberto) · Transferido · Não qualificado · Sem interesse · Sem potencial · Ctto Inválido (estes cinco encerram o lead).

5.2.2 Menu da SDR

Lançar · Prospecção · Painel · Campanhas (somente consulta) · Promoções (somente consulta) · Ajuda. A SDR não vê Histórico, Carteira, Dashboard nem Administrativo.

5.2.3 Lançar — Internos de Prospecção

• A tela mostra só o campo Internos de Prospecção (quantidade de ligações/contatos do dia).
• Um lançamento por dia. Depois de salvo, o campo e o botão ficam travados — a SDR não edita nem apaga. Para corrigir um erro, ela pede ao Líder.
• Aceita datas do mês atual e do mês anterior (para recuperar um esquecimento). Datas futuras não são permitidas.
• Os Internos da SDR não somam nos totais dos vendedores: aparecem no card próprio do Dashboard (visão do Líder) e no Painel da SDR.

5.2.4 Prospecção — registrar os contatos

A aba Prospecção usa o mesmo modal "Novo Lançamento" do CRM, adaptado à SDR.

• + Novo Lançamento — cria um novo lead (Contato 1). Campos: Empresa e WhatsApp/Telefone com DDD (obrigatórios), Contato, Segmento, Bairro, Perfil do contato (Decisor/Influenciador), Campanha (opcional), Resultado e Próximo Contato.
• ➕ Novo contato — botão no cartão do lead (aparece no último contato de um lead ainda aberto). Abre o modal já preenchido e conta como Contato 2 ou 3. Digitar o nome de um lead aberto em Empresa também continua o mesmo lead.
• O modal mostra "Contato X de 3 deste lead". No 3º contato as opções "Agendado" e "Não atendeu" somem.
• Aguardando — use quando o lead já foi qualificado, mas o vendedor ainda não pode ir. O lead fica guardado e não consome contato: o registro seguinte (Transferido, por exemplo) mantém o mesmo número de contato, mesmo no 3º. Depois de um Aguardando, só ficam disponíveis Aguardando, Transferido e os resultados que encerram o lead. No cartão do lead aparece o botão ➡ Retomar lead, e o Painel mostra o chip Aguardando com quantos leads estão guardados. Use o Próximo Contato para marcar quando voltar a falar com o vendedor.
• Telefone repetido — se o telefone já pertence a outro lead dela, o app avisa e não duplica. Antes de ligar para um nome da lista, a SDR confirma com o vendedor se a empresa já é cliente dele.
• Próximo Contato — a data aparece em "🔔 Pendências de Hoje" (e no pop-up diário) como a agenda de retornos da SDR; clicar numa pendência abre o próximo contato daquele lead.
• 💬 WhatsApp — abre a conversa; para a SDR não registra nada automaticamente (o registro é pelo botão Salvar).
• A SDR não edita nem apaga lançamentos; correções ficam com o Líder.

5.2.5 Transferir o lead ao vendedor

• No modal, escolha o Resultado Transferido. Aparece o quadro azul "Transferir lead ao vendedor": escolha o Vendedor e confira a Data da transferência (hoje por padrão; aceita mês atual ou anterior).
• Para transferir é obrigatório ter Contato, Bairro e Perfil do contato (Decisor/Influenciador) preenchidos.
• Observações para o vendedor (opcional, até 500 caracteres) — aparece só no resultado Transferido, logo abaixo de onde ficaria o Próximo Contato (que some nesse resultado, pois o lead sai da sua agenda). O texto vai junto na Carteira e no CRM do vendedor, no resumo da transferência.
• Ao salvar, o app faz tudo de uma vez: cria o cliente na Carteira do vendedor (origem "SDR", com o resumo dos contatos nas Observações), cria no CRM do vendedor uma linha "Transferido" (azul claro) e registra a linha da própria SDR.
• Os campos que existem só na prospecção (Perfil do contato, número do contato, Campanha) ficam no histórico da SDR; na Carteira entram os campos de cadastro que já existem.
• Depois de salvo não dá para editar. A SDR não consegue abrir a Carteira do vendedor.

5.2.6 Painel de performance

A aba Painel mostra, por período (De/Até, com atalhos Hoje, Este mês e Mês anterior) e campanha (opcional):

• Internos de Prospecção — somados do Lançar. Se a quantidade de lançamentos de prospecção for diferente, o card mostra o outro número para conferência. O Lançar não tem campanha: com uma campanha escolhida, este card mostra "—".
• Leads novos (1º contato no período, com quantos ainda estão em andamento) e Leads transferidos (com a taxa sobre os leads novos).
• Vendas — lançamentos "Vendeu" que o vendedor faz no CRM para clientes que vieram desta SDR (com número de clientes distintos e a conversão acumulada: clientes que já compraram ÷ todos os transferidos).
• Valor vendido — informado pela própria SDR (abaixo).
• Funil do período e como terminaram os leads (Transferido, Não qualificado, Sem interesse, Sem potencial, Ctto Inválido, Aguardando, Em andamento).

Valor Vendido (R$): no próprio Painel, a SDR informa Data, Valor e Campanha (opcional). Cada registro soma no dia; o Painel mostra o total por dia. Aceita datas do mês atual e do anterior; depois de salvo não é editado (correção pelo Líder). O valor é informado pela SDR — por isso aparece com essa identificação.

5.2.7 Campanhas e Promoções (consulta)

Em Campanhas a SDR vê as campanhas (período, etapas com o texto de cada uma e promoções ligadas) para usar como argumento nas ligações — não cria, edita nem envia nada. As imagens aparecem como miniatura de consulta: toque nela para ampliar (continua com a marca "SOMENTE CONSULTA", sem baixar). Em Promoções vê as promoções ativas; os campos de registro de vendas e o Ranking de Clientes ficam ocultos para ela. O pop-up diário de promoções e o de pendências também abrem para a SDR.

5.2.8 Para o Líder e o Master

• Cadastro — em Administrativo → Profissionais, perfil "SDR". Depois, abra o app uma vez para a lista de vendedores ficar disponível à SDR.
• Acompanhamento — card "SDR" no Dashboard (funil do mês e alerta de leads transferidos há 7+ dias sem registro do vendedor no CRM).
• Correções — o Líder e o Master podem corrigir os lançamentos da SDR (ela só cria). No Histórico, o lançamento diário de Internos dela aparece com o nome dela.

6. Simulação de Vendas B2B

Simulação completa de três meses de operação para uma equipe de três vendedores B2B. Ciclo dividido em: Descoberta, Ativação, Negociação e Fechamento.

6.1 Perfil dos Vendedores e Metas

Jan = bate a meta · Fev = supera em 10% · Mar = fica 15% abaixo

6.2 Funil — Carlos Mendes

6.3 Funil — Patrícia Lemos

6.4 Funil — Roberto Farias

6.5 Cotações Perdidas

6.6 Dashboard — Resultados do Trimestre

Anexo A — Exportação Ampliada para Excel

A partir da versão 4.0, o botão Exportar CSV (Excel), disponível na aba Administrativo → Exportar Excel, gera um único arquivo .csv com até cinco seções de dados consolidadas — Lançamentos, Campanhas, Promoções, Vendas por Promoção e Ranking de Clientes.

📊 Visualização — Planilha de Demonstração AgoraVAP! Dados hipotéticos · 7 abas formatadas

Aba 📊 Lançamentos · verde = Contatos · azul = Cotações/Pedidos · linha escura = Totais automáticos

A.1 Como Exportar

1. Acesse Administrativo → aba Exportar Excel.
2. Defina o período (Data inicial e Data final).
3. Escolha o Tipo de lançamento: Todos, Contatos ou Cotações/Pedidos.
4. Se desejar, filtre por um profissional específico no campo "Profissional".
5. Marque ou desmarque os módulos adicionais que deseja incluir no arquivo:
   Campanhas Promoções Vendas por Promoção Ranking de Clientes
6. Clique em Exportar CSV (Excel) — o arquivo será baixado automaticamente.

A.2 Estrutura do Arquivo Gerado

O arquivo é dividido em seções identificadas por linhas separadoras no formato === NOME DA SEÇÃO ===. Cada seção tem seu próprio cabeçalho de colunas.

A.3 Como Abrir o Arquivo no Excel

1. Localize o arquivo baixado na pasta Downloads. O nome segue o padrão AgoraVAP_AAAA-MM-DD_AAAA-MM-DD.csv.
2. Não dê duplo clique no arquivo. Abra o Excel primeiro, depois vá em Arquivo → Abrir → Procurar.
3. No Assistente de Importação (etapa 1/3): selecione Delimitado e codificação 65001 UTF-8.
4. Na etapa 2/3: marque apenas Vírgula como delimitador.
5. Na etapa 3/3: defina o formato de cada coluna — Data: DMA para datas; Geral para os demais.
6. Clique em Concluir e depois salve como .xlsx para preservar a formatação.

A.4 Como Navegar pelas Seções

1. Role para baixo no arquivo até localizar a linha === CAMPANHAS ===, === PROMOÇÕES === etc.
2. Use Ctrl+F e pesquise === para listar todas as seções de uma vez.
3. Cada seção começa com um cabeçalho próprio logo abaixo do separador.

A.5 Dicas de Formatação no Excel

A.6 Como Imprimir

1. Selecione o intervalo que deseja imprimir → Layout da Página → Área de Impressão → Definir.
2. Configure: Orientação → Paisagem · Tamanho → A4 · Margens → Estreitas.
3. Para repetir o cabeçalho em todas as páginas: Configurar Página → Planilha → Linhas a repetir no topo.
4. Visualize com Ctrl+F2 antes de imprimir. Se não couber: Layout → Dimensionar → Ajustar a 1 página.
5. Imprima com Ctrl+P, ou exporte como PDF em Arquivo → Exportar → Criar PDF/XPS.

7. Observação Legal

Demais condições de uso, Termos de Uso e Garantias devem ser acessadas, lidas e ter o "De Acordo" do cliente responsável no site:

Para suporte técnico ou dúvidas, entre em contato:

E-mail: contato@ernestocostasantos.com.br

Site: https://ernestocostasantos.com.br/agoravap

AgoraVAP! — Versão 4.0 · 2026