> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/connectors/zoho-desk.md).

# Zoho Desk

Zoho Desk Connector für Provider: Tickets, Kommentare, Anhänge und Kontakte je Kunde in Zoho Desk aus Equipme Pro anlegen und pflegen – Aktionen, Beispiele.

**Pfad:** „Automation“ → „Workflows“ → Flow-Designer → Modul **„Zoho Desk“**

Der **Zoho Desk Connector** verbindet Equipme Pro in [Workflows](https://hub.equipme.io/pro/dokumentation/automation/workflows.md) mit deinem Service-Desk in Zoho Desk. Zusammen mit dem Modul [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) entstehen Tickets aus Kundenaufträgen, Fulfillment-Positionen oder Bestellberechtigungen – zugeordnet zum richtigen Kunden.

## Wofür?

* **Kundenaufträge als Tickets:** Neuer Kundenauftrag in Pro → Ticket im Service-Desk für die Bearbeitung.
* **Fulfillment begleiten:** Neue Fulfillment-Position (z. B. Rückgabe oder Tausch) → Ticket mit allen Details; Versand oder Abschluss → Kommentar am Ticket.
* **Dokumente an den Kunden:** Lieferschein oder Übergabeprotokoll als PDF erzeugen und als öffentlichen Anhang ans Ticket hängen.
* **Kundenkontakte pflegen:** Ansprechpartner neuer Kunden als Kontakte in Zoho Desk anlegen und dem passenden Zoho-Konto zuordnen.
* **Bestellberechtigung prüfen:** Neue Anfrage zur Bestellberechtigung → Ticket für Vertrieb oder Buchhaltung.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/pro/dokumentation/automation.md)
* Ein Zoho-Desk-Konto im **EU-Rechenzentrum** von Zoho (Anmeldung über zoho.eu)
* Ein Zoho-Desk-Benutzer mit Rechten, Tickets und Kontakte zu lesen, anzulegen und zu ändern sowie Abteilungen, Teams, Agenten und Produkte zu lesen
* Für Beispiele mit Pro-Daten eine Verbindung des [equipme Connectors (Modul „Equipme Pro“)](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md)

## Verbindung einrichten

1. Im Flow-Designer eine Komponente des Moduls „Zoho Desk“ auf die Arbeitsfläche ziehen (z. B. *AddTicket*).
2. **Connect account** klicken.
3. Im Anmeldefenster von Zoho mit dem Zoho-Desk-Benutzer anmelden und den Zugriff bestätigen.
4. Die Verbindung erscheint mit dem Namen des Zoho-Profils unter **„Accounts“** und steht allen Komponenten des Moduls zur Verfügung.

{% hint style="info" %}
Die Verbindung arbeitet mit den Rechten des angemeldeten Zoho-Benutzers. Verwende am besten einen eigenen Benutzer für die Automation, damit Tickets und Kommentare klar als automatisch erzeugt erkennbar sind.
{% endhint %}

## Grundbegriffe

* **Organization ID:** die Zoho-Desk-Organisation (das Portal), in der die Aktion arbeitet. Die Auswahlliste zeigt die Organisationen des verbundenen Kontos.
* **Account ID:** In Zoho Desk bilden Konten („Accounts“) typischerweise deine Kunden ab. Speichere die Zoho-Konto-ID als Metadatum am Kunden in Pro (*Update Customer Metadata*), dann findest du sie in jedem Flow wieder.
* **Abhängige Auswahllisten:** Abteilung, Team, Kontakt, Konto, Produkt und Agent werden nach Auswahl der Organisation aus Zoho Desk geladen. Statt aus der Liste kannst du jeweils auch eine ID aus einer vorherigen Komponente einsetzen.

## Trigger

Der Connector bringt **keine eigenen Trigger** mit. Flows starten über andere Trigger – z. B. einen Trigger des Moduls [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) (*New Sales Order*, *New Fulfillment Order*, *New Authorization Request*), einen Zeitplan (Scheduler) oder einen Webhook aus Zoho Desk.

## Aktionen

### Tickets

| Komponente   | Zweck                               | Wichtige Optionen                                                                                                                                                                                                                                                                                                               |
| ------------ | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddTicket    | Neues Ticket anlegen                | Pflicht: Organization ID, Subject, Department ID, Contact ID. Optional: Description, Status, Priority, Assignee ID, Team ID, Product ID, Category, Subcategory, Classification („Problem“, „Request“, „Question“, „Others“), Due date, Channel, Language, Email, Phone, Shared departments, Secondary contacts, Customer fields |
| UpdateTicket | Bestehendes Ticket ändern           | Pflicht: Organization ID, Ticket ID. Alle Felder von *AddTicket* sowie Resolution; nur ausgefüllte Felder werden geändert                                                                                                                                                                                                       |
| GetTicket    | Ein Ticket mit allen Feldern lesen  | Organization ID, Ticket ID                                                                                                                                                                                                                                                                                                      |
| ListTickets  | Alle Tickets der Organisation lesen | Organization ID; liefert die vollständige Liste ohne Filter                                                                                                                                                                                                                                                                     |

### Kommentare und Anhänge

