Luan: Build 116 - Painel lateral.

2026-10-05T13:56:47Z

Build 116 - Painel lateral.

Página nova

''Disponível a partir da build 116.''

O '''Painel''' fica na borda direita da tela principal do Controllr. Fechado, ele aparece como uma faixa vertical com o texto '''Painel''' e, quando existe algum problema, '''Alertas: N''' em vermelho. Esse número soma os alarmes do Messenger e do Financeiro, assim você fica sabendo que tem algo errado mesmo com o painel fechado.

Clique na faixa para abrir o painel por cima da tela. Ele não empurra nem redimensiona as outras janelas. O painel '''só fecha quando você manda''': pelo '''X''' no topo do painel ou ao clicar em um item da lista. Ele não fecha sozinho quando o mouse sai de cima dele.

O painel tem três seções: '''Atalhos''', '''Messenger - Alarmes''' e '''Financeiro - Alarmes'''. Use as setas no título de cada seção para expandir ou recolher, e o botão de '''atualizar''' para recarregar na hora.

==Atalhos (Favoritos e Relatórios)==
Lista os atalhos salvos. No topo da seção há o seletor '''Tipo''':
* '''Favoritos''': registros específicos que você marcou, como um cliente, uma integração ou um ticket de suporte. Aparecem no formato ''[Tela] - #código - nome'', por exemplo ''[Cliente] - #9 Fulano''. Clicar no nome abre direto aquele registro.
* '''Relatórios''': listagens com filtros salvos. Clicar abre a tela já com os filtros aplicados. Neste modo também aparece a coluna '''App''', que mostra qual tela o relatório abre.

===Como adicionar um Favorito===
# Abra o registro que deseja favoritar (cliente, contrato, ticket etc.).
# Clique no botão da '''estrela verde''' (dica: ''Novo - Atalho'').
# Confira o nome sugerido (por padrão, o título da janela) e salve.
# O atalho passa a aparecer em Atalhos → Favoritos.

===Botões de cada linha===
{| class="wikitable"
! Botão !! O que faz
|-
| Engrenagem (Abrir) || Abre o favorito ou relatório.
|-
| Lápis (Editar) || Altera o nome, os filtros e o acesso do atalho. Fica desabilitado sem permissão de configuração ou quando o atalho é privado de outro usuário.
|-
| Vermelho (Remover) || Apaga o atalho, com pedido de confirmação.
|}

'''Permissões:''' é preciso a permissão ''Configuração de Filtros de Aplicativo'' (app_filter_config). Sem a permissão de '''visualizar''', a seção Atalhos não aparece. Para '''editar e remover''', é preciso a permissão de '''configurar'''.

==Messenger - Alarmes==
Mostra a saúde dos canais de mensagem (WhatsApp, e-mail etc.). O quadro do topo fica '''verde''' (''Todos os canais saudáveis'') quando está tudo certo, ou '''vermelho''' com a quantidade de alarmes.

{| class="wikitable"
! Campo !! Significado
|-
| Messenger || Canais de Messenger '''ativos / total cadastrado'''. Ex.: 3 / 6 = 6 cadastrados, 3 ativos.
|-
| Mailing || Canais de Mailing '''ativos / total cadastrado'''.
|-
| Tempo de atividade || Há quanto tempo o serviço de mensagens está rodando sem reiniciar.
|}

Ter menos canais ativos do que cadastrados '''não é erro'''. Canais desativados simplesmente não são verificados.

Abaixo do quadro aparece a lista de problemas atuais. Clique em um item para abrir o canal com problema. Possíveis alarmes:
{| class="wikitable"
! Alarme !! Significado
|-
| Não inicializado || O canal está ativo, mas não chegou a iniciar.
|-
| Conexão caída || A conexão com o provedor do canal caiu.
|-
| Credenciais ausentes || Falta token ou senha no cadastro do canal.
|-
| Identidade não confirmada || O número ou conta ainda não foi confirmado no provedor.
|-
| Alerta de qualidade || O provedor (ex.: Meta/WhatsApp) emitiu aviso de qualidade sobre o número.
|}

==Financeiro - Alarmes==
Mostra a saúde das integrações de cobrança e de nota fiscal. O quadro do topo fica '''verde''' quando está tudo certo, ou '''vermelho''' com a quantidade de alarmes.

{| class="wikitable"
! Campo !! Significado
|-
| Bancos || Contas bancárias integradas '''ativas / total cadastrado'''.
|-
| Emissores || Emissores de nota fiscal '''ativos / total cadastrado'''.
|-
| Tempo de atividade || Há quanto tempo o serviço de cobrança está rodando sem reiniciar.
|}

'''Processos automáticos''': para cada rotina aparece ''execuções sem erro / execuções totais · há quanto tempo rodou pela última vez''. Ex.: ''4 / 4 · há 8h18m''. Quando alguma execução falhou, aparece também ''N falharam''.
* '''Geração de faturas''': geração automática das faturas.
* '''Varredura de observações''': rotina periódica que processa as observações das cobranças.
* '''Avisos do gateway''': processamento dos avisos enviados pelos bancos e gateways, como pagamentos e baixas.

Se aparecer '''nunca''' ou um tempo muito alto, a rotina não está rodando.

Abaixo vem a lista de alarmes. Cada item mostra '''o problema''', '''qual banco ou emissor''' e '''qual processo''' falhou. Clique no item para abrir o cadastro do banco ou emissor. Principais mensagens:
{| class="wikitable"
! Alarme !! O que fazer
|-
| Falha de autenticação || Credenciais do banco estão erradas ou expiradas. Revise o cadastro do banco.
|-
| Acesso negado || O banco recusou o acesso. Verifique permissões e certificado junto ao banco.
|-
| Rejeitado pelo provedor || O banco recusou os dados enviados.
|-
| Provedor indisponível / Tempo esgotado || Instabilidade do lado do banco. Normalmente volta sozinho.
|-
| Limite de requisições || O banco está limitando as chamadas. Aguarde.
|-
| Processo falhou || Uma rotina automática falhou. Ela tenta de novo sozinha.
|-
| Processo travado || Uma rotina automática parou e não vai tentar de novo. Precisa de atenção.
|}

===Reconhecer alarmes===
* O '''X''' no título da seção Financeiro '''reconhece todos''' os alarmes.
* Clicando com o '''botão direito''' em um alarme de processo, a opção '''Reconhecer''' reconhece só aquele.
* Reconhecer só serve para os alarmes de '''processo''' e significa "já vi". Um banco que continua com erro volta a aparecer na próxima atualização até o problema ser corrigido.

==Atualização==
As seções de alarmes atualizam sozinhas a cada 5 minutos e também toda vez que o painel é aberto.

==Dúvidas frequentes==
* '''Não vejo a seção Atalhos''': falta a permissão de visualizar ''Configuração de Filtros de Aplicativo''.
* '''O botão Editar está cinza''': falta a permissão de configurar, ou o atalho é privado de outro usuário.
* '''Reconheci o alarme e ele voltou''': o problema ainda existe. Corrija o cadastro do banco ou canal.
* '''O painel não fecha''': use o X no topo do painel. Ele não fecha sozinho de propósito.

Controllr/Aplicativos/Painel Lateral - Histórico de revisão

Luan: Build 116 - Painel lateral.