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


---

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