| Komponente          | Zweck                             | Wichtige Optionen                                                                                                                                                                                                          |
| ------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddTicketComment    | Kommentar an ein Ticket schreiben | Ticket ID, Content, Content type („HTML“ oder „PlainText“, Standard HTML), Is public (für den Kunden sichtbar oder nur intern), Attachments (dynamic) aus vorherigen Schritten oder Attachments (static) als feste Dateien |
| UpdateTicketComment | Bestehenden Kommentar ändern      | Ticket ID, Comment ID, Content, Content type, Attachments                                                                                                                                                                  |
| AddTicketAttachment | Datei direkt an ein Ticket hängen | Ticket ID, Attachment (Datei, z. B. aus *HtmlToPdf*), Is public                                                                                                                                                            |

### Kontakte und Teams

| Komponente | Zweck                        | Wichtige Optionen                                                                                                                                                                                                                   |
| ---------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddContact | Neuen Kontakt anlegen        | Pflicht: Organization ID, Last name. Optional: Account ID (Kunde in Zoho Desk), First name, Email, Secondary email, Phone, Mobile, Title, Type, Adresse (Street, Zip, City, State, Country), Language, Description, Customer fields |
| ListTeams  | Teams der Organisation lesen | Organization ID                                                                                                                                                                                                                     |

## Beispiele

### Ticket je Kundenauftrag

1. **Equipme Pro › New Sales Order** – Trigger, optional gefiltert auf bestimmte Kunden.
2. **Equipme Pro › Get Customer Metadata** – Zoho-Konto- und Kontakt-ID des Kunden lesen.
3. **Zoho Desk › AddTicket** – Subject „Auftrag {Auftragsnummer} – {Kunde}“, Department ID = Auftragsbearbeitung, Contact ID aus Schritt 2, Classification „Request“, Description mit den Auftragspositionen.

### Versandmeldung an den Kunden

1. **Equipme Pro › New Fulfillment Parcel** – Trigger bei neuem Paket.
2. **Equipme Pro › Get Customer Metadata** – Kontakt-ID des Kunden in Zoho Desk lesen.
3. **Zoho Desk › AddTicket** – Ticket „Versand {Lieferscheinnummer}“ für den Kundenkontakt.
4. **Zoho Desk › AddTicketComment** – Kommentar mit Sendungsnummer und Tracking-Link, Is public an.

### Übergabeprotokoll als Anhang

1. **Equipme Pro › New Fulfillment Order** – Trigger, Transaction types „Delivery Request“.
2. **PDF › HtmlToPdf** – Protokoll mit Kunde, Gerät, Seriennummer und Empfänger erzeugen (siehe [Hilfsmodule: Lists und PDF](https://hub.equipme.io/pro/dokumentation/automation/connectors/utilities.md)).
3. **Zoho Desk › AddTicketAttachment** – PDF an das Kundenticket hängen, Is public an.

## Hinweise und Grenzen

* Der Connector unterstützt nur Zoho-Konten im **EU-Rechenzentrum**.
* *ListTickets* liest **alle** Tickets der Organisation – über alle Kunden hinweg. Für einzelne Tickets *GetTicket* verwenden und die Ticket-ID als Metadatum in Pro speichern.
* Status, Priorität und Kategorie sind Freitextfelder. Die Werte müssen exakt den in Zoho Desk konfigurierten Werten entsprechen.
* Benutzerdefinierte Felder („Customer fields“) erwartet Zoho Desk im JSON-Format mit den API-Namen der Felder.
* Alle Aktionen arbeiten mit den Rechten des verbundenen Zoho-Benutzers.

## Fehlersuche

| Problem                                      | Ursache / Lösung                                                                                                                                      |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Anmeldung bei „Connect account“ schlägt fehl | Konto liegt nicht im EU-Rechenzentrum oder der Benutzer hat keinen Zugriff auf Zoho Desk.                                                             |
| Auswahlliste (z. B. Account ID) bleibt leer  | Zuerst die Organization ID wählen. Bleibt die Liste leer, die ID aus Zoho Desk direkt eintragen oder aus einem vorherigen Schritt übernehmen.         |
| Fehler „Unauthorized“ oder „Forbidden“       | Der Zoho-Benutzer hat für diese Abteilung oder Aktion keine Rechte, oder die Verbindung wurde widerrufen. Unter „Accounts“ testen bzw. neu verbinden. |
| Ticket wird nicht angelegt                   | Pflichtfelder prüfen: Subject, Department ID und Contact ID. Status- und Prioritätswerte müssen in Zoho Desk existieren.                              |
| Ticket landet beim falschen Kunden           | Contact ID bzw. Account ID aus den Metadaten des Kunden prüfen.                                                                                       |

Protokolle jeder Ausführung findest du unter **„Insights“**.

## Häufige Fragen

**Kann ich mehrere Zoho-Desk-Portale nutzen, z. B. eines je Mandant?**

Ja. Jede Aktion wählt die Organization ID einzeln. Hat der Zoho-Benutzer Zugriff auf mehrere Organisationen, kannst du sie in einem Flow kombinieren.

**Wie ordne ich Tickets dem richtigen Kunden zu?**

Lege für jeden Kunden ein Konto und einen Hauptkontakt in Zoho Desk an und speichere deren IDs als Metadaten am Kunden in Pro. Flows lesen diese IDs und setzen sie in *AddTicket* ein.

**Sieht der Kunde automatisch erzeugte Kommentare?**

Nur wenn „Is public“ aktiviert ist. Interne Hinweise legst du mit deaktiviertem „Is public“ an.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/automation/connectors/zoho-desk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
