n8n-Zendesk-Integration: Nodes, Credentials und Beispiel-Workflows

Der Zendesk-Node liest oder ändert Daten in Zendesk als Schritt in einem Workflow. Die n8n-Dokumentation gruppiert seine Operationen nach Ressource.

Ein Verhalten sorgt immer wieder für Überraschungen. Wenn Sie Update Ticket verwenden und das Feld Tag Names or IDs ausfüllen, wird laut n8n-Dokumentation die gesamte Tag-Liste des Tickets ersetzt; jedes Tag, das Sie nicht angeben, wird entfernt. Das entspricht dem Standardverhalten der Zendesk API bei Tag-Updates. Die Dokumentation nennt drei Workarounds: die aktuellen Tags abrufen und vor dem Update mit den neuen zusammenführen, den HTTP-Request-Node mit der Zendesk-Eigenschaft additional_tags verwenden oder den Tags-Endpunkt des Tickets aufrufen. Die letzten beiden fügen Tags hinzu, ohne bestehende zu entfernen.

Wenn der Node eine benötigte Operation nicht unterstützt, verwenden Sie den HTTP-Request-Node, setzen Authentication auf Predefined Credential Type und wählen Ihr Zendesk-Credential. Die Anfrage nutzt dann dieselbe Verbindung wie der Zendesk-Node.

Die Nodes Zendesk und Zendesk Trigger verwenden dasselbe Credential, und n8n unterstützt zwei Arten der Authentifizierung. Beide brauchen Ihre Subdomain, also den Teil Ihrer Zendesk-URL zwischen https:// und .zendesk.com.

• API-Token: Öffnen Sie im Zendesk Admin Center Apps and integrations, dann APIs, und aktivieren Sie den Token-Zugriff für die Zendesk API. Fügen Sie ein Token mit einer Beschreibung hinzu und kopieren Sie es. Geben Sie in n8n die Subdomain, die E-Mail-Adresse, mit der Sie sich bei Zendesk anmelden, und das Token ein.
• OAuth2: Legen Sie im Zendesk Admin Center unter Apps and integrations, dann APIs, einen OAuth-Client an. Fügen Sie die OAuth-Callback-URL von n8n in das Feld für die Redirect-URL des Clients ein. Kopieren Sie die eindeutige Kennung des Clients in Client ID in n8n und sein Secret in Client Secret, ergänzen Sie die Subdomain, speichern Sie und verbinden Sie Ihr Zendesk-Konto.

Es gibt zwei Wege, einen n8n-Workflow aus Zendesk zu starten. Der Zendesk-Trigger-Node startet einen Workflow, wenn Zendesk-Ereignisse den Bedingungen entsprechen, die Sie im Node festlegen. Im Beispiel der n8n-Dokumentation filtert er nach Tickets mit dem Status Open, und der Workflow läuft, sobald Sie ihn aktivieren.

Die Alternative ist, die Verbindung selbst zu bauen. Gehen Sie im Zendesk Admin Center zu Apps and integrations, dann Webhooks, legen Sie einen Webhook an, wählen Sie Trigger oder Automation als Verbindungsmethode und richten Sie ihn auf die Production URL eines n8n-Webhook-Nodes. Fügen Sie dann einem Zendesk-Trigger oder einer Automation die Aktion 'Notify webhook' hinzu und schreiben Sie die Payload, die 16.000 Zeichen nicht überschreiten darf. So bleiben die Bedingungen in den Geschäftsregeln von Zendesk, und Sie bestimmen genau, welche Felder gesendet werden.

Wenn Sie einen Webhook verwenden, prüfen Sie, ob Anfragen wirklich von Zendesk kommen. Zendesk sendet zwei Header, X-Zendesk-Webhook-Signature und X-Zendesk-Webhook-Signature-Timestamp. Die Signatur ist base64(HMACSHA256(timestamp + body)), gebildet mit dem Signing Secret des Webhooks, das Sie auf der Detailseite des Webhooks anzeigen oder über die API abrufen können. Berechnen Sie sie in Ihrem Workflow neu und lehnen Sie Anfragen ab, die nicht übereinstimmen. Zendesk weist außerdem darauf hin, dass dieselbe Aktion einen Webhook mehr als einmal aufrufen kann; gestalten Sie den Workflow also so, dass er für dasselbe Ticket gefahrlos zweimal laufen kann.

Der Webhook-Node kann sofort antworten, nach Abschluss des letzten Nodes oder über einen separaten Respond-to-Webhook-Node. Bei längeren Workflows gibt eine sofortige Antwort Zendesk eine schnelle Rückmeldung, während der Rest der Arbeit weiterläuft.

