Zoho Desk

In diesem Dokument wird beschrieben, wie Sie Zoho Desk in Google SecOps einbinden.

Zoho Desk-Integration in Google Security Operations konfigurieren

Eine ausführliche Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
API-Stamm String https://desk.zoho.{region} Ja API-Stamm der Zoho Desk-Instanz.
Client-ID String – Ja Client-ID des Zoho Desk-Kontos.
Clientschlüssel Passwort – Ja Clientschlüssel des Zoho Desk-Kontos.
Aktualisierungstoken Passwort – Nein Aktualisierungstoken des Zoho Desk-Kontos. Sie müssen die Aktion „Aktualisierungstoken abrufen“ ausführen, um es zu generieren.
SSL überprüfen Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird geprüft, ob das SSL-Zertifikat für die Verbindung zum Zoho Desk-Server gültig ist.

API-Anmeldedaten abrufen

  1. Rufen Sie die Zoho Desk API-Konsole auf.
  2. Klicken Sie auf Add Client (Client hinzufügen) und wählen Sie Self Client (Eigener Client) aus.
  3. Kopieren Sie auf dem Tab Clientschlüssel die Werte der Parameter „Client-ID“ und „Clientschlüssel“ und fügen Sie sie in die entsprechenden Felder im Fenster für die Integrationskonfiguration ein.
  4. Geben Sie auf dem Tab Code generieren die folgenden Bereiche an: Desk.tickets.READ,Desk.tickets.CREATE,Desk.tickets.UPDATE,Desk.tickets.DELETE,Desk.settings.READ,Desk.basic.READ,Desk.products.READ,Desk.contacts.READ und fügen Sie eine Bereichsbeschreibung hinzu.
  5. Klicken Sie auf Erstellen, um einen Autorisierungscode zu erhalten.
  6. Kehren Sie zu Google SecOps zurück, simulieren Sie einen Fall und rufen Sie in der Zoho Desk-Integration die Aktion Aktualisierungstoken abrufen auf.
  7. Geben Sie zum Konfigurieren der Aktion Ihren Autorisierungscode und den Autorisierungslink ein.
  8. Kopieren Sie das Token aus dem JSON-Ergebnis der Aktion, fügen Sie es in das entsprechende Feld im Fenster für die Integrationskonfiguration ein und führen Sie einen Test aus.

Anwendungsbereiche

Führen Sie eine Triage-Aktion durch.

Aktionen

Kommentar zu Ticket hinzufügen

Beschreibung

Einem Ticket in Zoho Desk einen Kommentar hinzufügen

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Ticket-ID String – Ja Geben Sie die ID des Tickets an, dem Sie einen Kommentar hinzufügen möchten.
Sichtbarkeit DDL

Öffentlich

Mögliche Werte:

  • Öffentlich
  • Privat
 Nein Geben Sie an, ob der Kommentar öffentlich oder privat sein soll.
Typ String

Nur Text

Mögliche Werte:

  • Nur Text
  • HTML
 Nein Geben Sie den Typ des Kommentars an.
Text String – Nein Geben Sie den Inhalt des Kommentars an.
Auf Antwort warten Kästchen Deaktiviert Nein Wenn diese Option aktiviert ist, wartet die Aktion auf eine Antwort.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
    "content": "zsu[@user:11550965]zsu Please fix this ASAP",
    "commentedTime": "2022-07-01T11:18:43.935Z",
    "modifiedTime": "2022-07-01T11:18:43.935Z",
    "contentType": "plainText",
    "impersonatedUser": null,
    "encodedContent": "zsu[@user:11550965]zsu Please fix this ASAP",
    "id": "97709000000179081",
    "commenterId": "97709000000092001",
    "commenter": {
        "id": "97709000000092001",
        "name": "TIP Labops",
        "email": "tip.labops@siemplify.co",
        "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
        "type": "AGENT",
        "firstName": "TIP",
        "lastName": "Labops",
        "roleName": "CEO"
    },
    "attachments": [],
    "isPublic": false
}
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:

Wenn der Statuscode 200 gemeldet wird (is_success = true): „Der Kommentar ‚{text}‘ wurde dem Ticket {ticket id} in Zoho Desk hinzugefügt.“

Asynchrone Nachricht: „Warte auf Antwort…“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein kritischer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Kommentar zu Ticket hinzufügen‘. Reason: {0}''.format(error.Stacktrace)

Wenn Fehler gemeldet werden: „Fehler beim Ausführen der Aktion ‚Kommentar zu Ticket hinzufügen‘. Grund: {errors/errorMessage}

 Allgemein

Ticket erstellen

Beschreibung

Erstellen Sie ein Ticket in Zoho Desk.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Titel String – Nein Geben Sie den Titel für das Ticket an.
Beschreibung String – Nein Geben Sie die Beschreibung des Tickets an.
Name der Abteilung String – Nein Geben Sie den Namen der Abteilung an, die für das Ticket festgelegt werden soll.
Kontakt String – Nein Geben Sie die E-Mail-Adresse des Kontakts für das Ticket an.
Typ des Rechtsnachfolgers DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Agent
  • Team
 Nein

Geben Sie den Typ des Rechtsnachfolgers an.

Wenn „Agent“ oder „Team“ ausgewählt ist, ist der Parameter „Assignee Name“ erforderlich.
Name der zuständigen Person String – Nein Geben Sie den Namen der Person an, der das Ticket zugewiesen ist. Für den Agententyp können Sie eine E-Mail-Adresse oder einen Anzeigenamen angeben.
Priorität DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Keine Priorität
  • Niedrig
  • Mittel
  • Hoch
 Nein Geben Sie die Priorität für das Ticket an.
Klassifizierung DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Keine Klassifizierung
  • Frage
  • Problem
  • Funktion
  • Sonstiges
 Nein Geben Sie den Klassifizierungstyp für das Ticket an.
Kanal DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • E-Mail
  • Telefon
  • Web
  • Twitter
  • Facebook
  • Chat
  • Foren
 Nein Geben Sie den Kanal für das Ticket an.
Kategorie String – Nein Geben Sie die Kategorie für das Ticket an.
Unterkategorie String – Nein Geben Sie die Unterkategorie für das Ticket an.
Fälligkeitsdatum String – Nein

Geben Sie das Fälligkeitsdatum für das Ticket an.

Format: ISO 8601. Beispiel: 2022-07-06T07:05:43Z.

Benutzerdefinierte Felder JSON – Nein

Geben Sie ein JSON-Objekt mit den benutzerdefinierten Feldern an, die aktualisiert werden sollen.

Hinweis: Sie müssen die API-Namen der Schlüssel angeben.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
    "modifiedTime": "2022-07-01T11:00:33.000Z",
    "subCategory": null,
    "statusType": "On Hold",
    "subject": "Here's your first ticket.",
    "dueDate": null,
    "departmentId": "97709000000007061",
    "channel": "Chat",
    "onholdTime": "2022-07-01T09:32:14.717Z",
    "language": "English",
    "source": {
        "appName": null,
        "extId": null,
        "permalink": null,
        "type": "SYSTEM",
        "appPhotoURL": null
    },
    "resolution": "Koko",
    "sharedDepartments": [],
    "closedTime": null,
    "approvalCount": "0",
    "isOverDue": true,
    "isTrashed": false,
    "createdTime": "2022-06-27T17:02:17.000Z",
    "id": "97709000000160077",
    "isResponseOverdue": false,
    "customerResponseTime": "2022-06-27T17:02:17.000Z",
    "productId": null,
    "contactId": "97709000000160029",
    "threadCount": "1",
    "secondaryContacts": [],
    "priority": null,
    "classification": null,
    "commentCount": "1",
    "taskCount": "0",
    "accountId": "97709000000160001",
    "phone": "1 888 900 9646",
    "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000160077",
    "isSpam": false,
    "status": "On Hold",
    "entitySkills": [],
    "ticketNumber": "101",
    "customFields": {},
    "isArchived": false,
    "description": "Hello<",
    "timeEntryCount": "0",
    "channelRelatedInfo": null,
    "responseDueDate": null,
    "isDeleted": false,
    "modifiedBy": "97709000000092001",
    "email": "support@zohosupport.com",
    "layoutDetails": {
        "id": "97709000000023011",
        "layoutName": "Siemplify"
    },
    "channelCode": null,
    "cf": {},
    "slaId": null,
    "layoutId": "97709000000023011",
    "assigneeId": null,
    "teamId": "97709000000182001",
    "attachmentCount": "0",
    "isEscalated": false,
    "category": null
}
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen und die Ausführung des Playbooks nicht beenden:

