Zusammenfassung
In dieser Dokumentation behandeln wir:
- Aktivieren der Zendesk-Synchronisierungseinstellungen in Discourse
- Konfigurieren eines Zendesk-Webhooks
- Einrichten eines Zendesk-Triggers
Aktivieren der Zendesk-Synchronisierungseinstellungen
Zunächst müssen Sie das Zendesk-Plugin aktivieren, die Synchronisierungseinstellung aktivieren und ein sicheres Token angeben.
- Zu den Plugin-Einstellungen navigieren: Gehen Sie zu Ihrer Discourse-Seite und navigieren Sie zur Einstellungsseite des Zendesk-Plugins unter
/admin/plugins/discourse-zendesk-plugin. Alternativ finden Sie die Einstellungen, indem Sie unter/admin/site_settingssuchen. - Plugin aktivieren: Suchen Sie die Einstellung
zendesk enabledund aktivieren Sie sie, falls sie noch nicht aktiviert ist. - Synchronisierungseinstellung aktivieren: Suchen Sie die Einstellung
sync comments from zendeskund aktivieren Sie sie. - Webhook-Token bereitstellen: Generieren Sie im Feld
zendesk incoming webhook tokeneine zufällige sichere Zeichenfolge und fügen Sie diese hinzu. Dieses Token wird später für die Konfiguration des Zendesk-Webhooks verwendet. - Kategorien für die automatische Generierung konfigurieren: Die Zwei-Wege-Synchronisierung funktioniert nur für Themen in Kategorien, die für die automatische Generierung von Zendesk-Tickets konfiguriert sind. Aktivieren Sie entweder
zendesk autogenerate all categoriesoder fügen Sie bestimmte Kategorien zur Einstellungzendesk autogenerate categorieshinzu. Ohne dies ignoriert der Webhook eingehende Kommentare stillschweigend.
Einrichten eines Zendesk-Webhooks
Befolgen Sie diese Schritte, um einen Webhook in Zendesk zu konfigurieren:
- Auf die Webhooks-Seite zugreifen: Navigieren Sie in Zendesk unter Apps und Integrationen → Webhooks zum Abschnitt Webhooks.
- Beispiel-URL:
https://<instanz_name>.zendesk.com/admin/apps-integrations/webhooks/webhooks
- Beispiel-URL:
- Einen Webhook erstellen:
- Klicken Sie in der oberen rechten Ecke auf die Schaltfläche Aktionen.
- Wählen Sie Webhook erstellen.
- Füllen Sie die Webhook-Details aus:
- Anforderungsmethode:
PUT - Endpunkt-URL:
https://<discourse.example.com>/zendesk-plugin/sync - Anforderungsformat: JSON
- Anforderungsmethode:
- Den Webhook testen:
- Klicken Sie auf die Schaltfläche Webhook testen.
- Wählen Sie im Dropdown-Menü „Benutzerdefinierter Test“ aus.
- Ersetzen Sie das JSON durch das folgende und fügen Sie Ihr Token ein:
{
"ticket_id": "{{ticket.id}}",
"topic_id": "{{ticket.external_id}}",
"email": "{{current_user.email}}",
"token": "INSERT TOKEN HERE"
}
- Klicken Sie auf Test senden. Erwarten Sie eine
400 Bad Requestals positives Signal mit der angezeigten HTML-Seite, die den Erfolg anzeigt.
Einrichten eines Zendesk-Triggers
Konfigurieren Sie einen Trigger in Zendesk, um Aktionen zu automatisieren:
- Auf die Triggers-Seite zugreifen: Gehen Sie in Zendesk unter Admin → Objekte und Regeln → Geschäftsregeln → Trigger zum Abschnitt Trigger.
- Beispiel-URL:
https://<instanz_name>.zendesk.com/admin/objects-rules/rules/triggers
- Beispiel-URL:
- Einen Trigger erstellen:
- Klicken Sie auf Trigger hinzufügen.
- Nennen Sie ihn „Discourse Sync“ und legen Sie die Kategorie auf „Benachrichtigungen“ fest.
- Konfigurieren Sie die Bedingungen und Aktionen wie unten dargestellt.
- Verwenden Sie denselben JSON-Body wie im Test-Webhook-Schritt, wobei Sie „INSERT TOKEN HERE“ erneut durch Ihr Token ersetzen.
- Den Trigger speichern: Stellen Sie nach der Konfiguration sicher, dass Sie den Trigger speichern.
Es gibt jedoch ein Problem, wenn ein Kommentar in Zendesk einen Anhang enthält – die Nachricht kommt durch, aber der Anhang fehlt. Ich bin mir nicht sicher, ob im Webhook ein zusätzlicher Parameter übergeben werden muss, um Anhänge zu verarbeiten. Könnte jemand bitte klären, ob dafür spezifische Parameter erforderlich sind?
