Central de Ajuda Quaza Provedores

CRM — Gestão de Vendas e Pipeline (PT)

CRM — Gestão de Vendas e Pipeline

CRM — Gestão de Vendas e Pipeline — Como o Quaza organiza el funil de vendas, desde el lead até el contrato firmado

Este guia explica desde cero o módulo CRM — para quem precisa entender como Leads se convierten en clientes con contrato dentro de Quaza.

Nesta wiki:

Visão geral — la cadeia do CRM
Glossário — conceitos chave
Telas e seus propósitos
Fluxo: Lead → Oportunidade → Orçamento → Cliente
Integrações con outros módulos
Pegadinhas frequentes
Documentos relacionados
Perguntas frequentes

Tela "Oportunidade" — centro do CRM

Visão geral — la cadeia do CRM

El CRM (Customer Relationship Management) de Quaza es donde el ISP organiza seu pipeline de ventas: desde el primer contacto do lead até convertirse en cliente con contrato firmado.

┌─────────────┐ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐ │ LEAD │──▶│ OPORTUNIDAD │──▶│ PRESUPUESTO │──▶│ CLIENTE │ │ (Cliente) │ │ (Funil + │ │ (ítems con │ │ + CONTRATO │ │ tipoLead=1 │ │ Etapa) │ │ serviços) │ │ tipoLead=0 │ └─────────────┘ └──────────────┘ └──────────────┘ └─────────────┘ │ │ │ │ ▼ ▼ ▼ ▼ Forma de Contactos + Items de Comissão do contacto Anotações servicio vendedor

Cada paso es auditado (trait History) e conectado: la oportunidad obliga un Funil e uma Etapa; el presupuesto referencia ContratoServicio; la conversão muda tipoLead en la tabla Cliente.

Glossário — conceitos chave

Termo	Significado
Lead	Cliente potencial con `tipoLead=1` — visible apenas en la página "CRM › Cliente". Ainda no es cliente real.
Oportunidade	Posible venda vinculada a un Lead/Cliente. Tem Funil, Etapa, Responsável, Qualificação (1-5), Forma de contato inicial.
Funil	Pipeline configurável (ej. "Vendas Residencial"). Contem várias Etapas ordenadas.
Etapa	Estado da oportunidad dentro do funnel (ej. Prospección → Qualificação → Propuesta → Fechamento).
Campanha	Origen da oportunidad (ej. "Google Ads junio") — sirve para análisis de ROI.
Orçamento	Propuesta formal con ítems (plan + SVA + telefonía). Vinculado a uma oportunidad.
Forma de Contacto	Modelo CRUD (descripción libre) — diferente do enum FunilContato fijo (pessoalmente, email, teléfono, sitio, WhatsApp, redes sociales).
Vendedor (Perfil)	Tipo de vendedor con flag "Pagamento em dia". Define qué serviços genera comissão.
Comissão	% por servicio vendido. Configurável por período (sin solapamiento) por perfil.
Anotação / Contacto	Timeline da oportunidad: anotações libres (texto) e contactos rastreados (con duración).

Telas e seus propósitos

Tela	Para que serve
Funil	CRUD de funis de venda. Cada funnel tem N etapas (ordenables).
Oportunidade	Centro do CRM. Crea/edita oportunidades con cliente, funnel, etapa, qualificación, responsável.
Oportunidadees (calendário)	Vista calendário filtrada por funnel/período. Útil para gerente.
Campanha	Catálogo de campanhas de marketing — vincular a oportunidades.
Forma de Contacto	Catálogo customizable (além do enum fijo).
Lembrete	Alertas/recordatorios futuros para uma oportunidad.
Tarefa CRM	Tarefas con situaciones específicas (Pendente, Andamento, Concluído, Cancelado).
Orçamento	Propuesta con ítems vinculados a ContratoServicio (Internet/SVA/Telefonia).
Converter	Wizard: oportunidad → cliente real → contrato (muda `tipoLead`).
CRM › Cliente	Listado apenas de Leads (`tipoLead=1`).
Vendedor Perfil	Tipos de vendedor (con flag "pago en día").
Vendedor Comissão	% comissão por período (validado contra solapamiento).

Fluxo: Lead → Oportunidade → Orçamento → Cliente

1 Crear Lead — Cliente con tipoLead=1 entra en "CRM › Cliente".

2 Abrir Oportunidade — Seleciona Lead, asigna Funil + Etapa, define Forma de contato inicial, Campanha, Responsável, Qualificação 1-5.

