> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/configurando-sua-plataforma/configuracao-inicial/personalizar-ambiente.md). # Personalizar Ambiente {% embed url="" %} 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 1. No menu superior da plataforma, clique no botão **Admin** 2. 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. {% hint style="warning" %} ⚠️ **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á. {% endhint %}
* **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. {% hint style="warning" %} **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. {% endhint %} **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`). {% hint style="success" %} 💡 **Dica de Preenchimento:** Se sua empresa se chama "Olimpo" (masculino), você preencheria: Nome: `Olimpo` Artigo: `O Olimpo` Localização: `no Olimpo` Posse: `do Olimpo` {% endhint %} **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** 1. Na tela de Personalizar, clique na aba **"Apps".** 2. Você verá uma lista com os aplicativos disponíveis para integração. 3. 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.00` no 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. {% hint style="success" %} **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. {% endhint %}
#### 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** 1. Na tela de Personalizar, clique na aba **"Imagens".** 2. Para cada campo, clique no botão de **"Upload"** (ou no ícone de nuvem/pasta) para selecionar o arquivo no seu computador. 3. 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: 1. Clique no botão **Salvar** no canto inferior direito. 2. Atualize a página (F5) para ver a nova identidade visual aplicada. 3. 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 `header` **Authorization** utilizando o esquema `Bearer`. * *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.