# Campanhas de e-mail

> Como a equipe monta e envia um comunicado por e-mail para a comunidade: blocos, público, teste, cota de envios, descadastro, rastreio de aberturas e cliques, e os e-mails que sempre chegam.

**Campanhas** é a área da comunidade onde a equipe escreve um comunicado, escolhe quem recebe e envia por e-mail. Fica na **Administração**, ao lado de Membros e Monetização (`/campaigns`); não é um módulo de espaço.

Toda campanha leva o **nome da comunidade** como remetente, o **e-mail de contato do proprietário** para as respostas, um link para a pessoa **se descadastrar** e o aviso de que a Memberfy mede aberturas e cliques.

## Para que serve

| Comunidade | Campanha |
|---|---|
| Escola | O aviso de que as matrículas da nova turma abriram |
| Associação | O resumo do congresso, para todos os associados |
| Coworking | Um recado só para o grupo dos residentes |
| Mentoria | A novidade para quem tem a tag *Turma de março* |

## Como funciona

### Quem faz o quê

| Quem | O que faz |
|---|---|
| Proprietário e administrador | Tudo: criam o rascunho, conferem o público, enviam o teste e **enviam a campanha** |
| Moderador e financeiro | Veem a área e as campanhas, criam e editam rascunhos, conferem o público e enviam testes para si. **Não enviam** |
| Membro | Não vê a área |

A área aparece em **Administração** para toda a equipe. Quem abre **Nova campanha** sem poder enviar lê o aviso *"Só o owner e os admins enviam campanhas. Você pode escrever o rascunho e enviar testes para si."*

### A campanha

| Campo | Para quê |
|---|---|
| **Nome da campanha** | Só a equipe vê; serve para achar a campanha depois |
| **Assunto** | O assunto do e-mail. `{{nome}}` vira o primeiro nome de cada pessoa |
| **Texto de prévia (opcional)** | A frase que aparece ao lado do assunto na caixa de entrada |
| **Conteúdo** | Os blocos, na ordem em que saem no e-mail |
| **Público** | Quem recebe |

Os blocos são três:

| Bloco | O que leva |
|---|---|
| **Texto** | A mensagem, com formatação. `{{nome}}` também funciona aqui (sem nome, sai *"amigo(a)"*) |
| **Botão** | **Texto do botão** e **Link do botão**, que começa com `https://` |
| **Imagem** | **Endereço da imagem** (começa com `https://`) e **Descrição da imagem**, para quem não vê a figura. A imagem vem de um link: não há envio de arquivo |

Os blocos sobem e descem pelos botões **Subir bloco** e **Descer bloco**. Só o rascunho se edita: uma campanha já enviada não muda e não se exclui.

### O público

Em **Público**, escolha **Todas as pessoas** ou **Escolher o público**: **Grupos**, **Tags** e **Pessoas**, combinados em união. Quem está em mais de um critério recebe **uma vez só**.

A **Prévia do público** (depois de salvar o rascunho) mostra quantas pessoas vão receber e quantas **ficam de fora**, com o motivo: se descadastraram, têm e-mail que não recebe mensagens (bounce permanente) ou marcaram e-mails como spam. Mostra também um exemplo de quem recebe, com o e-mail parcialmente oculto.

- **Só membros da comunidade** entram; perfis apagados ficam de fora.
- Um envio vai para **no máximo 20.000 pessoas**. Acima disso, reduza o público.
- **Quem se descadastrou não volta a um público**: se a equipe tentar incluir essa pessoa na mão, a escolha é recusada. Só a própria pessoa reativa.

### Cota de envios

Para proteger a reputação dos e-mails da comunidade, cada comunidade tem uma **cota de envios**: **2 por dia** e **14 por semana**; o mês é a **soma das semanas**. Cada **envio** a um público conta como um só, seja qual for o tamanho do público. Dia, semana e mês seguem o fuso da comunidade.

- **O teste não conta.**
- A cota aparece nas janelas de enviar e de agendar (*"Cota que sobra depois deste envio"*) e, na lista de campanhas, numa linha discreta (*"Envios que ainda restam: hoje 2, esta semana 14, este mês 60."*).
- Envios agendados, repetidos e automáticos **também contam**, um por envio, no momento em que saem.
- Se o envio estourar qualquer limite, ele é **recusado antes de começar**, dizendo qual limite e quando libera. Nada é enviado pela metade.
- Só o SuperAdmin da Memberfy muda a cota de uma comunidade; owner e admin não editam.

