Zum Hauptinhalt springen

Zendesk-Integration - Einrichtungsanleitung

Verbinde dein Zendesk-Konto mit Goodweek, um Support-Tickets, Organisationen, Nutzer, Makros und Ansichten direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Zendesk-Konto mit Goodweek, um Support-Tickets, Organisationen, Nutzer, Makros und Ansichten direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die dem Nutzer innerhalb von Zendesk gewährten Zugriffsebenen und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Die Ergebnisse und verfügbaren Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Nutzers variieren.

📋 Voraussetzungen

Bevor ein Nutzer die Zendesk-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek-Admin-Panel im Tab „Integrationen“ aktivieren.

Admin-Einrichtung

Die Zendesk-Integration verwendet OAuth 2.0. Der verbindende Nutzer muss über die entsprechende Zendesk-Rolle verfügen, um Drittanbieter-Apps zu autorisieren. Für bestimmte Tools, wie das Konfigurieren von Triggern, Automatisierungen oder benutzerdefinierten Feldern, ist Zugriff auf Admin-Ebene erforderlich.

Nutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Zendesk und klicke auf Verbinden.

  3. Du wirst aufgefordert, deine Zendesk-Subdomain einzugeben (z. B. yourcompany aus yourcompany.zendesk.com).

  4. Du wirst zu Zendesk weitergeleitet, wo du aufgefordert wirst, dich anzumelden und den Zugriff zu autorisieren.

  5. Klicke auf Erlauben, um den Zugriff zu gewähren und zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Nutzer muss sein eigenes Konto einzeln verbinden.

  • Goodweek kann nur auf die Tickets, Organisationen und Daten zugreifen, die dein individuelles Zendesk-Konto einsehen darf. Es gelten die Sichtbarkeitsbeschränkungen des Agenten.

  • Einige Tools (Trigger, Automatisierungen, benutzerdefinierte Felder, Ansichten) erfordern die Zendesk-Administratorrolle. Reguläre Agenten haben keinen Zugriff auf diese Tools.

  • Du kannst den Zugriff von Goodweek jederzeit über Zendesk → Admin Center → Apps und Integrationen → Verbindungen → Composio → Widerrufen entziehen.


Verfügbare Tools

Tool

Beschreibung

Typ

Create Zendesk Ticket

Erstellt ein neues Support-Ticket in Zendesk mit voller Unterstützung für alle Ticketfelder.

Schreiben

Create Many Zendesk Tickets

Erstellt bis zu 100 Tickets in einer einzigen Anfrage als Hintergrundauftrag.

Schreiben

Get Zendesk About Me

Ruft Informationen über den aktuell authentifizierten Zendesk-Nutzer ab.

Lesen

Show Changes to Ticket

Zeigt die Änderungen an einem Ticket, die sich aus der Anwendung einer bestimmten Makro ergeben würden.

Lesen

Get Incremental Tickets

Ruft Tickets ab, die seit einem angegebenen Startzeitpunkt für die inkrementelle Synchronisierung geändert wurden.

Lesen

List Deleted Tickets

Listet Tickets auf, die in Zendesk vorläufig gelöscht (soft-deleted) wurden, mit bis zu 100 pro Seite.

Lesen

Create Zendesk Request

Erstellt über die API eine neue Support-Anfrage eines Endnutzers.

Schreiben

Create Side Conversation

Erstellt eine private Nebenunterhaltung zu einem Zendesk-Ticket für die Kommunikation zwischen Agenten.

Schreiben

Upload Zendesk Attachment

Lädt einen Dateianhang zu Zendesk hoch und gibt ein Anhang-Token zur Verwendung in Ticketkommentaren zurück.

Schreiben

Create Zendesk User

Erstellt einen neuen Nutzer (Agent oder Endnutzer) in Zendesk.

Schreiben

Create Many Zendesk Users

Erstellt bis zu 100 Nutzer in einer einzigen, asynchron verarbeiteten Anfrage.

Schreiben

Create or Update User

Erstellt oder aktualisiert einen Zendesk-Nutzer basierend auf einer Übereinstimmung von E-Mail oder external_id.

Schreiben

Autocomplete Users

Sucht Zendesk-Nutzer anhand eines Namenspräfixes für eine schnelle Nutzersuche.

Lesen

Get Incremental Users

Ruft Nutzer ab, die seit einem angegebenen Startzeitpunkt für die inkrementelle Synchronisierung geändert wurden.

Lesen

Create Zendesk Organization

Erstellt eine neue Organisation in Zendesk.

Schreiben

Get Zendesk Organizations

Listet alle Organisationen in Zendesk mit Seitenaufteilung (Pagination) auf.

Lesen

Create or Update Organization

Erstellt oder aktualisiert eine Zendesk-Organisation anhand von external_id als Abgleichsschlüssel.

Schreiben

Merge Zendesk Organizations

Führt zwei Zendesk-Organisationen zusammen und kombiniert Nutzer, Tickets und Daten.

Schreiben

Create Organization Membership

Weist einen Nutzer einer Zendesk-Organisation zu.

Schreiben

Create Zendesk Group