Hier ist ein gängiges Muster, beschrieben in Schritten. Es zeigt, wie die Nodes zusammenspielen. Es ist keine Fallstudie von TascaLab.

1. Trigger: ein Zendesk-Trigger-Node oder ein Webhook-Node, der von einem Zendesk-Trigger gespeist wird, der beim Erstellen eines Tickets auslöst. Senden Sie mindestens die Ticket-ID.
2. Abrufen: Ein Zendesk-Node mit der Ressource Ticket holt das vollständige Ticket, einschließlich Betreff, Beschreibung und aktueller Tags.
3. Klassifizieren: Ein Text-Classifier-Node ordnet den Text Kategorien zu, die Sie festlegen, etwa Abrechnung, technisches Problem oder Erstattung. Jede Kategorie hat einen Namen und eine Beschreibung, die dem Modell hilft. Standardmäßig werden Items, die zu keiner Kategorie passen, verworfen; aktivieren Sie daher den Zweig Other, um sie aufzufangen.
4. Aktualisieren: Ein Zendesk-Node setzt Gruppe und Tags. Führen Sie zuerst die bestehenden Tags zusammen oder fügen Sie Tags über den HTTP-Request-Node mit additional_tags hinzu, damit Sie keine Tags löschen, die Agenten gesetzt haben.
5. Benachrichtigen: Ein Slack-Node postet die Kategorie und einen Link zum Ticket in den Channel des Teams.
6. Fehler behandeln: Leiten Sie fehlgeschlagene Durchläufe an eine Warnung weiter, und warten Sie und versuchen Sie es erneut, wenn Zendesk eine 429-Antwort liefert.

Sie können dasselbe Muster erweitern. Schicken Sie dringende Tickets in einen separaten Slack-Channel, oder schlagen Sie mit der Ressource Organization die Organisation des Kunden nach, bevor Sie eine Gruppe wählen.

Zendesk begrenzt API-Anfragen pro Minute je nach Plan. Die Entwicklerdokumentation nennt diese Standardlimits für die Support- und Help-Center-APIs:

• Suite Team: 200 Anfragen pro Minute.
• Suite Growth und Suite Professional: 400 Anfragen pro Minute.
• Suite Enterprise: 700 Anfragen pro Minute.
• Suite Enterprise Plus: 2.500 Anfragen pro Minute.

Das Add-on High Volume API hebt einen berechtigten Plan auf 2.500 Anfragen pro Minute an. Es ersetzt das Plan-Limit, statt es zu ergänzen, und setzt Suite Growth oder höher (oder Support Professional oder höher) mit mindestens 10 Agenten-Lizenzen voraus. Bei Überschreitung des Limits liefert Zendesk HTTP 429 mit einem Retry-After-Header, der angibt, wie viele Sekunden Sie warten müssen. Manche Endpunkte haben eigene, strengere Limits. Zählen Sie die API-Aufrufe pro Durchlauf und multiplizieren Sie sie mit Ihrem Spitzen-Ticketvolumen. Bulk-Jobs, etwa das nachträgliche Setzen von Tags auf alten Tickets, stoßen eher an das Limit; bündeln Sie sie daher und bauen Sie Wartezeiten ein.

n8n läuft als n8n Cloud, eine verwaltete Instanz, die n8n für Sie betreibt, oder selbst gehostet auf Ihrem eigenen Rechner oder Ihrer eigenen Infrastruktur. Für die meisten selbst gehosteten Setups empfiehlt die Dokumentation Docker, und n8n Cloud, wenn Sie keine Erfahrung mit der Verwaltung von Servern haben. Bei beiden Trigger-Methoden muss Zendesk Ihre n8n-Instanz erreichen können. Sitzt eine selbst gehostete Instanz hinter einem Reverse Proxy, setzen Sie N8N_WEBHOOK_URL auf deren öffentliche Basis-URL, damit n8n die richtigen Webhook-URLs anzeigt und externe Dienste sie korrekt registrieren. N8N_WEBHOOK_URL ersetzt WEBHOOK_URL, das weiterhin funktioniert, aber ab n8n 2.35.0 veraltet ist.

TascaLab baut solche Zendesk-Automatisierungen mit n8n, Make, APIs und Webhooks, auf den Tools, die Sie bereits nutzen. Projekte für Ticket Routing & Categorization kosten 690 €, Projekte für Custom Automation ab 1.070 €. Die meisten Setups dauern 1 bis 3 Wochen, und jedes Projekt umfasst eine Basisdokumentation und 30 Tage Support nach dem Launch. Sie können mit einem kostenlosen 30-minütigen Health-Check-Gespräch starten.