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.
Índice
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
| 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.
| 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:
| 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.
| 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:
| 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.
