Vai al contenuto
Docs

Riferimento

Riferimento di tutti i trigger delle automazioni per contesto, con opzioni e filtri, cosa li fa scattare e le chiavi dei trigger da usare con l’API.

Aggiornato il 20 nov 2026

Un trigger decide quando un’automazione avvia un’esecuzione. Questa pagina elenca tutti i trigger disponibili in ogni contesto, cosa li fa scattare, le loro opzioni e la chiave da usare per ciascuno nell’API.

Come funzionano i trigger

  • Un trigger per automazione nel pannello. Seleziona il trigger sulla tela e cambialo con Trigger type. Con l’API, le automazioni di tipo Contact ed Email possono avere più trigger, purché siano tutti collegati allo stesso primo passaggio. Le automazioni di tipo Event ne hanno esattamente uno. Ogni trigger che scatta avvia una propria esecuzione, quindi una sola iscrizione può avviarne due: un modulo che aggiunge il contatto a una lista fa scattare Form submitted e Added to audience insieme. Per una sola esecuzione, nella scheda Settings imposta Same contact again while a run is in progress su Don’t start another run (allow_reentry: false).
  • L’automazione deve essere in esecuzione. I trigger delle automazioni in bozza, in pausa o interrotte vengono ignorati. Gli eventi precedenti all’avvio di un’automazione non avviano esecuzioni in seguito.
  • Le esecuzioni partono in pochi secondi. Emailit raccoglie i nuovi eventi a intervalli di pochi secondi. I trigger di data vengono controllati ogni 5 minuti.
  • Le automazioni di tipo Contact hanno bisogno di un contatto. Un evento che non si può associare a un contatto del workspace, come un’apertura da parte di un indirizzo che non è un contatto, non avvia un’esecuzione.
  • Le automazioni possono avviarsi a vicenda. Le modifiche fatte da un passaggio, come l’aggiunta di un tag o di un contatto a una lista, fanno scattare i trigger di altre automazioni. In questo modo un’automazione non avvia mai se stessa, e una catena di automazioni che si avviano a vicenda si ferma dopo 5 anelli.

Filtri

Contact updated, Custom event, Placed an order, Abandoned a cart, Viewed a product, Product back in stock e tutti i trigger delle email accettano un filtro facoltativo. Ogni regola confronta un campo dell’evento con un valore:

  • Operatori: Equals, Not equals, Contains, Not contains, Greater than, Less than, Is set, Is not set, In, Not in, Starts with e Ends with. Greater than e Less than confrontano numeri. Gli altri confrontano testo e distinguono tra maiuscole e minuscole.
  • Modalità di corrispondenza: All rules match oppure Any rule matches.

Con l’API, un filtro è { "match": "all", "rules": [{ "field": "...", "operator": "equals", "value": "..." }] } nel campo config.filter del trigger, con match impostato su all o any. I campi sono percorsi all’interno dell’oggetto dell’evento, ad esempio to, link.url o, per un evento personalizzato, properties.total. Per controllare il contatto stesso (tag, liste, punteggio), aggiungi un passaggio Condition dopo il trigger.

Trigger dei contatti

