Administração

Sistema

O módulo de quem configura a plataforma: o aplicativo com a marca da empresa, as integrações e o cadastro de fornecedores, os campos e as telas moldados à operação, a importação de dados, os tipos de documento, os tokens de API e a auditoria bancária.

A lógica do módulo

Este é o módulo de quem configura a plataforma, e não de quem a usa no dia a dia. Ele responde cinco perguntas:

  • Como o app chega ao formando, que é o WhiteLabel.
  • Com quem o sistema conversa, que são as integrações, os portais e os fornecedores.
  • Como o sistema é moldado à empresa, que são os campos e as telas.
  • Como os dados entram, que são o importador e os tipos de documento.
  • Quem pode falar com o sistema de fora, que são os tokens de API.

As telas deste módulo mudam o comportamento do sistema inteiro, para todos os usuários. Não é lugar de experimentar em horário de expediente.

Antes de começar

O que precisa estar prontoPor quê
Incluso no painelO bloco não depende de módulo do catálogo: ele aparece pela permissão.
Permissão Screen:Configuracoes:ViewCada subgrupo tem a sua: SistemaIntegracoes, SistemaPortais, SistemaFornecedores, SistemaCampos, SistemaTelas, SistemaTiposDocumento e SistemaImportador.
Credenciais dos serviços externos em mãosCada integração pede as chaves fornecidas pelo próprio serviço.
Um cofre de senhas da empresaO Client Secret do token de API é mostrado uma única vez.
A planilha limpa, para importarO mapeamento acerta a coluna, mas não corrige conteúdo sujo.

O mapa do menu

WhiteLabel

Item do menuO que faz
Visão GeralA tela de decisão: o que muda para os formandos, os três passos, o status nas lojas, o investimento e os requisitos.
ConfiguraçõesNome do app, canais de suporte que aparecem dentro dele e as URLs das lojas.
AssetsOs oito arquivos gráficos, cada um com tamanho e finalidade próprios.
Estatísticas do AppAcessos por dia, dispositivos, sistemas operacionais e horários de pico.

Integrações

Item do menuO que faz
IntegraçõesOs serviços externos que a plataforma usa, com a marcação do que ainda não foi ligado. Permissão: Screen:SistemaIntegracoes:View
PortaisOs endereços de todos os portais públicos e aplicativos da plataforma. Permissão: Screen:SistemaPortais:View
FornecedoresO cadastro central de fornecedores, usado por compras, contas a pagar, eventos e compliance. Permissão: Screen:SistemaFornecedores:View

Estrutura

Item do menuO que faz
CamposAs perguntas e campos personalizados, com identificador interno que vira coluna em relatório. Permissão: Screen:SistemaCampos:View
TelasA customização do que aparece e em que ordem nas telas que aceitam ajuste. Permissão: Screen:SistemaTelas:View

Dados & Documentos

Item do menuO que faz
Tipos de DocumentosA lista que o formando vê para enviar, com obrigatoriedade, formatos, tamanho e ordem. Permissão: Screen:SistemaTiposDocumento:View
Importador de DadosA importação de planilha com mapeamento de colunas, valores fixos, tradução de valores e preview. Permissão: Screen:SistemaImportador:View

Segurança & API

Item do menuO que faz
Tokens da APIAs credenciais de integração, com scopes, último acesso e o segredo de webhook. Permissão: Screen:Configuracoes:View
Auditoria BancáriaA auditoria de pagamentos do Financeiro, acessível a quem administra. Permissão: Screen:FinanceiroAuditoriaPagamentos:View

WhiteLabel: o app com a marca da empresa

SistemaWhiteLabelVisão Geral

A Visão Geral, com O que muda para seus formandos, Como funciona em três passos, Status nas Lojas, Investimento, Requisitos para solicitar e perguntas frequentes. Depois as Configurações, os Assets e as Estatísticas do App.

  1. Leia a Visão Geral, que é a tela de decisão, e confira os Requisitos para solicitar.
  2. Em Configurações, informe o Nome do App, curto, porque nome longo é cortado embaixo do ícone.
  3. Informe o E-mail de Suporte, o Telefone de Suporte e o WhatsApp de Suporte.
  4. Informe a URL da App Store e a URL do Google Play depois da publicação.
  5. Em Assets, envie os oito arquivos nos tamanhos exatos: Icon e Adaptive Icon em 1024 por 1024, App Icon em 512 por 512, Recurso Gráfico Android em 1024 por 500, Favicon em 48 por 48, Logo em 1024 por 1024, Notification Icon em 96 por 96 e Splash Screen em 1284 por 2778.
  6. Acompanhe o Status nas Lojas enquanto a plataforma gera o build e submete.
  7. Em Estatísticas do App, escolha o período entre 7, 15 e 30 dias e leia Acessos por Dia, Dispositivos, Sistemas Operacionais e Horários de Pico.

O Notification Icon é o que mais volta para correção: ele precisa ser PNG monocromático branco, porque o Android desenha só a silhueta. Ícone colorido vira um quadrado branco na barra de notificação. E imagem menor do que o tamanho pedido é ampliada e sai borrada, o que a loja aponta na revisão.

Os contatos de suporte aparecem dentro do app: um WhatsApp que ninguém lê vira reclamação em loja de aplicativo, que é pública e fica. Sobre prazos, o build sai em até 24 horas depois de configurações e assets enviados, a revisão do Google Play leva de um a três dias e a da App Store de dois a cinco dias úteis.

Integrações, portais e fornecedores

SistemaIntegrações

A tela Integrações, com os serviços e a marcação Não configurada; a tela de Portais, com os endereços de todos os portais e aplicativos; e a lista de Fornecedores, nas colunas Fornecedor, Tipo, Contato, Localização e Status.

  1. Em Integrações, abra o serviço que quer ligar e informe as credenciais fornecidas por ele.
  2. Use a etiqueta Não configurada como lista de trabalho da implantação.
  3. Em Portais, consulte os endereços de cada portal público e aplicativo antes de mandar um link.
  4. Em Fornecedores, clique em Novo Fornecedor.
  5. Informe o Nome Fantasia, a Razão Social, o Tipo ou Categoria e o CNPJ, ou o CPF quando for pessoa física.
  6. Complete contato e localização, e confira antes se o fornecedor já não está cadastrado.

O cadastro de fornecedores é central: ele alimenta compras, contas a pagar, produção de eventos e a due diligence do Compliance. Cadastrar o mesmo fornecedor duas vezes, com grafias diferentes, faz o relatório de gasto por fornecedor deixar de fazer sentido.

Integração não configurada não quebra nada: o recurso simplesmente não aparece ou avisa que está indisponível.

Campos e telas

SistemaEstruturaCampos

A tela de campos customizados, com os conjuntos e a lista de perguntas, e a Customização de Telas, com as telas que aceitam ajuste, como Detalhes do Formando e Detalhes da Turma.

  1. Em Campos, crie a pergunta com o Enunciado, o Texto de ajuda e o Grupo.
  2. Informe o Identificador interno e o Tipo, e as Opções quando for seleção.
  3. Em Telas, escolha a tela e ajuste o que aparece e em que ordem.
  4. Deixe em primeiro lugar o que a equipe realmente usa todos os dias.
  5. Antes de esconder um bloco, confirme que nenhuma área depende dele.

O Identificador interno é o que faz a resposta virar coluna em relatório e em exportação. Trocá-lo depois de já existirem respostas quebra a ligação com o que foi coletado. E a customização de tela vale para todo mundo, não só para você.

Tipos de documento

SistemaDados & DocumentosTipos de Documentos

A tela Tipos de Documentos, nas colunas Ordem, Documento, Obrigatório, Formatos, Tamanho e Status.

  1. Clique em Novo Tipo de Documento e informe o Nome do Documento e a Descrição.
  2. Marque se é obrigatório.
  3. Informe os formatos aceitos e o tamanho máximo.
  4. Defina a ordem, começando pelos documentos fáceis.

Esta tela define o que o formando vê como lista de documentos a enviar. Obrigatório trava o andamento de quem não enviou, restringir formatos evita receber arquivo que ninguém abre e limitar tamanho evita que uma foto de dez megabytes trave o envio em conexão ruim. A ordem é a ordem em que a pessoa vai enviar, e começar pelo fácil aumenta a chance de ela terminar.

Importador de dados

SistemaDados & DocumentosImportador de Dados

A tela Importador de Dados, com o Destino da importação, o bloco Arquivo e Opções, o Mapeamento de Colunas, os Campos com valor fixo, o Mapeamento de Valores e o Preview dos Dados.

  1. Escolha o Destino da importação.
  2. Envie o Arquivo, em xlsx, xls ou csv.
  3. Escolha a Turma e o Status inicial dos formandos, quando for o caso.
  4. No Mapeamento de Colunas, ligue cada Coluna no Arquivo ao Campo no Sistema.
  5. Confira o Status e a Amostra de cada linha do mapeamento.
  6. Use os Campos com valor fixo para o que é igual em todas as linhas.
  7. Use o Mapeamento de Valores, no formato de para, para traduzir conteúdo.
  8. Confira o Preview dos Dados antes de confirmar.

A coluna Amostra evita o erro clássico da importação: ela mostra um valor real do arquivo ao lado do campo escolhido. Se a amostra do campo telefone mostra uma data, o mapeamento está trocado, e dá para ver isso antes de importar. E o mapeamento de valores é o que resolve a planilha que traz M e F quando o sistema espera Masculino e Feminino.

Tokens da API e auditoria bancária

SistemaSegurança & APITokens da API

A tela Tokens da API, com o bloco Guarde estas credenciais, mostrando Client ID, Client Secret, Tenant ID e Segredo de webhook, e a lista nas colunas Nome, Client ID, Scopes, Último acesso e Ativo. E a Auditoria Bancária, que é a auditoria de pagamentos do Financeiro.

  1. Clique em Nova credencial e informe o Nome e a Descrição.
  2. Marque apenas os Scopes necessários àquela integração.
  3. Guarde o Client Secret no cofre da empresa na hora em que ele aparecer.
  4. Entregue o Segredo de webhook a quem recebe as notificações.
  5. Revise a coluna Último acesso periodicamente e desative o que não é mais usado.
  6. Use a Auditoria Bancária para conferir o que aconteceu com dinheiro, sem depender de quem opera o financeiro.

O Client Secret é mostrado uma única vez. Se perder, não há como vê-lo de novo: só resta criar outra credencial. E credencial ativa sem uso é porta aberta sem ninguém olhando.

A auditoria aparece aqui por segregação de funções: quem executa não é quem audita.

Fluxos completos

Do pedido do app à publicação nas lojas

  1. Leia a Visão Geral e confira os requisitos.
  2. Preencha as Configurações com nome curto e os canais de suporte que alguém realmente atende.
  3. Prepare os oito assets nos tamanhos exatos, com o ícone de notificação monocromático branco.
  4. Envie os assets.
  5. Acompanhe o build, que sai em até 24 horas.
  6. Acompanhe o Status nas Lojas durante a revisão.
  7. Depois de publicado, informe as URLs da App Store e do Google Play.
  8. Acompanhe as Estatísticas do App para escolher horário de comunicado.

Da planilha recebida aos dados importados

  1. Limpe a planilha na origem, deixando uma linha de cabeçalho.
  2. Abra o Importador de Dados e escolha o destino.
  3. Envie o arquivo e escolha turma e status inicial, se for o caso.
  4. Faça o mapeamento de colunas conferindo a amostra de cada linha.
  5. Use campos com valor fixo para o que se repete.
  6. Traduza os valores divergentes no mapeamento de valores.
  7. Confira o preview e confirme.
  8. Abra o módulo de destino e confira uma amostra dos registros importados.