Erstellt eine neue Agentengruppe in Zendesk.

Schreiben

List Assignable Groups

Listet alle Gruppen auf, die Tickets oder Nutzern zugewiesen werden können.

Lesen

List Group Users

Listet alle Nutzer auf, die zu einer bestimmten Zendesk-Gruppe gehören.

Lesen

Create Zendesk Group Membership

Weist einen Agenten einer Zendesk-Gruppe zu.

Schreiben

List Macros

Listet alle gemeinsamen und persönlichen Makros im Zendesk-Konto auf.

Lesen

Show Macro

Ruft Details zu einer bestimmten Makro anhand ihrer ID ab.

Lesen

Apply Zendesk Macro Preview

Zeigt eine Vorschau, wie sich eine Makro auf ein Ticket auswirken würde, ohne sie anzuwenden.

Lesen

Create View

Erstellt eine neue Ticketansicht (gespeicherter Filter) in Zendesk.

Schreiben

Preview View

Zeigt eine Vorschau, welche Tickets einer Reihe von Ansichtsbedingungen entsprechen, bevor die Ansicht gespeichert wird.

Schreiben

List Active Triggers

Listet alle aktiven Ticket-Trigger im Zendesk-Konto auf.

Lesen

Create Trigger

Erstellt einen neuen Geschäftsregel-Trigger, der auf Tickets wirkt, die bestimmte Bedingungen erfüllen.

Schreiben

List Automations

Listet alle im Zendesk-Konto konfigurierten Automatisierungen auf.

Lesen

Create Automation

Erstellt eine neue Automatisierung, die basierend auf zeitbasierten Bedingungen Aktionen auf Tickets ausführt.

Schreiben

List Brands

Listet alle im Zendesk-Konto konfigurierten Marken auf.

Lesen

Create Ticket Field

Erstellt ein neues benutzerdefiniertes Ticketfeld mit verschiedenen Feldtypen.

Schreiben

Create Custom Object Record

Erstellt einen neuen Datensatz für einen benutzerdefinierten Objekttyp in Zendesk.

Schreiben

Get Account Settings

Ruft die Kontoeinstellungen und Funktionskonfiguration von Zendesk ab.

Lesen

Get Attachment

Ruft Details zu einem einzelnen Zendesk-Anhang anhand seiner ID ab.

Lesen

List Guide Surveys

Listet verfügbare CSAT-Umfragen in Zendesk Guide auf.

Lesen

List Guide Survey Responses

Listet CSAT-Umfrageantworten aus Zendesk Guide auf.

Lesen

Delete Zendesk Ticket

Löscht ein Ticket einschließlich seines gesamten Konversationsverlaufs endgültig. Diese Aktion ist unwiderruflich.

⚠️ Destruktiv

Delete Zendesk User

Löscht einen Nutzer endgültig aus Zendesk. Diese Aktion kann nicht rückgängig gemacht werden.

⚠️ Destruktiv

Delete Zendesk Organization

Löscht eine Organisation endgültig aus Zendesk. Diese Aktion ist unwiderruflich.

⚠️ Destruktiv

Bulk Delete Zendesk Suspended Tickets

Löscht mehrere gesperrte Tickets in einer einzigen Aktion endgültig.

⚠️ Destruktiv

Anwendungsfälle

  • Support-Tickets aus Unterhaltungen erstellen und verwalten. Erfasse neue Zendesk-Tickets mit dem richtigen Betreff, der richtigen Beschreibung, dem richtigen Anfragenden und der richtigen Priorität direkt aus einer Goodweek-Unterhaltung heraus und behalte den Kontext der Support-Vorgänge im Verhältnis zu deiner übrigen Arbeit.

  • Nutzer und Organisationen verwalten. Erstelle oder aktualisiere Zendesk-Nutzer und -Organisationen, weise Nutzer Gruppen zu und verwalte Organisationsmitgliedschaften aus Goodweek heraus, um deine Support-Struktur akkurat zu halten.

  • Makros und Trigger vor der Anwendung prüfen. Sieh dir in Goodweek eine Vorschau an, wie sich Makros oder Ansichtsbedingungen auf Tickets auswirken würden, bevor du Änderungen bestätigst — das verringert das Risiko einer versehentlichen Fehlkonfiguration.

  • CSAT- und Umfrageantworten überwachen. Rufe CSAT-Umfrageergebnisse und -antworten aus Zendesk Guide innerhalb einer Goodweek-Unterhaltung ab, um Kundenzufriedenheitsdaten einzusehen, ohne im Zendesk-Explore-Dashboard navigieren zu müssen.


Fehlerbehebung

Einige Tools funktionieren nach dem Verbinden nicht

Bestimmte Zendesk-Tools erfordern die Admin-Rolle. Wenn du dich mit einem Agent-Konto verbindest, sind Tools auf Admin-Ebene nicht zugänglich. Wende dich bei Bedarf an deinen Zendesk-Administrator, um deine Rolle anzupassen.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass der Administrator deiner Organisation die Zendesk-Integration im Goodweek-Admin-Panel im Tab „Integrationen“ aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?