Zoho Desk

Integrationsversion: 4.0

Zoho Desk-Integration in Google Security Operations konfigurieren

Eine detaillierte 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-Stammverzeichnis 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 „Get Refresh Token“ (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 Console auf.
  2. Klicken Sie auf Client hinzufügen und wählen Sie Self Client (Selbst-Client) aus.
  3. Kopieren Sie auf dem Tab Clientschlüssel den Wert der Parameter „Client-ID“ und „Clientschlüssel“ und fügen Sie ihn 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 Fügen Sie eine Bereichsbeschreibung hinzu.
  5. Klicken Sie auf Erstellen, um einen Autorisierungscode zu erhalten.
  6. Kehren Sie zu Google Security Operations zurück, simulieren Sie einen Fall und rufen Sie die Aktion Aktualisierungstoken abrufen in der Zoho Desk-Integration auf.
  7. Geben Sie zur Konfiguration 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 die Triage-Aktion aus.

Aktionen

Kommentar zum Ticket hinzufügen

Beschreibung

Kommentar zu einem Ticket in Zoho Desk 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 Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses 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
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

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

Asynchrone Nachricht: „Warte auf eine Antwort…“

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

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

Wenn Fehler gemeldet werden: „Fehler beim Ausführen der Aktion ‚Kommentar zum 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.
Abteilungsname 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.
Zuweisungstyp DDL

Wählen Sie eine Option aus.

Mögliche Werte:

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

Geben Sie den Typ des Empfängers an.

Wenn „Kundenservicemitarbeiter“ oder „Team“ ausgewählt ist, ist der Parameter „Name des Zuweisungsempfängers“ erforderlich.
Name des Zugewiesenen String – Nein Geben Sie den Namen des Bearbeiters für das Ticket an. 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
  • Sonstige
 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 Channel 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 müssen.

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

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses 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
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen:

Wenn der Statuscode 200 gemeldet wird (is_success=true): „Successfully created a ticket with ID {ticket id} in Zoho Desk.“ (Ein Ticket mit der ID {ticket id} wurde in Zoho Desk erstellt.)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

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

Wenn der Kundenservicemitarbeiter 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 Rechtschreibung.“'

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 Rechtschreibung.“

Wenn „Agent“ oder „Team“ ausgewählt ist, der Parameter „Assignee Name“ aber nicht angegeben wird: „Error executing action 'Create Ticket'“ (Fehler beim Ausführen der Aktion „Create Ticket“). Grund: „Name des Zuweisungsempfängers“ 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 Rechtschreibung.“

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 Rechtschreibung.“

 Allgemein

Aktualisierungstoken abrufen

Beschreibung

Aktualisierungstoken für die Konfiguration abrufen

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 Elemente ausgeführt.

Aktionsergebnisse

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

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Bei Erfolg: „Successfully generated refresh token. Kopieren Sie den Wert in den Parameter „Aktualisierungstoken“ in der Integrationskonfiguration.

Die Aktion sollte fehlschlagen und die Ausführung eines 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‘. Grund: {0}''.format(error.Stacktrace)

Wenn ein Fehler gemeldet wird: „Error executing action ‚Get Refresh Token‘. Grund: {error}''

 Allgemein

Ticketdetails abrufen

Beschreibung

Detaillierte Informationen zum Ticket in 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 ein Insight mit Informationen zu Tickets erstellt.
Zusätzliche Felder, die zurückgegeben werden sollen CSV Kontakte, Produkte, Zuweisungsempfänger, Abteilungen, Vertrag, isRead, Team, Fähigkeiten 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 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 Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses 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
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn Daten für mindestens eine ID verfügbar sind (is_success = true): „Successfully returned details related to the following tickets in Zoho Desk: {ticket ids}“ (Details zu den folgenden Tickets in Zoho Desk wurden zurückgegeben: {ticket ids}).

Wenn für mindestens eine ID keine Daten verfügbar sind (is_success=true): „Action wasn't able to find details related to the following tickets in Zoho Desk: {ticket ids}“ (Die Action konnte in Zoho Desk keine Details zu den folgenden Tickets 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 Playbook-Ausführung 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‘. Grund: {0}''.format(error.Stacktrace)

 Allgemein
Tabelle „Fall-Repository“

Tabellenname:Ticketdetails Tabellenspalten:

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

Ticket als Spam markieren

Beschreibung

Markieren Sie das Ticket in Zoho Desk als Spam.

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 muss.
Kontakt markieren 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 Elemente ausgeführt.

Aktionsergebnisse

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

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen :

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

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder „Sonstiges“: „Fehler beim Ausführen der Aktion ‚Ticket als Spam markieren‘. Grund: {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 Parametern, die auf der Seite für die Integrationskonfiguration auf dem Tab „Google Security Operations Marketplace“ angegeben sind.

Parameter

–

Ausführen am

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

Aktionsergebnisse

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

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Bei Erfolg (is_success=true): „Die Verbindung zum Zoho Desk-Server wurde mit den angegebenen Verbindungsparametern hergestellt.“

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn nicht erfolgreich (is_success= false): „Verbindung zum Zoho Desk-Server konnte nicht hergestellt werden. Fehler: {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 muss.
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.
Abteilungsname 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.
Zuweisungstyp DDL

Wählen Sie eine Option aus.

Mögliche Werte:

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

Geben Sie den Typ des Empfängers an.

Wenn „Kundenservicemitarbeiter“ oder „Team“ ausgewählt ist, ist der Parameter „Name des Zuweisungsempfängers“ erforderlich.
Name des Zugewiesenen String – Nein Geben Sie den Namen des Bearbeiters für das Ticket an. 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
  • Warten
  • 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
  • Sonstige
 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 Channel 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 „Warten“ festgelegt ist.
Benutzerdefinierte Felder JSON – Nein

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

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

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses 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
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

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

Die Aktion sollte fehlschlagen und die Playbook-Ausführung 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 ‚Ticket aktualisieren‘. Grund: {0}''.format(error.Stacktrace)

Wenn der Kundenservicemitarbeiter 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 Rechtschreibung.“'

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 Rechtschreibung.“

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 Rechtschreibung.“'

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 Rechtschreibung.“

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 Rechtschreibung.“

Wenn „Agent“ oder „Team“ ausgewählt ist, der Parameter „Assignee Name“ aber nicht angegeben wird: „Error executing action "Update Ticket". Grund: „Name des Zuweisungsempfängers“ muss angegeben werden.

 Allgemein

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