Verbinde dein Zoho Desk-Konto mit Goodweek, um Support-Tickets, Kontakte, Agenten und Abteilungen direkt aus deinem KI-Arbeitsbereich zu verwalten.
ℹ️ Hinweis zur Governance
Goodweek überschreitet niemals die dem Nutzer innerhalb von Zoho Desk 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 der einzelnen Nutzer variieren.
📋 Voraussetzungen
Bevor ein Nutzer die Zoho Desk-Integration sehen und verbinden kann, muss dein Organisationsadministrator sie zunächst im Goodweek-Admin-Panel unter dem Tab Integrationen aktivieren.
Administrator-Einrichtung
Die Zoho Desk-Integration verwendet OAuth 2.0 und erfordert keine Genehmigung auf Administratorebene innerhalb von Zoho, bevor sich Nutzer verbinden können.
⚠️ Regionale Rechenzentren
Zoho betreibt Rechenzentren in mehreren Regionen (USA, EU, AU, IN, JP). Achte während des OAuth-Verbindungsvorgangs darauf, dich mit dem Konto anzumelden, das deinem richtigen regionalen Rechenzentrum zugeordnet ist.
Nutzerverbindung
Gehe in Goodweek zu Integrationen.
Suche Zoho Desk und klicke auf Verbinden.
Du wirst zu Zoho weitergeleitet, wo du dich anmelden und den Zugriff autorisieren musst.
Klicke auf Akzeptieren, um den Zugriff zu gewähren und zu Goodweek zurückzukehren.
Wichtige Hinweise
Jeder Nutzer muss sein eigenes Konto individuell verbinden.
Goodweek kann nur auf die Tickets, Kontakte und Abteilungen zugreifen, die dein individuelles Zoho Desk-Profil einsehen darf.
Du kannst den Zugriff von Goodweek jederzeit über Zoho Desk → Setup → Developer Space → OAuth-Apps → Composio → Widerrufen aufheben.
Verfügbare Tools
Tool | Beschreibung | Typ |
List Tickets | Listet Support-Tickets mit optionaler Filterung und Paginierung auf. | Lesen |
Get Ticket | Ruft die vollständigen Details eines bestimmten Support-Tickets anhand seiner ID ab. | Lesen |
Get Ticket Latest Thread | Ruft den neuesten Gesprächsverlauf eines Tickets ab. | Lesen |
Get Ticket Thread | Ruft einen bestimmten Gesprächsverlauf innerhalb eines Tickets anhand der Thread-ID ab. | Lesen |
List Ticket Conversations | Listet alle Gesprächsverläufe eines bestimmten Tickets auf. | Lesen |
Get Ticket Resolution | Ruft die zu einem bestimmten Ticket erfasste Lösungsnotiz ab. | Lesen |
Create Ticket | Erstellt ein neues Support-Ticket mit Betreff, Beschreibung, Abteilung und Anfragedetails. | Schreiben |
Update Ticket | Aktualisiert Status, Priorität, Zuständigen, Beschreibung oder andere Felder eines bestehenden Tickets. | Schreiben |
Download Ticket Attachment | Lädt einen Dateianhang von einem Zoho Desk-Ticket anhand der Anhang-ID herunter. | Lesen |
Upload Ticket Attachment | Lädt einen Dateianhang zu einem bestimmten Zoho Desk-Ticket hoch. | Schreiben |
List Contacts | Listet Kontakte in Zoho Desk mit optionaler Filterung und Paginierung auf. | Lesen |
Get Contact | Ruft die vollständigen Details eines bestimmten Zoho Desk-Kontakts anhand seiner ID ab. | Lesen |
Get Contacts By IDs | Ruft mehrere Kontakte anhand ihrer IDs in einer einzigen Anfrage ab. | Lesen |
Create Contact | Erstellt einen neuen Kontakt in Zoho Desk mit Name, E-Mail und weiteren Details. | Schreiben |
List Contact Accounts | Listet Konten auf, die mit einem bestimmten Zoho Desk-Kontakt verknüpft sind. | Lesen |
Update Account | Aktualisiert die Informationen eines bestehenden Zoho Desk-Kontos. | Schreiben |
List Agents | Listet alle Agenten der Zoho Desk-Organisation mit optionaler Filterung und Paginierung auf. | Lesen |
Get Agent | Ruft die vollständigen Details eines bestimmten Zoho Desk-Agenten anhand seiner ID ab. | Lesen |
Get Agents Count | Gibt die Gesamtzahl der Agenten zurück, optional gefiltert nach Status. | Lesen |
List Departments | Listet alle Abteilungen der Zoho Desk-Organisation auf. | Lesen |
Get Department | Ruft die vollständigen Details einer bestimmten Abteilung anhand ihrer ID ab. | Lesen |
Get Departments Count | Gibt die Gesamtzahl der Abteilungen zurück. | Lesen |
List Teams in Department | Listet alle Teams innerhalb einer bestimmten Zoho Desk-Abteilung auf. | Lesen |
List Views | Listet alle Ticketansichten (gespeicherte Filter) der Zoho Desk-Organisation auf. | Lesen |
List Roles | Listet alle in Zoho Desk konfigurierten Rollen auf. | Lesen |
List Organizations | Listet alle Organisationen auf, denen der aktuelle Nutzer angehört. | Lesen |
Search | Durchsucht Zoho Desk-Module, einschließlich Tickets, Konten, Kontakte und Aufgaben, nach einem Stichwort. | Lesen |
Update Many Tasks | Aktualisiert mehrere Aufgaben in einem einzigen API-Aufruf. | Schreiben |
Anwendungsfälle
Support-Tickets aus Unterhaltungen erstellen und aktualisieren. Erfasse neue Kundensupport-Tickets in Zoho Desk direkt aus einer Goodweek-Unterhaltung — mit Betreff, Beschreibung, Abteilung und Priorität —, ohne das Tool zu wechseln.
Ticketstatus und Gesprächsverläufe prüfen. Rufe offene Tickets ab, prüfe den neuesten Gesprächsverlauf zu einem bestimmten Ticket oder sieh dir die Lösung eines Tickets direkt in Goodweek an, um dir schnell einen Überblick über Kundenanliegen zu verschaffen.
Tickets, Kontakte und Konten durchsuchen. Finde bestimmte Support-Datensätze per Stichwort direkt in Goodweek, ohne die Zoho Desk-Oberfläche zu öffnen.
Mit Tickets verknüpfte Kontakte verwalten. Suche oder erstelle Zoho Desk-Kontakte direkt aus einer Unterhaltung heraus, um sicherzustellen, dass Tickets dem richtigen Kundendatensatz zugeordnet sind.
Fehlerbehebung
Verbunden, aber es werden Daten der falschen Organisation angezeigt
Stelle sicher, dass du dich während des Verbindungsvorgangs mit dem Zoho-Konto angemeldet hast, das deinem richtigen regionalen Rechenzentrum zugeordnet ist. Trenne die Verbindung bei Bedarf und stelle sie erneut her.
Integration in Goodweek nicht sichtbar
Stelle sicher, dass dein Organisationsadministrator die Zoho Desk-Integration im Goodweek-Admin-Panel unter dem Tab Integrationen aktiviert hat.