Wenn der Statuscode 200 gemeldet wird (is_success=true): „In Zoho Desk wurde ein Ticket mit der ID {ticket id} erstellt.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Ticket erstellen‘. Reason: {0}''.format(error.Stacktrace)

Wenn der Agent nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket erstellen‘. Grund: Der Agent {agent_name} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn das Team nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket erstellen‘. Grund: Das Team {team_name} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn „Agent“ oder „Team“ ausgewählt ist, aber der Parameter „Assignee Name“ nicht angegeben ist: „Error executing action ‚Create Ticket‘. Grund: „Name des Rechtsnachfolgers“ muss angegeben werden.

Wenn die Abteilung nicht gefunden wird : „Fehler beim Ausführen der Aktion ‚Ticket erstellen‘. Grund: Die Abteilung {department_name} wurde in Zoho Desk nicht gefunden.“

Wenn der Kontakt nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket erstellen‘. Grund: Der Kontakt {contact} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn das Produkt nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket erstellen‘. Grund: Das Produkt {product} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

 Allgemein

Aktualisierungstoken abrufen

Beschreibung

Rufen Sie ein Aktualisierungstoken für die Konfiguration ab.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Autorisierungslink String https://accounts.zoho.{region} Ja Geben Sie den Autorisierungslink für die Integration an.
Autorisierungscode Passwort – Ja Geben Sie den Autorisierungscode an, der in der Entwicklerkonsole von Zoho generiert wurde.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
    "refresh_token": "1000.90567b1fc0c54f540e56200ae4388cef.a8f6b313297d558774bee07d60cc6863"
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:

Bei Erfolg: „Aktualisierungstoken wurde generiert. Kopieren Sie den Wert in den Parameter „Aktualisierungstoken“ in der Integrationskonfiguration.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Aktualisierungstoken abrufen‘. Reason: {0}''.format(error.Stacktrace)

Wenn ein Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Aktualisierungstoken abrufen‘. Grund: {error}''

 Allgemein

Ticketdetails abrufen

Beschreibung

Detaillierte Informationen zum Ticket von Zoho Desk abrufen.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Ticket-IDs String – Ja Geben Sie eine durch Kommas getrennte Liste von IDs an, für die Sie Details zurückgeben möchten.
Insight erstellen Kästchen Deaktiviert Nein Wenn diese Option aktiviert ist, wird durch die Aktion eine Statistik mit Informationen zu Tickets erstellt.
Zusätzliche Felder, die zurückgegeben werden sollen CSV contacts, products, assignee, departments, contract, isRead, team, skills Nein

Geben Sie die zusätzlichen Felder an, die zurückgegeben werden sollen.

Mögliche Werte: contacts, products, assignee, departments, contract, isRead, team, skills.
Kommentare abrufen Kästchen Aktiviert Nein Wenn diese Option aktiviert ist, werden mit der Aktion Kommentare zu den Tickets abgerufen.
Maximale Anzahl zurückzugebender Kommentare Ganzzahl 50 Nein

Geben Sie die Anzahl der Kommentare an, die pro Ticket zurückgegeben werden sollen.