3 Rastrear Contactos — Cada chamada/email registrado como OportunidadeeContato con fecha, duración e forma. Sistema computa quantidadeContato e tempoContato automáticamente.

4 Crear Orçamento — Vinculado a la oportunidad, con ítems referenciando ContratoServicio específicos.

5 Converter — Botón "Converter para contrato" abre wizard:

Confirma datos do Cliente
Muda tipoLead=0 (deja de ser Lead)
Abre popup para crear Contrato vinculado al OrçamentoItem

6 Cerrar Oportunidade — situacao = CONCLUIDO. A partir de ahí no se pode deshacer (botón "Converter" desaparece).

Integrações con outros módulos

Cliente: Lead vive en la mesma tabla Cliente con flag tipoLead. Converter = cambiar el flag.
Contrato / ContratoServicio: OrçamentoItem referencia ContratoServicio. Converter abre creación de Contrato.
Mapa (ReservaPorta): Al borrar Oportunidade, libera reservas de puerta (vinculadas vía idOportunidadee).
Comissão: VendedorComissao + VendedorPerfilItem definen % por servicio e período.
Historial: Oportunidadee, Orcamento e OportunidadeeAnotacao usan trait Histore (auditoría completa).

Pegadinhas frequentes

Pegadinha 1 — Lead que es cliente real: Si el cliente selecionado ya tem tipoLead=0, os campos nombre/email/CPF ficam readonly en la oportunidad. No intentes editarlos ahí — usa o módulo Cliente.

Pegadinha 2 — Oportunidade concluida no vuelve atrás: Cuando OportunidadeeSituacao = CONCLUIDO, el botón "Converter para contrato" desaparece, lembretes/contactos/tarefas se ocultan. No hae reabertura automática — hae que crear nova oportunidad.

Pegadinha 3 — Permiso "oportunidadesProprias": Si el vendedor tem esa ACL marcada, ve solo as oportunidades donde él es responsável. Esto também filtra Presupuestes (subquere JOIN). Gestores deben tener ACL completa.

Pegadinha 4 — Solapamiento de comissão: VendedorComissao valida que no haya dos períodos solapados para el mesmo perfil. Se erro ao salvar, revisar fechas anteriores.

Pegadinha 5 — FormaContato (modelo) vs FunilContato (enum): Son dos cosas distintas. La oportunidad usa el enum fijo; os contactos individuales (timeline) usan el modelo customizable.

Galeria de telas

FAQ

Como começar a usar este módulo?

Configure os pré-requisitos listados acima, faça um teste em ambiente seguro (ou com poucos registros), valide com a equipe, e só então ative em produção.

Preciso de permissão especial pra acessar?

Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com o administrador do Quaza.

Posso integrar com sistemas externos?

Via API REST do Quaza. Webhooks notificam eventos importantes. Consulte a equipe técnica para credenciais.

O que acontece se houver erro?

Os logs ficam no painel de tarefas/auditoria. Configure alertas (email/Slack) para falhas críticas — não confie em ninguém olhar log manualmente.

Como acompanhar mudanças?

Cada registro tem histórico (timestamp, usuário, ação). Use o filtro de auditoria pra rastrear modificações suspeitas.

O módulo funciona multi-filial?

Sim — via centro de custo (filial) atribuído ao lançamento. Relatórios filtram por filial.

Documentos relacionados

Cliente — Cadastro e tipoLead
Contrato e Fatura — Lo que se crea al convertir oportunidad
Comissões — Configuração detallada de comissão por servicio
Mapa — Reserva de puerta vinculada a oportunidad
Vendas — Plan de ventas e serviços

Perguntas frequentes

¿Puedo tener vários funis (ej. Residencial, Empresarial)?
Sim. Crea funis distintos con sus propias etapas. Cada oportunidad va en uno solo.

¿Qué pasa si elimino un Lead con oportunidad abierta?
La oportunidad fica huérfana — además, libera reservas de puerta en Mapa. Mejor cancelar la oportunidad primero.

¿Como veo qué campaña trae mais conversão?
Campanha tem FK desde Oportunidade. En la vista "Oportunidadees" podes filtrar/agrupar.

¿Diferença entre Tarefa CRM e Tarefa Operacional?
Tarefa CRM (este módulo) tem seu propio enum de situaciones e se ve apenas dentro da oportunidad. Tarefa Operacional (módulo Tarefa/Projeto) es para el equipo técnico/projeto.