Trigger Chiave API Opzioni Avvia un’esecuzione quando
Added to audience contact.added_to_audience Audience. Lascialo vuoto per qualsiasi lista. Un contatto entra nella lista, o viene aggiunto di nuovo dopo essersi disiscritto.
Removed from audience contact.removed_from_audience Audience. Lascialo vuoto per qualsiasi lista. L’appartenenza di un contatto alla lista viene eliminata.
Added to segment contact.added_to_segment Tracked segment (obbligatorio) e se includere i membri attuali Un contatto inizia a corrispondere a un segmento tracciato.
Removed from segment contact.removed_from_segment Tracked segment (obbligatorio) Un contatto smette di corrispondere a un segmento tracciato.
Contact created contact.created Nessuna Viene creato un contatto.
Contact updated contact.updated Field that changed, filtro facoltativo Cambiano i campi, i campi personalizzati, i tag, il punteggio o lo stato marketing di un contatto.
Tag added contact.tag_added Tag. Lascialo vuoto per qualsiasi tag. Il contatto riceve il tag.
Tag removed contact.tag_removed Tag. Lascialo vuoto per qualsiasi tag. Il tag viene rimosso dal contatto.
Score changed contact.score_changed Crosses e Direction Il lead score del contatto cambia o supera una soglia.
Unsubscribed contact.unsubscribed Audience. Lascialo vuoto per qualsiasi lista. Il contatto si disiscrive da una lista o da tutte le email di marketing.
Email opened contact.loaded_email Solo le email inviate da questa automazione Il contatto carica un’email tracciata inviata al suo indirizzo.
Link clicked contact.clicked_in_email Link contains, solo le email inviate da questa automazione Il contatto fa clic su un link tracciato in un’email inviata al suo indirizzo.
Date in contact field contact.on_date Date field, scostamento, ora, fuso orario, Repeat Arriva una data salvata sul contatto, o mancano un certo numero di giorni.
Date anniversary contact.date_anniversary Date field, scostamento, ora, fuso orario Ogni anno, nel mese e nel giorno di una data salvata sul contatto.
Custom event contact.on_event Event name. Lascialo vuoto per qualsiasi evento. La tua app invia con l’API degli eventi un evento di workspace o personalizzato per il contatto, come un acquisto. Piani Business e Custom.
Form submitted form.submitted Form. Lascialo vuoto per qualsiasi modulo. Qualcuno invia un modulo con un indirizzo email.
Placed an order contact.on_purchase Filtro facoltativo Un contatto effettua un nuovo ordine.
Abandoned a cart contact.abandoned_cart Filtro facoltativo Il carrello di un contatto viene abbandonato.
Viewed a product contact.viewed_product Filtro facoltativo Un contatto guarda un prodotto sul tuo sito.
Product back in stock contact.back_in_stock Filtro facoltativo Un prodotto chiesto da un contatto torna disponibile.

Added to audience

Scatta quando qualcuno viene aggiunto a una lista dal pannello (Add subscriber, Add to audience, Add contact con liste), con l’API (Aggiungi un iscritto, oppure Crea un contatto con audiences), con l’azione di massa Add to audience o con il passaggio Add to audience, Subscribe / unsubscribe o Create contact di un’altra automazione. Scatta anche quando aggiungi di nuovo qualcuno che si era disiscritto.

Non scatta per i contatti aggiunti tramite importazione da file o un’iscrizione tramite URL di iscrizione, e non conta nemmeno riattivare Subscribed per un iscritto esistente nel pannello.

Removed from audience

Scatta quando un iscritto viene eliminato: Delete nella pagina della lista, Remove from audience, Elimina un iscritto, un aggiornamento del contatto la cui lista audiences esclude quella lista, o il passaggio Remove from audience di un’altra automazione. Eliminare un contatto lo fa scattare una volta per ogni lista in cui si trovava il contatto. La disiscrizione non lo fa scattare, perché la persona resta nella lista; in quel caso usa Unsubscribed.

Per fermare le esecuzioni di una sequenza quando il contatto lascia la sua lista, non serve una seconda automazione: attiva Leave when removed or unsubscribed from the audience that started the run nella scheda Settings. Vedi Condizioni di uscita e obiettivi.

Trigger dei segmenti

Added to segment e Removed from segment scattano quando un contatto entra in un segmento tracciato o ne esce. Come i segmenti, sono in alpha e aperti solo al team di Emailit. Scegli il segmento in Tracked segment. Vengono elencati e accettati solo i segmenti tracciati, perché gli altri segmenti non registrano ingressi e uscite.

  • Quando scattano. Quando un contatto cambia, i suoi segmenti vengono ricontrollati, e di solito le esecuzioni partono entro un minuto. Le importazioni e le liste eliminate vengono controllate al termine. Le regole che si spostano nel tempo, come Created negli ultimi 30 giorni, vengono controllate da una sincronizzazione giornaliera alle 00:30 UTC.
  • Le modifiche al segmento non avviano esecuzioni. I contatti che entrano o escono perché hai cambiato l’origine o i filtri del segmento vengono registrati e inviati ai webhook, ma non avviano automazioni.
  • Nessuna esecuzione per il primo conteggio. La creazione di un segmento tracciato, o la ripresa del tracciamento dopo il passaggio a un piano superiore, registra i membri attuali senza avviare esecuzioni.
  • Includere i membri attuali. In Added to segment, seleziona Also start for contacts already in the segment when the automation is first started per avviare un’esecuzione anche per ogni membro attuale. Succede una sola volta, al primo avvio dell’automazione. Le impostazioni di rientro valgono comunque.

