# Testa e programma una campagna

> Invia email di prova, visualizza l’anteprima di una campagna come un contatto reale, inviala subito o programmala, annulla una programmazione e segui cosa succede durante l’invio.

Prima che una campagna parta, controllala nella tua inbox e con i dati di contatti reali. Poi inviala subito o scegli un orario. Questa pagina spiega il test, la programmazione, l’annullamento di una programmazione e cosa succede durante l’invio della campagna, nel pannello e con l’API.

## Invia un’email di prova

Le email di prova vanno ai tuoi indirizzi, così puoi controllare l’email in inbox e client di posta reali.

1. **Apri il passaggio di test.** Nella procedura guidata della campagna, vai a **Preview and test**.

2. **Inserisci gli indirizzi.** In **Send test**, digita fino a 5 indirizzi, separati da virgole, spazi o punti e virgola, ad esempio `me@acme.com, colleague@acme.com`.

3. **Invia.** Seleziona **Send test**. La conferma dice «Test email is being sent.»

Le email di prova differiscono dalla campagna vera:

- **I tag di unione usano dati segnaposto.** `{{email}}` diventa l’indirizzo di prova. Nome, cognome e campi personalizzati sono vuoti. Per controllare i valori reali, usa [Preview as contact](#preview-as-a-contact).
- **Il link di disiscrizione non disiscrive nessuno.**
- **Caricamenti e clic non vengono tracciati**, e le email di prova non rientrano nel report della campagna.
- **Limiti:** fino a 5 indirizzi per test e 3 test al minuto. Prima serve un **From email** nella campagna.
- **I workspace in sandbox** possono inviare email di prova solo agli indirizzi degli account dei membri del workspace. Vedi [Accesso alla produzione](/it/docs/workspaces/production-access/).

Le email di prova compaiono in **Email API → Emails** come le altre email in uscita.

## Anteprima come contatto

Nello stesso passaggio, **Preview as contact** elabora la campagna con i dati di un contatto. Cerca un contatto per nome o email, e l’anteprima mostra oggetto e contenuto come li vedrà quella persona, con «Previewing as» e il suo nome in alto. Passa da **Desktop** a **Mobile** per controllare entrambe le larghezze.

Usala per individuare nomi vuoti, chiavi sbagliate dei campi personalizzati e tag non sostituiti. Vedi [Tag di unione](/it/docs/campaigns/merge-tags/).

## Invia subito o programma

Nel passaggio **Send**, seleziona **Send campaign** e scegli quando:

| Opzione | Cosa succede |
| --- | --- |
| **Immediately** | Seleziona **Send now**. La campagna passa a **In process** e l’invio inizia subito. |
| **Schedule** | Scegli data e ora in **Schedule for** e seleziona **Schedule**. La campagna passa a **Scheduled**. |

Quando programmi:

- **L’orario è nel fuso orario del tuo computer.** Il campo propone l’ora intera successiva. Emailit salva l’orario in UTC.
- **Deve essere nel futuro.** Altrimenti la finestra mostra «Pick a time in the future.»
- **L’invio inizia entro un minuto dall’orario.** Emailit cerca le campagne in scadenza ogni minuto.
- **I destinatari vengono determinati quando inizia l’invio**, quindi le persone che entrano o escono dalle liste nel frattempo vengono contate correttamente.
- **La campagna è bloccata.** Si possono modificare solo le bozze. Per cambiare una campagna programmata, annulla prima la programmazione.

## Annulla una programmazione

1. **Trova la campagna.** In **Email Marketing → Campaigns**, apri la scheda **Scheduled**.

2. **Annulla.** Nel menu della riga, o in alto nella pagina della campagna, seleziona **Cancel Schedule** e conferma.

La campagna torna a **Draft** senza orario di invio, così puoi modificarla e inviarla o programmarla di nuovo. Non puoi annullare negli ultimi 5 minuti prima dell’orario programmato: in quel caso il pannello mostra «Campaign cannot be canceled less than 5 minutes before scheduled time.»

## Durante l’invio della campagna

Quando inizia l’invio, Emailit seleziona i destinatari, salta gli indirizzi disiscritti e soppressi e crea un’email per destinatario, in batch. Nel frattempo la pagina della campagna mostra:

- Un riquadro **In process**: «This campaign is still sending. Counts update as messages move through delivery.»
- **Send progress**: la quota di email create che hanno lasciato la coda, ad esempio «1,200 of 5,000 created messages have left the unprocessed queue.»
- I conteggi in tempo reale di **Sent**, **Delivered**, **Attempted**, **Not processed**, **Bounced**, **Suppressed** e **Complained**. Vedi [Report delle campagne](/it/docs/campaigns/reports/#metrics).

Quando tutte le email dei destinatari sono state create, lo stato passa a **Sent**. La consegna prosegue anche dopo: le email verso server temporaneamente non disponibili vengono ritentate per circa 21 ore al massimo, e caricamenti e clic continuano ad arrivare. Il report si aggiorna di conseguenza.

Una campagna il cui invio è iniziato non si può fermare dal pannello, quindi testala prima di inviarla.

## Usa l’API

Invia subito una bozza con [Invia o programma una campagna](/it/docs/api-reference/campaigns/send/):

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "sending",
  "message": "Campaign send initiated"
}
```

Per programmarla, passa `scheduled_at` come data e ora ISO 8601 nel futuro. Funziona anche un timestamp Unix. Si possono programmare solo le bozze:

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scheduled_at": "2026-10-15T09:00:00Z" }'
```

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "scheduled",
  "scheduled_at": "2026-10-15T09:00:00Z",
  "message": "Campaign is scheduled"
}
```

| Errore | Causa |
| --- | --- |
| `403` | Il workspace non ha ancora l’accesso alla produzione. |
| `422` «Invalid scheduled_at» | `scheduled_at` non è una data valida nel futuro. |
| `422` «Campaign cannot be scheduled» | La campagna non è una bozza. |

[Annulla una campagna](/it/docs/api-reference/campaigns/cancel/) imposta una campagna `draft` o `sending` su `canceled`. Le email già create per i destinatari partono comunque. Per riportare una campagna programmata a bozza, usa **Cancel Schedule** nel pannello.

Segui l’avanzamento con gli [eventi webhook](/it/docs/webhooks/event-types/) `campaign.scheduled`, `campaign.queued`, `campaign.sending`, `campaign.sent` e `campaign.canceled`.

## Vedi anche

  - [Report delle campagne](/it/docs/campaigns/reports/): Cosa significa ogni metrica.
  - [Crea una campagna](/it/docs/campaigns/create/): La procedura guidata completa.

---
Fonte: https://emailit.com/it/docs/campaigns/test-and-schedule/