Trigger delle automazioni

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.
• 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.

Filtri

Contact updated e tutti i trigger delle email accettano un filtro facoltativo, in Filter events (optional). 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 o link.url.

Trigger dei contatti

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) o con l’azione di massa Add to audience. Scatta anche quando aggiungi di nuovo qualcuno che si era disiscritto.

Non scatta per i contatti aggiunti tramite importazione da file, un’iscrizione tramite URL di iscrizione o il passaggio Add to audience o Create contact di un’altra automazione, e non conta nemmeno riattivare Subscribed per un iscritto esistente.

Removed from audience

Scatta quando un iscritto viene eliminato: Delete nella pagina della lista, Remove from audience, Elimina un iscritto o un aggiornamento del contatto la cui lista audiences esclude quella lista. 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.

Contact updated

Scatta ogni volta che un contatto viene aggiornato nel pannello o con l’API, comprese le azioni di massa Unsubscribe e Resubscribe. 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.

Date anniversary

Scegli un Date field, un campo personalizzato di tipo Date, come un compleanno. Una volta al giorno, Emailit avvia un’esecuzione per ogni contatto la cui data ha il mese e il giorno di oggi, in UTC. L’anno non conta, quindi un contatto con 1990-04-12 ottiene un’esecuzione ogni 12 aprile. Ogni automazione gestisce fino a 10.000 contatti al giorno.

Trigger dei contatti solo via API

L’API accetta anche contact.visits_url, contact.on_purchase e contact.on_event, ma per ora nulla li fa scattare.

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.

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.

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. 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 o i valori di Edit contact, possono contenere segnaposto che vengono compilati per ogni esecuzione:

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

Vedi anche