> For the complete documentation index, see [llms.txt](https://digitalsac.gitbook.io/digicrm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digitalsac.gitbook.io/digicrm/digicrm/operacao-uso-do-sistema/configuracoes/comunicados.md).

# Comunicados

### Comunicados

**Finalidade:** enviar e gerenciar comunicados/notificações internas para usuários e grupos (escopo tenant ou global), com acompanhamento de leitura.

**Caminho:** Configurações → **Comunicados** (`/configuracoes/comunicados`)

**Código:** `ConfiguracoesComunicados.vue`, `comunicados/ModalCriarComunicado.vue`, `comunicados/ModalGruposComunicados.vue`\
**i18n:** `comunicados.*`

\[\[FOTO]]

***

#### Permissões / licença

| Requisito | Valor                     |
| --------- | ------------------------- |
| Menu      | Admin (`adminOnly: true`) |
| Licença   | **FREE**                  |

***

#### Lista

**Modos:** lista / cards.\
**Filtros:** busca, escopo (global/tenant), tenant (quando aplicável), tipo.

**Colunas:**

| Coluna        | Descrição                           |
| ------------- | ----------------------------------- |
| Título        | Título do comunicado                |
| Escopo        | Global ou Tenant (Master)           |
| Tipo          | Tipo da notificação                 |
| Prioridade    | Baixa / Normal / Alta / Crítica     |
| Destinatários | Contagem                            |
| Enviado em    | Data/hora                           |
| Criador       | Autor                               |
| Ações         | Detalhe, status de leitura, excluir |

**Ações do hero:** Gerenciar grupos / Novo comunicado.

\[\[FOTO]]

***

#### Criar comunicado (`ModalCriarComunicado`) — stepper

**Passo 1 — Conteúdo**

| Campo           | Descrição                            |
| --------------- | ------------------------------------ |
| Título          | Obrigatório                          |
| Escopo          | `global` \| `tenant`                 |
| Tipo            | Select                               |
| Prioridade      | low / normal / high / critical       |
| Exibir no login | `showOnLogin`                        |
| Exige ciência   | `requiresAcknowledgement`            |
| Expira em       | `expiresAt` (opcional)               |
| Conteúdo HTML   | Editor + preview                     |
| Anexos          | Upload com validação de tipo/tamanho |

**Passo 2 — Destinatários**

| Campo    | Descrição                            |
| -------- | ------------------------------------ |
| Grupos   | Multi-select de grupos de comunicado |
| Usuários | Busca + selecionar todos / limpar    |

**Passo 3 — Revisão e envio**

Resumo de escopo, flags, anexos e contagens; botão **Enviar**.

\[\[FOTO]]

***

#### Detalhe e status

* **Detalhe:** conteúdo, destinatários, data de envio.
* **Status:** totais (total / lidas / não lidas / ciente); abas todos / não lidas / lidas; origem via grupo quando houver.

**Grupos:** modal dedicado para CRUD de grupos de destinatários.

***

#### Regras

* Comunicados com “exige ciência” pedem acknowledgement do usuário.
* Escopo **global** tipicamente exige visão Master/multi-tenant nos filtros.