Discourse Zendesk

[Discourse]

	Zusammenfassung	Erstellen von Zendesk-Tickets aus Discourse-Themen.
	Installationsanleitung	Dieses Plugin ist im Discourse-Kern enthalten. Eine separate Installation des Plugins ist nicht erforderlich.

Da es sich um ein #offizielles Plugin handelt, das vom Discourse-Team gepflegt wird, können Support, Contribute > Bug, #contribute:ux- und #contribute:feature-Anfragen in den jeweiligen Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicke auf einen der folgenden Links, um eine Anfrage zu starten.

 Support  Fehler  UX  Funktion

Da Zendesk die API-Token-Authentifizierung am 30. April 2027 dauerhaft deaktivieren wird, müssen bestehende Installationen auf Authentifizierung via OAuth migrieren.

Funktionen

Erstellen von Zendesk-Tickets

Mit diesem Plugin können Sie Zendesk-Tickets aus Discourse-Themen erstellen. Dies kann entweder durch die Konfiguration des Plugins erfolgen, sodass alle Themen in einer Kategorie automatisch Zendesk-Tickets generieren, oder indem Sie einzelne Themen auf Zendesk schieben, indem Sie auf die Schaltfläche „Zendesk-Ticket erstellen“ klicken, die für Site-Mitarbeiter unter jedem Thema angezeigt wird:

Wenn das Ticket erstellt wird, wird der Autor des ersten Beitrags des Themas als Antragsteller in Zendesk festgelegt. Er wird auch zu Ihrer Liste der Zendesk-Kunden hinzugefügt.

Nachdem das Ticket erstellt wurde, wird die Schaltfläche „Zendesk-Ticket erstellen“ in „In Zendesk anzeigen“ aktualisiert. Ein Klick auf diese Schaltfläche führt Sie zum zugehörigen Zendesk-Ticket:

Antworten, die in Discourse erstellt wurden, auf Zendesk schieben

Das Plugin ermöglicht es Ihnen, optional alle Antworten auf das Discourse-Thema auf das Zendesk-Ticket zu schieben oder nur die Antworten des Autors des Themas zu schieben. Beide Funktionen können über die Einstellungen des Plugins konfiguriert werden.

Synchronisieren von Zendesk-Kommentaren mit Discourse

Zendesk-Kommentare können mit dem Discourse-Thema synchronisiert werden, aus dem das Ticket stammt.

Konfiguration

Die Einstellungen für Discourse Zendesk sind über die Plugin-Seite im Admin-Bereich Ihrer Discourse-Site zugänglich. Klicken Sie auf der Seite auf die Schaltfläche „Einstellungen“ für den Eintrag „discourse-zendesk-plugin“.

OAuth konfigurieren

Erstellen Sie zunächst einen OAuth-Client in Zendesk:

1. Gehen Sie im Zendesk Admin Center zu Apps and integrations > APIs > OAuth clients.
2. Klicken Sie auf Add OAuth client.
3. Geben Sie einen Namen und eine Beschreibung ein und wählen Sie Confidential als Client-Typ. Eine Weiterleitungs-URL ist nicht erforderlich.
4. Konfigurieren Sie die Scopes auf tickets:read, tickets:write, users:read und users:write, um den OAuth-Client nur auf die vom Plugin benötigten Scopes zu beschränken.
5. Speichern Sie den Client.
6. Kopieren Sie die Kennung und den Geheimen Schlüssel des Clients. Zendesk zeigt den vollständigen geheimen Schlüssel nur einmal an.

Konfigurieren Sie diese Discourse-Einstellungen:

• zendesk oauth client id: Geben Sie die Kennung des OAuth-Clients ein.
• zendesk oauth client secret: Geben Sie den Geheimen Schlüssel des OAuth-Clients ein.

Weitere Einstellungen

• zendesk url: Geben Sie die URL Ihres Zendesk-Kontos gefolgt von /api/v2 ein. Zum Beispiel https://example.zendesk.com/api/v2.

• zendesk enabled: Aktivieren oder deaktivieren Sie das Plugin.

• zendesk jobs api token: Veraltet. Bestehende Installationen sollten auf OAuth migrieren.

• zendesk jobs email: Veraltet. Bestehende Installationen sollten auf OAuth migrieren.

• zendesk autogenerate all categories (eher zendesk enable all categories): Erstellen Sie automatisch Zendesk-Tickets für Themen in jeder Kategorie. Diese Einstellung ist standardmäßig deaktiviert.

• zendesk autogenerate categories (eher zendesk enabled categories): Wählen Sie die Discourse-Kategorien aus, deren neue Themen automatisch Zendesk-Tickets erstellen sollen.

• zendesk job push all posts: Schieben Sie Antworten als Ticket-Kommentare auf Zendesk. Diese Einstellung ist standardmäßig aktiviert.

• zendesk job push only author posts: Schieben Sie nur Antworten, die vom ursprünglichen Themenautor geschrieben wurden. Diese Einstellung gilt, wenn zendesk job push all posts aktiviert ist, und ist standardmäßig deaktiviert.

• sync comments from zendesk und zendesk incoming webhook token: Synchronisieren Sie Kommentare von Zendesk mit Discourse. Siehe So aktivieren Sie die Zwei-Wege-Synchronisierung mit Zendesk.

• zendesk tags: Eine optionale Liste von Tags, die zu Zendesk-Tickets hinzugefügt werden sollen, die aus Discourse erstellt wurden.