Trigger e azioni

Un trigger è l'evento che avvia un'automazione, per esempio un nuovo membro o un corso completato. Un'azione è ciò che l'automazione fa poi, per esempio aggiungere un tag o inviare un'email. Questo articolo li elenca tutti con i loro campi.

Apra le automazioni

Dove trovarli

Nell'editor, la Libreria ha due schede: Trigger e Azioni. I blocchi integrati si trovano sotto MemberArea, raggruppati in Membri, Pagamenti, Corsi, Comunità, Eventi, Affiliati e Utilità. Le integrazioni seguono sotto il proprio nome. Cerca passaggi… cerca in nomi e descrizioni. Clicchi su un blocco o lo trascini sul canvas, poi ci clicchi per compilarne i campi.

Creare un'automazione

Trigger dei membri

• Nuovo Membro: viene creato un account membro.
• Nuovo contatto: viene creato un contatto, per esempio tramite un modulo di iscrizione. Un contatto non è ancora un membro, quindi le azioni sui membri non fanno nulla finché non usa Converti contatto in membro.
• Campo membro modificato: un campo membro cambia. Scelga il campo in Campo membro per reagire solo a quel campo; se lo lascia vuoto, conta ogni campo. Il nuovo valore è disponibile per i passaggi come {{value}}. Dopo che un campo è stato svuotato, è vuoto.
• Accesso del membro: un membro accede, una volta per sessione.
• Tag applicato e Tag rimosso: un tag viene aggiunto a un membro o rimosso da esso. Scelga il tag in Tag per reagire solo a quel tag; se lo lascia vuoto, conta ogni tag.
• Membro del team invitato: un amministratore invita un nuovo membro del team.
• Membro inattivo: viene eseguito una volta quando un membro non accede da un certo numero di giorni. Inserisca il numero in Giorni di inattività, veda "Restringere un trigger" più sotto. I membri che sono già inattivi quando attiva l'automazione vengono saltati; l'automazione reagisce ai membri che diventano inattivi da quel momento.

Trigger dei pagamenti

• Nuovo cliente: un ordine pagato crea un nuovo account membro.
• Nuovo ordine: un nuovo ordine viene pagato.
• Checkout completato: un acquirente completa un checkout online, qualunque sia il fornitore di pagamento che lo ha gestito.
• Pagamento in elaborazione: un pagamento differito come addebito SEPA, Klarna o Sofort è stato autorizzato e il denaro è ancora in arrivo. L'acquirente ha già accesso.
• Pagamento non riuscito: il pagamento di un ordine viene rifiutato, oppure denaro già registrato come pagato viene richiesto indietro giorni dopo.
• Abbonamento rinnovato: un abbonamento ricorrente si rinnova con successo.
• Pagamento rimborsato: un ordine viene rimborsato, in tutto o in parte.
• Abbonamento annullato: un membro annulla un abbonamento.
• Rinnovo imminente: viene eseguito un numero stabilito di giorni prima del rinnovo di un abbonamento. Inserisca il numero in Giorni prima del rinnovo.

Trigger dei corsi

• Lezione completata: un membro completa una lezione.
• Corso completato: ogni lezione obbligatoria di un corso è completata.
• Avanzamento del corso raggiunto: viene eseguito una volta quando l'avanzamento di un membro in un corso supera una percentuale. La inserisca in Soglia percentuale, per esempio 50. Senza di essa, il trigger viene eseguito a ogni passo di avanzamento.
• Esame superato ed Esame non superato: un membro supera o non supera un esame.

Tutti e cinque possono essere ristretti a un corso con Corso. Una lezione o un esame possono trovarsi in un modulo condiviso da più corsi. L'automazione parte comunque una volta per ogni lezione completata o risultato d'esame, e Corso corrisponde quando uno qualsiasi di questi corsi è quello che ha scelto.

Trigger della community

• Community: post creato: un membro crea un post, una discussione o un sondaggio. Forum lo restringe a un forum.
• Community: membro salito di livello: un membro raggiunge un livello più alto.
• Community: segnalazione aperta: un contenuto viene segnalato da un membro o dal sistema.
• Badge ottenuto: un membro ottiene un badge della community. Badge lo restringe a un badge.

