CRM - Visão Geral do Módulo

O que é

O CRM (Customer Relationship Management) é o módulo módulo do Viagilize dedicado à gestão comercial. Ele consolida em um só lugar leads (potenciais clientes), oportunidades (negócios em andamento) e todo o relacionamento que acontece antes e depois da venda - chamadas, e-mails, mensagens, reuniões, tarefas e automações. O objetivo é evitar que contatos esfriem e dar visibilidade clara do funil de vendas para o time comercial.

O usuário chega ao CRM tipicamente em três momentos: (1) ao receber um lead novo vindo do site, indicação ou rede social, para qualificá-lo; (2) durante a operação do dia a dia para mover oportunidades no Kanban, registrar interações e concluir tarefas; e (3) na gestão, para acompanhar KPIs como valor no pipeline, taxa de conversão e oportunidades paradas.

O CRM é um módulo: só aparece no menu lateral quando o módulo crm está ativo no plano da sua empresa. Sem o módulo, nenhuma tela da área abre.

Como usar

1. Acesse Módulos > CRM no menu lateral. Você cai no Dashboard CRM (/admin/crm).
2. Confira o painel de KPIs no topo:
   • Oportunidades Abertas - total de negócios em andamento.
   • Valor no Pipeline - soma dos valores das oportunidades abertas (e valor ponderado pela probabilidade de cada etapa, se habilitado em Configurações Gerais).
   • Ganhas (Mês) - oportunidades fechadas com sucesso no mês corrente, com valor total ganho.
   • Taxa Conversão - percentual de oportunidades ganhas sobre o total fechado no mês.
   • Tarefas Pendentes / Vencidas - quantas tarefas estão em aberto e quantas passaram do prazo.
   • Total de Leads / Leads Novos - base de leads ativos e quantos estão no status inicial.
3. Use o bloco Acesso Rápido logo abaixo dos KPIs para ir direto a Kanban, Leads, Oportunidades, Tarefas, Interações ou Configurações. Os botões que aparecem podem ser ligados/desligados em Configurações Gerais.
4. Operação diária: clique em Kanban (botão no topo) para arrastar oportunidades entre etapas, registrar avanços e fechar negócios.
5. Captação: vá em Leads (atalho do Acesso Rápido) para cadastrar novos contatos, qualificar e converter em oportunidade.
6. Follow-up: a lista Próximas Tarefas no dashboard mostra o que precisa ser feito hoje; marque como concluída direto no card clicando no círculo de check à esquerda da tarefa.
7. Alerta de risco: o bloco Oportunidades Paradas lista negócios sem atividade há X dias (X é configurável em Configurações Gerais); clique em cada item para abrir e dar andamento.

Casos especiais

Vendedor sem permissão de ver todas as oportunidades do CRM

Vendedores comuns só enxergam suas próprias oportunidades nos KPIs, no Kanban, nos relatórios e no gráfico por etapa. Quem precisa ver a operação inteira (gerente comercial, proprietário) deve receber a permissão de ver todas as oportunidades do CRM no cargo correspondente.

Nenhum pipeline cadastrado

Se você ainda não criou nenhum pipeline, ao tentar abrir o Kanban o sistema redireciona para a tela de criação de pipeline com o aviso "Crie um pipeline primeiro para usar o CRM." Cadastre o primeiro funil em Configurações > Pipelines antes de operar.

Terminologia customizada

O CRM permite que cada empresa renomeie termos do módulo (ex: chamar "Oportunidade" de "Negócio", "Pipeline" de "Funil"). Os textos exibidos no dashboard, Kanban e listagens respeitam essa configuração - definida em Configurações Gerais dentro do dropdown de Configurações.

Múltiplos pipelines com visibilidade restrita

Pipelines podem ter acesso limitado a usuários específicos via Acessos do Pipeline. O dashboard e o Kanban filtram automaticamente para mostrar apenas pipelines visíveis ao usuário logado, usando o escopo visivelPara($user).

Erros comuns e como resolver

• Menu CRM não aparece no sidebar - Causa: módulo crm não está ativo no plano. Solução: acessar Configurações > Billing/Plano e ativar o módulo CRM, ou abrir chamado no suporte.
• "Você não tem acesso a esta oportunidade." - Causa: vendedor sem permissão de ver todas as oportunidades do CRM tentou mover oportunidade que não é dele no Kanban. Solução: pedir ao gerente que reatribua a oportunidade ou conceda a permissão ao cargo.
• "Crie um pipeline primeiro para usar o CRM." - Causa: nenhum pipeline cadastrado ou nenhum visível ao usuário. Solução: cadastrar em Configurações > Pipelines e garantir que o usuário tenha acesso.
• KPIs zerados mesmo com leads/oportunidades cadastrados - Causa: o vendedor logado não tem ver todas as oportunidades do CRM e não é responsável por nenhum registro. Solução: revisar atribuição de vendedor ou ajustar permissão.

Onde encontrar

• URL: /admin/crm
• Caminho no menu: Módulos > CRM
• Permissão necessária: ver o CRM + crm.dashboard
• Módulo necessário: crm

Veja também

• Gerenciar Leads - captação e qualificação de potenciais clientes
• Pipelines e Kanban - configuração do funil e operação visual
• Oportunidades de Venda - negócios em andamento, ganhar/perder/reabrir
• Tarefas e Follow-ups - agenda de contatos do time comercial
• Interações com Clientes - histórico de chamadas, e-mails e mensagens
• Automações do CRM - regras automáticas de movimentação e notificação
• Relatórios do CRM - análise de conversão, performance e previsão