Zendesk-Trigger

Der Zendesk-Trigger ist ein Connector-Ereignistrigger, mit dem Sie eine Integration basierend auf den Zendesk-Ereignissen aufrufen können, die Sie in Ihrer Zendesk-Verbindung abonniert haben.

Hinweise

Wenn Sie eine neue Verbindung für den Zendesk-Trigger erstellen oder konfigurieren möchten, benötigen Sie die folgende IAM-Rolle für das Projekt:

  • Connector-Administrator (roles/connectors.admin)
  • Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Weisen Sie dem Dienstkonto, das Sie für den Zendesk-Trigger verwenden möchten, die folgenden IAM-Rollen zu:

  • Application Integration Invoker (roles/integrations.integrationInvoker)
  • Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Zendesk-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen Zendesk-Trigger hinzuzufügen:

  1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

    Zu „Application Integration“

  2. Klicken Sie im Navigationsmenü auf Integrationen.

    Die Seite Integrationsliste wird angezeigt und enthält alle Integrationen, die im Google Cloud-Projekt verfügbar sind.

  3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus.
    3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste der Integration ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen.

    Die neu erstellte Integration wird im Integrationseditor geöffnet.

  4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
  5. Klicken Sie auf das Element Zendesk-Trigger und platzieren Sie es im Integrationseditor.
  6. Wenn Sie den Zendesk-Trigger konfigurieren möchten, können Sie entweder eine vorhandene Zendesk-Verbindung verwenden, die in Integration Connectors verfügbar ist, oder eine neue Zendesk-Verbindung mit der Inline-Option zum Erstellen von Verbindungen erstellen.

Zendesk-Trigger mit einer vorhandenen Verbindung konfigurieren

Sie können den Zendesk-Trigger mit einer vorhandenen Zendesk-Verbindung in Integration Connectors konfigurieren. Der Zendesk-Trigger ist ein Connector-Ereignistrigger. Daher können Sie zum Konfigurieren des Triggers nur eine Zendesk-Verbindung mit aktivierter Ereignisregistrierung verwenden.

Informationen zum Konfigurieren eines Zendesk-Triggers mit einer neuen Zendesk-Verbindung finden Sie unter Zendesk-Trigger mit einer neuen Verbindung konfigurieren.

So konfigurieren Sie einen Zendesk-Trigger mit einer vorhandenen Zendesk-Verbindung:

  1. Klicken Sie im Integrationseditor auf das Element Zendesk-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
  2. Klicken Sie auf Trigger konfigurieren.
  3. Geben Sie auf der Seite Connector Event Trigger Editor die folgenden Konfigurationsdetails an:
    1. Region:Wählen Sie die Region Ihrer Zendesk-Verbindung aus.
    2. Verbindung:Wählen Sie die Zendesk-Verbindung aus, die Sie verwenden möchten.

      Unter „Anwendungseinbindung“ werden nur Zendesk-Verbindungen angezeigt, die aktiv sind und für die ein Ereignisabo aktiviert ist.

    3. Typ des Ereignisabos:Wählen Sie den Typ des Ereignisabos aus, der die Integration auslöst. Informationen zu den unterstützten Ereignisabotypen für diesen Trigger finden Sie unter Unterstützte Ereignisabotypen.
    4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den Zendesk-Trigger aus.
  4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

Zendesk-Trigger mit einer neuen Verbindung konfigurieren