Trigger degli eventi

• Iscrizione all'evento: un membro si iscrive a un evento.
• Partecipazione all'evento: un membro viene segnato come presente, per esempio al check-in.
• Evento in arrivo: viene eseguito un tempo stabilito prima dell'inizio di un evento, una volta per ogni membro iscritto. Inserisca le ore in Ore prima dell'inizio, per esempio 24.

Evento restringe i primi due a un evento.

Trigger degli affiliati

Commissione affiliato approvata viene eseguito quando una commissione viene approvata e bloccata per il pagamento. Scatta solo se gestisce un programma partner.

Pianificazione e webhook

Secondo una pianificazione

Pianificato (cron) avvia l'automazione a orari fissi. Ha due campi:

• Espressione cron (obbligatoria): cinque parti per minuto, ora, giorno del mese, mese e giorno della settimana. 0 9 * * * significa ogni giorno alle 09:00, 0 9 * * 1 ogni lunedì alle 09:00.
• Fuso orario: il fuso orario a cui si riferiscono gli orari, per esempio Europe/Berlin. È UTC se lo lascia vuoto.

La pianificazione viene controllata ogni minuto. La prima esecuzione avviene all'orario corrispondente successivo dopo che ha attivato l'automazione. Un'esecuzione pianificata non ha un membro, quindi la usi per passaggi che non ne hanno bisogno, come una richiesta esterna o un'integrazione che scrive al Suo team.

Webhook in entrata

Webhook in entrata avvia l'automazione quando un altro sistema le invia una richiesta, per esempio il Suo sito web, uno strumento per moduli o Zapier.

1. Aggiunga il trigger e salvi l'automazione. Fino ad allora il pannello mostra "Salva l'automazione per generare l'URL e il secret del webhook." Un'automazione creata da un modello, un duplicato o una copia per un'altra azienda ha subito il proprio indirizzo e il proprio secret.
2. Clicchi sul trigger. Il pannello mostra l'URL del webhook con Copia URL e il Secret con Copia il secret.
3. Nell'altro sistema, invii una richiesta POST all'URL. Inserisca il secret nell'intestazione X-Automation-Secret. Invii i dati come JSON.

Ogni campo di primo livello del corpo è disponibile per i passaggi come {{field}}. Se il corpo contiene member_email con l'indirizzo di uno dei Suoi membri, l'esecuzione appartiene a quel membro, e azioni e segnaposto dei membri funzionano.

L'automazione deve essere attiva e pubblicata. Altrimenti la chiamata viene rifiutata, come succede con un secret errato o mancante. Ogni automazione accetta fino a 120 chiamate al minuto. Le chiamate successive vengono respinte finché il minuto non è trascorso.

Per impostazione predefinita il chiamante riceve subito {"ok": true, "triggers_fired": 1}, e i passaggi vengono eseguiti in background. Se un passaggio Rispondi al webhook segue questo trigger nel flusso, il chiamante attende e riceve lo stato e il corpo che ha impostato in quel passaggio. Lo posizioni prima di qualsiasi ritardo, altrimenti il chiamante riceve la risposta predefinita. Un passaggio Rispondi al webhook su un percorso che questo trigger non raggiunge mai non cambia nulla.

Condizioni, rami e ritardi

Rigenera il secret crea un nuovo secret dopo la Sua conferma. Quello vecchio smette subito di funzionare, quindi aggiorni ogni sistema che lo usa.

Restringere un trigger

Molti trigger hanno campi che li restringono a un elemento o stabiliscono un tempo. Si trovano nelle impostazioni del trigger subito sotto Tipo di trigger, prima di Condizioni.

• Corso, Evento, Forum e Badge sono elenchi con i nomi dei Suoi elementi. La prima opzione, come Qualsiasi corso o Qualsiasi evento, rimuove di nuovo il filtro, e il trigger reagisce a ogni elemento.
• I campi senza elenco, come Prodotto, Lezione o Calendario, accettano l'ID dell'elemento. Per vedere quali ID invia un trigger, apra un'esecuzione passata in Esecuzioni e guardi l'Input del trigger.

