Ciao a tutti!
Benvenuti in questo tutorial su come configurare un flusso di lavoro automatizzato con Integromat che vi permetterà di ricevere automaticamente una notifica via email ogni volta che un nuovo utente si iscrive alla vostra comunità Discourse.
Per collegare Discourse a Integromat, è necessario disporre di un account Integromat. Se non ne avete ancora uno, potete registrarvi qui.
Questo metodo utilizza la funzionalità webhook offerta da Discourse; pertanto, prima di iniziare, dovrete avere i privilegi di amministratore sulla vostra comunità Discourse.
Una volta ottenuti i privilegi di amministratore, la prima cosa da fare è creare una nuova richiesta webhook. Per farlo, fate clic sull’icona del vostro profilo nell’angolo in alto a destra e, dalla scheda del profilo, selezionate l’opzione Riepilogo.
Questo vi porterà alla pagina del vostro profilo. Fate clic sul pulsante Amministratore per accedere alla pagina di amministrazione.
Fate clic sull’opzione API.
Selezionate la scheda Webhook e fate clic sul pulsante Nuovo Webhook per generare una nuova richiesta webhook.
La pagina di configurazione dovrebbe apparire così.
Per compilare questo modulo, dovrete generare un nuovo webhook Integromat che verrà utilizzato per ricevere i dati inviati da Discourse ogni volta che un nuovo utente si iscrive alla vostra comunità.
Per fare ciò, accedete al vostro account Integromat e create un nuovo scenario.
Per prima cosa, dovrete configurare un modulo di attivazione, ovvero il modulo che avvierà l’esecuzione del vostro scenario. In questo caso, si tratterà di un modulo webhook; quindi, potete fare clic sull’icona con il punto interrogativo e cercare l’app Webhook.
Fate clic sull’app Webhook e selezionate il modulo Webhook personalizzato.
Successivamente, create un nuovo webhook in modo che il vostro scenario possa ricevere i dati inviati da Discourse. Per farlo, fate clic sull’app Webhook per aprire la finestra di configurazione e poi sul pulsante Aggiungi per impostare un nuovo webhook.
Assegnate un nome al vostro webhook. Può essere qualsiasi cosa vi piaccia, ad esempio “Webhook Discourse”.
Il passaggio successivo consiste nel fare clic sull’opzione Mostra impostazioni avanzate e selezionare l’opzione Ottieni intestazioni della richiesta. Una volta fatto ciò, fate clic su Salva per generare il nuovo webhook.
Il vostro webhook dovrebbe ora essere visibile. Si tratta dell’URL evidenziato in blu. Fate clic sul pulsante Copia indirizzo negli appunti per copiare il webhook e tornate alla pagina di configurazione del webhook su Discourse.
Incollate l’URL del webhook Integromat nel campo URL del payload.
Successivamente, selezionate l’opzione Evento utente dall’elenco e assicuratevi che tutto il resto sia deselezionato. Questo garantirà che questo webhook riceva dati solo in base a eventi specifici relativi agli utenti.
Infine, selezionate le caselle di controllo Verifica certificato TLS dell’URL del payload e Attivo alla fine della pagina e fate clic sul pulsante Crea per stabilire questa connessione tra la vostra comunità Discourse e il webhook Integromat.
La nuova connessione dovrebbe ora essere visibile nella pagina Webhook del vostro account Discourse.
Il passaggio successivo consiste nel verificare che la connessione tra la comunità Discourse e il vostro webhook Integromat sia stata stabilita. Per farlo, fate clic su Inattivo.
Vi verrà quindi presentata una piccola menu simile a questo. Fate semplicemente clic su Ping e tornate al vostro scenario Integromat per verificare se il webhook ha rilevato correttamente questo evento.
Se ciò è avvenuto, vedrete un messaggio che dice Rilevamento riuscito.
Il passaggio successivo consiste nel verificare se il webhook può effettivamente ricevere dati dalla vostra comunità Discourse. Per farlo, dovete eseguire lo scenario una volta facendo clic sul pulsante Esegui una volta.
Una volta che il modulo webhook inizia a ruotare, tornate alla vostra comunità Discourse, disconnettetevi e create un nuovo account utente. Una volta creato con successo il nuovo utente, il webhook dovrebbe ricevere dei dati, che appariranno così.
Questo vi aiuterà a verificare che il webhook possa effettivamente rilevare eventi reali (non solo ping) e vi consentirà di mappare gli elementi di dati ricevuti all’app Email in un secondo momento di questo tutorial. Se il webhook Integromat ha rilevato con successo l’evento, lo scenario sarà stato eseguito correttamente e apparirà così.
Ora che sapete che il modulo webhook funziona come previsto e che il vostro scenario Integromat viene attivato ogni volta che viene creato un nuovo utente, è il momento di estendere lo scenario e configurarlo in modo che vi invii automaticamente un’email con tutte le informazioni sull’utente.
Il primo passo sarà collegare un modulo Iteratore al modulo di attivazione webhook. Potete trovarlo nel menu Strumenti del creatore di scenari. Spiegheremo l’uso di questo modulo più avanti.
Fate clic sul modulo Iteratore per aprire la sua finestra di configurazione.
Una volta fatto clic sul campo Array, si aprirà un menu sulla sinistra con alcuni elementi di dati recuperati dal modulo webhook. Trascinate semplicemente l’elemento di dati chiamato Intestazioni nel campo Array del modulo Iteratore. Si tratterà di un array con molti valori.
Il passaggio successivo consiste nel collegare l’app Email dopo l’app Iteratore. Fate clic sull’icona più e cercate l’app Email. Una volta trovata, fate clic su di essa per selezionare il modulo che desiderate utilizzare.
Selezionate il modulo Invia un’email dall’elenco per inviare un’email a voi stessi ogni volta che viene creato un nuovo utente nella vostra comunità Discourse.
Prima di configurare il modulo Email, dovete impostare un filtro tra le app Iteratore ed Email che vi assicurerà di ricevere email solo per gli utenti che si iscrivono alla vostra comunità. Questo è necessario perché, per impostazione predefinita, Discourse attiverà richieste webhook per tutti i tipi di attività degli utenti.
Nella finestra di configurazione del filtro, dovrete prima inserire un’etichetta. Può essere qualsiasi cosa vi piaccia, ad esempio “Nuovo utente”.
Poi, dovrete creare una condizione che attiverà questo filtro. Nel primo campo della condizione, mappate semplicemente l’elemento di dati Valore dal modulo Iteratore. Per l’operatore logico, selezionate Uguale a. Infine, nel campo inferiore, inserite il valore user_created.
Il funzionamento di questa condizione è il seguente:
I dati webhook che Integromat riceve da Discourse ogni volta che un utente compie un’azione contengono un array Intestazioni (un array è una raccolta di valori). Il compito dell’iteratore è recuperare ciascuno di questi valori individualmente in modo che possano essere elaborati e applicati al filtro. Da qualche parte in questo array di valori, c’è un valore che specifica il tipo di evento eseguito dall’utente. Poiché l’evento che ci interessa si chiama user_created (perché indica che l’azione compiuta dall’utente è stata quella di creare un nuovo account), dobbiamo impostare un filtro per assicurarci che i valori delle intestazioni dei dati webhook contengano effettivamente questo valore. Se lo contengono, procediamo con l’esecuzione dei moduli successivi dello scenario. Se non lo contengono, l’esecuzione dello scenario termina rapidamente e nessuna email viene inviata.
Una volta configurato il filtro, potete fare clic sul modulo Email per aprire la sua finestra di configurazione.
La prima cosa da fare è collegare l’account email che desiderate utilizzare per inviare le email. Se state collegando il vostro Gmail, assicuratevi di seguire questa guida, che spiega il processo passo dopo passo.
Una volta collegata la vostra email, potete procedere impostando le altre opzioni del modulo email.
Per il campo A, potete fare clic su Aggiungi un destinatario e inserire l’email su cui desiderate ricevere questi aggiornamenti.
Per l’Oggetto, potete inserire qualsiasi cosa vi piaccia e per il Tipo di contenuto, potete selezionare l’opzione Testo semplice per costruire il messaggio che desiderate inviare ogni volta che questo modulo viene eseguito.
Il campo Contenuto è dove potete costruire il messaggio dell’email. Qui, potete scrivere del testo statico (cioè testo che rimane sempre lo stesso in ogni esecuzione), ma potete anche mappare elementi di dati dinamici dal modulo webhook. Il webhook contiene molti dati sull’utente che potete utilizzare, tra cui il nome utente, il nome, l’email, ecc.
Ed eccolo fatto! Siete riusciti con successo a creare uno scenario Integromat che vi notifica ogni volta che un nuovo utente si unisce alla vostra comunità Discourse.
Speriamo che questo tutorial sia stato utile! Se avete domande o raccomandazioni su cosa vorreste vedere in futuro, non esitate a farcelo sapere nei commenti, inviate un ticket al team di supporto di Integromat o visitate la Comunità Facebook di Integromat con 10.000 membri.
Buona automazione!
LINKS
Come collegare Discourse con centinaia di app utilizzando Integromat