So konfigurieren Sie den Zendesk-Trigger mit einer neuen Zendesk-Verbindung:

  1. Klicken Sie im Integrationseditor auf das Element Zendesk-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
  2. Klicken Sie auf Trigger konfigurieren.
  3. Überspringen Sie das Feld Region.
  4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
  5. Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
    1. Wählen Sie im Schritt Standort den Standort für die neue Zendesk-Verbindung aus:
      1. Region:Wählen Sie eine Region aus der Drop-down-Liste aus.
      2. Klicken Sie auf Weiter.
    2. Geben Sie im Schritt Verbindungsdetails Details zur neuen Zendesk-Verbindung an:
      1. Connector-Version:Wählen Sie eine verfügbare Version des Zendesk-Connectors aus der Drop-down-Liste aus.
      2. Verbindungsname: Geben Sie einen Namen für die Zendesk-Verbindung ein.
      3. (Optional) Beschreibung : Geben Sie eine Beschreibung für die Verbindung ein.
      4. Optional: Cloud Logging aktivieren: Aktivieren Sie dieses Kästchen, um alle Logdaten der Verbindung zu speichern.
      5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die Zendesk-Verbindung aus.
      6. Event-Abo aktivieren:Wählen Sie diese Option aus, um ein neues Event-Abo für die Zendesk-Verbindung zu erstellen und zu aktivieren. Sie können entweder nur Ereignisabos aktivieren oder auch Entitäten, Vorgänge und Aktionen der Verbindung einbeziehen.
      7. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für den Verbindungsknoten zu konfigurieren.

        Weitere Informationen zu den Einstellungen für Zendesk-Verbindungsknoten finden Sie in der Dokumentation zur Zendesk-Verbindung.

      8. Optional: Klicken Sie auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
      9. Klicken Sie auf Weiter.
    3. Geben Sie im Schritt Ziele die Details zur Zendesk-Instanz an:
      1. Zieltyp:Wählen Sie Hostadresse aus.
      2. Host:Geben Sie den Hostnamen oder die IP-Adresse Ihrer Zendesk-Instanz ein.
      3. Klicken Sie auf Weiter.
    4. Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für die Zendesk-Instanz an:
      1. Wählen Sie den gewünschten Authentifizierungstyp aus und geben Sie die entsprechenden Details ein, um auf die bereitgestellte Zendesk-Host-URL zuzugreifen.

        Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

      2. Klicken Sie auf Weiter.
    5. Geben Sie im Schritt Details zum Ereignis-Abo Details zur Zendesk-Instanz an, in der die Ereignis-Abos erstellt werden.
      1. Zieltyp:Wählen Sie Hostadresse aus.
      2. Host:Geben Sie die Registrierungs-URL Ihrer Zendesk-Instanz ein. Für diese URL werden Ereignisabos erstellt.
      3. Nutzername:Geben Sie den Nutzernamen für den Zugriff auf die angegebene Registrierungs-URL ein.
      4. Passwort:Wählen Sie das Secret Manager-Secret mit dem Passwort aus, das dem Nutzernamen zugeordnet ist.
      5. Secret-Version:Wählen Sie eine Secret-Version aus.
      6. Datenanreicherung aktivieren:Wählen Sie dieses Kästchen aus, wenn der Zendesk-Trigger die vollständige Ereignisnutzlast aus der Zendesk-Instanz abrufen soll. Beispiele finden Sie unter Triggerausgabe.
      7. Klicken Sie auf Weiter.
    6. Überprüfung: Prüfen Sie die angegebenen Zendesk-Verbindungsdetails.
    7. Klicken Sie auf Erstellen, um die neue Zendesk-Verbindung zu erstellen.
  6. Typ des Ereignisabos:Wählen Sie den Typ des Ereignisabos aus, der die Integration auslöst. Informationen zu den unterstützten Ereignisabotypen für diesen Trigger finden Sie unter Unterstützte Ereignisabotypen.
  7. Klicken Sie auf Fertig und schließen Sie die Seite.

Trigger-Ausgabe

Es dauert einige Minuten, bis der Zendesk-Trigger die Konfiguration des Ereignisabos abgeschlossen hat. Den Status Ihres Ereignisabos können Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo einsehen.

