# Double opt-in ed email di conferma

> Chiedi alle persone di confermare il proprio indirizzo prima di entrare in una lista e dai loro il benvenuto con un’email di conferma. Imposta il mittente, i testi o un design MJML personalizzato e prova entrambe le email.

Ogni lista può inviare due email proprie:

- **Double opt-in**: un’email con un link di conferma. Chi si iscrive entra nella lista solo dopo averci fatto clic, così ogni indirizzo della lista appartiene a qualcuno che ha chiesto di esserci.
- **Email di conferma**: una breve email «iscrizione completata» inviata subito dopo che qualcuno entra nella lista, oppure dopo la conferma quando il double opt-in è attivo.

Entrambe sono disattivate finché non le attivi, ed entrambe partono dal tuo dominio di invio verificato.

## Prima di iniziare

- Verifica un dominio di invio. Entrambe le email richiedono un indirizzo **From** su uno dei tuoi [domini verificati](/it/docs/domains/).
- Ogni email costa un credito, come qualsiasi altra email.
- Un workspace non ancora verificato può inviare email solo ai propri membri, quindi le email di double opt-in verso altre persone non vanno a buon fine finché il workspace non viene verificato.

## Attiva il double opt-in

1. **Apri le impostazioni.** Vai a **Email Marketing → Audiences**, apri la lista e seleziona la scheda **Settings**.

2. **Imposta il mittente.** Nella sezione **Double opt-in**, inserisci un indirizzo **From** su un dominio verificato, ad esempio `News <news@example.com>`, e, se vuoi, un indirizzo **Reply-to**.

3. **Modifica l’email.** Cambia **Subject**, **Heading**, **Text**, **Button text** e **Footer**, oppure mantieni i valori predefiniti. L’anteprima sulla destra si aggiorna mentre scrivi.

