## Visão geral

Os **Relatórios do CRM** são o painel de análise da sua operação de vendas na Conversa Labs.
Em uma única tela você acompanha **conversão**, **valor em aberto e ganho**, **previsão ponderada**,
o **funil por etapa**, o cumprimento de **SLA**, a **saúde** e a **prioridade** dos negócios e o
**ranking de responsáveis** — tudo filtrável por pipeline e por período.

É uma superfície **administrativa**: o acesso é restrito a usuários com perfil de **administrador**.
Você abre o painel pela barra lateral em **CRM > Relatórios** (rota `crm_reports_index`).

## Pré-requisitos

- Perfil de **administrador** na conta. Agentes não têm acesso a esta tela.
- O módulo de **CRM (pipelines)** habilitado para a conta.
- Pelo menos um **pipeline com negócios** cadastrados, para que os painéis tenham dados para exibir.

## Passo a passo

1. Abra o **CRM** pela barra lateral e selecione **Relatórios**.
2. No filtro de **pipeline**, escolha **Todos os pipelines** (relatório por conta) ou um **pipeline específico**.
3. No filtro de **período**, escolha uma janela pronta (**7**, **30** ou **90** dias), **Todo o período**
   ou **Personalizado** para informar uma data inicial e final.
4. Leia cada painel de cima para baixo: **KPIs de resumo**, **distribuições** (SLA, saúde, prioridade),
   **funil por etapa** (quando há um pipeline selecionado) e **principais responsáveis**.
5. Para reaproveitar uma combinação de pipeline + período, **salve uma visão** (veja "Configurações & opções").

## Configurações & opções

### Painéis e métricas

- **Resumo (KPIs)** — visão geral da carteira:
  - **Negócios abertos**, e a contagem de **ganhos / perdidos**.
  - **Taxa de conversão** = ganhos ÷ (ganhos + perdidos).
  - **Taxa de ganho** = ganhos ÷ total de negócios do período.
  - **Tempo médio de ciclo** — média do tempo entre a **data de abertura** e o fechamento dos
    negócios encerrados (a data de abertura é editável no negócio; por padrão é a data de criação).
  - **Valor em aberto**, **valor ganho** e **previsão ponderada**, sempre **agrupados por moeda**.
- **Funil por etapa** — por etapa do pipeline: **contagem** de negócios, **valor em aberto** e
  **previsão** por moeda e o **SLA** da etapa. Exige um **pipeline específico** selecionado.
- **SLA dos negócios abertos** — distribui os negócios abertos em **no prazo**, **vencendo**
  (perto do limite), **estourado** (acima do SLA) e **sem prazo** (etapa sem SLA definido).
- **Distribuição por saúde** — **saudável**, **em risco** e **crítico**.
- **Distribuição por prioridade** — **baixa**, **média**, **alta** e **urgente**.
- **Principais responsáveis** — ranking dos donos de negócios pelo **número de negócios abertos**
  e pelo **valor em aberto** por moeda.

### Previsão ponderada

A **previsão** soma, para cada negócio aberto, o seu valor multiplicado pela **probabilidade da etapa**
em que ele está. Etapas mais avançadas pesam mais na previsão; por isso, manter a probabilidade das
etapas realista deixa a previsão mais confiável.

### Filtros e visões salvas

- **Pipeline**: **Todos os pipelines** ou um pipeline específico.
- **Período**: janelas de **7 / 30 / 90 dias**, **Todo o período** ou **Personalizado** (data inicial/final).
- **Visões salvas**: salve a combinação atual de **pipeline + período** como uma predefinição nomeada e
  aplique-a depois com um clique. As visões usam o mecanismo de filtros salvos (tipo de filtro de relatório).

### Multimoeda

Os valores são **agrupados por moeda**, **sem conversão automática**. Se a carteira tem negócios em
moedas diferentes (por exemplo, BRL e USD), cada moeda aparece com seu próprio total, lado a lado.

## Casos de uso

- Acompanhar a **conversão por etapa** e identificar onde os negócios travam no funil.
- **Priorizar** o esforço da equipe pela **previsão ponderada** e pelo valor em aberto.
- **Monitorar o SLA e a saúde** da carteira para agir antes que negócios estourem o prazo ou virem risco.
- Comparar o desempenho dos **responsáveis** por volume e por valor em aberto.

## Dicas, limites e boas práticas

- O **funil só aparece com um pipeline específico** selecionado. Com **Todos os pipelines**, o relatório
  por conta **omite o funil** (as etapas pertencem a cada pipeline, então um funil consolidado não faria sentido).
- O **período filtra pela data de abertura** do negócio (por padrão, a data de criação — corrigível
  no próprio negócio), não pela data de fechamento. Ajuste a janela conforme o que você quer medir.
- Mantenha a **probabilidade das etapas** realista — ela alimenta diretamente a previsão ponderada.
- O ranking de responsáveis mostra os **principais** donos por negócios abertos; donos sem negócios abertos
  no período não aparecem.

## Solução de problemas

- **O funil está vazio**: selecione um **pipeline específico** no filtro — o relatório por conta não exibe funil.
- **Acesso negado / não vejo Relatórios**: a tela é **somente para administradores**. Peça acesso a um
  administrador da conta.
- **Os valores aparecem em moedas diferentes**: isso é esperado — não há conversão automática; cada moeda
  tem seu próprio total.
- **Os números parecem baixos**: confira o **período** (ele filtra pela data de abertura) e o **pipeline**
  selecionados antes de comparar.

## Veja também

- [CRM: pipelines, kanban e negócios (deals)](/hc/ajuda/articles/contacts-crm-crm-pipelines-kanban-negocios-pt-br)
- [Registro de pedidos (Orders Registry) no CRM](/hc/ajuda/articles/contacts-crm-crm-orders-registry-pt-br)
- [Visão geral de Contatos e do CRM](/hc/ajuda/articles/contacts-crm-overview-pt-br)