# Automazioni

> Le automazioni eseguono passaggi come inviare un’email, attendere o aggiornare un contatto quando scatta un trigger. Scopri contesti, stati, esecuzioni, crediti e API.

Un’automazione è un flusso che parte da solo: quando scatta un trigger, come l’ingresso di un contatto in una lista o il bounce di un’email, Emailit avvia un’esecuzione che percorre i passaggi che hai collegato, come inviare un’email, attendere un giorno o aggiornare il contatto. Usa le automazioni per email di benvenuto, sequenze di onboarding, email di compleanno, inoltri e avvisi.

> **Le automazioni sono in beta:** Le automazioni funzionano in tutti i workspace, ma alcune opzioni sono ancora in fase di completamento. Dove il pannello e l’API differiscono, queste pagine lo indicano.

## Come funziona

1. **Scatta un trigger.** Ogni automazione inizia con un trigger, ad esempio **Added to audience**. Filtri facoltativi lo restringono.
2. **Emailit avvia un’esecuzione** per il contatto o l’email che l’ha causata, e addebita 3 crediti.
3. **L’esecuzione percorre i passaggi** collegati al trigger, uno dopo l’altro. I passaggi **Wait** mettono in pausa l’esecuzione, e i passaggi **Condition** la indirizzano su una diramazione **Yes** o **No**.
4. **L’esecuzione termina** quando raggiunge l’ultimo passaggio della sua diramazione, oppure non riesce se un passaggio non riesce.

Puoi costruire il flusso su una tela nel pannello, oppure inviarlo all’API come elenco di passaggi e collegamenti. Vedi [Trigger](/it/docs/automations/triggers/) e [Passaggi](/it/docs/automations/steps/).

## Contesti

Ogni automazione ha un contesto, che stabilisce l’oggetto di un’esecuzione e quali trigger e passaggi sono disponibili. Lo scegli quando crei l’automazione e non si può cambiare in seguito.

| Contesto | Etichetta | Ogni esecuzione riguarda | Ideale per | Trigger |
| --- | --- | --- | --- | --- |
| **Contact** | Easy | Un contatto | Serie di benvenuto, onboarding, riattivazione | Appartenenza alle liste, modifiche ai contatti, anniversari di date |
| **Email** | Medium | Un’email | Gestione delle risposte, inoltri automatici, avvisi sui bounce | Eventi email, come consegna, bounce o ricezione |
| **Event** | Advanced | Una chiamata API | Flussi guidati dall’API, integrazioni personalizzate | Un trigger manuale che chiami con l’API |

Nel pannello, il contesto **Event** mostra il badge **Soon** e non è ancora selezionabile. Puoi creare automazioni di tipo Event con l’API.

## Crea un’automazione

1. **Inizia.** Vai a **Email Marketing → Automations** e seleziona **New automation**.

2. **Scegli il contesto.** Scegli **Contact** o **Email**.

3. **Scegli un modello.** Scegli uno dei [modelli pronti](/it/docs/automations/recipes/) oppure **Start from scratch** per una tela vuota con solo un trigger.

4. **Dagli un nome.** Compila il campo **Name** e, facoltativamente, **Description**, poi seleziona **Create**. L’automazione si apre come bozza.

5. **Costruisci il flusso.** Nella scheda **Editor**, seleziona il trigger e ogni passaggio per configurarli, e aggiungi passaggi con i pulsanti più. Seleziona **Save**.

6. **Avviala.** Seleziona **Start**. Da questo momento, ogni trigger corrispondente avvia un’esecuzione.

La pagina dell’elenco ha le schede per le automazioni **Contact**, **Email** ed **Event** e mostra per ciascuna **Name**, **Status**, l’orario **Last triggered** e la data **Created**.

## Stati

| Stato | I trigger avviano esecuzioni | Modificabile nel pannello | Come ci si arriva |
| --- | --- | --- | --- |
| **Draft** | No | Sì | Ogni nuova automazione parte come bozza. |
| **Running** | Sì | No | Con **Start** su un’automazione in bozza o in pausa. |
| **Paused** | No | Sì | Con **Pause** su un’automazione in esecuzione. **Start** la riprende. |
| **Stopped** | No | No | Solo con l’endpoint [stop](/it/docs/api-reference/automations/stop/) dell’API, che annulla anche tutte le esecuzioni in corso. |

La pausa impedisce l’avvio di nuove esecuzioni, ma quelle già in corso continuano, comprese quelle in attesa in un passaggio **Wait**. **Delete**, nel menu in cima all’automazione, la elimina in qualsiasi stato.

### Regole di modifica

La scheda **Editor** è disponibile solo mentre l’automazione è in bozza o in pausa. Su un’automazione in esecuzione, la scheda mostra **Pause to edit**.

**Save** controlla l’intero flusso ed evidenzia i passaggi che richiedono attenzione, ad esempio un passaggio **Send email** senza template o un’attesa superiore a 30 giorni. Correggili e salva di nuovo prima di selezionare **Start**: l’avvio non ripete i controlli.

## Esecuzioni

Un’esecuzione è un passaggio completo attraverso l’automazione per un contatto, un’email o una chiamata API. Ogni esecuzione ha uno stato:

| Stato dell’esecuzione | Significato |
| --- | --- |
| **Running** | L’esecuzione sta percorrendo i passaggi o è in attesa. |
| **Completed** | Tutti i passaggi sul percorso dell’esecuzione sono terminati. |
| **Failed** | Un passaggio non è riuscito, oppure il workspace non aveva crediti sufficienti all’avvio dell’esecuzione. |
| **Canceled** | L’automazione è stata interrotta con l’API mentre l’esecuzione era in corso. |

Per impostazione predefinita, ogni trigger avvia una nuova esecuzione, anche se lo stesso contatto o la stessa email ne ha già una in corso. Lo stesso evento non avvia mai due esecuzioni della stessa automazione. Per la cronologia delle esecuzioni e il debug, vedi [Esecuzioni e statistiche](/it/docs/automations/runs/).

## Crediti

| Azione | Crediti |
| --- | --- |
| Ogni esecuzione | 3, addebitati all’avvio dell’esecuzione |
| Ogni email inviata da un passaggio **Send email** | 1 |
| Ogni email inviata da un passaggio **Forward email** | 1 |

Se il workspace non ha 3 crediti quando scatta un trigger, l’esecuzione viene creata con lo stato **Failed** e il motivo `insufficient_credits` nel suo `meta`. Se i crediti finiscono durante un’esecuzione, il passaggio **Send email** o **Forward email** non riesce. Vedi [Crediti](/it/docs/billing/credits/).

## Usa l’API

L’[API delle automazioni](/it/docs/api-reference/automations/) gestisce le automazioni e legge le loro esecuzioni. Richiede una chiave API con **Full Access**.

| Endpoint | A cosa serve |
| --- | --- |
| [Crea](/it/docs/api-reference/automations/create/), [aggiorna](/it/docs/api-reference/automations/update/), [recupera](/it/docs/api-reference/automations/get/), [elenca](/it/docs/api-reference/automations/list/) ed [elimina](/it/docs/api-reference/automations/delete/) | Gestire le automazioni. Passaggi e collegamenti vengono inviati insieme. |
| [Avvia](/it/docs/api-reference/automations/start/), [metti in pausa](/it/docs/api-reference/automations/pause/) e [interrompi](/it/docs/api-reference/automations/stop/) | Cambiare lo stato. |
| [Avvia un’esecuzione](/it/docs/api-reference/automations/trigger/) | Far scattare un trigger **Manual**, con un `payload` facoltativo. L’automazione deve essere in esecuzione. È possibile solo con l’API. |
| [Elenca le esecuzioni](/it/docs/api-reference/automations/runs/), [recupera un’esecuzione](/it/docs/api-reference/automations/run/), [statistiche](/it/docs/api-reference/automations/stats/) e [statistiche dei passaggi](/it/docs/api-reference/automations/step-stats/) | Leggere la cronologia delle esecuzioni e i risultati per passaggio. |

L’API accetta anche impostazioni (`settings`) delle automazioni che il pannello non mostra ancora:

| Impostazione | Predefinito | Effetto |
| --- | --- | --- |
| `allow_reentry` | `true` | Imposta `false` per saltare le nuove esecuzioni di un contatto o di un’email che ha già un’esecuzione in corso. |
| `max_concurrent_runs` | `0` (nessun limite) | Salta le nuove esecuzioni mentre è in corso questo numero di esecuzioni. |
| `cooldown_seconds` | `0` | Salta le nuove esecuzioni di un contatto o di un’email che ha avviato un’esecuzione entro questo numero di secondi. |
| `on_step_failure` | `stop` | `stop` fa fallire l’esecuzione quando un passaggio non riesce. `skip` lascia proseguire l’esecuzione. |

Le esecuzioni saltate non vengono create e non consumano crediti.

```bash
curl https://api.emailit.com/v2/automations \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "contact",
    "name": "Welcome email",
    "settings": { "allow_reentry": false },
    "steps": [
      { "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
      { "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome" } }
    ],
    "connections": [
      { "from": "trigger-1", "to": "send_email-1", "branch": "default" }
    ]
  }'
```

L’automazione viene creata come bozza. Chiama [Avvia un’automazione](/it/docs/api-reference/automations/start/) per attivarla.

## Passaggi successivi

  - [Trigger](/it/docs/automations/triggers/): Ogni trigger e le sue opzioni.
  - [Passaggi](/it/docs/automations/steps/): Ogni passaggio, le sue impostazioni e come funzionano le diramazioni.
  - [Modelli](/it/docs/automations/recipes/): I sei modelli pronti.
  - [Esecuzioni e statistiche](/it/docs/automations/runs/): Segui le esecuzioni ed esegui il debug degli errori.

---
Fonte: https://emailit.com/it/docs/automations/