# Campagne e-mail

> Come il team prepara e invia un comunicato via e-mail alla community: blocchi, pubblico, test, quota di invii, disiscrizione, misurazione di aperture e clic, e le e-mail che arrivano sempre.

**Campagne** è l'area della community in cui il team scrive un comunicato, sceglie chi lo riceve e lo invia via e-mail. Si trova in **Amministrazione**, accanto a Membri e Monetizzazione (`/campaigns`); non è un modulo di spazio.

Ogni campagna porta come mittente il **nome della community**, l'**e-mail di contatto del proprietario** per le risposte, un link per **disiscriversi** e l'avviso che Memberfy misura aperture e clic.

## A cosa serve

| Community | Campagna |
|---|---|
| Scuola | L'avviso che le iscrizioni della nuova classe sono aperte |
| Associazione | Il riepilogo del congresso, per tutti i soci |
| Coworking | Un messaggio solo per il gruppo dei residenti |
| Mentorship | La novità per chi ha il tag *Classe di marzo* |

## Come funziona

### Chi fa cosa

| Chi | Cosa fa |
|---|---|
| Proprietario e amministratore | Tutto: creano la bozza, controllano il pubblico, inviano il test e **inviano la campagna** |
| Moderatore e finanza | Vedono l'area e le campagne, creano e modificano bozze, controllano il pubblico e inviano test a sé stessi. **Non inviano** |
| Membro | Non vede l'area |

L'area compare in **Amministrazione** per tutto il team. Chi apre **Nuova campagna** senza poter inviare legge *"Solo owner e admin inviano le campagne. Puoi scrivere la bozza e inviare test a te stesso."*

### La campagna

| Campo | A cosa serve |
|---|---|
| **Nome della campagna** | Lo vede solo il team; serve a ritrovare la campagna dopo |
| **Oggetto** | L'oggetto dell'e-mail. `{{nome}}` diventa il nome di ciascuna persona |
| **Testo di anteprima (facoltativo)** | La frase che compare accanto all'oggetto nella casella di posta |
| **Contenuto** | I blocchi, nell'ordine in cui escono nell'e-mail |
| **Pubblico** | Chi la riceve |

I blocchi sono tre:

| Blocco | Cosa contiene |
|---|---|
| **Testo** | Il messaggio, con formattazione. `{{nome}}` funziona anche qui (senza nome, esce *"amico/a"*) |
| **Pulsante** | **Testo del pulsante** e **Link del pulsante**, che inizia con `https://` |
| **Immagine** | **Indirizzo dell'immagine** (inizia con `https://`) e **Descrizione dell'immagine**, per chi non vede la figura. L'immagine arriva da un link: non c'è caricamento di file |

I blocchi salgono e scendono con i pulsanti **Sposta il blocco su** e **Sposta il blocco giù**. Si modifica solo la bozza: una campagna già inviata non cambia e non si elimina.

### Il pubblico

In **Pubblico**, scegli **Tutte le persone** o **Scegli il pubblico**: **Gruppi**, **Tag** e **Persone**, combinati in unione. Chi rientra in più criteri la riceve **una sola volta**.

L'**Anteprima del pubblico** (dopo aver salvato la bozza) mostra quante persone la riceveranno e quante **restano fuori**, con il motivo: si sono disiscritte, hanno un'e-mail che non riceve messaggi (rimbalzo permanente) o hanno segnalato e-mail come spam. Mostra anche un esempio di chi la riceve, con l'e-mail parzialmente nascosta.

- **Entrano solo i membri della community**; i profili eliminati restano fuori.
- Un invio va a **al massimo 20.000 persone**. Oltre, riduci il pubblico.
- **Chi si è disiscritto non torna in un pubblico**: se il team prova a includerlo a mano, la scelta viene rifiutata. Solo la persona stessa può riattivarsi.

### Quota di invii

Per proteggere la reputazione delle e-mail della community, ogni community ha una **quota di invii**: **2 al giorno** e **14 alla settimana**; il mese è la **somma delle settimane**. Ogni **invio** a un pubblico conta come uno, qualunque sia la dimensione del pubblico. Giorno, settimana e mese seguono il fuso orario della community.

- **Il test non conta.**
- La quota compare nelle finestre di invio e di programmazione (*"Quota rimasta dopo questo invio"*) e, nell'elenco delle campagne, in una riga discreta (*"Invii rimasti: 2 oggi, 14 questa settimana, 60 questo mese."*).
- Anche gli invii programmati, ripetuti e automatici **contano**, uno per invio, quando escono.
- Se l'invio superasse un limite, viene **rifiutato prima di iniziare**, indicando quale limite e quando si libera. Nulla viene inviato a metà.
- Solo il SuperAdmin di Memberfy cambia la quota di una community; owner e admin non la modificano.

### Aperture e clic

Memberfy misura sempre **aperture** e **clic** sui link; non si può disattivare. I numeri sono **somme**, senza il nome di nessuno, e compaiono in **Invii**: **Destinatari**, **Consegnate**, **Aperture**, **Clic**, **Rimbalzi** e **Segnalazioni**. L'apertura è una **stima**: alcune app di posta aprono i messaggi da sole. Il piè di pagina dell'e-mail avvisa la persona che la misurazione esiste.

### Disiscrizione

Ogni e-mail di campagna porta un link **Annulla l'iscrizione** (e il pulsante di annullamento che i provider di posta mostrano). La pagina *"Gestisci le e-mail che ricevi"* lascia scegliere alla persona, **per community**:

| Scelta | Cosa cambia |
|---|---|
| **Non ricevere più comunicazioni** | Esce dalle campagne. Continua a ricevere gli avvisi della community (promemoria di evento, certificato…) |
| **Non ricevere più nessuna e-mail** | Smette di ricevere anche gli avvisi della community. Le e-mail dell'elenco qui sotto continuano ad arrivare |

La disiscrizione vale per l'**indirizzo e-mail in quella community**; in un'altra community la persona continua a ricevere. Un clic sul pulsante del provider vale come *comunicazioni*. La persona può tornare con il link **Ho cambiato idea, voglio tornare a riceverle** oppure, da loggata, con la scheda **E-mail di questa community** in **Il mio account**, che offre **Ricevi tutto**, **Blocca le comunicazioni** e **Blocca tutte le e-mail**.

La scheda **Disiscrizioni** mostra al team chi ha chiesto di non ricevere, con l'e-mail parzialmente nascosta, la portata (*Senza comunicazioni* o *Nessuna e-mail*) e l'origine (*Link dell'e-mail*, *Un clic nell'e-mail* o *Preferenza nel profilo*).

### E-mail che arrivano sempre

Anche con *tutte le e-mail* bloccate, la persona continua a ricevere: recupero e cambio password, avviso di accesso, codici di accesso e verifica, ricevute di acquisto e di rinnovo e avvisi legali. La scheda in **Il mio account** lo ricorda.

## Passo dopo passo

### Creare, provare e inviare

1. In **Amministrazione**, apri **Campagne** e clicca **Nuova campagna**.
2. Compila **Nome della campagna** e **Oggetto** (e, se vuoi, il **Testo di anteprima**).
3. In **Contenuto**, aggiungi i blocchi (**Aggiungi testo**, **Aggiungi pulsante**, **Aggiungi immagine**) e scrivi.
4. In **Pubblico**, scegli **Tutte le persone** o **Scegli il pubblico**.
5. Clicca **Salva bozza** e controlla l'**Anteprima del pubblico**.
6. Clicca **Inviami un test**: l'e-mail arriva solo al tuo indirizzo, con **[Prova]** nell'oggetto, e non consuma la quota. C'è un limite di test all'ora.
7. *Ruolo: proprietario o amministratore.* Clicca **Invia ora**. Il dialogo *"Inviare ora questa campagna?"* mostra quante persone ricevono, quante sono rimaste fuori e la quota rimasta. Spunta *"Confermo che queste persone sono membri della mia community e accettano di ricevere comunicazioni."* e conferma con **Invia ora**.

L'invio **non può essere ritirato**. Le e-mail escono a lotti, quindi una community grande impiega un po' a consegnare tutto; i numeri di **Invii** si aggiornano man mano che arrivano. Le e-mail di campagna non ritardano quelle di sicurezza e di acquisto.

### Eliminare una bozza

Apri la bozza e usa **Elimina bozza**. Le campagne già inviate non si eliminano.

## Programmare, ripetere e seguire gli invii

*Ruolo per programmare, mettere in pausa, riprendere e annullare: proprietario o amministratore.* Al posto di **Invia ora**, **Programma l'invio** apre la finestra *"Programma l'invio"*, con il **Tipo di invio**:

| Tipo | Quando esce |
|---|---|
| **Una volta** | Nella data e all'ora scelte |
| **Ogni giorno** | Ogni giorno, all'ora scelta |
| **Giorni della settimana** | Nei giorni della settimana scelti, all'ora scelta |

Data e ora valgono nel **fuso orario della community**, e l'ora locale resta la stessa quando cambia l'ora legale. Un orario nel passato viene rifiutato.

- **La quota si consuma quando l'invio esce**, non alla programmazione. Ogni invio ripetuto consuma un invio. Se in quel momento non c'è quota, o se l'orario è passato da più di 12 ore prima che l'invio potesse uscire, l'invio viene **saltato** e registrato, e il proprietario riceve un'e-mail (una volta per invio). Un invio singolo saltato torna a bozza.
- **A ogni invio, pubblico e contenuto vengono letti di nuovo**: chi è entrato nella community la riceve, chi è uscito o si è disiscritto no. I blocchi automatici mostrano solo ciò che è nuovo dall'invio precedente (al primo, gli ultimi 7 giorni).
- **Senza novità, non invia.** L'invio viene saltato e registrato come *"Saltato: non c'era nulla di nuovo da inviare."* Testo, pulsante e immagine contano come contenuto, quindi una campagna solo di testo invia sempre.
- **Metti in pausa** trattiene ciò che non è ancora uscito e conserva la data successiva; **Riprendi** continua solo con ciò che mancava; **Annulla campagna** conclude, e ciò che è già uscito resta inviato. Gli stati sono *Bozza*, *Programmata*, *Invio in corso*, *Inviata*, *In pausa* e *Annullata*.
- Una campagna che non è più una bozza non si modifica: usa il pannello **Invio** per riprogrammare, mettere in pausa o annullare.

### Seguire gli invii

In **Invii**, ogni invio mostra **Destinatari**, **Consegnate**, **Aperture**, **Clic**, **Rimbalzi** e **Segnalazioni** (e le disiscrizioni), e **Somma di tutti gli invii** mette tutto insieme. **Sono solo numeri**: nessun nome né e-mail di nessuno. Un invio saltato mostra il motivo. **Vedi come la riceve la persona** apre l'e-mail come uscirebbe ora, senza inviare né consumare quota.

## Blocchi con i contenuti della community

Oltre a **Testo**, **Pulsante** e **Immagine**, l'e-mail accetta blocchi che prendono i contenuti della community stessa:

| Gruppo | Blocco | Cosa mostra |
|---|---|---|
| **Contenuto automatico** | **Ultime pubblicazioni** | Da 1 a 10 pubblicazioni, di uno spazio o di tutti gli spazi aperti |
| | **Prossimi eventi** | Da 1 a 10 eventi che iniziano nei prossimi giorni (da 1 a 90) |
| | **Nuovi corsi** | I corsi pubblicati dall'invio precedente |
| | **Nuovi annunci** | Gli annunci nuovi dall'invio precedente |
| **Contenuto fisso** | **Un corso**, **Un evento**, **Un prodotto** | Una scheda con link all'elemento scelto (il prodotto porta al negozio) |

Ogni blocco accetta un titolo di sezione facoltativo. Il contenuto viene letto **al momento dell'invio**.

- **Entra solo ciò che tutte le persone del pubblico possono vedere**: contenuto approvato e online, in spazi e sezioni aperti a tutti i membri (senza piano, gruppo o prodotto richiesto, e non privati). **Nessun contenuto a pagamento va nell'e-mail.** Un elemento fisso che non tutti vedono viene rifiutato al salvataggio; se smette di essere visibile dopo, esce dall'e-mail.
- Il blocco **Immagine** accetta **Carica immagine** (JPEG, PNG o WebP, fino a 20 MB, ridotta a 1200 px al massimo), **Sostituisci immagine** e **Rimuovi immagine**; oppure l'indirizzo incollato.
- Un invio senza alcun contenuto viene rifiutato.

## E-mail automatiche

Nella scheda **Automatiche**, il proprietario e gli amministratori hanno il pulsante **Nuova campagna automatica**, che crea una campagna programmata per ogni giorno o per giorni della settimana. La scheda mostra i modelli pronti (come **Novità della settimana**) e **Le tue campagne ricorrenti**. In **Campagne**, l'invio predefinito è quello **una volta**.

Nella scheda **Automatiche** ci sono e-mail pronte che la piattaforma mantiene. La prima è **Novità della settimana**: un riepilogo settimanale con **Ultime pubblicazioni**, **Nuovi corsi**, **Prossimi eventi** e **Nuovi annunci** (scegli quali entrano).

- **Parte spenta, in ogni community.** Nessuna community invia e-mail di massa da sola. Tutto il team vede la scheda; solo il proprietario e gli amministratori la attivano e la regolano.
- Per **Attivare**, la finestra chiede di confermare che invierà e-mail in volume, nel giorno e all'ora scelti, **senza che tu prema nulla**. Puoi spegnerla quando vuoi.
- Regolabili: giorno, ora, oggetto, introduzione e blocchi. **Ripristina predefinito** riporta tutto e la spegne.
- **Settimana senza novità, non invia.** L'introduzione da sola non la fa partire.
- Rispetta le disiscrizioni, porta solo contenuto che tutti vedono, conta nella quota e compare nell'elenco e nei rapporti come qualsiasi campagna. Non si invia, programma, modifica né elimina dalle schermate comuni.

## Protezione della reputazione di invio

- **Quota:** gli invii programmati, ripetuti e automatici **contano anch'essi**, uno per invio, quando escono.
- **Primi invii:** finché la community non ha completato nessun invio, il pubblico è limitato a **500 persone**; oltre, l'invio viene rifiutato prima di consumare quota.
- **Pausa automatica:** se un invio ha superato 50 e-mail e oltre il **5%** è tornato come indirizzo che non riceve (rimbalzo permanente) o oltre lo **0,3%** è diventato segnalazione di spam, la campagna **va in pausa da sola** (e anche la ripetizione), ciò che manca non esce e i proprietari ricevono un'e-mail, una volta. Riprendere è una decisione del proprietario o dell'amministratore.

## Cosa non esiste ancora

Non esiste ancora: un editor visivo drag and drop, la segmentazione per comportamento (ad esempio, chi non ha aperto l'ultima e-mail), i test A/B, l'importazione di contatti esterni alla community e l'invio via SMS o WhatsApp.

## Esempi

**Avviso a una classe.** Il team crea *"Lezione inaugurale"*, sceglie il gruppo *Classe di marzo*, invia il test, controlla che 38 persone ricevano e 2 restino fuori (disiscritte) e il proprietario invia.

**Comunicato a tutti.** Un messaggio breve, con un pulsante verso la community, per **Tutte le persone**. Se è il terzo invio della giornata, Memberfy lo rifiuta prima di iniziare e dice quando si libera la quota.

## Errori comuni e come risolverli

| Situazione | Cosa fare |
|---|---|
| *Dai un nome alla campagna.* / *Scrivi l'oggetto.* | Compila i campi e salva |
| *Ogni pulsante richiede un testo e un link che inizi con https://.* | Controlla il pulsante |
| *Scegli almeno un gruppo, tag o persona, oppure invia a tutte le persone.* | Definisci il pubblico |
| *Il pubblico supera le 20.000 persone…* | Riduci il pubblico o dividi in campagne |
| Limite giornaliero, settimanale o mensile raggiunto | Il messaggio dice quale e quando si libera; aspetta o parla con Memberfy |
| Una persona scelta a mano viene rifiutata | Si è disiscritta: solo lei può tornare a ricevere |
| Il pulsante **Invia ora** non compare | Solo proprietario e amministratore inviano |

## Domande frequenti

**La persona può rispondermi?**
Sì: le risposte vanno all'e-mail di contatto del proprietario.

**Posso vedere chi ha aperto?**
No. I numeri sono somme, senza il nome di nessuno, e le aperture sono una stima.

**Se qualcuno si disiscrive, perdo il contatto?**
Solo via e-mail di campagna. Gli avvisi della community continuano, a meno che la persona non li blocchi tutti, e le e-mail di sicurezza e di acquisto arrivano sempre.

**La quota è per e-mail inviata?**
No: è per **invio**. Un invio a 5 persone e uno a 5.000 ne consumano uno ciascuno.

## Nell'API

`GET` e `POST /api/campaigns`, `GET`, `PUT` e `DELETE /api/campaigns/{id}` (solo bozza), `POST /api/campaigns/{id}/audience-preview`, `POST /api/campaigns/{id}/test`, `POST /api/campaigns/{id}/send` (corpo `consent: true`, risponde `202`), `GET /api/campaigns/quota`, `GET /api/campaigns/opt-outs` e `GET` e `PUT /api/me/email-preferences`. La disiscrizione pubblica è in `/api/public/unsubscribe/{token}`. Il riferimento di ogni rotta entra nella pagina [Riferimento dell'API](/api/referencia) quando le campagne saranno disponibili.

## Correlati

- [E-mail della piattaforma](/notificacoes/emails-da-plataforma)
- [Gruppi e organigramma](/membros/grupos-e-organograma)
- [Tag](/membros/tags)