Zapier bietet eine Reihe offizieller Discourse-Zap-Vorlagen an. Diese Vorlagen ermöglichen es, Discourse mit einer externen Anwendung mit minimalem Konfigurationsaufwand zu verbinden. Sie finden sie hier:
Scrollen Sie auf dieser Seite nach unten, um die Liste der aktuell verfügbaren Integrationen zu sehen.
Diese Vorlagen sind in zwei Typen unterteilt. Beim ersten Typ ist Discourse die Trigger-App. Diese Vorlagen ermöglichen es Ihnen, Discourse-Beiträge in Slack, Mattermost, Discord, Facebook-Gruppen, Facebook-Seiten, Google Sheets und andere Dienste zu veröffentlichen. Beim zweiten Vorlagentyp ist Discourse die Aktor-App. Mit diesen Vorlagen können Sie Beiträge von WordPress und Ghost in Discourse veröffentlichen. Es gibt auch eine Vorlage zum Veröffentlichen von Twitch-Live-Streams in Discourse.
Hinzufügen Ihrer Discourse-Anmeldedaten in Zapier
Um eine der Zapier-Discourse-Integrationen zu nutzen, müssen Sie beim ersten Einrichten des Zaps die Basis-URL Ihres Forums sowie Ihren Discourse-Benutzernamen und Ihren API-Schlüssel angeben.
In den meisten Fällen sollte der Zap von einem Site-Administrator mit dessen Discourse-Benutzernamen und API-Schlüssel konfiguriert werden. API-Schlüssel können in Discourse auf der Seite „Admin / API / Keys" erstellt werden. Beachten Sie, dass der vollständige API-Schlüsselwert nur einmal beim Erstellen des Schlüssels angezeigt wird. Kopieren Sie ihn daher zu diesem Zeitpunkt.
Nachdem Sie Ihre Discourse-Anmeldedaten in Zapier hinzugefügt haben, klicken Sie auf die Schaltfläche „Weiter". Sie sollten eine Erfolgsmeldung auf dem Bildschirm sehen.
Konfigurieren, welche Beiträge der Zap abrufen soll
Wenn Discourse die Trigger-App ist, werden standardmäßig alle neuen Beiträge auf Ihrer Seite als Auslöser für den Zap verwendet. Sie können den Zap so einschränken, dass er nur für Beiträge ausgelöst wird, die in einem bestimmten Thema erstellt wurden, oder nur für Beiträge, die von einem bestimmten Benutzer erstellt wurden. Dies erfolgt im optionalen Schritt „Optionen bearbeiten".
Verwenden Sie das Dropdown-Menü „Thema" des Schritts, um ein bestimmtes Thema auszuwählen, das den Zap auslösen soll. Wenn dies konfiguriert ist, werden von Zapier nur Beiträge abgerufen, die im gewählten Thema erstellt wurden. Verwenden Sie das Dropdown-Menü „Autor" des Schritts, um einen Benutzernamen für den Zap auszuwählen. Wenn dies konfiguriert ist, werden von Zapier nur Beiträge abgerufen, die von diesem Benutzer erstellt wurden.
Hinzufügen eines Filterschritts für eine feinere Steuerung der Beiträge
Wenn der Schritt „Optionen bearbeiten" nicht genügend Kontrolle darüber bietet, welche Beiträge als Auslöser für den Zap verwendet werden, können Sie einen optionalen Filterschritt zum Zap hinzufügen. Ein Beispiel dafür, was mit einem Filter möglich ist, besteht darin, festzulegen, dass der Zap nur dann fortfährt, wenn der Beitrag der erste Beitrag in einer bestimmten Kategorie ist. Um einen Filter hinzuzufügen, klicken Sie auf das 
-Symbol unter dem Trigger und wählen Sie dann „Filter" aus dem Menü.
Der Filter ermöglicht es Ihnen, die Bedingungen festzulegen, unter denen der Zap fortfahren soll. Das folgende Beispiel fährt nur fort, wenn der Beitrag der erste Beitrag in einem Thema ist, das in der Kategorie mit der ID 2 liegt.
Auswahl des in Discourse zu veröffentlichenden Inhalts
Beim Veröffentlichen von Beiträgen von Discourse in eine andere Anwendung ermöglicht Zapier Ihnen die Auswahl des Teils des Beitrags, der veröffentlicht werden soll. Ihre Wahl hängt von der Anwendung ab, in die Sie veröffentlichen. Als Beispiel werde ich die Veröffentlichung eines Discourse-Beitrags in einer Facebook-Gruppe verwenden.
Das Feld „Nachricht" im Formular legt den Inhalt fest, der veröffentlicht wird. Um den vollständigen Beitrag zu veröffentlichen, wählen Sie im Dropdown-Menü „Nachricht" das Feld „Raw" aus. Um nur den Titel des Themas zu veröffentlichen, wählen Sie im Dropdown-Menü „Thementitel" aus.
Erstellen eines Links zu einem Beitrag oder einem Thema
Beim Veröffentlichen eines Discourse-Beitrags in eine externe Anwendung müssen Sie möglicherweise einen Link zum Beitrag oder zu seinem Thema aus den von Discourse zurückgegebenen Daten erstellen. Geben Sie dazu die Basis-URL Ihrer Site in das Feld ein, in das Sie den Link hinzufügen möchten, gefolgt von /t/. Wenn die URL Ihrer Site beispielsweise https://discourse.example.com lautet, geben Sie https://discourse.example.com/t/ in das Formular ein.
Öffnen Sie nun das Dropdown-Menü des Felds und wählen Sie „Thema-Slug" aus dem Menü.
Zapier fügt einen Platzhalter für den Thema-Slug in das Feld ein.
Geben Sie nun einen Schrägstrich (/) nach dem Thema-Slug-Platzhalter ein und wählen Sie dann „Thema-ID" aus dem Dropdown-Menü.
Das Endergebnis sieht ähnlich aus wie im folgenden Screenshot.
Um einen Link zu bestimmten Beiträgen in einem Thema zu erstellen, fügen Sie einen weiteren Schrägstrich (/) zum Feld hinzu und wählen Sie dann „Beitragsnummer" aus dem Menü.
Beachten Sie, dass die Werte aller Platzhalter, die Sie beim Einrichten des Zaps verwenden, durch die von Discourse übergebenen Werte ersetzt werden, wenn ein neuer Beitrag veröffentlicht wird.
Erstellen von Integrationen ohne Vorlage
Die auf der Integrationsseite von Zapier aufgeführten Vorlagen wurden entwickelt, um die Verbindung von Discourse mit einer externen Anwendung zu erleichtern. Wenn Sie Discourse mit einer Anwendung verbinden möchten, für die keine Vorlage vorhanden ist, oder wenn Sie einen Zap erstellen möchten, der auf einen Discourse-Webhook lauscht oder eine POST-Anfrage an die Discourse-API stellt, können Sie dies tun, indem Sie einen der hier aufgeführten Anleitungen folgen oder diese anpassen:
.