Tre trigger richiedono un numero e non partono mai senza:

Inserisca un numero intero pari o superiore a 1. Finché il campo è vuoto o inferiore a 1, l'editor segna il trigger con un avviso come "«Giorni di inattività» deve essere almeno 1." e lo elenca tra i problemi quando attiva l'automazione.

I trigger senza tali campi, per esempio Nuovo Membro o i trigger di un'integrazione, mostrano invece Filtri. Ogni riga è una chiave e un valore, e il trigger avvia l'automazione solo quando l'evento porta esattamente quel valore sotto quella chiave. Usi Aggiungi per altre righe; tutte le righe devono corrispondere.

Test e cronologia delle esecuzioni

Condizioni sul membro

Condizioni controlla il membro prima che l'automazione parta. Ogni riga è il nome di un campo dell'account membro e un valore, per esempio language e de. Il trigger avvia l'automazione solo quando il membro ha esattamente questi valori in ogni riga.

Per controllare altro, come un tag che il membro ha o un campo personalizzato, aggiunga un passaggio Condizione o Filtro dopo il trigger.

Condizioni, rami e ritardi

Azioni sui membri

Le azioni sui membri agiscono sul membro dell'esecuzione.

• Aggiungi tag e Rimuovi Tag: Tag sceglie il tag.
• Aggiungi al gruppo e Rimuovi dal gruppo: Gruppo sceglie il gruppo.
• Concedi accesso al corso e Revoca accesso al corso: Corso sceglie il corso. Un corso non pubblicato non viene concesso; l'esecuzione annota che non è cambiato nulla.
• Imposta campo membro: Campo membro e Valore. Il valore viene salvato così come lo digita.
• Cancella campo membro: Campo membro viene svuotato per il membro.
• Converti contatto in membro: crea un account membro da un contatto e ne riporta i campi. Invia email di benvenuto è attivo per impostazione predefinita.
• Disattiva membro: disattiva l'account del membro sulla Sua piattaforma.
• Invia email: un'email al membro, senza link di disiscrizione. Per le email di marketing, usi una sequenza email. Oggetto e Corpo sono obbligatori. Destinatario resta vuoto per scrivere al membro, oppure accetta l'indirizzo email di un altro membro della Sua piattaforma.
• Invia SMS: invia un messaggio tramite Twilio. Messaggio è obbligatorio. Compili Twilio Account SID, Twilio Auth Token e il numero mittente; senza tutti e tre, non parte nessun SMS. Nel numero destinatario, inserisca un numero oppure [|Phone|] per il numero di telefono del membro. Se ha collegato Twilio come integrazione, la sua azione Invia SMS usa invece quel collegamento.

Azioni della community

• Crea post nella community: pubblica un post nel Forum scelto a nome del membro. Forum elenca per nome i forum della Sua piattaforma e richiede che la community sia attiva. Titolo del post è facoltativo, il corpo del post è obbligatorio.
• Assegna badge: assegna al membro il Badge scelto.
• Assegna punti: assegna al membro dei Punti, che contano per i livelli. Motivo è facoltativo e compare nella cronologia dei punti.

Fai richiesta esterna

Fai richiesta esterna invia una richiesta HTTP a un server di Sua scelta, per esempio per passare un nuovo membro al Suo sistema. Clicchi su Aggiungi la tua richiesta per aprire Modifica richiesta:

• Tipo di Richiesta: GET, POST, PUT o DELETE.
• URL Richiesta: un indirizzo https. Il campo offre campi membro da inserire come segnaposto.
• Intestazioni: Aggiungi Intestazione Richiesta aggiunge una Chiave e un Valore.
• Corpo: il Corpo Richiesta come JSON, con un'Anteprima accanto.
• Risposta: la risposta del Suo ultimo test.

Test Richiesta invia subito la richiesta con il membro che ha scelto in Membro per test. La scheda Risposta mostra allora Intestazioni della risposta, Corpo della risposta, Intestazioni della richiesta e Corpo Richiesta. Sono consentiti solo indirizzi pubblici, e la richiesta non segue i reindirizzamenti. Salva conserva la richiesta.