Os envios agendados, repetidos e automáticos também contam na cota, um por envio, no momento em que saem. Ver [Agendar, repetir e acompanhar](#agendar-repetir-e-acompanhar).

### Aberturas e cliques

A Memberfy sempre mede **aberturas** e **cliques** nos links; não dá para desligar. Os números são **somas**, sem nome de ninguém, e aparecem em **Envios**: **Destinatários**, **Entregues**, **Aberturas**, **Cliques**, **Bounces** e **Reclamações**. A abertura é uma **estimativa**: alguns aplicativos de e-mail abrem as mensagens por conta própria. O rodapé do e-mail avisa a pessoa de que a medição existe.

### Descadastro

Todo e-mail de campanha traz um link **Descadastrar-se** (e o botão de cancelar inscrição que os provedores de e-mail mostram). A página *"Gerencie os e-mails que você recebe"* deixa a pessoa escolher, **por comunidade**:

| Escolha | O que muda |
|---|---|
| **Parar de receber comunicados** | Sai das campanhas. Continua recebendo os avisos da comunidade (lembrete de evento, certificado…) |
| **Parar de receber todos os e-mails** | Deixa de receber também os avisos da comunidade. Os e-mails da lista abaixo continuam |

O descadastro vale para o **endereço de e-mail naquela comunidade**; em outra comunidade a pessoa continua recebendo. Um clique no botão do provedor vale como *comunicados*. A pessoa pode voltar pelo link **Mudei de ideia, quero voltar a receber** ou, logado, pelo cartão **E-mails desta comunidade** em **Minha Conta**, que oferece **Receber tudo**, **Bloquear comunicados** e **Bloquear todos os e-mails**.

A aba **Descadastros** mostra a equipe quem pediu para não receber, com o e-mail parcialmente oculto, o alcance (*Sem comunicados* ou *Sem nenhum e-mail*) e a origem (*Link do e-mail*, *Um clique no e-mail* ou *Preferência no perfil*).

### E-mails que sempre chegam

Mesmo com *todos os e-mails* bloqueados, a pessoa continua recebendo: recuperação e troca de senha, aviso de login, códigos de acesso e verificação, recibos de compra e de renovação e avisos legais. O cartão em **Minha Conta** lembra isso.

## Passo a passo

### Criar, testar e enviar

1. Em **Administração**, abra **Campanhas** e clique em **Nova campanha**.
2. Preencha **Nome da campanha** e **Assunto** (e, se quiser, o **Texto de prévia**).
3. Em **Conteúdo**, adicione os blocos (**Adicionar texto**, **Adicionar botão**, **Adicionar imagem**) e escreva.
4. Em **Público**, escolha **Todas as pessoas** ou **Escolher o público**.
5. Clique em **Salvar rascunho** e confira a **Prévia do público**.
6. Clique em **Enviar teste para mim**: o e-mail chega só ao seu endereço, com **[Teste]** no assunto, e não gasta a cota. Há um limite de testes por hora.
7. *Papel: proprietário ou administrador.* Clique em **Enviar agora**. O diálogo *"Enviar esta campanha agora?"* mostra quantas pessoas recebem, quantas ficaram de fora e a cota que sobra. Marque *"Confirmo que estas pessoas são membros da minha comunidade e aceitam receber comunicados."* e confirme em **Enviar agora**.

O envio **não pode ser recolhido**. Os e-mails saem em lotes, então uma comunidade grande leva um tempo para entregar tudo; os números de **Envios** se atualizam à medida que chegam. Os e-mails de campanha não atrasam os de segurança e os de compra.

### Excluir um rascunho

Abra o rascunho e use **Excluir rascunho**. Campanhas já enviadas não se excluem.

## Agendar, repetir e acompanhar

*Papel para agendar, pausar, retomar e cancelar: proprietário ou administrador.* No lugar de **Enviar agora**, **Agendar envio** abre a janela *"Agendar o envio"*, com o **Tipo de envio**:

| Tipo | Quando sai |
|---|---|
| **Uma vez** | Na data e na hora escolhidas |
| **Todo dia** | Todo dia, na hora escolhida |
| **Dias da semana** | Nos dias da semana escolhidos, na hora escolhida |

A data e a hora valem no **fuso da comunidade**, e a hora local se mantém quando muda o horário de verão. Um horário no passado é recusado.

- **A cota é gasta na hora em que o envio sai**, não ao agendar. Cada envio repetido gasta um disparo. Se não houver cota nessa hora, ou se o horário passou mais de 12 horas antes de o envio sair, o envio é **pulado** e registrado, e o proprietário recebe um e-mail avisando (uma vez por envio). Um envio único pulado volta a ser rascunho.
- **A cada envio, o público e o conteúdo são lidos de novo**: quem entrou na comunidade recebe, quem saiu ou se descadastrou não. Os blocos automáticos mostram só o que é novo desde o envio anterior (no primeiro, os últimos 7 dias).
- **Sem nada novo, não envia.** O envio é pulado e registrado como *"Pulado: não havia nada novo para mandar."* Texto, botão e imagem contam como conteúdo, então uma campanha só de texto sempre envia.
- **Pausar** segura o que ainda não saiu e guarda a próxima data; **Retomar** continua só do que faltava; **Cancelar campanha** encerra, e o que já saiu fica enviado. Os estados são *Rascunho*, *Agendada*, *Enviando*, *Enviada*, *Pausada* e *Cancelada*.
- Uma campanha que não é mais rascunho não se edita: use o painel **Envio** para reagendar, pausar ou cancelar.

### Acompanhar os envios

Em **Envios**, cada envio mostra **Destinatários**, **Entregues**, **Aberturas**, **Cliques**, **Bounces** e **Reclamações** (e os descadastros), e **Soma de todos os envios** junta tudo. **São só números**: nenhum nome nem e-mail de ninguém. Um envio pulado mostra o motivo. **Ver como a pessoa recebe** abre o e-mail como ele sairia agora, sem enviar nem gastar cota.

## Blocos com o conteúdo da comunidade

Além de **Texto**, **Botão** e **Imagem**, o e-mail aceita blocos que puxam o conteúdo da própria comunidade:

| Grupo | Bloco | O que mostra |
|---|---|---|
| **Conteúdo automático** | **Últimas publicações** | De 1 a 10 publicações, de um espaço ou de todos os espaços abertos |
| | **Próximos eventos** | De 1 a 10 eventos que começam nos próximos dias (de 1 a 90) |
| | **Cursos novos** | Os cursos publicados desde o envio anterior |
| | **Classificados novos** | Os anúncios novos desde o envio anterior |
| **Conteúdo fixo** | **Um curso**, **Um evento**, **Um produto** | Um cartão com link para o item escolhido (o produto leva à loja) |

Cada bloco aceita um título de seção opcional. O conteúdo é lido **na hora do envio**.

- **Só entra o que todas as pessoas do público podem ver**: conteúdo aprovado e no ar, em espaço e seção abertos a todos os membros (sem plano, grupo ou produto exigido, e não privados). **Nenhum conteúdo pago vai no e-mail.** Um item fixo que nem todos veem é recusado ao salvar; se deixar de ser visível depois, some do e-mail.
- O bloco **Imagem** aceita **Enviar imagem** (JPEG, PNG ou WebP, até 20 MB, reduzida a no máximo 1200 px), **Trocar imagem** e **Remover imagem**; ou o endereço colado.
- Um envio sem nenhum conteúdo é recusado.

## E-mails automáticos

Na aba **Automáticos**, o proprietário e o administrador têm o botão **Nova campanha automática**, que cria uma campanha agendada para todo dia ou para dias da semana. A aba mostra os modelos prontos (como **Atualizações da semana**) e **Suas campanhas recorrentes**. Em **Campanhas**, o envio padrão é o de **uma vez**.

Na aba **Automáticos** ficam e-mails prontos que a plataforma mantém. O primeiro é **Atualizações da semana**: um resumo semanal com **Últimas publicações**, **Cursos novos**, **Próximos eventos** e **Classificados novos** (escolha quais entram).

- **Vem desligado, em toda comunidade.** Nenhuma comunidade manda e-mail em massa sozinha. A equipe toda vê a aba; só o proprietário e o administrador ligam e ajustam.
- Para **Ligar**, a janela pede a confirmação de que vai mandar e-mail em volume, no dia e na hora escolhidos, **sem você apertar nada**. Dá para desligar quando quiser.
- Ajustáveis: dia, hora, assunto, introdução e blocos. **Restaurar padrão** volta tudo e desliga.
- **Semana sem nada novo, não envia.** A introdução sozinha não dispara.
- Respeita descadastros, só traz conteúdo que todos veem, conta na cota e aparece na lista e nos relatórios como qualquer campanha. Não se envia, agenda, edita nem exclui pelas telas comuns.

## Proteção da reputação de envio

- **Cota:** envios agendados, repetidos e automáticos **também contam**, um por envio, quando saem.
- **Primeiros envios:** enquanto a comunidade ainda não concluiu nenhum envio, o público é limitado a **500 pessoas**; acima disso o envio é recusado antes de gastar cota.
- **Pausa automática:** se um envio já passou de 50 e-mails e mais de **5%** voltaram como endereço que não recebe (bounce permanente) ou mais de **0,3%** viraram reclamação de spam, a campanha **pausa sozinha** (e a repetição também), o que falta não sai e os proprietários recebem um e-mail, uma vez. Retomar é decisão do proprietário ou do administrador.

## O que ainda não existe

Ainda não existe: editor visual de arrastar e soltar, segmentação por comportamento (por exemplo, quem não abriu o último e-mail), testes A/B, importar contatos de fora da comunidade e envio por SMS ou WhatsApp.

## Exemplos

**Aviso para uma turma.** A equipe cria *"Aula de abertura"*, escolhe o grupo *Turma de março*, envia o teste, confere que 38 pessoas recebem e 2 ficam de fora (descadastradas) e o proprietário envia.

**Comunicado a todos.** Um recado curto, com um botão para a comunidade, para **Todas as pessoas**. Se for o terceiro envio do dia, a Memberfy recusa antes de começar e diz quando a cota libera.

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| *Dê um nome à campanha.* / *Escreva o assunto.* | Preencha os campos e salve |
| *Todo botão precisa de texto e de um link começando com https://.* | Confira o botão |
| *Escolha ao menos um grupo, tag ou pessoa, ou envie para todas as pessoas.* | Defina o público |
| *O público passa de 20.000 pessoas…* | Reduza o público ou divida em campanhas |
| Limite diário, semanal ou mensal atingido | A mensagem diz qual e quando libera; espere ou fale com a Memberfy |
| A pessoa escolhida na mão é recusada | Ela se descadastrou: só ela pode voltar a receber |
| O botão **Enviar agora** não aparece | Só proprietário e administrador enviam |

## Perguntas frequentes

**A pessoa pode me responder?**
Sim: as respostas vão para o e-mail de contato do proprietário.

**Dá para ver quem abriu?**
Não. Os números são somas, sem nome de ninguém, e as aberturas são uma estimativa.

**Se alguém se descadastrar, perco o contato?**
Só por e-mail de campanha. Os avisos da comunidade continuam, a menos que a pessoa bloqueie todos, e os e-mails de segurança e de compra sempre chegam.

**A cota é por e-mail enviado?**
Não: é por **envio**. Um envio para 5 pessoas e outro para 5.000 gastam um disparo cada.

## Na API

`GET` e `POST /api/campaigns`, `GET`, `PUT` e `DELETE /api/campaigns/{id}` (só rascunho), `POST /api/campaigns/{id}/audience-preview`, `POST /api/campaigns/{id}/test`, `POST /api/campaigns/{id}/send` (corpo `consent: true`, responde `202`), `GET /api/campaigns/quota`, `GET /api/campaigns/opt-outs` e `GET` e `PUT /api/me/email-preferences`. O descadastro público fica em `/api/public/unsubscribe/{token}`. A referência de cada rota entra na página [Referência da API](/api/referencia) quando as campanhas estiverem no ar.

## Relacionados

- [E-mails da plataforma](/notificacoes/emails-da-plataforma)
- [Grupos e organograma](/membros/grupos-e-organograma)
- [Tags](/membros/tags)