Maximum: 100

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
  "modifiedTime": "2022-06-27T17:12:35.000Z",
  "subCategory": null,
  "statusType": "Open",
  "subject": "tesa",
  "dueDate": null,
  "departmentId": "97709000000007061",
  "channel": "Phone",
  "onholdTime": null,
  "language": null,
  "source": {
      "appName": null,
      "extId": null,
      "permalink": null,
      "type": "SYSTEM",
      "appPhotoURL": null
  },
  "resolution": null,
  "sharedDepartments": [],
  "closedTime": null,
  "approvalCount": "0",
  "isOverDue": false,
  "isTrashed": false,
  "contact": {
      "firstName": null,
      "lastName": "test",
      "phone": null,
      "mobile": null,
      "id": "97709000000159194",
      "isSpam": false,
      "type": null,
      "email": "test@test.com",
      "account": {
          "website": null,
          "accountName": "test!@test.com",
          "id": "97709000000159182"
      }
  },
  "createdTime": "2022-06-27T17:12:35.000Z",
  "id": "97709000000159224",
  "isResponseOverdue": false,
  "customerResponseTime": "2022-06-27T17:12:35.000Z",
  "productId": null,
  "contactId": "97709000000159194",
  "threadCount": "1",
  "secondaryContacts": [],
  "priority": null,
  "classification": null,
  "commentCount": "0",
  "taskCount": "0",
  "accountId": "97709000000159182",
  "phone": null,
  "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000159224",
  "assignee": {
      "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
      "firstName": "TIP",
      "lastName": "Labops",
      "id": "97709000000092001",
      "email": "tip.labops@siemplify.co"
  },
  "isSpam": false,
  "status": "Open",
  "entitySkills": [],
  "ticketNumber": "102",
  "sentiment": null,
  "customFields": {},
  "isArchived": false,
  "skillsInfo": [],
  "isRead": false,
  "description": "<div style=\"font-size: 13px; font-family: Regular, Lato, Arial, Helvetica, sans-serif\"><div>tetsta</div></div>",
  "timeEntryCount": "0",
  "channelRelatedInfo": null,
  "responseDueDate": null,
  "isDeleted": false,
  "modifiedBy": "97709000000092001",
  "department": {
      "name": "Siemplify",
      "id": "97709000000007061"
  },
  "followerCount": "0",
  "email": "test@test.com",
  "layoutDetails": {
      "id": "97709000000023011",
      "layoutName": "Siemplify"
  },
  "channelCode": null,
  "product": null,
  "isFollowing": false,
  "cf": {},
  "slaId": null,
  "team": null,
  "layoutId": "97709000000023011",
  "assigneeId": "97709000000092001",
  "createdBy": "97709000000092001",
  "teamId": null,
  "contractId": null,
  "tagCount": "0",
  "attachmentCount": "0",
  "isEscalated": false,
  "category": null
  "comments":          {
            "content": "<div style=\"font-size: 14px; font-family: LatoRegular, Regular, Lato, &quot;Lato 2&quot;, Arial, Helvetica, sans-serif\"><div style=\"font-size: 14px; font-family: LatoRegular, Regular, Lato, &quot;Lato 2&quot;, Arial, Helvetica, sans-serif\"><ul><li>asdasdasdasd<br /></li></ul></div><div><br /></div></div>",
            "commentedTime": "2022-06-29T10:21:24.000Z",
            "modifiedTime": "2022-06-29T10:23:42.000Z",
            "contentType": "html",
            "impersonatedUser": null,
            "encodedContent": "&lt;div style&#x3d;&quot;font-size&#x3a; 14px&#x3b; font-family&#x3a; LatoRegular, Regular, Lato, &amp;quot&#x3b;Lato 2&amp;quot&#x3b;, Arial, Helvetica, sans-serif&quot;&gt;&lt;div style&#x3d;&quot;font-size&#x3a; 14px&#x3b; font-family&#x3a; LatoRegular, Regular, Lato, &amp;quot&#x3b;Lato 2&amp;quot&#x3b;, Arial, Helvetica, sans-serif&quot;&gt;&lt;ul&gt;&lt;li&gt;asdasdasdasd&lt;br &#x2f;&gt;&lt;&#x2f;li&gt;&lt;&#x2f;ul&gt;&lt;&#x2f;div&gt;&lt;div&gt;&lt;br &#x2f;&gt;&lt;&#x2f;div&gt;&lt;&#x2f;div&gt;",
            "id": "97709000000172003",
            "commenterId": "97709000000092001",
            "commenter": {
                "id": "97709000000092001",
                "name": "TIP Labops",
                "email": "tip.labops@siemplify.co",
                "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
                "type": "AGENT",
                "firstName": "TIP",
                "lastName": "Labops",
                "roleName": "CEO"
            },
            "attachments": [],
            "isPublic": false
        }

}
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:

Wenn Daten für mindestens eine ID verfügbar sind (is_success = true): „Details zu den folgenden Tickets in Zoho Desk wurden erfolgreich zurückgegeben: {ticket ids}“.

Wenn für mindestens eine ID keine Daten verfügbar sind (is_success=true): „Die Aktion konnte keine Details zu den folgenden Tickets in Zoho Desk finden: {ticket ids}“.

Wenn keine Daten für alle IDs verfügbar sind (is_success=false): „Es wurden keine Tickets gefunden.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Ticketdetails abrufen‘. Reason: {0}''.format(error.Stacktrace)

 Allgemein
Tabelle mit Fall-Repository

Tabellenname: Ticketdetails Tabellenspalten:

  • Nummer: ticketNumber
  • Status: status Subject: subject
  • Erstellungszeit: createdTime
  • Auflösung: Auflösung
  • E-Mail-Adresse: email
  • Kontakt: {firstName} + {lastName}
 Allgemein

Ticket als Spam markieren

Beschreibung

Ticket in Zoho Desk als Spam markieren.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Ticket-ID String – Ja Geben Sie die ID des Tickets an, das als Spam markiert werden soll.
Mark Contact Kästchen Aktiviert Nein Wenn diese Option aktiviert ist, wird der Kontakt, der das Ticket erstellt hat, als Spammer markiert.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen und die Ausführung eines Playbooks nicht beenden :

Wenn der Statuscode 200 zurückgegeben wird (is_success = true): „Ein Ticket wurde in Zoho Desk erfolgreich als Spam markiert.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Ticket als Spam markieren‘. Reason: {0}''.format(error.Stacktrace)

Wenn Fehler gemeldet werden: „Fehler beim Ausführen der Aktion ‚Ticket als Spam markieren‘. Grund: {errors/errorMessage}

 Allgemein

Ping

Beschreibung

Testen Sie die Verbindung zu Zoho Desk mit den Parametern, die auf der Seite „Integrationskonfiguration“ im Google SecOps Content Hub angegeben sind.

Parameter

–

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine obligatorischen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht\*

Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:

Wenn erfolgreich (is_success=true): „Successfully connected to the Zoho Desk server with the provided connection parameters!“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn nicht erfolgreich (is_success= false): „Failed to connect to the Zoho Desk server! Error is {0}".format(exception.stacktrace)

 Allgemein

Ticket aktualisieren

Beschreibung

Ticket in Zoho Desk aktualisieren

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Ticket-ID String – Ja Geben Sie die ID des Tickets an, das aktualisiert werden soll.
Titel String – Nein Geben Sie den Titel an, der für das Ticket festgelegt werden soll.
Beschreibung String – Nein Geben Sie die Beschreibung für das Ticket an.
Name der Abteilung String – Nein Geben Sie den Namen der Abteilung an, die für das Ticket festgelegt werden soll.
Kontakt String – Nein Geben Sie die E-Mail-Adresse des Kontakts für das Ticket an.
Typ des Rechtsnachfolgers DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Agent
  • Team
 Nein

Geben Sie den Typ des Rechtsnachfolgers an.

Wenn „Agent“ oder „Team“ ausgewählt ist, ist der Parameter „Assignee Name“ erforderlich.
Name der zuständigen Person String – Nein Geben Sie den Namen der Person an, der das Ticket zugewiesen ist. Für den Agententyp können Sie eine E-Mail-Adresse oder einen Anzeigenamen angeben.
Lösung String – Nein Geben Sie die Lösung für das Ticket an.
Priorität DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Keine Priorität
  • Niedrig
  • Mittel
  • Hoch
 Nein Geben Sie die Priorität für das Ticket an.
Status DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Öffnen
  • Im Wartestatus
  • Eskaliert
  • Geschlossen
 Nein Geben Sie den Status für das Ticket an.
