Indicadores Portall

About

O que é
Indicadores Portall é uma extensão que exibe, no badge do ícone e em um popup, valores vindos de múltiplos endpoints JSON definidos pelo usuário. Foi pensada para uso com o CMS Portall como painel leve de indicadores de CRM (ex.: leads, agendados, atendidos), mas funciona com qualquer JSON público.

Como funciona

Você cadastra cada indicador informando: URL do JSON, caminho do campo (dot-notation, ex.: itens[0].leads_total), cor do badge, intervalo de atualização (ex.: 5 ou 10 minutos) e link de destino ao clicar.

O indicador marcado como Primário aparece no badge; todos ficam listados no popup com o valor atual e um link rápido.

Atualizações acontecem em segundo plano usando chrome.alarms.

Integração com o CMS Portall (caso de uso recomendado)

Ideal para acompanhar métricas de CRM expostas por APIs do Portall (ou outras APIs internas) como leads_total, agendados, atendidos, etc.

Basta apontar para o endpoint JSON do seu CMS (público ou protegido por token) e indicar o campo a ser lido.

Recursos
• Suporte a múltiplos indicadores com intervalos independentes.
• Badge com o indicador primário (compacta números: 9.5k, 10k, 1m).
• Popup com a lista completa, status (OK/Erro) e horário da última atualização.
• Editar, Testar e Excluir indicadores diretamente na página de opções.
• Exportar/Importar configuração (backup em .json).
• Permissões por domínio (opcionais): a extensão solicita acesso apenas às origens que você cadastrar.
• Armazenamento das configurações em chrome.storage (sincronizado quando possível).

Exemplos de caminho do campo (dot-notation)

count → { "count": 42 }

data.total → { "data": { "total": 12 } }

items.length → { "items": [ ... ] }

itens[0].leads_total → { "itens": [ { "leads_total": "376" } ] }

Como começar

Instale a extensão e clique em Configurar.

Adicione um indicador com a URL do JSON e o caminho do campo.

Marque Tornar Primário se quiser que ele apareça no badge.

(Opcional) Informe o link para abrir seu painel do Portall/CRM ao clicar.

Permissões

Storage: guardar suas configurações e último valor obtido.

Alarms: agendar as atualizações periódicas.

Hosts (opcionais): acesso apenas às origens dos JSONs que você cadastrar; usado exclusivamente para GET dos dados. Não injetamos scripts em páginas.

Privacidade

Não coletamos, armazenamos ou enviamos dados pessoais a servidores do desenvolvedor.

As configurações residem no chrome.storage.

As requisições são feitas diretamente aos endpoints informados por você.

Não executamos código remoto; os dados JSON são apenas lidos e exibidos.

Boas práticas

Prefira endpoints somente-leitura e, se necessário, token na URL (evite depender de cookies/sessão).

Evite expor informações sensíveis; use filtros no servidor para retornar apenas o que precisa.

Limitações conhecidas

O Chrome permite um único ícone por extensão. Para múltiplos badges simultâneos, use um indicador primário (badge) e os demais no popup — ou crie extensões separadas.

Suporte
Dúvidas sobre configurar seus endpoints do CMS Portall ou ajuste de “caminho do campo”? Consulte a documentação interna do seu CMS ou entre em contato com o responsável pelo seu ambiente Portall.