In un’esecuzione, {{payload.object.segment.name}} contiene il nome del segmento e {{payload.object.reason}} il motivo per cui il contatto è entrato o uscito: contact, schedule, oppure existing_member per le esecuzioni avviate per i membri attuali del segmento.

Con l’API, imposta config.segment_id sull’ID seg_ del segmento e, per contact.added_to_segment, facoltativamente config.include_current_members: true. Un segmento usato da automazioni non si può eliminare finché non modifichi queste automazioni.

Contact updated

Scatta ogni volta che un contatto viene aggiornato nel pannello, con l’API o da un passaggio di un’automazione, comprese le modifiche ai tag e al punteggio e le azioni di massa Unsubscribe e Resubscribe. Field that changed lo limita a un solo campo, ad esempio un campo personalizzato purchased impostato dal tuo CRM. Il filtro può controllare i valori attuali di Email, First name, Last name, Unsubscribed e dei campi personalizzati, e i loro valori precedenti, elencati come Previous email, Previous first name e così via. I valori precedenti sono presenti solo per i campi che sono cambiati.

Ad esempio, per reagire quando un contatto passa al piano pro, aggiungi due regole con All rules match: custom_fields.plan Equals pro e Previous plan (previous.custom_fields.plan) Not equals pro.

Tag added e Tag removed

Scattano quando un tag viene aggiunto al contatto o rimosso, in qualsiasi modo: dal pannello, con l’API, dal server MCP o da un passaggio di un’automazione. I tag vengono confrontati in minuscolo, quindi VIP e vip sono lo stesso tag.

Score changed

Scatta quando il lead score del contatto cambia. Con Crosses impostato, scatta solo quando il punteggio supera quel valore: verso l’alto (Going up, il valore predefinito) significa che il punteggio precedente era inferiore al valore e quello nuovo è pari o superiore, quindi «i lead sopra 50 entrano nel flusso di vendita» scatta una sola volta, non a ogni punto. Going down scatta quando il punteggio scende sotto il valore.

Unsubscribed

Scatta quando il contatto si disiscrive da una lista (con un link di disiscrizione, dal pannello, con l’API o con un passaggio Subscribe / unsubscribe) o da tutte le email di marketing. Con Audience impostato, scatta solo per quella lista e per le disiscrizioni da tutto.

Scattano quando il contatto carica un’email tracciata inviata al suo indirizzo o fa clic su un suo link: campagne, email inviate con l’API e con SMTP, ed email delle automazioni. Il tracciamento richiede le impostazioni di tracciamento del dominio di invio e un CNAME di tracciamento verificato. Only emails sent by this automation li limita alle email inviate dall’automazione stessa, e Link contains ai link il cui URL contiene il testo, ad esempio /pricing.

Per reagire all’apertura o al clic di un’email che l’esecuzione ha appena inviato, usa invece un passaggio Wait until con Something happens. Vedi Wait until.

Date in contact field e Date anniversary

Scegli un Date field, un campo personalizzato di tipo Date come una data di rinnovo o un compleanno, poi quando partire:

  • Days con Unit (days o weeks) e When (before the date o after the date), ad esempio 3 giorni prima di un rinnovo. 0 significa il giorno stesso.
  • At time (predefinito 00:00) in Timezone (un nome IANA come Europe/Prague, predefinito UTC).
  • Repeat su Date in contact field: Once, on that date oppure Every year (anniversary). Date anniversary si ripete sempre ogni anno; l’anno nel campo non conta, quindi 1990-04-12 avvia un’esecuzione ogni 12 aprile. Negli anni non bisestili, gli anniversari del 29 febbraio partono il 28 febbraio.

Emailit guarda 5 minuti avanti e avvia ogni esecuzione al minuto che hai impostato. Ogni contatto riceve un’esecuzione per data (o per anno, per gli anniversari), e ogni controllo gestisce fino a 100.000 contatti per automazione.

Con l’API, imposta config.date_field sulla chiave del campo personalizzato, offset su { "amount": 3, "unit": "days", "direction": "before" } e, facoltativamente, time, timezone e repeat: "yearly".

Custom event

