> 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/contas-e-planos/avisos/criacao-de-avisos-personalizados.md).

# Criação de Avisos Personalizados

{% embed url="<https://drive.google.com/file/d/1awcCg4hUp4pK3UU9eI4Xwi5cA23gavpF/view>" %}

A ferramenta de **Avisos Personalizados** foi desenvolvida para dar autonomia à sua comunicação. Com ela, você pode criar alertas proativos para manter seus usuários informados sobre manutenções programadas, novidades na plataforma ou avisos administrativos.

O sistema permite segmentar o público (definindo quais perfis ou contas específicas visualizarão a mensagem) e escolher o formato ideal de impacto, seja através de uma **faixa de alerta** discreta no topo ou um **modal (pop-up)** de destaque.

{% hint style="success" %}
**Pré-requisito:**

Possuir acesso de Super Administrador na conta.
{% endhint %}

#### Como criar um Aviso do Tipo Faixa (Barra de Alerta)

*Ideal para avisos rápidos e curtos, exibidos no topo da tela.*

**Passo 1: Iniciar**

1. No menu principal, navegue até **Admin** e clique em **Avisos personalizados**.
2. Na tela de listagem, clique no botão + Novo (canto superior direito).

**Passo 2: Configuração Inicial**

* Nome: Insira uma identificação interna para o aviso.
* Situação: Defina como Ativo para que fique visível ou Inativo para rascunho.

**Passo 3: Configurar a Faixa**

1. No tipo de exibição, selecione Faixa de alerta.
2. Preencha os campos obrigatórios:
   * Texto: A mensagem curta que aparecerá na barra.
   * Cor da faixa: Escolha a cor de fundo (ex: vermelho para urgência, azul para info).
   * Botão de ação: (Opcional) Adicione um link se necessário.

**Passo 4: Definir o Público (Segmentação)**

* Perfis: Marque os níveis de acesso.

{% hint style="warning" %}
**Regras de Exibição e Hierarquia**

Ao selecionar um perfil inferior (ex: Atendente), o sistema habilita automaticamente os superiores (Admin e Super Admin).
{% endhint %}

* Contas: Escolha entre Todas as contas ou use Selecionar contas para escolhas pontuais.

**Passo 5: Publicação**

* Programar data (Opcional): Defina Data de Início e Fim se quiser agendar.
* Concluir: Clique em Salvar.

{% hint style="warning" %}
**Publicação Imediata**

Se salvo como "Ativo" sem agendamento, o modal aparecerá na tela dos usuários imediatamente.
{% endhint %}

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

#### Como criar um Aviso do Tipo Modal (Pop-up)

*Ideal para comunicados detalhados, com imagens e textos longos.*

**Passo 1: Iniciar**

1. No menu principal, navegue até **Admin** e clique em **Avisos personalizados**.
2. Clique no botão + Novo no canto superior direito.

**Passo 2: Configuração Inicial**

* Nome: Defina o nome interno do aviso.
* Situação: Marque como Ativo (visível) ou Inativo.

**Passo 3: Configurar o Modal**

1. No tipo de exibição, selecione Abrir modal.
2. Preencha os detalhes do comunicado:
   * **Título:** A chamada principal do aviso.
   * **Texto:** O conteúdo detalhado da mensagem.
   * **Imagem:** (Opcional) Adicione um visual para ilustrar.
   * **Botão:** (Opcional) Inclua um link de redirecionamento.

{% hint style="warning" %}
**Nota sobre Carrossel**

Caso o usuário tenha múltiplos modais ativos para visualizar, o sistema os exibirá em sequência (carrossel).
{% endhint %}

**Passo 4: Definir o Público (Segmentação)**

* Perfis: Selecione quem deve ver o pop-up.

{% hint style="warning" %}
**Regras de Exibição e Hierarquia**

Ao selecionar um perfil inferior (ex: Atendente), o sistema habilita automaticamente os superiores (Admin e Super Admin).
{% endhint %}

* Contas: Defina se será para Todas as contas ou contas específicas.

**Passo 5: Publicação**

* Programar data (Opcional): Use esta opção para exibir o aviso apenas durante um período específico.
* Concluir: Clique em Salvar.

{% hint style="warning" %}
**Publicação Imediata**

Se salvo como "Ativo" sem agendamento, o modal aparecerá na tela dos usuários imediatamente.
{% endhint %}

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

#### Regras de exibição dos avisos.

**Modal (Carrosel)**

Quando houver mais de um aviso ativo simultaneamente, o sistema os exibirá automaticamente em formato de carrossel. Confira as regras de comportamento:

* **Ordem de Prioridade:** A exibição segue a ordem decrescente de ativação. Ou seja, o aviso ativado mais recentemente será o primeiro a aparecer para o usuário.
* **Fechamento em lote:** Se o usuário navegar até a última página do carrossel e fechar a janela, o sistema considerará todos os avisos daquela sequência como "lidos" e não os exibirá novamente.
* **Fechamento parcial:** Se fechar a janela no meio da navegação (ex: no 2º aviso), os avisos seguintes que não foram vistos continuarão aparecendo individualmente até serem fechados.
* **Redirecionamento (Botão):** Caso o aviso possua um botão de ação configurado, o link de destino será aberto sempre em uma **nova aba** do navegador, mantendo a plataforma aberta na guia original.

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

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

**Faixa de Alerta**

Caso existam múltiplos avisos do tipo "Faixa" ativos simultaneamente, o sistema gerenciará a exibição de forma rotativa. Confira as regras de comportamento:

* **Ordem de Prioridade:** A exibição segue a ordem decrescente de ativação. O aviso ativado mais recentemente será o primeiro a ser apresentado no topo da tela.
* **Redirecionamento (Botão):** Se o aviso contiver um Botão de Ação, o clique abrirá o link de destino sempre em uma **nova aba** do navegador, mantendo a plataforma aberta na guia original.
* **Exibição Persistente (Avisos Fixos):** Faixas configuradas **sem** a opção de fechar permanecerão fixas no topo da plataforma. Elas só desaparecerão quando o prazo de exibição expirar ou se forem inativadas manualmente pelo administrador.

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

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

#### **Comportamento de Reexibição**

Uma vez fechado pelo usuário, o aviso será considerado "lido" apenas na sessão atual. Ele voltará a ser exibido automaticamente nas seguintes condições:

* **Limpeza de Cache:** Se os dados de navegação/cache da plataforma forem limpos.
* **Novo Acesso:** Se o usuário realizar logout e fizer login novamente.
* **Nova Sessão:** Se a plataforma for aberta em uma nova aba ou janela do navegador.

#### **Exclusão de Avisos**

Caso um aviso não seja mais necessário e você não pretenda reutilizá-lo no futuro, é possível removê-lo permanentemente da listagem.

1. Na lista de avisos, clique sobre o aviso desejado para abrir o painel de detalhes.
2. No topo do painel lateral, clique no botão **Excluir**.
3. Uma janela de confirmação será exibida. Leia atentamente e clique em **Excluir** para confirmar.

⚠️ **Atenção:** Esta ação é **irreversível**. Ao excluir um aviso, todos os dados de visualização e configurações serão removidos permanentemente do sistema e não poderão ser recuperados.

{% hint style="warning" %}
**Restrição de Edição**

Após salvar o registro, o **Tipo de Exibição** torna-se imutável. Não é possível converter uma Faixa de Alerta em Modal (ou vice-versa). Caso precise alterar o formato, será necessário criar um novo aviso.
{% endhint %}