Der Zendesk-Trigger gibt den Status eines Ereignisabos mit den folgenden Status an:

  • Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
  • Active: Gibt an, dass der Trigger erfolgreich für ein Ereignisabo registriert wurde.
  • Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Neben dem Status des Ereignisabos werden im Bereich Details zum Ereignisabo auch andere Details wie Verbindungsregion, Verbindungsname und Name des Ereignisabos angezeigt.

Das folgende Bild zeigt ein Beispiellayout des Konfigurationsbereichs für Zendesk-Trigger:

Abbildung: Bereich für die Konfiguration von Zendesk-Triggern Abbildung: Bereich für die Konfiguration von Zendesk-Triggern

Variable „Trigger-Ausgabe“

Für jedes Ereignis generiert der Zendesk-Trigger eine ConnectorEventPayload-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable hat das JSON-Format und enthält das Zendesk-Nutzlastschema für die Ausgabe.

Beispiel 1: Ausgabenutzlast für das Zendesk-Ereignis Agentenzuweisung geändert

  {
    "description": "The root schema of event that has occurred in Zendesk.",
    "type": "object",
    "properties": {
        "data": {
    "description": "",
    "type": "object",
    "properties": {
        "accountId": {
            "description": "Zendesk account ID.",
            "type": "number",
            "readOnly": false
        },
        "integration_key": {
            "description": "Integration Key retrieved from ZIS bundle.",
            "type":  "string",
            "readOnly": false
        },
        "subdomain": {
            "description": "Account subdomain.",
            "type":  "string",
            "readOnly": false
        },
        "input": {
            "description": "Contains information about events changes.",
            "type": "object",
            "properties": {
                "ticket_event": {
                    "description": "Type of event is ticket event.",
                    "type": "object",
                    "properties": {
                        "meta": {
                            "description": "Metadata about the ticket.",
                            "type": "object",
                            "properties": {
                                "version": {
                                    "description": "Event version",
                                    "type":  ["string", "null"]
                                },
                                "occurred_at": {
                                    "description": "Timestamp when the event occurred.",
                                    "type":  "string"
                                },
                                "ref": {
                                    "description": "Reference ID",
                                    "type":  ["string", "null"]
                                },
                                "sequence": {
                                    "description": "Sequence of Occurrence",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "description": "",
                                            "type":  ["string", "null"]
                                        },
                                        "position": {
                                            "description": "",
                                            "type": ["number","null"]
                                        },
                                        "total": {
                                            "description": "",
                                            "type": ["number","null"]
                                        }
                                    }
                                }
                            }
                        },
                        "type": {
                            "description": "Type of Ticket Event ",
                            "type":  "string"
                        },
                        "previous": {
                            "description": "Previous ID",
                            "type": ["number","null"]
                        },
                        "current": {
                            "description": "Current ID",
                            "type": ["number","null"]
                        },
                        "ticket": {
                            "description": "Properties related to the ticket",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "description": "Ticket ID",
                                    "type": "number"
                                },
                                "created_at": {
                                    "description": "Timestamp of ticket creation.",
                                    "type":  "string"
                                },
                                "updated_at": {
                                    "description": "Timestamp of ticket updation.",
                                    "type":  "string"
                                },
                                "type": {
                                    "description": "Type of ticket",
                                    "type":  ["string", "null"]
                                },
                                "priority": {
                                    "description": "Priority of ticket.",
                                    "type":  ["string", "null"]
                                },
                                "status": {
                                    "description": "Status of the ticket.",
                                    "type":  ["string", "null"]
                                },
                                "requester_id": {
                                    "description": "ID of the ticket requestor.",
                                    "type": ["number","null"]
                                },
                                "submitter_id": {
                                    "description": "ID of the ticket submitter.",
                                    "type": ["number","null"]
                                },
                                "assignee_id": {
                                    "description": "ID of the ticket assignee.",
                                    "type": ["number","null"]
                                },
                                "organization_id": {
                                    "description": "ID of the organization ticket belongs to.",
                                    "type": ["number","null"]
                                },
                                "group_id": {
                                    "description": "ID of the group ticket belongs to.",
                                    "type": ["number","null"]
                                },
                                "brand_id": {
                                    "description": "ID of the brand ticket belongs to",
                                    "type": ["number","null"]
                                },
                                "form_id": {
                                    "description": "ID of the form associated with the ticket.",
                                    "type": ["number","null"]
                                },
                                "external_id": {
                                    "description": "",
                                    "type":  ["string", "null"]
                                },
                                "tags": {
                                    "description": "Tags associated with the ticket.",
                                    "type": "array",
                                    "items": {
                                        "description": "",
                                        "type":  ["string", "null"]
                                    }
                                },
                                "via": {
                                    "description": "Channel via which change was made.",
                                    "type": "object",
                                    "properties": {
                                        "channel": {
                                            "description": "",
                                            "type":  "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "readOnly": false
        }
    }
}
}
}

Beispiel 2: Nutzlast der angereicherten Daten für das Zendesk-Ereignis Agent Assignment Changed (Agentenzuweisung geändert)

    {
      "description": "The root schema of event that has occurred in Zendesk.",
      "type": "object",
      "properties": {
        "data": {
          "description": "",
          "type": "object",
          "properties": {
            "accountId": {
              "description": "Zendesk account ID.",
              "type": "number",
              "readOnly": false
            },
            "integration_key": {
              "description": "Integration Key retrieved from ZIS bundle.",
              "type": "string",
              "readOnly": false
            },
            "subdomain": {
              "description": "Account subdomain.",
              "type": "string",
              "readOnly": false
            },
            "input": {
              "description": "Contains information about events changes.",
              "type": "object",
              "properties": {
                "ticket_event": {
                  "description": "Type of event is ticket event.",
                  "type": "object",
                  "properties": {
                    "meta": {
                      "description": "Metadata about the ticket.",
                      "type": "object",
                      "properties": {
                        "version": {
                          "description": "Event version",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "occurred_at": {
                          "description": "Timestamp when the event occurred.",
                          "type": "string"
                        },
                        "ref": {
                          "description": "Reference ID",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "sequence": {
                          "description": "Sequence of Occurrence",
                          "type": "object",
                          "properties": {
                            "id": {
                              "description": "",
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "position": {
                              "description": "",
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "total": {
                              "description": "",
                              "type": [
                                "number",
                                "null"
                              ]
                            }
                          }
                        }
                      }
                    },
                    "type": {
                      "description": "Type of Ticket Event ",
                      "type": "string"
                    },
                    "previous": {
                      "description": "Previous ID",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "current": {
                      "description": "Current ID",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "ticket": {
                      "description": "Properties related to the ticket",
                      "type": "object",
                      "properties": {
                        "id": {
                          "description": "Ticket ID",
                          "type": "number"
                        },
                        "created_at": {
                          "description": "Timestamp of ticket creation.",
                          "type": "string"
                        },
                        "updated_at": {
                          "description": "Timestamp of ticket updation.",
                          "type": "string"
                        },
                        "type": {
                          "description": "Type of ticket",
                          "type": "string"
                        },
                        "priority": {
                          "description": "Priority of ticket.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "status": {
                          "description": "Status of the ticket.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "requester_id": {
                          "description": "ID of the ticket requestor.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "submitter_id": {
                          "description": "ID of the ticket submitter.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "assignee_id": {
                          "description": "ID of the ticket assignee.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "organization_id": {
                          "description": "ID of the organization ticket belongs to.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "group_id": {
                          "description": "ID of the group ticket belongs to.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "brand_id": {
                          "description": "ID of the brand ticket belongs to",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "form_id": {
                          "description": "ID of the form associated with the ticket.",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "external_id": {
                          "description": "",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "tags": {
                          "description": "Tags associated with the ticket.",
                          "type": "array",
                          "items": {
                            "description": "",
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "via": {
                          "description": "Channel via which change was made.",
                          "type": "object",
                          "properties": {
                            "channel": {
                              "description": "",
                              "type": "string"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              },
              "readOnly": false
            }
          }
        },
"context-data": {
          "description": "",
          "type": "object",
          "properties": {
            "Id": {
              "type": "number",
              "readOnly": false,
              "description": "Automatically assigned when the ticket is created."
            },
            "Subject": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The value of the subject field for this ticket. When used in WHERE clause: The text in the ticket subject"
            },
            "RawSubject": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The dynamic content placeholder, if present, or the subject value, if not."
            },
            "Description": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The first comment on the ticket. When used in WHERE clause: The text in the tickets description and comments"
            },
            "Type": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The type of this ticket. Possible values: problem, incident, question or task."
            },
            "Priority": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The urgency with which the ticket should be addressed. Possible values: urgent, high, normal, low."
            },
            "Status": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The state of the ticket. Possible values: new, open, pending, hold, solved, closed."
            },
            "Recipient": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The original recipient e-mail address of the ticket."
            },
            "HasIncidents": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Is true of this ticket has been marked as a problem, false otherwise."
            },
            "DueAt": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "If this is a ticket of type task it has a due date. Due date format uses ISO 8601 format."
            },
            "RequesterId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The user who requested this ticket."
            },
            "SubmitterId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The user who submitted the ticket. The submitter always becomes the author of the first comment on the ticket. "
            },
            "AssigneeId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The agent currently assigned to the ticket."
            },
            "OrganizationId": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The organization of the requester. You can only specify the ID of an organization associated with the requester."
            },
            "GroupId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The group this ticket is assigned to. When used in WHERE clause: The assigned agents group name."
            },
            "CollaboratorIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ids of users currently cc-ed on the ticket."
            },
            "FollowerIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Agents currently following the ticket."
            },
            "ForumTopicId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The topic this ticket originated from, if any."
            },
            "ProblemId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "For tickets of type incident, the ID of the problem the incident is linked to."
            },
            "ExternalId": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "An id you can use to link Zendesk Support tickets to local records."
            },
            "FollowupIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Closed tickets only. The ids of the followups created from this ticket."
            },
            "ViaFollowupSourceId": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "POST requests only. The id of a closed ticket when creating a follow-up ticket.."
            },
            "MacroIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "POST requests only. List of macro IDs to be recorded in the ticket audit."
            },
            "TicketFormId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "Enterprise only. The id of the ticket form to render for the ticket."
            },
            "BrandId": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "Enterprise only. The id of the brand this ticket is associated with."
            },
            "Tags": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The array of tags applied to this ticket."
            },
            "ViaChannel": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "This tells you how the ticket or event was created. Examples: web, mobile, rule, system."
            },
            "ViaSource": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The tickets source. "
            },
            "CustomFields": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Custom fields for the ticket.The values of custom field are set and get dynamically"
            },
            "SatisfactionRating": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The satisfaction rating of the ticket, if it exists, or the state of satisfaction, offered or unoffered."
            },
            "SharingAgreementIds": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ids of the sharing agreements used for this ticket."
            },
            "AllowChannelback": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Is false if channelback is disabled, true otherwise. Only applicable for channels framework ticket."
            },
            "IsPublic": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Is true if any comments are public, false otherwise."
            },
            "CreatedAt": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "When this record was created."
            },
            "UpdatedAt": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "When this record last got updated."
            },
            "Url": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The API url of this ticket."
            },
            "View_Id": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The view that tickets belong to."
            },
            "User_Id": {
              "type": [
                "number",
                "null"
              ],
              "readOnly": false,
              "description": "The user that tickets belong to."
            },
            "Assignee": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The assigned agent or other entity. You can specify none, me, user name (full name or partial), email address, user ID, or phone number"
            },
            "GroupName": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The assigned agents group name."
            },
            "Requester": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ticket requester. You can specify none, me, user name (full name or partial), email address, user ID, or phone number."
            },
            "Submitter": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The ticket submitter. This may be different than the requester if the ticket was submitted by an agent on behalf of the requester. You can specify none, me, user name (full name or partial), email address, user ID, or phone number. ."
            },
            "Brand": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "Search for a specific Brand on a ticket."
            },
            "Via": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "The tickets source, which can be any of the following:mail, api, phone, etc."
            },
            "Commenter": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "People who have added comments to tickets. You can specify none, me, user name (full name or partial), email address, user ID, or phone number."
            },
            "Cc": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false,
              "description": "People who have been CCd on tickets. You can specify none, me, user name (full name or partial), email address, user ID, or phone number."
            },
            "HasAttachment": {
              "type": [
                "boolean",
                "null"
              ],
              "readOnly": false,
              "description": "Search for all tickets with or without attachments using true or false."
            },
            "Ticket status": {
              "type": [
                "string",
                "null"
              ],
              "readOnly": false
            }
          }
        }
      }
    }
    
  