Questo trigger è incluso nei piani Business e Custom. Con Pay as you go e Pro, un’automazione che lo aggiunge non si può salvare (403 con "error": "plan_required"). Le automazioni che lo usano già lo mantengono dopo il passaggio a un piano inferiore.

Scatta quando la tua app invia per il contatto un evento personalizzato (eventi c:) o un evento di workspace (eventi w:) con l’API degli eventi. Gli eventi dello script di tracciamento non avviano esecuzioni, perché chiunque abbia la tua chiave di tracciamento pubblica può attribuire a qualsiasi visitatore l’identità che vuole. Indicalo in Event name:

  • purchase corrisponde a c:purchase e w:purchase.
  • Un nome con il prefisso, come w:webinar.attended, corrisponde solo a quell’evento.
  • Lascialo vuoto per avviare l’automazione con qualsiasi evento di workspace o personalizzato.

Il campo suggerisce gli eventi di workspace che hai definito e gli eventi personalizzati inviati di recente dal workspace. In Only when the properties match (optional), filtra sulle proprietà dell’evento, ad esempio properties.total Greater than 100. Per un evento di workspace, l’elenco dei campi mostra le sue proprietà definite.

L’evento deve indicare un contatto del workspace tramite ID o indirizzo email. Gli eventi dei visitatori anonimi, o di indirizzi che non sono contatti, non avviano esecuzioni. Nell’esecuzione, {{payload.object.properties.total}} e simili contengono le proprietà.

Placed an order

Come l’e-commerce, questo trigger è in alpha e aperto solo al team di Emailit. Le automazioni che lo usano già continuano a funzionare.

Scatta una volta per ogni nuovo ordine di un contatto, ricevuto dall’API degli ordini o dal comando purchase dello script di tracciamento. Gli ordini importati come storico e gli ordini senza un contatto non lo fanno scattare, e gli aggiornamenti di un ordine non lo fanno scattare di nuovo. Il filtro può controllare Order total, Currency, Status, Source e Coupon codes dell’ordine, e le email possono usare l’ordine come {{payload.object.total}}, {{payload.object.external_id}} e così via.

Abandoned a cart

Come l’e-commerce, questo trigger è in alpha e aperto solo al team di Emailit. Le automazioni che lo usano già continuano a funzionare.

Scatta ogni volta che un carrello viene abbandonato: un carrello di un contatto noto che contiene articoli e non è cambiato per il tempo impostato nelle impostazioni e-commerce (60 minuti per impostazione predefinita). Il filtro può controllare Cart total, Currency e Source. Nelle email, {{cart}} mostra il carrello, vedi Prodotti, coupon e carrello.

I passaggi Send email di un’esecuzione avviata da questo trigger vengono saltati quando quel carrello si è trasformato in un ordine, così chi ha acquistato non riceve promemoria su ciò che ha appena comprato. Vedi il modello per il carrello abbandonato.

L’API accetta anche contact.visits_url, ma per ora nulla lo fa scattare.

Viewed a product

Come l’e-commerce, questo trigger è in alpha e aperto solo al team di Emailit. Le automazioni che lo usano già continuano a funzionare.

Si attiva quando un contatto guarda un prodotto sul tuo sito, con il comando product dello script di tracciamento o con il pixel di Emailit su Shopify. Chiunque abbia la tua chiave di tracciamento pubblica può inviare visualizzazioni, quindi lo attivano solo le visualizzazioni di un contatto arrivato da una delle tue email (un link firmato) o iscritto a una lista. Il filtro può controllare Product ID (shop), Product title e Price. Le email possono usare {{payload.object.product.title}}, oppure mostrare tutto quello che il contatto ha guardato con {{products "recently_viewed"}}.

Di solito una visita comprende più visualizzazioni di prodotti. Per l’abbandono della navigazione, imposta Wait between runs for the same contact (hours), attendi prima dell’email ed esci con Placed an order, come fa il modello Browse abandonment.

Product back in stock

Come l’e-commerce, questo trigger è in alpha e aperto solo al team di Emailit. Le automazioni che lo usano già continuano a funzionare.

Si attiva quando un prodotto che un contatto ha chiesto con il modulo di disponibilità del tuo negozio Shopify torna disponibile, una volta per richiesta. Il filtro può controllare Product ID (shop), Product title e Variant ID. Le email possono usare {{payload.object.product.title}}, {{payload.object.product.url}}, {{payload.object.product.image_url}} e {{payload.object.variant.title}}. Il modello Back in stock invia la sua email come transazionale, perché è stato il contatto a chiederla.

