Informationen zu den unterstützten Connectors für Application Integration.

Zendesk-Trigger

Der Zendesk-Trigger ist ein Connector-Ereignis-Trigger, 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 der 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 Liste der Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, 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 Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

  4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um eine Liste der verfügbaren Trigger aufzurufen.
  5. Klicken Sie auf das Element Zendesk-Trigger und platzieren Sie es im Integrationseditor.
  6. Sie können den Zendesk-Trigger entweder mit einer vorhandenen Zendesk-Verbindung konfigurieren, die in Integration Connectors verfügbar ist, oder eine neue Zendesk-Verbindung mit der Option zum Erstellen einer Inline-Verbindung 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. Sie können den Trigger daher nur mit einer Zendesk-Verbindung mit aktiviertem Ereignisabo konfigurieren.

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 (Editor für Connector-Ereignistrigger) 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.

      In der Anwendungsintegration 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, das die Integration auslöst. Informationen zu den unterstützten Ereignisabonnementstypen für diesen Trigger finden Sie unter Unterstützte Ereignisabonnementstypen.
    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 ein:
      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: Klicken Sie dieses Kästchen an, um alle Protokolldaten der Verbindung zu speichern.
      5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die Zendesk-Verbindung aus.
      6. Ereignisanmeldung aktivieren:Wählen Sie diese Option aus, um eine neue Ereignisanmeldung für die Zendesk-Verbindung zu erstellen und zu aktivieren. Sie können entweder nur Ereignisabonnements aktivieren oder auch Entitäten, Vorgänge und Aktionen für Verbindungen einbeziehen.
      7. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für den Verbindungsknoten zu konfigurieren.

        Weitere Informationen zu den Verbindungsknoteneinstellungen für Zendesk 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 angegebene 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 Ereignisabo Details zur Zendesk-Instanz an, in der die Ereignisabos 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:Klicken Sie dieses Kästchen an, 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üfen: 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, das die Integration auslöst. Informationen zu den unterstützten Ereignisabonnementstypen für diesen Trigger finden Sie unter Unterstützte Ereignisabonnementstypen.
  7. Klicken Sie auf Fertig und schließen Sie die Seite.

Trigger-Ausgabe

Bei Verwendung des Zendesk-Triggers dauert es einige Minuten, bis die Konfiguration des Ereignisabonnements abgeschlossen ist. Den Status Ihres Ereignisabonnements finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabonnement.

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

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

Im Bereich Details zum Ereignisabo werden neben dem Status des Ereignisabos auch weitere Details wie die Verbindungsregion, der Verbindungsname und der Name des Ereignisabos angezeigt.

Die folgende Abbildung zeigt ein Beispiellayout für den Konfigurationsbereich für Zendesk-Trigger:

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

Trigger-Ausgabevariable

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

Beispiel 1: Ausgabenutzlast für das Zendesk-Ereignis Agent Assignment Changed

  {
    "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: Daten angereicherte 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"
                        },
                        "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 Ereignisabonnements 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 Ereignisabos.

    Daraufhin werden alle Ereignisabonnements für die Verbindung angezeigt.

Zendesk-Trigger bearbeiten

Sie können einen Zendesk-Trigger bearbeiten, um die Verbindungskonfiguration und die Details zum Ereignisabo 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-Ereignistrigger-Editor die folgenden Schritte aus:
    1. Wenn Sie das zuvor konfigurierte Ereignisabo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
    2. Aktualisieren Sie die Verbindungskonfiguration und die Details zum Ereignisabo nach Bedarf.
    3. Klicken Sie auf Fertig.
  4. Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo.

Unterstützte Ereignisabonnementstypen

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

Ereignisabotypen 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 Strings wurden endgültig aus einem Ticketkommentar entfernt.
ticket.DescriptionChanged Die Beschreibung in einem Ticket wird geändert.
ticket.ExternalIdChanged Die externe Ticket-ID wird geändert.
ticket.FollowersChanged Die Benachrichtigungen für ein Ticket 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 Anfragende eines Tickets wurde geändert.
ticket.StatusChanged Der Status eines Tickets wird geändert.
ticket.SubjectChanged Der Betreff eines Tickets wird geändert.
ticket.SubmitterChanged Der Einreicher eines Tickets wurde geändert.
ticket.TagsChanged Tags in einem Ticket wurden geändert.
ticket.TaskDueAtChanged Das Abgabedatum und die Abgabezeit der Aufgabe in einem Ticket werden geändert.
ticket.TicketCreated Ein Support-Ticket wird erstellt.
ticket.TicketFormChanged Das Formular im Ticket wird 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 keine Nutzer sichtbar ist, einschließlich 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 hat sich geändert.
user.UserAliasChanged Der Alias eines Nutzers wurde geändert.
user.UserCreated Ein Nutzer wird erstellt.
user.UserDetailsChanged Die Details 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 Aktivitätsstatus eines Nutzers hat sich 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