> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Insights (CRM)

> Dashboard personalizável com KPIs e gráficos sobre sua base de clientes

**Insights** é o painel de business intelligence do CRM: você monta seu dashboard com **widgets arrastáveis** sobre a sua base de clientes, usando filtros de **período** e **pipeline**.

<Info>
  Navegação no painel: **CRM** > **Insights**.
</Info>

***

## O que você pode fazer

* Adicionar e remover **widgets** (KPI, barras, área temporal, rosca, funil, tabela).
* **Redimensionar e reposicionar** cada bloco no grid (layout responsivo).
* **Configurar** título, **métrica** e, quando aplicável, **pipeline** (ex.: funil por etapas).
* **Salvar** o layout por **usuário** e **organização**; usar **Resetar** para voltar ao layout padrão da plataforma.
* Aplicar **filtros globais** na página: intervalo de dias (ex.: 7 a 365) e pipeline específica ou “todas”.

<Tip>
  Os filtros de período e pipeline refetcham os dados — todos os widgets passam a refletir o mesmo recorte.
</Tip>

***

## Tipos de widget

| Tipo                  | Uso típico                                                                            |
| --------------------- | ------------------------------------------------------------------------------------- |
| **KPI**               | Número grande com ícone — totais e contadores do resumo                               |
| **Gráfico de barras** | Comparar categorias (etapa, origem, tags, responsáveis)                               |
| **Gráfico de linha**  | Série temporal (novos clientes ao longo do tempo; visualização em área com gradiente) |
| **Rosca (donut)**     | Partes de um todo (ex.: distribuição por pipeline)                                    |
| **Funil**             | Contagem por etapa de uma pipeline (opcionalmente filtrada por pipeline no widget)    |
| **Tabela**            | Rankings (tags, responsáveis, etc.) ou listagens resumidas                            |

Cada tipo tem **tamanho mínimo** no grid para manter legibilidade.

***

## Métricas disponíveis (visão geral)

Os widgets consomem campos como:

* **Resumo**: total de clientes, novos no período, com pipeline, sem pipeline.
* **Por etapa**, **por origem**, **por tag**, **por responsável**, **por pipeline**.
* **Evolução temporal**: novos clientes (e cumulativo no tooltip, quando exposto pela API).
* **Funil**: estágios ordenados com contagens para a pipeline escolhida.

A API também pode retornar distribuições de **campos customizados**; widgets dedicados podem ser ampliados no produto ao longo do tempo — consulte a interface para as opções atuais ao adicionar um widget.

***

## Persistência do layout

* O layout (posição, tamanho, tipo e configuração de cada widget) é **salvo por usuário** — cada pessoa da organização mantém seu próprio painel.
* Se você nunca personalizou, vê o **conjunto padrão** (vários KPIs, gráficos e tabelas sugeridos).
* **Resetar** remove sua personalização e restaura esse padrão.

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Clientes" icon="users" href="/clients">
    Enriqueça a base que alimenta os gráficos
  </Card>

  <Card title="Board" icon="table-columns" href="/board">
    Etapas e pipelines usados nos funis e filtros
  </Card>

  <Card title="Campanhas" icon="bullhorn" href="/campaigns">
    Origem "campanha" nas métricas
  </Card>

  <Card title="Introdução" icon="book" href="/introduction">
    Visão geral da plataforma
  </Card>
</CardGroup>