In un'esecuzione la richiesta viene inviata come JSON con un limite di tempo di 15 secondi. Se il Suo server risponde con un errore, non risponde in tempo o reindirizza, il passaggio non riesce e con esso l'esecuzione. L'errore mostra lo stato e l'inizio della risposta, per esempio "La richiesta ha restituito HTTP 503: Service Unavailable". Testi la richiesta prima di attivare l'automazione.

Segnaposto

Segnaposto dei membri

I campi di testo delle azioni, come l'oggetto e il corpo di un'email, il messaggio SMS, il post, il motivo dei punti e la richiesta esterna, sostituiscono questi segnaposto con i dati del membro:

• [|First Name|] o : nome
• [|Last Name|] o : cognome
• [|Email|] o : indirizzo email
• [|Phone|] o {settings.phone}: numero di telefono dal profilo
• [|Language|] o : lingua
• [|Member Id|] o : ID del membro
• [|Image|] o : immagine del profilo
• [|Registered at|] o : data e ora della registrazione
• [|Last Login|] o : data e ora dell'ultimo accesso
• [|Full Member Data|]: tutti i dati del membro come JSON

Un campo membro compare come [|cf_…|] o {cf_…} con l'ID del campo; la richiesta esterna lo inserisce per Lei. Quando un'esecuzione non ha un membro, nome, cognome, email e telefono provengono dai campi first_name, last_name, email e phone dei dati del trigger, se li contengono.

Segnaposto dei dati

I passaggi Imposta campi, Condizione, Filtro, Confronta, Ciclo, Attendi fino alla data e Rispondi al webhook leggono i dati dell'esecuzione:

• {{key}} prende un valore dai dati del trigger o da un passaggio precedente, per esempio {{amount}} di un ordine o un campo inviato dal Suo webhook.
• {{member.first_name}} e gli altri segnaposto {{member.…}} leggono il membro dell'esecuzione. {{member.tags}} e {{member.groups}} restituiscono i tag e i gruppi del membro.
• {{member.cf_…}} con l'ID di un campo personalizzato legge il valore del membro per quel campo così com'è salvato. L'ID è quello del segnaposto {cf_…} qui sopra.

I campi delle azioni non leggono {{key}}. Per usare i dati di un webhook in un'email, colleghi l'esecuzione a un membro con member_email e usi i segnaposto dei membri.

Trigger e azioni delle integrazioni

Quando collega un servizio, i suoi trigger e le sue azioni compaiono nella libreria sotto il nome del servizio. Finché non è collegato, restano in grigio con Collega; cliccandone uno si apre la finestra di collegamento, e Aggiungi integrazione in fondo alla libreria collega altri servizi. Un'automazione con un servizio non collegato non può essere attivata. Integrazione nell'azione sceglie l'account collegato da usare.

I trigger provengono da Stripe, GoHighLevel, Calendly, Digistore24, Shopify, Hotmart, CopeCart e WooCommerce, per esempio per acquisti, rimborsi, cancellazioni o prenotazioni.

Le azioni sono disponibili per:

• Strumenti di automazione: Webhooks, Zapier, Make, n8n e Pabbly.
• Email e CRM: ActiveCampaign, Brevo, Customer.io, Drip, Flodesk, GetResponse, GoHighLevel, HubSpot, Intercom, Kit, Klaviyo, KlickTipp, Mailchimp, ManyChat, Pipedrive e Quentn.
• Messaggi: Discord, Slack, Twilio e WhatsApp.
• Negozio e contabilità: Shopify, lexoffice e sevDesk.
• Strumenti di lavoro: Airtable, Asana, ClickUp, Coda, Google Sheets, monday.com, Notion, Trello e Zoom.

Collegare altri strumenti

Avviare le automazioni tramite l'API

Con una chiave API, il Suo software può elencare le Sue automazioni, avviarne una con dati propri e leggerne le esecuzioni.

Chiavi API e accesso per sviluppatori

Articoli correlati

• Panoramica delle automazioni
• Creare un'automazione
• Condizioni, rami e ritardi
• Test e cronologia delle esecuzioni