PanoramicaBeta
Automazioni
Le automazioni eseguono passaggi come inviare un’email, attendere o aggiungere un tag a un contatto quando scatta un trigger. Scopri contesti, uscite, obiettivi, 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, l’aggiunta di un tag o il raggiungimento di un lead score, Emailit avvia un’esecuzione che percorre i passaggi che hai collegato, come inviare un’email, attendere fino a una data, controllare una condizione o aggiornare il contatto. Usa le automazioni per sequenze di benvenuto e di onboarding, promemoria per carrelli abbandonati e webinar, lead scoring, email di compleanno, inoltri e avvisi.
Come funziona
- Scatta un trigger. Ogni automazione inizia con un trigger, ad esempio Added to audience o Tag added. Impostazioni e filtri facoltativi lo restringono.
- Emailit avvia un’esecuzione per il contatto o l’email che l’ha causata, e addebita 3 crediti.
- L’esecuzione percorre i passaggi collegati al trigger. I passaggi Time delay e Wait until la mettono in pausa, i passaggi Condition la indirizzano su una diramazione Yes o No, e i passaggi di azione inviano email, modificano il contatto o chiamano altri sistemi.
- L’esecuzione termina quando raggiunge l’ultimo passaggio della sua diramazione, un passaggio End automation o una condizione di uscita, oppure non riesce se un passaggio non riesce.
Due elementi possono spostare un’esecuzione senza che arrivi al passaggio successivo: una condizione di uscita fa uscire il contatto appena corrisponde (ad esempio quando acquista), e un passaggio Goal porta avanti l’esecuzione fino all’obiettivo quando il contatto lo soddisfa. I passaggi obiettivo sono inclusi nei piani Pro, Business e Custom. Vedi Condizioni di uscita e obiettivi.
Puoi costruire il flusso su una tela nel pannello, oppure inviarlo all’API o al server MCP come elenco di passaggi e collegamenti. Vedi Trigger e Passaggi.
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, promemoria per carrelli e webinar, lead scoring | Liste, tag, punteggio, modifiche ai contatti, date, aperture e clic, moduli, eventi personalizzati |
| 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
-
Inizia. Vai a Email MarketingAutomations e seleziona New automation.
-
Scegli il contesto. Scegli Contact o Email.
-
Scegli un modello. Scegli uno dei modelli pronti oppure Start from scratch per una tela vuota con solo un trigger. Aggiungi il primo passaggio con il pulsante più sotto il trigger.
-
Dagli un nome. Compila il campo Name e, facoltativamente, Description, poi seleziona Create. L’automazione si apre come bozza.
-
Costruisci il flusso. Nella scheda Editor, seleziona il trigger e ogni passaggio per configurarli, e aggiungi passaggi con i pulsanti più. Seleziona Save.
-
Imposta le uscite. Nella scheda Settings, aggiungi condizioni di uscita, ad esempio «avviene un acquisto», e scegli cosa succede quando un contatto è già nell’automazione. Nelle nuove automazioni di tipo Contact, l’esecuzione di un contatto termina quando il contatto viene rimosso dalla lista che l’ha avviata o si disiscrive da quella lista.
-
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 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 Time delay o Wait until. Le loro condizioni di uscita e i loro obiettivi continuano a funzionare mentre l’automazione è in pausa. 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. La scheda Settings si può modificare in qualsiasi stato, e le nuove condizioni di uscita si applicano alle esecuzioni già in corso.
Save controlla l’intero flusso ed evidenzia i passaggi che richiedono attenzione, ad esempio un passaggio Send email senza template o un passaggio Wait until senza data. Correggili e salva di nuovo prima di selezionare Start: l’avvio di un flusso salvato non ripete i controlli. Se ci sono modifiche non salvate, Start le salva prima, esegue gli stessi controlli e avvia solo se vengono superati.
Esecuzioni
Un’esecuzione è un percorso 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 | L’esecuzione ha raggiunto la fine del suo percorso o un passaggio End automation, oppure è passata a un’altra automazione. |
| Failed | Un passaggio non è riuscito, oppure il workspace non aveva crediti sufficienti all’avvio dell’esecuzione. |
| Canceled | Una condizione di uscita ha trovato corrispondenza, il contatto ha lasciato la lista, qualcuno ha annullato l’esecuzione o ha rimosso il contatto, un’altra automazione lo ha rimosso, oppure l’automazione è stata interrotta. |
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. Puoi annullare un’esecuzione dalla scheda Runs. Per la cronologia delle esecuzioni e il debug, vedi Esecuzioni e statistiche.
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 |
Le email di marketing saltate perché il contatto si è disiscritto non consumano crediti. 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.
Usa l’API
L’API delle automazioni gestisce le automazioni e le loro esecuzioni. Richiede una chiave API con Full Access. Le stesse operazioni sono disponibili come strumenti sul server MCP, quindi un assistente AI può costruire un intero flusso a partire da una descrizione.
| Endpoint | A cosa serve |
|---|---|
| Crea, aggiorna, recupera, elenca ed elimina | Gestire le automazioni. Passaggi e collegamenti vengono inviati insieme. |
| Avvia, metti in pausa e interrompi | Cambiare lo stato. |
| Avvia un’esecuzione | Far scattare un trigger Manual, con un payload facoltativo. L’automazione deve essere in esecuzione. È possibile solo con l’API. |
| Annulla un’esecuzione e rimuovi un contatto | Fermare un’esecuzione, o tutte le esecuzioni di un contatto in questa automazione. |
| Elenca le esecuzioni, le esecuzioni di un contatto, recupera un’esecuzione, statistiche e statistiche dei passaggi | Leggere la cronologia delle esecuzioni e i risultati per passaggio. |
Impostazioni (settings) delle automazioni, disponibili anche nella scheda Settings:
| Impostazione | Predefinito | Effetto |
|---|---|---|
exit_conditions |
nessuna | Annulla l’esecuzione di un contatto appena un evento o una condizione corrisponde. Vedi Condizioni di uscita. |
exit_on_audience_removal |
false (true per le automazioni di tipo Contact create nel pannello) |
Annulla un’esecuzione quando il contatto viene rimosso o si disiscrive dalla lista che l’ha avviata. |
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 prosegue dopo il passaggio non riuscito (una condizione non riuscita prosegue su No). |
Le esecuzioni saltate non vengono create e non consumano crediti.
curl https://api.emailit.com/v2/automations \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"context": "contact",
"name": "Cart reminder",
"settings": {
"exit_on_audience_removal": true,
"exit_conditions": [{ "event": "contact.tag_added", "tag": "customer" }]
},
"steps": [
{ "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
{ "key": "wait-1", "type": "action", "action": "wait", "config": { "seconds": 3600 } },
{ "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "cart-reminder" } }
],
"connections": [
{ "from": "trigger-1", "to": "wait-1", "branch": "default" },
{ "from": "wait-1", "to": "send_email-1", "branch": "default" }
]
}'L’automazione viene creata come bozza. Chiama Avvia un’automazione per attivarla.