Mark State DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Lesen
  • Ungelesen
 Nein Geben Sie den Markierungsstatus für das Ticket an.
Klassifizierung DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • Keine Klassifizierung
  • Frage
  • Problem
  • Funktion
  • Sonstiges
 Nein Geben Sie den Klassifizierungstyp für das Ticket an.
Kanal DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Wählen Sie eine Option aus.
  • E-Mail
  • Telefon
  • Web
  • Twitter
  • Facebook
  • Chat
  • Foren
 Nein Geben Sie den Kanal für das Ticket an.
Kategorie String – Nein Geben Sie die Kategorie für das Ticket an.
Unterkategorie String – Nein Geben Sie die Unterkategorie für das Ticket an.
Fälligkeitsdatum String – Nein

Geben Sie das Fälligkeitsdatum für das Ticket an.

Format: ISO 8601. Beispiel: 2022-07-06T07:05:43Z.

Hinweis:Dieser Parameter hat keine Auswirkungen, wenn der Status „On Hold“ festgelegt ist.
Benutzerdefinierte Felder JSON – Nein

Geben Sie ein JSON-Objekt mit den benutzerdefinierten Feldern an, die aktualisiert werden sollen.

Hinweis: Sie müssen die API-Namen der Schlüssel angeben.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
    "modifiedTime": "2022-07-01T11:00:33.000Z",
    "subCategory": null,
    "statusType": "On Hold",
    "subject": "Here's your first ticket.",
    "dueDate": null,
    "departmentId": "97709000000007061",
    "channel": "Chat",
    "onholdTime": "2022-07-01T09:32:14.717Z",
    "language": "English",
    "source": {
        "appName": null,
        "extId": null,
        "permalink": null,
        "type": "SYSTEM",
        "appPhotoURL": null
    },
    "resolution": "Koko",
    "sharedDepartments": [],
    "closedTime": null,
    "approvalCount": "0",
    "isOverDue": true,
    "isTrashed": false,
    "createdTime": "2022-06-27T17:02:17.000Z",
    "id": "97709000000160077",
    "isResponseOverdue": false,
    "customerResponseTime": "2022-06-27T17:02:17.000Z",
    "productId": null,
    "contactId": "97709000000160029",
    "threadCount": "1",
    "secondaryContacts": [],
    "priority": null,
    "classification": null,
    "commentCount": "1",
    "taskCount": "0",
    "accountId": "97709000000160001",
    "phone": "1 888 900 9646",
    "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000160077",
    "isSpam": false,
    "status": "On Hold",
    "entitySkills": [],
    "ticketNumber": "101",
    "customFields": {},
    "isArchived": false,
    "description": "Hello<",
    "timeEntryCount": "0",
    "channelRelatedInfo": null,
    "responseDueDate": null,
    "isDeleted": false,
    "modifiedBy": "97709000000092001",
    "email": "support@zohosupport.com",
    "layoutDetails": {
        "id": "97709000000023011",
        "layoutName": "Siemplify"
    },
    "channelCode": null,
    "cf": {},
    "slaId": null,
    "layoutId": "97709000000023011",
    "assigneeId": null,
    "teamId": "97709000000182001",
    "attachmentCount": "0",
    "isEscalated": false,
    "category": null
}
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:

Wenn der Statuscode 200 gemeldet wird (is_success = true): „Das Ticket mit der ID {ticket id} wurde in Zoho Desk aktualisiert.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Reason: {0}''.format(error.Stacktrace)

Wenn der Agent nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Grund: Der Agent {agent_name} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn das Team nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Grund: Das Team {team_name} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn die Abteilung nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Grund: Die Abteilung {department} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn der Kontakt nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Grund: Der Kontakt {contact} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn das Produkt nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Grund: Das Produkt {product} wurde in Zoho Desk nicht gefunden. Bitte überprüfen Sie die Schreibweise.“

Wenn „Agent“ oder „Team“ ausgewählt ist, aber der Parameter „Assignee Name“ nicht angegeben ist: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Grund: „Name des Rechtsnachfolgers“ muss angegeben werden.

 Allgemein

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten