Personalizar Ambiente
Aprenda a configurar a identidade do seu ambiente, definindo nomes, regras gramaticais e a aparência da tela de login do seu negócio.
A tela de Personalizar permite que você ajuste as configurações globais da plataforma para que ela reflita a marca e as necessidades do seu negócio.
Passo 1: Acessar a Tela de Personalização
No menu superior da plataforma, clique no botão Admin
No menu suspenso, selecione a opção Personalizar.
Passo 2: Configurações da Plataforma (Aba Detalhes)
Na aba Detalhes, você definirá como o sistema "fala" o nome da sua empresa e quais canais estarão disponíveis. Abaixo explicamos cada campo disponível nesta seção:
1. Permissões e Canais
Permitir demonstração: Ao marcar esta opção, um botão para "Criar conta de demonstração" será habilitado na tela de login do seu ambiente. Isso permite que leads criem contas de teste automaticamente.
⚠️ Pré-requisito Obrigatório:
Para que a criação de contas de demonstração funcione, você precisa ter um canal de demonstração conectado no seu ambiente de parceiro.
Vá até Admin -> Canais e certifique-se de que existe um canal configurado e ativo para este fim. Sem isso, a criação da conta falhará.

Ativar canal não oficial (Integrado): Habilita o uso de canais não oficiais (via QR Code) gerenciados diretamente pela plataforma Helena.
Ativar canal não oficial (Conta Própria): Permite que o cliente conecte seu próprio número de WhatsApp não oficial (via QR Code) utilizando sua própria instância.
Observação Importante: Pelo menos uma dessas opções deve estar marcada para que a funcionalidade "Canal não oficial" fique disponível no plano da conta, permitindo a conexão de números.
2. Identidade e Gramática (Nomenclatura)
O sistema utiliza os campos abaixo para garantir que as mensagens automáticas e notificações enviadas pela plataforma tenham a concordância gramatical correta ao se referir à sua empresa.
Preencha conforme o gênero do nome da sua marca:
Nome: O nome da sua empresa (Ex:
Helena).Nome com artigo: Usado quando o sistema precisa dizer "A [Empresa]" (Ex:
A Helena).Nome com artigo de localização: Usado para indicar "na [Empresa]" (Ex:
na Helena).Nome com artigo de posse: Usado para indicar "da [Empresa]" (Ex:
Da Helena).
💡 Dica de Preenchimento: Se sua empresa se chama "Olimpo" (masculino), você preencheria:
Nome: Olimpo
Artigo: O Olimpo
Localização: no Olimpo
Posse: do Olimpo
3. Personalização da Tela de Login
Aqui você define os textos que aparecerão na tela de acesso para seus usuários e clientes.
Título no login: O texto de destaque que aparece à direita na tela de login.
Descrição no login: Um subtítulo ou frase de boas-vindas que aparece logo abaixo do título.
Visualização do Resultado: Os textos configurados acima aparecerão na área destacada da tela de login, conforme o exemplo abaixo:


Passo 3: Definir Valores dos Aplicativos (Aba Apps)
Na aba "Apps", você configura a precificação das integrações e módulos adicionais que sua plataforma oferece.
O objetivo desta configuração é dar transparência ao seu cliente sobre o custo para ativar cada funcionalidade extra.
1. Configurando os Preços
Na tela de Personalizar, clique na aba "Apps".
Você verá uma lista com os aplicativos disponíveis para integração.
No campo ao lado de cada aplicativo, insira o valor mensal (em Reais) que você deseja cobrar do seu cliente para que ele utilize aquela ferramenta.
Exemplo: Se você deseja cobrar R$ 99,00 pelo uso do CRM, digite
99.00no campo correspondente.
2. Visualização do Cliente
O valor que você configurar acima será exibido diretamente na tela de Apps do seu cliente.
Quando o cliente acessar o menu de aplicativos para ativar uma nova integração, ele verá o preço destacado no card do aplicativo, deixando claro o valor da contratação adicional.
Dica de Negócio:
Utilize essa área para destacar o valor dos seus serviços agregados. Se um app faz parte do pacote padrão e não tem custo extra, você pode deixar o valor zerado ou ajustar conforme sua estratégia comercial.


Passo 4: Identidade Visual (Aba Imagens)
Na aba "Imagens", você fará o upload dos logotipos e ícones que substituirão a marca padrão da plataforma. Isso garante que, ao acessar o sistema, seu cliente veja apenas a sua marca.
1. Como Alterar
Na tela de Personalizar, clique na aba "Imagens".
Para cada campo, clique no botão de "Upload" (ou no ícone de nuvem/pasta) para selecionar o arquivo no seu computador.
Certifique-se de que as imagens estejam em boa resolução e, preferencialmente, com fundo transparente para um acabamento profissional.
2. Salvar e Conferir
Após carregar todas as imagens:
Clique no botão Salvar no canto inferior direito.
Atualize a página (F5) para ver a nova identidade visual aplicada.
Faça logoff (sair da conta) momentaneamente para conferir como ficou a personalização na tela de login.

Passo 5: Centralizando o Suporte e Documentação (Aba Documentação)
Nesta etapa, você define para onde seus clientes serão direcionados quando precisarem de ajuda. Essa configuração é fundamental para manter o atendimento centralizado nos seus canais oficiais ou na sua própria base de conhecimento, garantindo que a experiência do usuário permaneça dentro do seu ecossistema

1. Configurando o Link de Ajuda
O "Link de Suporte" é o destino para onde o usuário será levado ao buscar auxílio proativo na plataforma.
O que preencher: No campo "Link de suporte", insira a URL completa (com
https://) do canal que você deseja que o cliente acesse.Exemplos de uso:
Sua Central de Ajuda própria (ex:
https://ajuda.suaempresa.com.br).Um link direto para o WhatsApp do seu time de suporte (ex:
https://wa.me/5511999999999).Um formulário de abertura de chamados (tickets).
Como isso aparece para o cliente?
Ao salvar essa configuração, a ação será ativada no botão "Preciso de ajuda" (localizado no menu de usuário ou no ícone de interrogação ? no canto superior direito). Ao clicar ali, o cliente será redirecionado automaticamente para o link definido em uma nova aba.

2. Configurando o Número de Suporte
Este campo é utilizado nos avisos do sistema.
Para que serve: O sistema utiliza este número para preencher automaticamente o botão de ação em avisos padrão do sistema, como o aviso de bloqueio ou suspensão.
Como funciona: Quando um aviso padrão do sistema é exibido, ele utiliza o número cadastrado aqui para gerar uma "URL de direcionamento" (geralmente um link de WhatsApp), permitindo que o cliente bloqueado entre em contato rapidamente com sua equipe para regularizar a situação.

Passo 6: Integrações e API de Parceiro (Aba Integração)
A aba Integração é destinada a desenvolvedores e gestores que precisam conectar a plataforma Helena a sistemas externos (como ERPs ou ferramentas de automação) via API. Aqui, você gera as credenciais de "Super Usuário" (Parceiro).
1. Criando um Token de Parceiro
Diferente das integrações comuns, o token gerado nesta tela possui permissões de nível de parceiro.
Como criar: Clique no botão roxo "Criar Token". O sistema irá gerar um novo registro na lista abaixo.
Gerenciamento: Na tabela exibida, você pode visualizar o Nome, o Token (que geralmente começa com o prefixo
pn_) e a data de criação. Use o ícone de copiar (folhas sobrepostas) ao lado do token para levá-lo ao seu código ou sistema externo.
2. Aplicação e Uso Técnico
Este token é a chave de acesso exclusiva para os endpoints de Contas e Parceiros, permitindo ações administrativas globais via API.
Onde é obrigatório: Você precisará deste token para acessar as rotas listadas na seção "CORE" da documentação, especificamente nas abas Contas e Parceiros (ex: extrair o Relatório de faturamento).
Como autenticar: Nas requisições, o token deve ser enviado no
headerAuthorization utilizando o esquemaBearer.Exemplo de uso: Para criar, suspender ou editar clientes de forma programática, o sistema validará se este Token de Parceiro foi enviado corretamente, garantindo a segurança da operação.

Passo 7: Salvar Alterações
Após preencher todos os campos desejados, clique no botão Salvar localizado no canto inferior direito da tela para aplicar as mudanças.
Atualizado