Riferimento
Trigger delle automazioni
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.
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.
Email opened e Link clicked
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 (
daysoweeks) e When (before the dateoafter the date), ad esempio 3 giorni prima di un rinnovo.0significa il giorno stesso. - At time (predefinito
00:00) in Timezone (un nome IANA comeEurope/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-12avvia 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:
purchasecorrisponde ac:purchaseew: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:
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.