Passaggi delle automazioni

I passaggi sono ciò che un’esecuzione fa dopo che è scattato il trigger. Questa pagina elenca tutti i passaggi per contesto con le loro impostazioni e regole, spiega come i passaggi si collegano in diramazioni e mostra cosa succede quando un passaggio non riesce.

Aggiungi e configura i passaggi

Nella scheda Editor dell’automazione (disponibile mentre l’automazione è in bozza o in pausa):

• Aggiungi un passaggio: seleziona il pulsante più sotto l’ultimo passaggio, oppure sotto Yes o No in una condizione. Cerca nel selettore o scegli tra le Actions.
• Configura un passaggio: selezionalo sulla tela. Le sue impostazioni si aprono in un pannello laterale. Dopo la prima esecuzione del passaggio, accanto a Configure compare una scheda Stats.
• Rimuovi un passaggio: selezionalo e seleziona Delete step nel pannello laterale.
• Salva: seleziona Save. I passaggi con problemi vengono evidenziati con il numero di errori.

Passaggi per contesto

Le impostazioni dei passaggi possono contenere segnaposto come {{contact.first_name}} o {{payload.object.to}}, compilati per ogni esecuzione. Vedi Dati disponibili per i passaggi.

Send email

Invia un’email creata da uno dei tuoi template.

Regole:

• Il template viene elaborato con Temple. Nelle automazioni di tipo Contact, i campi del contatto sono disponibili direttamente, quindi {{first_name}}, {{email}} e {{custom_fields.plan}} funzionano. Ogni contesto ha anche {{contact.*}}, {{payload.*}} e {{meta.*}}. I tag di unione delle campagne come {{cf.plan}} e {{unsubscribe_url}} non vengono compilati.
• Il mittente deve appartenere a un dominio verificato. La sostituzione in From o il mittente del template deve usare un dominio verificato nel workspace. Save controlla le sostituzioni, e il passaggio non riesce in fase di esecuzione se il dominio non è verificato.
• Oggetto e contenuto sono obbligatori, dal template o dalle sostituzioni.
• Ogni email costa 1 credito, oltre ai 3 crediti dell’esecuzione.
• Non controlla le iscrizioni. L’email viene inviata anche se il contatto si è disiscritto dalle tue liste. Gli indirizzi soppressi vengono comunque bloccati alla consegna, e i workspace in sandbox possono inviare solo agli indirizzi degli account dei membri.
• Niente link di disiscrizione né caricamenti e clic. Le email delle automazioni non ricevono gli header List-Unsubscribe, e caricamenti e clic non vengono tracciati.

Le Stats del passaggio seguono ogni email inviata attraverso Accepted e Delivered, e contano bounce, errori e segnalazioni.

Wait / Delay

Mette in pausa l’esecuzione prima del passaggio successivo.

Mentre un’esecuzione è in attesa, resta Running e il passaggio di attesa risulta in attesa. Mettere in pausa l’automazione non interrompe le esecuzioni in attesa.

Condition (If/Else)

Indirizza l’esecuzione sulla diramazione Yes quando le regole corrispondono, o sulla diramazione No quando non corrispondono.

• Regole: un campo, un operatore e un valore, combinati con All rules match o Any rule matches. Gli operatori sono gli stessi dei filtri dei trigger.
• Campi: nelle automazioni di tipo Contact, Email, First name, Last name e i tuoi campi personalizzati. Nelle automazioni di tipo Email, i campi dell’evento del trigger. Con l’API, field può essere qualsiasi percorso, con i prefissi contact., email., payload. e meta..
• Diramazioni: aggiungi il passaggio successivo sotto Yes, No o entrambi. Una diramazione senza passaggi termina lì l’esecuzione.

Add to audience

Contesto Contact. Iscrive il contatto dell’esecuzione alla lista scelta in Audience. Se il contatto si era disiscritto, viene iscritto di nuovo. Il passaggio non riesce se la lista ha raggiunto il limite di iscritti. Non avvia le automazioni Added to audience.

Remove from audience

Contesto Contact. Disattiva l’iscrizione del contatto alla lista scelta in Audience. Il contatto resta nella lista come iscritto disiscritto, a differenza di Remove from audience nel pannello, che elimina l’appartenenza.

Edit contact

Contesto Contact. Imposta uno o più campi del contatto dell’esecuzione. Aggiungi una riga per campo, con Field name e Value:

I valori possono usare segnaposto, ad esempio {{payload.object.audience.name}}. La modifica non genera un evento contact.updated, quindi non avvia automazioni Contact updated né webhook.

Forward email

Contesti Email ed Event. Invia una copia dell’email dell’esecuzione, con il contenuto e gli allegati originali, all’indirizzo indicato in Forward to. L’oggetto diventa «Fwd: » seguito dall’oggetto originale. L’email deve provenire da un dominio di invio verificato nel workspace, e ogni inoltro costa 1 credito. Vedi Inoltra con le automazioni.

Add to suppressions

Contesti Email ed Event. Aggiunge un indirizzo alla lista di soppressione con tipo recipient, che blocca ogni invio a quell’indirizzo, e con il motivo inserito in Reason (predefinito automation). Nelle automazioni di tipo Email, l’indirizzo è il destinatario dell’email. Nelle automazioni di tipo Event, imposta email con l’API, ad esempio {{payload.email}}. Il passaggio genera un evento suppression.created.

Remove from suppressions

Contesti Email ed Event. Rimuove l’indirizzo dalla lista di soppressione: il destinatario dell’email nelle automazioni di tipo Email, oppure email impostato con l’API nelle automazioni di tipo Event.

Create contact

Contesti Email ed Event. Crea un contatto e, se scegli una lista in Audience (optional), lo iscrive a quella lista.

• Nelle automazioni di tipo Email, il contatto è l’indirizzo del destinatario dell’email. Per le email ricevute, è l’indirizzo a cui è stata inviata l’email. Per creare invece un contatto per il mittente, imposta email su {{email.mail_from}} con l’API.
• Nelle automazioni di tipo Event, imposta email e, facoltativamente, first_name con l’API.
• Se il contatto esiste già, viene mantenuto così com’è e solo iscritto alla lista.
• Il passaggio non avvia le automazioni Added to audience.

Passaggi solo API

Questi passaggi si possono aggiungere con l’API ma non ancora nell’editor del pannello. Funzionano in tutti i contesti.

{
  "key": "notify-crm",
  "type": "action",
  "action": "call_webhook",
  "config": {
    "url": "https://crm.acme.com/hooks/new-subscriber",
    "method": "POST",
    "headers": { "Authorization": "Bearer crm_token" },
    "body": { "email": "{{contact.email}}", "source": "emailit" }
  }
}

Diramazioni e collegamenti

Con l’API, un’automazione è un elenco di steps, ciascuno con una key univoca, e un elenco di connections dalla chiave di un passaggio a quella successiva:

{
  "steps": [
    { "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": {} },
    { "key": "is-pro", "type": "action", "action": "condition", "config": {
      "filter": { "match": "all", "rules": [{ "field": "custom_fields.plan", "operator": "equals", "value": "pro" }] }
    } },
    { "key": "send-pro", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome-pro" } },
    { "key": "send-free", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome-free" } }
  ],
  "connections": [
    { "from": "trigger-1", "to": "is-pro", "branch": "default" },
    { "from": "is-pro", "to": "send-pro", "branch": "yes" },
    { "from": "is-pro", "to": "send-free", "branch": "no" }
  ]
}

• branch è default per un normale passaggio successivo, yes o no dopo una condizione e la chiave di una variante dopo un random split.
• Una condizione segue solo la diramazione che ha scelto. Un collegamento default in uscita da una condizione non viene mai seguito.
• Un passaggio con più collegamenti in uscita sulla stessa diramazione li avvia tutti, e le diramazioni vengono eseguite in parallelo.
• Ogni passaggio deve essere raggiungibile da un trigger. Nelle automazioni di tipo Contact ed Email con più trigger, tutti i trigger devono essere collegati allo stesso primo passaggio.
• Invia steps e connections insieme quando aggiorni un’automazione. I passaggi le cui chiavi non cambiano mantengono cronologia e statistiche.

Quando un passaggio non riesce

Per impostazione predefinita, un passaggio non riuscito fa fallire l’intera esecuzione, e i passaggi rimanenti non vengono eseguiti. L’errore viene salvato sul passaggio, e puoi leggerlo nei dettagli dell’esecuzione nella scheda Runs. Per lasciare invece proseguire le esecuzioni oltre i passaggi non riusciti, imposta on_step_failure su skip nelle settings dell’automazione con l’API.

Per trovare e correggere le esecuzioni non riuscite, vedi Esecuzioni e statistiche.

Vedi anche