# Personalizar Ambiente

{% embed url="<https://drive.google.com/file/d/19Em6PVRs8KZ01xNf8ec9Ed-FncI8k88e/view>" %}

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.&#x20;

#### 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:**&#x20;

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 %}

<figure><img src="/files/M6s9lg1HMBSTaZSyYg8N" alt=""><figcaption></figcaption></figure>

* **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:

<figure><img src="/files/KiNdTjVrkDuJQzk1r1R9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/aFL0h4wj1tj3XT9Omg8P" alt=""><figcaption></figcaption></figure>

#### 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:**&#x20;

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 %}

<figure><img src="/files/4wdnEMlSmQV3dLoZJCkN" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/jtICeGJ7sdOWgDaY1uSP" alt=""><figcaption></figcaption></figure>

#### 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**.

<figure><img src="/files/8cGBF4XHeVEujdOZvZwr" alt=""><figcaption></figcaption></figure>

#### 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

<figure><img src="/files/FnKccipNlnHSTw6sprhp" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="/files/IDwJ2GP0DoBRgsi9Fmrg" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="/files/GZEyQSQplsWpkNGKo2Mc" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="/files/5w2u798T5rUK15lm0JIC" alt=""><figcaption></figcaption></figure>

#### 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helena.app/configurando-sua-plataforma/configuracao-inicial/personalizar-ambiente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
