Widgets customizados no dashboard
10 min
Criado por Nathalia Moreira de Jesus em 15/10/2026 09:28

Widgets customizados no dashboard


Nesse artigo você vai aprender

O que é um widget customizado, como pedir um para a sua empresa e como colocá-lo no seu dashboard. Você também vai ver o que dá para mudar nele depois de adicionado e por que ele pode aparecer sem dados ou sumir do painel.




Descrição

Os widgets do dashboard são os quadros com indicadores: vendas do mês, entregas atrasadas, ranking de vendedores e outros. O Pontta já traz um catálogo pronto, organizado por área (Geral, Atendimento, Vendas, Produção, Financeiro...).


Quando a sua empresa precisa de um indicador que não está no catálogo, o time técnico do Pontta pode montar um widget customizado. Ele é feito sob medida, a partir de um dos formatos de visualização do Pontta, e passa a aparecer para todos os usuários da empresa numa categoria própria, chamada Customizados, na hora de adicionar widgets.


Os formatos disponíveis são os mesmos dos widgets do catálogo:


  • Números em destaque: KPI, Contador e Contador soma.
  • Gráficos: Gráfico de barras vertical, Gráfico de barras horizontal, Gráfico de linhas, Gráfico de pizza, Grade de pizza, Gráfico de funil, Gráfico de fluxo de caixa e Medidor em anel.
  • Listas e rankings: Tabela, Lista de alertas, Lista de ranking, Pódio e Mapa de árvore.
  • Outros: Mapa do Brasil, Agenda, Lista de tarefas e Kanban.


Nota: o widget customizado é cadastrado para a empresa inteira, não para um usuário. Já o dashboard é de cada pessoa: cada usuário escolhe se quer ou não colocar o widget no seu painel.




Sumário

Utilize os links abaixo para ir diretamente à seção desejada:




⚓ 

Pré-requisitos

  • Ter pelo menos um widget customizado cadastrado para a sua empresa. Enquanto não houver nenhum, a categoria Customizados não aparece.
  • Ter um dashboard criado. Se você ainda não tem, ao abrir o Dashboard clique em Criar meu primeiro dashboard.




⚓ 

Como pedir um widget customizado

O cadastro do widget customizado é feito pelo time técnico do Pontta, porque ele envolve programar a consulta que busca os dados. Abra um chamado com o suporte e informe:


  • O indicador: o que o widget deve mostrar e de onde vêm os números (por exemplo, "total de pedidos de venda do mês, sem os cancelados").
  • O formato: um dos formatos listados na Descrição, como KPI, Tabela ou Gráfico de pizza.
  • Título e descrição: o nome que vai aparecer no catálogo e uma frase explicando o que ele mostra.
  • Link: se o resultado deve abrir uma tela do Pontta ao clicar, quando o formato permitir.


Nota: o widget customizado não tem filtros de período ou de unidade de negócio na tela. Se o indicador precisa de um recorte (mês atual, últimos 30 dias, uma unidade só), informe no chamado para que ele já seja montado assim.




⚓ 

Adicionar o widget ao dashboard

No menu lateral, abra o Dashboard e escolha o dashboard em que quer colocar o widget.

    1 - Confira o dashboard selecionado. O widget entra só no painel que estiver aberto.

    2 - Clique na engrenagem (Personalizar) para entrar no modo de edição.


    1 - Clique em Adicionar widget.

    2 - Quando terminar todas as alterações, clique no check (Confirmar) para salvar o dashboard.


    1 - Pesquisa: digite parte do título ou da descrição do widget para encontrá-lo mais rápido.

    2 - Customizados: a categoria reúne os widgets feitos para a sua empresa. Eles têm todos o mesmo ícone de ajustes.

    3 - Clique no widget. Ele é incluído no dashboard e o card passa a mostrar um check.


Nota: cada widget customizado entra uma vez só em cada dashboard. Depois de incluído, o card fica desabilitado no diálogo. Para ter o mesmo widget duas vezes, crie outro dashboard.


Arraste o widget até a posição desejada e clique no check (Confirmar) para salvar.




⚓ 

Renomear, atualizar e remover o widget

Com o dashboard em modo de edição (engrenagem Personalizar), cada widget mostra três ícones no canto superior direito.

    1 - Atualizar dados: busca os números de novo na hora. Use quando o widget parecer desatualizado.

    2 - Remover widget: tira o widget deste dashboard. O widget continua cadastrado e pode ser adicionado de novo pelo diálogo.

    3 - Configurar: abre a configuração do widget neste dashboard.


    1 - Título do widget: troque o nome que aparece no topo do widget, com até 60 caracteres. A mudança vale só para o seu dashboard.

    2 - Clique em Salvar e depois no check (Confirmar), no topo do dashboard.


Nota: no widget customizado, o título é a única configuração. Período, unidade de negócio e outros filtros não aparecem, porque o recorte já vem definido no cadastro do widget.




⚓ 

O que muda em relação aos widgets do catálogo

  • Filtros: os widgets do catálogo podem ter filtros de período, unidade de negócio e outros. O customizado não tem nenhum.
  • Quem vê: alguns widgets do catálogo só aparecem para quem tem a permissão ou o módulo correspondente. O customizado aparece para todos os usuários da empresa.
  • Repetição: widgets do catálogo podem ser adicionados mais de uma vez no mesmo dashboard. O customizado, uma vez só.
  • Alterações: quando o time técnico altera o widget customizado, a mudança chega a todos os dashboards que o usam, sem precisar adicioná-lo de novo.


Nota: como o widget customizado aparece para todos, evite pedir indicadores com informação que nem todos os usuários podem ver, como margem ou salários. Ele não respeita as permissões do papel de colaborador.




⚓ 

Dúvidas frequentes

Não encontro a categoria Customizados no Adicionar widget.

A categoria só aparece quando existe pelo menos um widget customizado cadastrado para a sua empresa. Se o widget foi pedido e ainda não aparece, confirme com o suporte se o cadastro foi concluído.


O card do widget está desabilitado, com um check.

O widget já está neste dashboard. Cada widget customizado entra uma vez só por dashboard.


O widget aparece, mas sem dados.

Pode ser que não haja dados para o recorte do indicador ou que a consulta do widget tenha dado erro. Clique em Atualizar dados. Se continuar vazio, abra um chamado informando o título do widget: o erro não aparece na tela.


O widget sumiu do meu dashboard.

Quando o widget customizado é excluído do cadastro, ou tem o identificador alterado, ele some de todos os dashboards, sem aviso. Fale com o suporte para saber se ele foi substituído por outro.


Ao confirmar o dashboard, apareceu "Widget [catalog-...] não disponível".

O dashboard ainda guarda um widget customizado que não existe mais. Remova o widget do painel, ou recarregue a página, e confirme de novo. Se o erro continuar, abra um chamado com o texto da mensagem.


O widget mostra números antigos.

Os dados dos widgets ficam guardados por um tempo para o dashboard abrir mais rápido. Em modo de edição, clique em Atualizar dados para buscar os números do momento.


Posso criar um widget customizado eu mesmo?

Não. O cadastro é feito pelo time técnico do Pontta, porque exige programar a consulta dos dados. Veja Como pedir um widget customizado.


Encontrei textos sobre "Widget personalizado" e "selecionar um template". Isso ainda existe?

Não. A primeira versão do dashboard tinha um widget montado a partir de um modelo de documento. Ele foi substituído pelos widgets customizados descritos neste artigo.



Este artigo foi útil para você?
Últimos artigos visitados