Ereignisabos ansehen

So rufen Sie alle Ereignisabos auf, die mit einer Verbindung in Integration Connectors verknüpft sind, und verwalten sie:

  1. Rufen Sie die Seite Integration Connectors > Verbindungen auf.

    Zur Seite „Verbindungen“

  2. Klicken Sie auf die Verbindung, für die Sie die Abos aufrufen möchten.
  3. Klicken Sie auf den Tab Event-Abos.

    Hier werden alle Ereignisabos für die Verbindung angezeigt.

Zendesk-Trigger bearbeiten

Sie können einen Zendesk-Trigger bearbeiten, um die Verbindungskonfiguration und die Details zum Ereignis-Abo zu ändern oder zu aktualisieren.

So bearbeiten Sie einen Zendesk-Trigger:

  1. Klicken Sie im Integrationseditor auf das Element Zendesk-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
  2. Klicken Sie auf Zendesk-Trigger konfigurieren.
  3. Führen Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Schritte aus:
    1. Wenn Sie das zuvor konfigurierte Ereignis-Abo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
    2. Aktualisieren Sie die Verbindungskonfiguration und die Details zum Ereignis-Abo nach Bedarf.
    3. Klicken Sie auf Fertig.
  4. Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich für die Triggerkonfiguration unter Details zum Ereignisabo.

Unterstützte Arten von Ereignisabos

Mit dem Zendesk-Trigger können Sie eine Integration für die folgenden Arten von Ereignisabonnements aufrufen:

Arten von Ereignisabos Beschreibung
organization.ExternalChanged Die externe ID einer Organisation hat sich geändert.
organization.OrganizationCreated Eine Organisation wird erstellt.
organization.TagsChanged Die Tags einer Organisation wurden geändert.
ticket.AgentAssignmentChanged Ein Ticket wird einem anderen Kundenservicemitarbeiter zugewiesen.
ticket.AttachmentLinkedToComment Ein Anhang ist mit einem Ticketkommentar im Support verknüpft.
ticket.AttachmentRedactedFromComment Ein Anhang wird aus einem vorhandenen Kommentar in einem Ticket entfernt.
ticket.BrandChanged Die Marke wurde geändert. Eine Marke ist eine kundenorientierte Identität, die durch mehrere Produkte oder Dienstleistungen oder mehrere Marken des Unternehmens repräsentiert werden kann.
ticket.CcsChanged Nutzer wurden einem Ticket hinzugefügt oder daraus entfernt.
ticket.CommentAdded Ein Kommentar wird hinzugefügt, wenn ein Support-Ticket erstellt oder aktualisiert wird.
ticket.CommentMadePrivate Einem Support-Ticket wird ein privater Kommentar hinzugefügt.
ticket.CommentRedacted Wörter oder Zeichenfolgen wurden dauerhaft aus einem Ticketkommentar entfernt.
ticket.DescriptionChanged Die Beschreibung wird in einem Ticket geändert.
ticket.ExternalIdChanged Die externe Ticket-ID wird geändert.
ticket.FollowersChanged Die Follower eines Tickets wurden geändert.
ticket.GroupAssignmentChanged Ein Ticket wird einer anderen Gruppe von Kundenservicemitarbeitern zugewiesen.
ticket.MarkedAsSpam Ein Ticket wird als Spam markiert.
ticket.OrganizationChanged Die Organisation wird im Ticket geändert.
ticket.PriorityChanged Die Priorität eines Tickets wird geändert.
ticket.ProblemLinkChanged Die Problem-ID, die mit einem Ticket vom Typ „Vorfall“ verknüpft ist, wird geändert.
ticket.RequesterChanged Der Antragsteller eines Tickets wird geändert.
ticket.StatusChanged Der Status eines Tickets wird geändert.
ticket.SubjectChanged Der Betreff eines Tickets wird geändert.
ticket.SubmitterChanged Der Absender eines Tickets wird geändert.
ticket.TagsChanged Tags in einem Ticket wurden geändert.
ticket.TaskDueAtChanged Das Fälligkeitsdatum und die Fälligkeitszeit einer Aufgabe in einem Ticket werden geändert.
ticket.TicketCreated Ein Support-Ticket wird erstellt.
ticket.TicketFormChanged Das Formular wird im Ticket geändert.
ticket.TicketMerged Ein Ticket wird mit einem anderen Ticket zusammengeführt.
ticket.TicketPermanentlyDeleted Ein Ticket wird endgültig gelöscht.
ticket.TicketSoftDeleted Ein Ticket wird so gelöscht, dass es für keinen Nutzer sichtbar ist, auch nicht für Administratoren, die entweder die Produktoberfläche oder die API verwenden.
ticket.TicketTypeChanged Ein Tickettyp wird geändert.
ticket.TicketUndeleted Ein Ticket wird wiederhergestellt.
user.CustomRoleChanged Die benutzerdefinierte Rolle eines Nutzers wurde geändert.
user.ExternalidChanged Die externe ID eines Nutzers wurde geändert.
user.LastLoginChanged Der Zeitpunkt der letzten Anmeldung eines Nutzers hat sich geändert.
user.OnlyPrivateCommentsChanged Die Möglichkeit eines Nutzers, öffentliche Kommentare zu erstellen, hat sich geändert.
user.TageChanged Die Tags eines Nutzers wurden geändert.
userTimeZoneChanged Die Zeitzone eines Nutzers wurde geändert.
user.UserAliasChanged Der Alias eines Nutzers wurde geändert.
user.UserCreated Ein Nutzer wird erstellt.
user.UserDetailsChanged Die Daten eines Nutzers haben sich geändert.
user.UserGroupAdded Ein Nutzer wird einer Gruppe hinzugefügt.
user.UserGroupRemoved Ein Nutzer wird aus einer Gruppe entfernt.
user.UserIdentityChanged Die Identität eines Nutzers wurde geändert.
user.UserIdentityCreated Die Identität eines Nutzers wird erstellt.
user.UserIdentityRemoved Die Identität eines Nutzers wird gelöscht.
user.UserActiveChanged Der aktive Status eines Nutzers wurde geändert.
user.UserMerged Ein Nutzer wird mit einem anderen Nutzer zusammengeführt.
user.UserNameChanged Der Name eines Nutzers wurde geändert.
user.UserNotesChanged Die Notizen eines Nutzers wurden geändert.
user.UserOrganizationAdded Ein Nutzer wird einer Organisation hinzugefügt.
user.UserOrganizationRemoved Ein Nutzer wird aus einer Organisation entfernt.
user.UserPhotoChanged Das Foto eines Nutzers wurde geändert.
user.UserRoleChanged Die Rolle eines Nutzers wurde geändert.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte