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

# Dashboard

> Acompanhe o volume e o resultado dos seus envios, as métricas de e-commerce, automações e conteúdo rico, e monte gráficos próprios conversando com a IA

O **Dashboard** é a tela inicial do painel (menu **Dashboard**). Ele reúne o volume e o resultado dos seus envios e as métricas dos módulos que a sua conta usa. Todos os usuários da conta têm acesso.

A tela tem duas abas:

* **Visão geral** — indicadores e gráficos prontos.
* **Personalizado** — gráficos que a sua equipe monta descrevendo para a IA o que quer ver.

## Visão geral

### Período, exportação e atalho

No topo da aba ficam:

* **Período** — **7 dias**, **30 dias** (padrão) ou **90 dias**.
* **Exportar** — baixa em CSV os números do gráfico **Envios por dia** no período escolhido.
* **Nova comunicação** — abre a criação de uma comunicação. Veja [Comunicações](https://docs.octasend.com.br/plataforma/comunicacoes.md).

O período vale para o gráfico **Envios por dia**, para o **WhatsApp: grupo x individual** e para as seções **E-commerce**, **Automações** e **Conteúdo Rico**. Em todos eles, "últimos N dias" são exatamente N dias contando hoje: em **7 dias**, hoje e os 6 dias anteriores. Os demais gráficos mostram o **total histórico** da conta. A descrição de cada gráfico diz qual dos dois ele usa ("Últimos 30 dias" ou "Total histórico").

> [!NOTE]
>
> O que conta como "hoje" e a divisão por dia dos gráficos de envios, de WhatsApp, de e-commerce e de automações seguem o **fuso horário** da conta, definido em **Configurações → Geral → Fuso horário** (sem essa configuração, vale o horário de São Paulo). Um envio às 22h de segunda conta na segunda, mesmo que já seja terça em UTC. Veja [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md).

### Precisa da sua atenção

Quando há algo a resolver, o topo da **Visão geral** mostra um bloco **Precisa da sua atenção**, com uma linha por problema:

| Aviso | Quando aparece | Ação |
| - | - | - |
| **WhatsApp desconectado** | Um número de WhatsApp com conexão ativa está com problema. | **Reconectar** |
| **N falhas hoje** | Há envios com falha hoje. | **Ver falhas** abre o histórico filtrado. |
| **Só X% dos envios deram certo nos últimos N dias** | A taxa de sucesso do período está abaixo de 70%, há falhas reais e pelo menos 20 envios no período. | **Ver falhas** |

O bloco só aparece quando há aviso. A taxa só dispara alarme com volume mínimo (20 envios), para que uma falha entre poucos envios não gere falso alarme.

### Fila da inbox

Com a inbox de conversas liberada na conta, a Visão geral mostra três contadores: **Sem dono**, **Minhas** e **Não lidas**. Cada um leva à inbox já na visão correspondente. Veja [Conversas e grupos do WhatsApp](https://docs.octasend.com.br/plataforma/whatsapp-conversas-e-grupos.md).

### Indicadores

| Indicador | O que mostra |
| - | - |
| **Comunicações** | Quantas comunicações a conta tem cadastradas. |
| **Enviados no período** | Envios com status **Enviada**, **Entregue** ou **Lida** no período escolhido. A dica **Hoje** mostra o valor de hoje. |
| **Falhas no período** | Envios com status **Falhou** no período, com a dica **Hoje**. O cartão leva aos logs filtrados por falha. |
| **Total histórico** | Todos os registros de envio da conta, de todos os canais e status. |
| **Taxa de sucesso** | Percentual de envios com sucesso sobre o total do período. Verde a partir de 90%, amarelo de 70% a 89% e vermelho abaixo de 70%. Sem envios, mostra "Sem envios no período". |

### Gráficos de envio

| Gráfico | Período | O que mostra |
| - | - | - |
| **Envios por dia** | Selecionado | Mensagens com status **Enviada**, **Entregue** ou **Lida** por dia, uma linha por canal. Só aparecem os canais que tiveram envio no período. Entram os envios das comunicações, campanhas, automações e da API, inclusive respostas do bot; não entram respostas de atendentes na inbox nem mensagens em grupos. |
| **Distribuição por canal** | Histórico | Todos os envios da conta, divididos por canal. |
| **WhatsApp: grupo x individual** | Selecionado | Mensagens que a conta enviou pelo WhatsApp em grupos e em conversas individuais. No individual entram as respostas do chatbot e as digitadas pelo atendimento na tela de conversas. Respostas do [Chatbot do site](https://docs.octasend.com.br/plataforma/chatbot-do-site.md) só contam quando saíram pelo WhatsApp; as que ficaram só no site não entram, inclusive nos dias anteriores. |
| **Status dos e-mails** | Histórico | Situação de cada e-mail enviado (veja abaixo). |
| **Status dos envios de WhatsApp** | Histórico | Situação de cada envio de WhatsApp (veja abaixo). |
| **Top comunicações** | Histórico | As 8 comunicações com mais envios, com quantas mensagens de cada uma foram enviadas e quantas falharam. |
| **Taxa de sucesso por canal** | Histórico | Percentual de envios com status **Enviada**, **Entregue** ou **Lida** sobre o total do canal. A barra fica verde a partir de 90%, amarela de 70% a 89% e vermelha abaixo de 70%. |
| **Envios por comunicação e canal** | Histórico | As 8 comunicações com mais envios com sucesso, com o total e a divisão por canal. |
| **Últimos envios** | — | Os 8 envios mais recentes, com destinatário, canal, idioma, status e data. Um destinatário protegido pela configuração de campos protegidos da conta aparece como **Criptografado**. Se essa configuração não carregar, todos os destinatários aparecem mascarados, com um aviso. **Ver todos** abre os [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md). |

**Top comunicações** e **Envios por comunicação e canal** consideram só os envios feitos a partir de uma comunicação.

> [!NOTE]
>
> Um envio de WhatsApp pela Evolution (QR code) passa de **Enviada** para **Entregue** e **Lida** quando o WhatsApp confirma. Ele continua contando como envio com sucesso em **Enviados hoje**, **Envios por dia** (e no CSV de **Exportar**), nas enviadas de **Top comunicações**, em **Envios por comunicação e canal** e em **Taxa de sucesso por canal**. Para acompanhar a entrega e a leitura do WhatsApp, use o gráfico **Status dos envios de WhatsApp**.

Alguns gráficos só aparecem quando fazem sentido para a sua conta:

* **Status dos e-mails** — quando o canal E-mail está configurado e ativo.
* **Status dos envios de WhatsApp** — quando o canal WhatsApp está configurado e ativo.
* **WhatsApp: grupo x individual** — quando o canal WhatsApp está ativo e o menu **WhatsApp** (conversas e grupos) está liberado para a conta. Veja [WhatsApp: conversas e grupos](https://docs.octasend.com.br/plataforma/whatsapp-conversas-e-grupos.md).

> [!TIP]
>
> Nas roscas, passe o mouse (ou navegue com **Tab**) sobre uma fatia ou um item da legenda para ver o valor e o percentual no centro.

### Status dos e-mails

Cada e-mail entra uma única vez, na situação mais avançada que atingiu:

| Situação | Quando |
| - | - |
| **Falhou** | O envio falhou, inclusive quando o provedor informou uma rejeição depois do envio. |
| **Clicado** | Alguém clicou num link rastreado do e-mail. |
| **Aberto** | A abertura do e-mail foi registrada, sem clique. |
| **Entregue** | O SendGrid confirmou a entrega, com o webhook de eventos configurado, sem abertura registrada. |
| **Enviado** | O provedor aceitou a mensagem, sem confirmação de entrega ou abertura. |
| **Ignorado** | Nada foi enviado, por exemplo porque o contato se descadastrou do e-mail ou a comunicação não tinha versão publicada. |
| **Pendente** | O envio ainda está na fila ou em processamento. |

Veja como a entrega, a abertura e o clique são registrados em [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md#rastreamento-de-abertura-e-clique).

### Status dos envios de WhatsApp

| Situação | Quando |
| - | - |
| **Lido** | O WhatsApp confirmou a leitura. |
| **Entregue** | O WhatsApp confirmou a entrega no aparelho. |
| **Enviado** | A mensagem foi aceita, sem confirmação de entrega. |
| **Falhou** | O envio falhou, inclusive quando o provedor informou a falha depois do envio. |
| **Ignorado** | Nada foi enviado, por exemplo porque o número não está registrado no WhatsApp. |
| **Pendente** | O envio ainda está na fila ou em processamento. |

> [!NOTE]
>
> **Entregue** e **Lido** dependem das confirmações do WhatsApp. Na Meta Cloud API, elas chegam pelo webhook configurado no canal, e o envio continua **Enviada** na tela de Logs. Na Evolution (QR code), elas chegam sozinhas pela conexão e também mudam o status do envio nos Logs. Envios feitos pela Evolution antes dessa atualização continuam como **Enviado**. Veja o guia de [WhatsApp](https://docs.octasend.com.br/guias/whatsapp.md).

### Exportar

**Exportar** baixa o arquivo `envios-30-dias.csv` (o número acompanha o período escolhido), com uma linha por dia e uma coluna por canal, separadas por ponto e vírgula. São os mesmos números do gráfico **Envios por dia**: mensagens com status **Enviada**, **Entregue** ou **Lida**. O botão fica desabilitado quando não há envios no período.

## Seções dos módulos

Abaixo dos gráficos de envio, a **Visão geral** mostra uma seção para cada módulo em uso. Todas seguem o período escolhido no topo e só aparecem quando o módulo está disponível para a conta.

> [!NOTE]
>
> As antigas telas de **Métricas** dos menus de E-commerce, Automações e Conteúdo Rico viraram estas seções. Um link salvo para uma delas abre o Dashboard já na seção certa.

### E-commerce

Aparece quando a conta tem uma loja ou sistema conectado (como Nuvem Shop, Wake, Yampi, Shopify ou Conta Azul) ou já importou pedidos, clientes ou produtos por planilha. O link **Ver pedidos** leva à lista de pedidos. Veja [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md).

| Indicador | O que mostra |
| - | - |
| **Faturamento** | Soma do valor dos pedidos que contam como venda no período. |
| **Pedidos** | Quantidade de pedidos que contam como venda. |
| **Ticket médio** | Faturamento dividido pela quantidade de pedidos. |
| **Clientes que compraram** | Clientes diferentes com pelo menos um pedido que conta como venda. |

Contam como venda os pedidos com status de pago e os pedidos **sem status** (o caso típico é a planilha importada sem a coluna de status). Pedidos cancelados, pendentes ou com um status que o sistema não reconhece ficam fora do faturamento. Logo abaixo dos indicadores, uma linha explica quantos pedidos sem status foram contados como pagos e quantos ficaram de fora, e por quê.

> [accordion] Quais status contam como pago, cancelado ou pendente
>
> A comparação ignora maiúsculas e espaços nas pontas.
>
> | Grupo | Status reconhecidos |
> | - | - |
> | Pago (conta como venda) | paid, pago, approved, aprovado, faturado, entregue, delivered, enviado, shipped, completed, complete, concluido, concluído, finalizado |
> | Cancelado | cancelled, canceled, cancelado, refunded, reembolsado, estornado, devolvido, voided |
> | Pendente | pending, pendente, aguardando, awaiting, unpaid, nao pago, não pago, aberto, em aberto |
>
> Qualquer outro texto entra como **Não reconhecido** e fica fora do faturamento.

Gráficos da seção:

* **Faturamento por dia** — valor vendido em cada dia; ao passar o mouse, aparecem o valor e a quantidade de pedidos do dia.
* **Produtos mais vendidos** — os 10 produtos com mais unidades vendidas (no empate, maior receita), com unidades e receita.
* **Melhores clientes** — os 10 clientes que mais gastaram, com quantidade de pedidos e total.
* **Pedidos por status** — todos os pedidos do período, inclusive os que não viraram receita: Pago, Sem status, Cancelado, Pendente e Não reconhecido.
* **Pedidos por loja** — de qual loja vieram os pedidos que viraram faturamento (por exemplo, Nuvem Shop, Wake ou Cadastro manual), com o nome da integração de origem.

> [!WARNING]
>
> O recorte é pela data do pedido na loja. Pedidos sem essa data (por exemplo, de uma planilha importada sem a coluna de data) não entram nos números do Dashboard.

### Automações

Módulo opcional: se a seção não aparecer, fale com a OctaSend para ativar. O link **Ver automações** leva à lista de automações. Veja [Automações](https://docs.octasend.com.br/plataforma/automacoes.md).

* Indicadores: **Total de execuções**, **Concluídas**, **Falharam** e **Em andamento**. O total inclui as execuções canceladas, que não têm indicador próprio.
* **Execuções por dia** — concluídas, com falha e em andamento, por dia.
* **Últimas execuções** — as 8 execuções mais recentes do período, com o nome da automação, a data e a situação (Concluída, Falhou, Em andamento ou Cancelada). Clicar numa delas abre o histórico de execuções daquela automação.

### Conteúdo Rico

Módulo opcional: se a seção não aparecer, fale com a OctaSend para ativar. Mostra como o seu conteúdo está sendo visto nos sites onde o script foi instalado. O link **Ver conteúdos** leva à lista de conteúdos. Veja [Conteúdo rico](https://docs.octasend.com.br/plataforma/conteudo-rico.md).

| Indicador | O que mostra |
| - | - |
| **Visualizações** | Quantas vezes o conteúdo foi visto. |
| **Cliques** | Quantos cliques o conteúdo recebeu. |
| **Taxa de clique** | Cliques divididos por visualizações. |
| **Botão exibido** | Quantas vezes o botão de carregar o conteúdo apareceu, mesmo sem clique. |
| **Visualizações de vídeos** | Quantas vezes os vídeos dos blocos de vídeos curtos foram vistos. |

> [!NOTE]
>
> Em conteúdo com carregamento sob demanda, **Visualizações** só conta quem clicou no botão para ver o conteúdo. **Botão exibido** mostra quantas vezes o botão apareceu.

A seção traz ainda o gráfico **Visualizações, cliques e botão exibido por dia** e duas tabelas: **Por domínio** (site onde o conteúdo foi exibido) e **Por conteúdo** (por SKU).

## Personalizado: gráficos com IA

Na aba **Personalizado**, a sua equipe monta gráficos descrevendo o que quer ver, e a IA transforma o pedido num gráfico com os dados da conta. Os gráficos salvos ficam na aba para todos os usuários da conta, que podem editá-los e excluí-los.

### Criar um gráfico

**1. Abra o construtor**

Em **Dashboard → Personalizado**, clique em **Novo gráfico**. Com a aba ainda vazia, aparecem até três sugestões de pergunta. Clicar numa delas já abre o construtor com a pergunta enviada.

**2. Descreva o que quer ver**

Escreva o pedido, por exemplo "Envios por canal nos últimos 30 dias", e clique em **Enviar** (ou tecle **Enter**; **Shift + Enter** quebra a linha). A IA responde na conversa e a prévia do gráfico aparece ao lado.

**3. Ajuste**

Peça mudanças na própria conversa ("só WhatsApp", "agrupe por semana", "mostre os 5 maiores"). Você também pode trocar o **Tipo de gráfico** e editar o **Título** direto nos campos abaixo da prévia.

**4. Salve**

Clique em **Salvar gráfico**. Se fechar o construtor com alterações não salvas, o painel pede confirmação antes de descartar.

Tipos de gráfico: **Linha**, **Área**, **Barras**, **Barras horizontais**, **Barras empilhadas**, **Rosca**, **Número** e **Tabela**. O campo **Tipo de gráfico** só oferece os tipos que combinam com os dados escolhidos: uma rosca, por exemplo, precisa de uma única divisão que não seja data, e uma linha precisa de uma divisão por data.

**Período.** Diga o período na pergunta: últimos 7, 30 ou 90 dias, últimos 12 meses ou um intervalo de datas. Sem período, a IA usa os últimos 30 dias. O máximo é 24 meses, e "tudo" significa os últimos 24 meses. Um gráfico salvo com período relativo é recalculado sempre que a aba é aberta: "últimos 30 dias" acompanha a data de hoje.

**Idioma.** Os rótulos do gráfico seguem o idioma do painel de quem está vendo (português, inglês ou espanhol).

> [!NOTE]
>
> Cada mensagem na conversa com a IA consome o uso de IA da conta. Abrir a aba, trocar o tipo de gráfico, reordenar, duplicar ou baixar um gráfico salvo não usa IA.

### Gerenciar os gráficos

O menu **Ações do gráfico** (os três pontos no canto de cada gráfico) tem:

* **Editar** — reabre o construtor. A conversa começa com a descrição do gráfico atual, e você pede o que quer mudar.
* **Duplicar** — cria uma cópia com "(cópia)" no título.
* **Mover para cima** / **Mover para baixo** — muda a ordem na aba, para todos os usuários.
* **Baixar CSV** — baixa os dados do gráfico.
* **Excluir** — pede confirmação e remove o gráfico para todos os usuários da conta.

### Quais dados a IA pode usar

A IA não escreve consultas livres: ela escolhe entre fontes e campos pré-definidos, e todo gráfico lê só dados da sua conta. As fontes disponíveis dependem dos módulos da conta:

| Fonte | Disponível quando |
| - | - |
| Envios | Sempre |
| Campanhas | Sempre |
| Contatos | Sempre |
| Uso de IA | Sempre |
| Pedidos, Itens vendidos, Produtos e Clientes da loja | Há loja conectada ou dados importados por planilha |
| Carrinhos abandonados | Módulo de carrinho abandonado ativo |
| Conversas | Módulo de WhatsApp, Chatbot ou Chatbot do site ativo |
| Execuções de automação | Módulo de [Automações](https://docs.octasend.com.br/plataforma/automacoes.md) ativo |
| Respostas de avaliações | Módulo de [Avaliações](https://docs.octasend.com.br/plataforma/avaliacoes.md) ativo |
| Avaliações de produtos | Módulo de [Avaliações de produtos](https://docs.octasend.com.br/plataforma/avaliacoes-de-produtos.md) ativo |
| Tours | Módulo de [Tours](https://docs.octasend.com.br/plataforma/tours.md) ativo |
| Conteúdo rico | Módulo de [Conteúdo rico](https://docs.octasend.com.br/plataforma/conteudo-rico.md) ativo |
| Token Control | Módulo de [Token Control](https://docs.octasend.com.br/plataforma/token-control.md) ativo |
| Sessões do assistente | Módulo de [Chatbot do site](https://docs.octasend.com.br/plataforma/chatbot-do-site.md) ativo |

Se um módulo for desativado depois, os gráficos que usam a fonte dele passam a mostrar "Esta fonte não está mais disponível para sua conta".

### Limites

| Limite | Valor |
| - | - |
| Gráficos por conta | 50 |
| Título | Até 80 caracteres |
| Tamanho de cada mensagem na conversa | Até 2.000 caracteres |
| Mensagens suas por conversa | 20 (depois disso, o campo é bloqueado) |
| Mensagens para a IA por minuto, por usuário | 20 |
| Período de um gráfico | Até 24 meses |
| Itens em rankings de barras e tabelas | 10 por padrão, até 50 se você pedir |
| Linhas, áreas e barras empilhadas | Até 5 séries |
| Rosca | Até 5 fatias |
| Linhas de resultado | 1.000 |
| Tempo de cada consulta | 5 segundos |

Quando a medida é uma contagem ou uma soma, o que passa do limite de séries ou fatias é somado em **Outros**.

### Mensagens de erro

| Mensagem | O que fazer |
| - | - |
| Limite de 50 gráficos atingido. Exclua um para criar outro. | Exclua um gráfico que não usa mais. |
| Consulta pesada demais. Edite o gráfico e escolha um período menor. | Edite o gráfico e peça um período mais curto ou menos divisões. |
| O resultado passou de 1.000 linhas; o gráfico mostra só parte dos dados. | Peça um período menor, um agrupamento maior (semana ou mês) ou um filtro. |
| Muitas atualizações em pouco tempo. Aguarde um minuto e recarregue a página. | Aguarde um minuto e recarregue. |
| Muitas mensagens em pouco tempo. Aguarde um minuto e tente de novo. | Aguarde um minuto antes de mandar a próxima mensagem. |
| Seu limite de uso de IA foi atingido. | A conta chegou ao limite de uso de IA; fale com a OctaSend. |
| Não foi possível falar com a IA agora. | Clique em **Tentar de novo**. A mensagem é reenviada sem você precisar digitar de novo. |
| Esta fonte não está mais disponível para sua conta | O módulo da fonte foi desativado. Exclua o gráfico ou fale com a OctaSend para reativar o módulo. |

## Veja também

> [card] [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md)
>
> O histórico de cada envio, com status, conteúdo e rastreamento

> [card] [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md)
>
> Fuso horário e demais preferências da conta


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.