Da integração nova à credencial em uso

  1. Levante o que o sistema externo precisa ler ou gravar.
  2. Crie a credencial com nome e descrição que digam para que ela serve.
  3. Marque só os scopes necessários.
  4. Guarde o Client Secret no cofre da empresa na hora.
  5. Configure o segredo de webhook no sistema que vai receber as notificações.
  6. Teste a integração e confira a coluna Último acesso.
  7. Coloque na rotina a revisão periódica das credenciais sem uso.

Erros comuns e o que fazer

SintomaCausa provávelO que fazer
O ícone de notificação virou um quadrado brancoArquivo colorido: o Android usa só a silhueta.Envie o Notification Icon em PNG monocromático branco, 96 por 96.
O nome do app aparece cortado no celularNome longo demais para o espaço embaixo do ícone.Use o nome curto pelo qual a empresa é conhecida.
O relatório de gasto por fornecedor não fechaO mesmo fornecedor cadastrado duas vezes, com grafias diferentes.Unifique o cadastro e pesquise antes de criar um novo.
A resposta do campo sumiu do relatórioO identificador interno foi trocado depois de já existirem respostas.Volte o identificador anterior: é ele que liga a resposta à coluna.
A importação gravou telefone no lugar erradoMapeamento de colunas trocado, sem conferir a amostra.Confira a coluna Amostra ao mapear e use o preview antes de confirmar.
Perdi o Client SecretEle é exibido uma única vez.Crie outra credencial, guarde no cofre e desative a antiga.
Uma área reclamou que um bloco sumiu da telaCustomização de telas aplicada sem consultar quem usa.Reponha o bloco: a mudança vale para todos os usuários.
O formando não consegue enviar o documentoFormato não aceito ou tamanho acima do limite do tipo.Revise formatos e tamanho no tipo de documento.

Perguntas frequentes

Preciso pagar as contas de desenvolvedor das lojas para ter o WhiteLabel?

Não. A anuidade da Apple e a taxa do Google já estão inclusas, e o pagamento do WhiteLabel é único, sem mensalidade nem taxa de manutenção.

Quem já usa o app atual precisa migrar?

Não. O WhiteLabel é uma versão separada: os formandos existentes continuam usando normalmente e os novos baixam o app com a marca da empresa.

Quanto tempo leva da entrega dos assets até a publicação?

Cerca de uma semana. O build sai em até 24 horas, a revisão do Google Play leva de um a três dias e a da App Store de dois a cinco dias úteis.

E se a loja rejeitar o app?

A plataforma ajusta e reenvia sem custo adicional até a publicação ser aprovada.

Uma integração não configurada quebra alguma coisa?

Não. O recurso correspondente simplesmente não aparece ou avisa que está indisponível.

Posso trocar o identificador interno de um campo depois?

Não sem consequência. É ele que liga a resposta à coluna do relatório e da exportação: trocar quebra a ligação com o que já foi coletado.

Como evito importar dado na coluna errada?

Confira a coluna Amostra no mapeamento, que mostra um valor real do arquivo ao lado do campo escolhido, e use o preview antes de confirmar.

Perdi o Client Secret de uma credencial. Consigo ver de novo?

Não. Ele é mostrado uma única vez. Crie outra credencial, guarde no cofre da empresa e desative a antiga.

Por que a auditoria bancária aparece no Sistema se ela é do Financeiro?

Por segregação de funções: quem executa o pagamento não deve ser quem audita. É a mesma tela, acessível a quem administra.

Para onde ir depois

Configurações

Usuários, perfis e permissões de tela. Veja Configurações.

Financeiro

A auditoria de pagamentos na origem. Veja Financeiro.

Formandos

O destino mais comum da importação. Veja Formandos.

Compras e Suprimentos

Quem mais usa o cadastro de fornecedores. Veja Compras e Suprimentos.

Página comercial

O que o recurso entrega, na visão de catálogo. Veja Segurança e LGPD.

Voltar ao índice do manual

Última revisão: 19 de setembro de 2026