4. **Scegli dove arrivano le persone.** Facoltativo: inserisci una pagina nel campo **After confirming, go to**. Senza, le persone vedono una pagina di conferma con un link per [gestire le proprie iscrizioni](/it/docs/audiences/manage-subscriptions/). Ha il design della tua [pagina di disiscrizione](/it/docs/audiences/unsubscribe-page/#other-pages-with-this-design) e si apre nella lingua del browser della persona.

5. **Attivalo.** Attiva **Require confirmation** e seleziona **Save**.

Il salvataggio non riesce con «Use an address on a verified sending domain of this workspace.» quando il dominio del **From** non è verificato.

### Quali iscrizioni chiedono la conferma

| Come entra la persona | Con il double opt-in attivo |
| --- | --- |
| L’[URL di iscrizione](/it/docs/audiences/subscribe-url/) della lista | Riceve l’email di double opt-in ed entra nella lista dopo aver fatto clic sul suo link. L’URL restituisce `202`. |
| Un [modulo](/it/docs/forms/) che aggiunge persone alla lista | Lo stesso, a meno che il modulo non gestisca un proprio double opt-in. In quel caso basta la conferma del modulo. Se l’email di double opt-in non può essere inviata, il modulo aggiunge subito la persona. |
| **Add subscriber** nel pannello | La casella **Ask them to confirm by email first (double opt-in)** è spuntata. Togli la spunta per aggiungere subito la persona. |
| [Aggiungi un iscritto](/it/docs/api-reference/audiences/subscribers/add/) con l’API | Solo con `"double_opt_in": true`. Senza, la persona viene aggiunta subito. |
| Importazioni, unioni e azioni di massa sui contatti | La persona viene aggiunta subito. |
| La [pagina di gestione delle iscrizioni](/it/docs/audiences/manage-subscriptions/) | La persona viene aggiunta subito. Il link le è stato inviato per email, e questo dimostra già che l’indirizzo è suo. |

### Cosa succede dopo un’iscrizione

1. Emailit crea il contatto se è nuovo, senza modificare un contatto esistente, e invia l’email di double opt-in. La persona non è ancora nella lista. Le persone già iscritte non ricevono alcuna email, ma l’URL di iscrizione restituisce comunque `202`, così non rivela chi è nella lista.
2. Quando apre il link, entra nella lista con **Subscribed** attivo. Viene inviato un evento `subscriber.created` e partono le automazioni **Added to audience**. Segue l’email di conferma, se è attiva.
3. Aprire di nuovo il link non ha altri effetti. I link scadono dopo 30 giorni. Chi non ha confermato può iscriversi di nuovo per ricevere un nuovo link. I link precedenti continuano a funzionare fino alla scadenza, e basta confermarne uno qualsiasi. Iscriversi di nuovo subito dopo la prima volta non invia una seconda email, così l’URL di iscrizione non può essere usato per sommergere di email l’inbox di qualcuno; il primo link continua a funzionare.

La scheda **Settings** mostra quante persone non hanno ancora confermato. Se l’email non può essere inviata, ad esempio perché il dominio non è più verificato o il workspace non ha crediti, la persona non viene aggiunta e l’URL di iscrizione restituisce `503`. Un modulo invece aggiunge subito la persona, così l’iscrizione non va persa, e la risposta registra l’errore.

## Invia un’email di conferma

1. **Apri le impostazioni.** Nella scheda **Settings** della lista, vai alla sezione **Confirmation email**.

2. **Scrivi l’email.** Inserisci un indirizzo **From** su un dominio verificato, poi modifica i testi. Compila **Button text** e **Button link** per indirizzare le persone al tuo sito, oppure lasciali vuoti per un’email senza pulsante.

3. **Attivala.** Attiva **Send it** e seleziona **Save**.

L’email di conferma va alle persone che entrano nella lista tramite l’URL di iscrizione, un modulo, un link di double opt-in o la pagina di gestione delle iscrizioni. Quando aggiungi tu le persone, viene inviata solo se lo chiedi: spunta **Send the confirmation email** in **Add subscriber**, oppure passa `"send_confirmation_email": true` all’API. Le importazioni e le unioni non la inviano mai.

Un’email di conferma che non viene inviata non annulla l’iscrizione.

## Variabili

L’oggetto, i testi e i design personalizzati possono usare le variabili di [Temple](/it/docs/templates/temple/). Ai valori del contatto viene applicato l’escape prima che entrino nell’email.

| Variabile | Valore |
| --- | --- |
| `{{confirm_url}}` | Il link di conferma. Solo per il double opt-in. |
| `{{manage_subscriptions_url}}` | Il link personale alla [pagina di gestione delle iscrizioni](/it/docs/audiences/manage-subscriptions/). Solo per l’email di conferma. |
| `{{audience_name}}` | Il nome pubblico della lista, oppure il suo nome se non ne ha uno. |
| `{{email}}`, `{{first_name}}`, `{{last_name}}` | I dati del contatto. Usa un valore predefinito per i valori vuoti, ad esempio `{{first_name\|"there"}}`. |

**Text** e **Footer** mantengono gli a capo e accettano HTML inline come `<a>` e `**`. **Heading** e **Button text** sono testo semplice. Il pulsante del double opt-in punta sempre a `{{confirm_url}}`.

## Progetta l’email in MJML

> **MJML è in alpha:** Il Visual Editor MJML è aperto solo al team di Emailit mentre lo testiamo. Tutti gli altri usano il design predefinito, con tutti i testi descritti sopra. Vedi [Editor e API MJML](/it/docs/templates/mjml/).

Per cambiare il layout, seleziona **Customize in the MJML visual editor**. L’editor si apre con il design predefinito e i tuoi testi attuali. Il salvataggio imposta l’email su **Custom design (MJML)**. Riporta **Design** su **Default design** per usare di nuovo i testi; il design personalizzato viene conservato.

Un’email di double opt-in personalizzata deve contenere un link a `{{confirm_url}}`. Se ne salvi una senza, il salvataggio non riesce con «The double opt-in email must link to `{{confirm_url}}`.»

## Prova le email

Sotto ogni anteprima, inserisci un indirizzo in **Send a test to** e seleziona **Send test**. Il test usa la versione salvata, quindi salva prima le modifiche. Le email di prova usano valori di esempio per il contatto e i loro link non iscrivono nessuno.

## Usa l’API

[Aggiorna una lista](/it/docs/api-reference/audiences/update/) imposta entrambe le email. Invia solo i campi che vuoi cambiare:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "double_opt_in": {
      "enabled": true,
      "redirect_url": "https://example.com/welcome",
      "email": { "from": "News <news@example.com>", "subject": "Confirm your subscription to {{audience_name}}" }
    },
    "confirmation_email": {
      "enabled": true,
      "email": { "from": "News <news@example.com>", "button_label": "Read the latest issue", "button_url": "https://example.com/blog" }
    }
  }'
```

Poi chiedi la conferma quando aggiungi qualcuno:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "double_opt_in": true }'
```

La risposta è `202` con `"status": "pending"`. Impostare un design personalizzato (`email.source`) tramite l’API fa parte dell’alpha di MJML.

## Vedi anche

  - [Pagina di gestione delle iscrizioni](/it/docs/audiences/manage-subscriptions/): Permetti alle persone di scegliere le loro liste.
  - [URL di iscrizione](/it/docs/audiences/subscribe-url/): Raccogli iscrizioni dal tuo sito.

---
Fonte: https://emailit.com/it/docs/audiences/double-opt-in/