Zapier offre numerosi modelli ufficiali di Zap per Discourse. Questi modelli consentono di collegare Discourse a un’applicazione esterna con una configurazione minima. Puoi trovarli qui:
Scorri verso il basso nella pagina per visualizzare l’elenco delle integrazioni attualmente disponibili.
Questi modelli sono suddivisi in due tipi. Nel primo tipo, Discourse è l’app trigger. Questi modelli ti consentono di pubblicare i post di Discourse su Slack, Mattermost, Discord, Gruppi Facebook, Pagine Facebook, Google Sheets e altri servizi. Nel secondo tipo di modello, Discourse è l’app azione. Con questi modelli puoi pubblicare post da WordPress e Ghost su Discourse. Esiste inoltre un modello per pubblicare stream live di Twitch su Discourse.
Aggiunta delle credenziali di Discourse su Zapier
Per utilizzare qualsiasi integrazione Zapier per Discourse, dovrai aggiungere l’URL di base del tuo forum, oltre al tuo nome utente Discourse e alla tua Chiave API, durante la prima configurazione dello Zap.
Nella maggior parte dei casi, lo Zap dovrebbe essere configurato da un amministratore del sito utilizzando il proprio nome utente Discourse e la propria Chiave API. Le Chiavi API possono essere create su Discourse dalla pagina Amministratore / API / Chiavi. Tieni presente che il valore completo della Chiave API viene visualizzato una sola volta al momento della creazione della chiave, quindi assicurati di copiarlo in quel momento.
Dopo aver aggiunto le tue credenziali Discourse a Zapier, fai clic sul pulsante Continua. Dovresti vedere un messaggio di successo sullo schermo.
Configurazione dei post da recuperare tramite lo Zap
Quando Discourse è l’app trigger, per impostazione predefinita tutti i nuovi post sul tuo sito attiveranno lo Zap. Puoi limitare lo Zap in modo che venga attivato solo per i post creati in un argomento specifico, o solo per i post creati da un utente specifico, nella facoltativa fase “Modifica opzioni”.
Utilizza il menu a tendina Argomento della fase per selezionare un argomento specifico che deve attivare lo Zap. Quando questa opzione è configurata, solo i post creati nell’argomento scelto verranno recuperati da Zapier. Utilizza il menu a tendina Autore della fase per selezionare un nome utente per lo Zap. Quando configurato, solo i post creati da questo utente verranno recuperati da Zapier.
Aggiunta di un passaggio filtro per un controllo più preciso sui post
Se la fase “Modifica opzioni” non ti offre un controllo sufficiente su quali post vengono utilizzati per attivare lo Zap, puoi aggiungere un facoltativo passaggio Filtro allo Zap. Un esempio di ciò che è possibile fare con un filtro è scegliere di far continuare lo Zap solo se il post è il primo post in una categoria specifica. Per aggiungere un filtro, fai clic sull’icona 
situata sotto il Trigger, quindi seleziona “Filtro” dal menu.
Il filtro ti consentirà di impostare le condizioni in base alle quali lo Zap deve continuare. L’esempio seguente procederà solo se il post è il primo post in un argomento che si trova nella categoria con ID 2.
Selezione del contenuto di Discourse da pubblicare
Quando pubblichi post da Discourse su un’altra applicazione, Zapier ti consentirà di selezionare quale parte del post desideri pubblicare. La scelta di cosa pubblicare dipenderà dall’applicazione di destinazione. Userò come esempio la pubblicazione di un post di Discourse in un Gruppo Facebook.
Il campo Messaggio del modulo imposta il contenuto che verrà pubblicato. Per pubblicare l’intero contenuto del post, seleziona il campo “Raw” dal menu a tendina Messaggio. Per pubblicare solo il titolo dell’argomento, seleziona “Topic Title” dal menu a tendina.
Costruzione di un link a un post o a un argomento
Quando pubblichi un post di Discourse su un’applicazione esterna, potresti dover costruire un link al post o al suo argomento utilizzando i dati restituiti da Discourse. Per farlo, inserisci l’URL di base del tuo sito nel campo in cui stai aggiungendo il link, seguito da /t/. Ad esempio, se l’URL del tuo sito è https://discourse.example.com, inserisci https://discourse.example.com/t/ nel modulo.
Ora apri il menu a tendina del campo e seleziona “Topic Slug” dal menu.
Zapier aggiungerà un segnaposto per lo slug dell’argomento al campo.
Ora inserisci una barra (/) dopo il segnaposto dello slug dell’argomento e seleziona “Topic ID” dal menu a tendina.
Il risultato finale sarà simile allo screenshot sottostante.
Per costruire un link a post specifici all’interno di un argomento, aggiungi un’altra barra (/) al campo e seleziona “Post Number” dal menu.
Tieni presente che i valori di eventuali segnaposto utilizzati durante la configurazione dello Zap verranno sostituiti dai valori passati da Discourse quando un nuovo post viene pubblicato.
Creazione di integrazioni senza un modello
I modelli Zapier elencati nella loro pagina di integrazioni sono progettati per facilitare la connessione di Discourse con un’applicazione esterna. Se desideri collegare Discourse a un’applicazione che non dispone di un modello, o se desideri creare uno Zap che ascolti un webhook di Discourse o invii una richiesta POST all’API di Discourse, puoi farlo seguendo o modificando una delle guide elencate qui:
.