Trigger delle email

I trigger delle email scattano per le email del workspace: tutto ciò che invii con l’API o con SMTP, le email delle campagne e delle automazioni, e le email in entrata per Email received. Ogni esecuzione riguarda una sola email.

Trigger Chiave API Avvia un’esecuzione quando Campi del filtro
Email delivered email.delivered Il server del destinatario ha accettato l’email. From, To, Subject, Status
Email bounced email.bounced L’email non è stata consegnata in modo permanente. From, To, Subject, Status
Email failed email.failed L’email non è stata inviata a causa di un errore. From, To, Subject, Status
Email suppressed email.suppressed L’email non è stata inviata perché il destinatario è soppresso. From, To, Subject, Status
Email complained email.complained Il destinatario ha segnalato l’email come spam. From, To, Subject, Status
Email received email.received È arrivata un’email in entrata. Vedi Email in entrata. From, To, Subject
Email loaded email.loaded Il destinatario ha caricato un’email tracciata. Recipient, Sender, Subject, IP address, User agent
Email clicked email.clicked Il destinatario ha cliccato un link tracciato. Recipient, Sender, Subject, Link URL, IP address, User agent

L’editor elenca anche Email accepted, Email scheduled, Email attempted ed Email rejected. Le automazioni con questi trigger non si possono ancora salvare, quindi scegli uno dei trigger qui sopra. Con l’API puoi usare anche email.canceled, che scatta quando un’email programmata o in coda viene annullata.

Trigger degli eventi

Per ora le automazioni di tipo Event si possono creare solo con l’API.

Trigger Chiave API Avvia un’esecuzione quando
Manual trigger system.manual Chiami Avvia un’esecuzione.
Schedule system.schedule Riservato. Per ora nulla lo fa scattare, quindi chiama l’endpoint del trigger dal tuo scheduler, ad esempio un cron job.

Manual trigger

Chiama l’endpoint del trigger di un’automazione in esecuzione, con un oggetto payload facoltativo:

Terminal
curl https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/trigger \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "payload": { "email": "ada@example.com", "plan": "pro" } }'

L’endpoint restituisce { "message": "Automation trigger dispatched." }, oppure 422 se l’automazione non è in esecuzione. Avvia un’esecuzione solo di quell’automazione. I passaggi possono leggere il payload come {{payload.email}}, {{payload.plan}} e così via. Emailit aggiunge automation_id al payload.

system.manual funziona come trigger anche nelle automazioni di tipo Contact ed Email create con l’API. Includi contact_id (un ID con_) o email_id nel payload per eseguire l’automazione per quel contatto o quell’email.

Dati disponibili per i passaggi

Le impostazioni dei passaggi, come il destinatario di Send email, i valori di Update contact fields o il corpo di un Webhook, possono contenere segnaposto che vengono compilati per ogni esecuzione:

Segnaposto Contiene
{{contact.<field>}} Il contatto dell’esecuzione nelle automazioni di tipo Contact, ad esempio {{contact.email}}, {{contact.score}} o {{contact.custom_fields.plan}}.
{{cf.<key>}} Un campo personalizzato del contatto, ad esempio {{cf.plan}}.
{{tags}} I tag del contatto, separati da virgole.
{{global.<key>}} Un valore globale, ad esempio {{global.webinar_date}}.
{{email.<field>}} L’email dell’esecuzione nelle automazioni di tipo Email, ad esempio {{email.rcpt_to}} o {{email.subject}}.
{{payload.<path>}} L’evento che ha avviato l’esecuzione. Per gli eventi in stile webhook, i dati dell’evento si trovano in payload.object, ad esempio {{payload.object.to}}. Per i trigger manuali è il tuo payload.
{{meta.<path>}} Dati aggiuntivi che Emailit salva sull’esecuzione.
{{run.id}} L’ID dell’esecuzione (aur_…).

I template email inviati da Send email usano Temple con gli stessi dati. Vedi Passaggi.

Cosa può fare un’esecuzione una volta avviata.
Eventi che terminano o spostano un’esecuzione.
Gli eventi alla base dei trigger dei contatti e delle email.
Tag e punteggi per trigger e condizioni.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.