# Avisos de novidade por e-mail

> Como a equipe avisa por e-mail, ao publicar, quem tem acesso ao espaço (evento, post, curso, download, produto na loja, chamada de trabalhos aberta e pesquisa), com a caixa Avisar por e-mail e a contagem de pessoas, a espera de 10 minutos, uma vez por item, nunca em data retroativa e no máximo 3 avisos por pessoa por dia.

Quando a equipe publica algo novo num espaço, quem tem acesso a ele recebe **um e-mail** com o título e o botão para abrir no app. Assim a pessoa que não entra todo dia fica sabendo do evento, do curso ou da chamada a tempo, sem a equipe montar uma campanha à mão (e sem gastar a cota de campanhas).

## O que avisa

| Ao… | Categoria do membro |
|---|---|
| Criar um evento futuro (evento não tem rascunho: criar é publicar) | **Eventos** |
| Publicar um post num espaço de Conteúdo (ou uma enquete de Conteúdo) | **Posts e conteúdos** |
| Publicar um curso pela primeira vez | **Cursos** |
| Publicar um download pela primeira vez | **Downloads e materiais** |
| Publicar um produto que aparece numa loja | **Novidades da loja** |
| Abrir uma chamada de trabalhos pela primeira vez | **Chamadas de trabalhos** |
| Abrir uma pesquisa (o convite) | **Pesquisas** |

**Não avisam** por item: post curto do Feed, classificado, foto da galeria, aula nova e comentário. São frequentes demais ou de membro; entram no [resumo semanal](/notificacoes/campanhas-de-email), se a comunidade o ligou.

## A caixa Avisar por e-mail

Ao publicar um desses itens, a equipe (proprietário, administrador e moderador, conforme o módulo) vê a caixa **Avisar por e-mail · N pessoas**, **marcada por padrão**. O número já desconta quem desligou a categoria e quem publica. Abaixo, *"O aviso sai 10 minutos depois, para quem tem acesso e deixou a categoria ligada."*

- **Desmarcada**, *"Ninguém recebe e-mail desta publicação, e ela não avisa depois."* Serve para uma correção ou um teste. Desmarcar não muda a preferência de ninguém.
- Ao publicar, uma mensagem confirma: *"Aviso por e-mail para N pessoas em 10 min."*
- Conteúdo publicado por um **membro** nunca avisa, e a caixa não aparece para ele.

## As regras

- **A preferência do membro sempre vence.** Só recebe quem tem a categoria ligada em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade). Todas vêm ligadas.
- **Quem recebe:** o membro ativo que tem acesso ao espaço e ao item, pela mesma regra que decide o que ele vê no app ([Visibilidade e acesso](/conceitos/visibilidade-e-acesso)). Quem publicou não recebe.
- **Entrada paga.** Numa comunidade com entrada paga, um post só para membros não avisa quem ainda espera a entrada ser liberada, porque essa pessoa não consegue abri-lo.
- **Espera de 10 minutos.** O aviso sai 10 minutos depois de publicar. Na hora de sair, ele confere que o item continua publicado e não foi apagado, usa o título dessa hora e confere de novo a preferência. Publicou por engano e apagou antes? Nenhum e-mail sai.
- **Uma vez por item.** Editar, mudar a data, despublicar e publicar de novo, fechar e reabrir a chamada: nada reenvia. A mensagem diz *"Este item já teve o seu aviso por e-mail; nada foi enviado de novo."*
- **Nunca no passado.** Post com data retroativa, conteúdo importado e evento que já passou não avisam; a caixa nem aparece.
- **Moderação.** Um item que espera aprovação só avisa quando é aprovado, se a caixa estava marcada.
- **No máximo 3 avisos por pessoa por dia** na mesma comunidade. Passou disso, o aviso não sai para aquela pessoa (o item continua no resumo semanal). Não gasta a cota de campanhas.
- **Privacidade.** A equipe vê só o número de pessoas, nunca quem desligou o quê. O e-mail mostra só o que o item mostra a quem tem acesso.

O e-mail sai no idioma de cada pessoa (ou no da comunidade), com as datas no fuso da comunidade e a cor dela, e traz no rodapé o descadastro de um clique daquela categoria. Ver [E-mails desta comunidade › Descadastro de um clique](/notificacoes/emails-desta-comunidade#descadastro-de-um-clique).

## Exemplo

A coordenadora abre a chamada de trabalhos do encontro anual com a caixa marcada (**Avisar por e-mail · 1.240 pessoas**). Dez minutos depois, 1.240 membros com acesso ao espaço recebem o e-mail com o título e o prazo. Ela corrige o título no dia seguinte: nenhum e-mail novo. Quem clica em **Não quero mais avisos de Chamadas de trabalhos** continua recebendo os de eventos.

## Pelo assistente (MCP)

As ferramentas de publicar aceitam `notify_by_email` (padrão ligado, como no app) e devolvem `email_notice` com `scheduled`, `recipient_count` e, quando não sai, o motivo: `create_event`, `create_post`, `create_poll` (em Conteúdo), `update_course`, `update_download_item`, `publish_product`, `update_call_status` e `open_survey`. `get_email_notice_recipient_count` dá o "N pessoas vão receber" antes de publicar. Ver [Ferramentas · Comunidade](/mcp/ferramentas-comunidade#get-email-notice-recipient-count).

## Na API

As rotas de publicar aceitam `notifyByEmail` (padrão `true`) e respondem com `emailNotice` (`scheduled`, `recipientCount`, `reason`). `GET /api/content-notices/recipient-count?type=…` conta quem vai receber (por `itemId`, ou por `spaceId` antes de o item existir), para a equipe que publica naquele módulo.

## Relacionados

- [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)
- [E-mails da plataforma](/notificacoes/emails-da-plataforma)
- [Campanhas de e-mail](/notificacoes/campanhas-de-email)