Consultez la liste des connecteurs compatibles avec Application Integration.

Déclencheur Zendesk

Le déclencheur Zendesk est un déclencheur d'événement du connecteur qui vous permet d'appeler une intégration en fonction des événements Zendesk auxquels vous êtes abonné dans votre connexion Zendesk.

Avant de commencer

Si vous envisagez de créer ou de configurer une nouvelle connexion pour le déclencheur Zendesk, assurez-vous de disposer du rôle IAM suivant sur le projet:

  • Administrateur des connecteurs (roles/connectors.admin)
  • Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur Zendesk:

  • Demandeur Application Integration (roles/integrations.integrationInvoker)
  • Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.

Ajouter le déclencheur Zendesk

Pour ajouter un déclencheur Zendesk à votre intégration, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Integrations (Intégrations).

    La page Liste des intégrations s'affiche. Elle répertorie toutes les intégrations disponibles dans le projet Google Cloud.

  3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

    Si vous créez une intégration :

    1. Saisissez un nom et une description dans le volet Create Integration (Créer une intégration).
    2. Sélectionnez une région pour l'intégration.
    3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment dans le volet Récapitulatif de l'intégration de la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    Cela entraîne son ouverture dans l'éditeur d'intégrations.

  4. Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
  5. Cliquez sur l'élément Déclencheur Zendesk et placez-le dans l'éditeur d'intégration.
  6. Pour configurer le déclencheur Zendesk, vous pouvez utiliser une connexion Zendesk existante disponible dans Integration Connectors ou créer une connexion Zendesk à l'aide de l'option de création de connexion intégrée.

Configurer le déclencheur Zendesk à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur Zendesk à l'aide d'une connexion Zendesk existante dans Integration Connectors. Notez que le déclencheur Zendesk est un déclencheur d'événement de connecteur. Par conséquent, vous ne pouvez utiliser qu'une connexion Zendesk avec l'abonnement aux événements activé pour configurer le déclencheur.

Pour savoir comment configurer un déclencheur Zendesk à l'aide d'une nouvelle connexion Zendesk, consultez Configurer un déclencheur Zendesk à l'aide d'une nouvelle connexion.

Pour configurer un déclencheur Zendesk à l'aide d'une connexion Zendesk existante, procédez comme suit:

  1. Cliquez sur l'élément Déclencheur Zendesk dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
  2. Cliquez sur Configurer un déclencheur.
  3. Indiquez les informations de configuration suivantes sur la page Éditeur de déclencheurs d'événements de connecteur:
    1. Region (Région) : sélectionnez la région de votre connexion à Zendesk.
    2. Connection (Connexion) : sélectionnez la connexion Zendesk que vous souhaitez utiliser.

      Application Integration n'affiche que les connexions Zendesk actives et pour lesquelles l'abonnement aux événements est activé.

    3. Type d'abonnement aux événements:sélectionnez le type d'abonnement aux événements qui déclenche l'intégration. Pour en savoir plus sur les types d'abonnements à des événements compatibles avec ce déclencheur, consultez Types d'abonnements aux événements compatibles.
    4. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur Zendesk.
  4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer le déclencheur Zendesk à l'aide d'une nouvelle connexion

Pour configurer le déclencheur Zendesk à l'aide d'une nouvelle connexion Zendesk, procédez comme suit:

  1. Cliquez sur l'élément Déclencheur Zendesk dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
  2. Cliquez sur Configurer un déclencheur.
  3. Ignorez le champ Région.
  4. Cliquez sur Connexion, puis sélectionnez l'option Créer une connexion dans le menu déroulant.
  5. Procédez comme suit dans le volet Créer une connexion :
    1. Dans l'étape Emplacement, choisissez l'emplacement de la nouvelle connexion Zendesk :
      1. Région : sélectionnez une région dans la liste déroulante.
      2. Cliquez sur Suivant.
    2. À l'étape Connection Details (Détails de la connexion), fournissez les détails de la nouvelle connexion Zendesk:
      1. Connector version (Version du connecteur) : choisissez une version disponible du connecteur Zendesk dans la liste déroulante.
      2. Connection Name (Nom de connexion) : saisissez un nom pour la connexion Zendesk.
      3. (Facultatif) Description : saisissez une description de la connexion.
      4. (Facultatif) Activer Cloud Logging:cochez cette case pour stocker toutes les données de journal de la connexion.
      5. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour la connexion à Zendesk.
      6. Enable event subscription (Activer l'abonnement aux événements) : sélectionnez cette option pour créer et activer un abonnement à un événement pour la connexion Zendesk. Vous pouvez soit activer uniquement les abonnements à des événements, soit inclure des entités, des opérations et des actions de connexion.
      7. (Facultatif) Développez Paramètres avancés pour configurer les paramètres du nœud de connexion.

        Pour en savoir plus sur les paramètres de nœud de connexion pour Zendesk, consultez la documentation sur la connexion à Zendesk.

      8. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé-valeur.
      9. Cliquez sur Suivant.
    3. À l'étape Destinations, fournissez les détails de l'instance Zendesk :
      1. Destination Type (Type de destination) : sélectionnez Host address (Adresse de l'hôte).
      2. Host (Hôte) : saisissez le nom d'hôte ou l'adresse IP de votre instance Zendesk.
      3. Cliquez sur Suivant.
    4. À l'étape Authentification, indiquez les informations d'authentification de l'instance Zendesk:
      1. Sélectionnez le type d'authentification souhaité, puis saisissez les informations nécessaires pour accéder à l'URL de l'hôte Zendesk fournie.

        Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.

      2. Cliquez sur Suivant.
    5. À l'étape Event subscription details (Détails de l'abonnement aux événements), indiquez les détails de l'instance Zendesk dans laquelle les abonnements aux événements seront créés.
      1. Destination Type (Type de destination) : sélectionnez Host address (Adresse de l'hôte).
      2. Host (Hôte) : saisissez l'URL d'enregistrement de votre instance Zendesk. Des abonnements aux événements seront créés pour cette URL.
      3. Username (Nom d'utilisateur) : saisissez le nom d'utilisateur pour accéder à l'URL d'inscription fournie.
      4. Mot de passe:sélectionnez le secret Secret Manager contenant le mot de passe associé au nom d'utilisateur.
      5. Version du secret:sélectionnez une version du secret.
      6. Activer l'enrichissement des données:cochez cette case si vous souhaitez que le déclencheur Zendesk récupère la charge utile complète de l'événement à partir de l'instance Zendesk. Consultez la section Sortie du déclencheur pour obtenir des exemples.
      7. Cliquez sur Suivant.
    6. Vérification: examinez les détails de connexion à Zendesk fournis.
    7. Cliquez sur Create (Créer) pour terminer la création de la connexion Zendesk.
  6. Type d'abonnement aux événements:sélectionnez le type d'abonnement aux événements qui déclenche l'intégration. Pour en savoir plus sur les types d'abonnements à des événements compatibles avec ce déclencheur, consultez Types d'abonnements aux événements compatibles.
  7. Cliquez sur OK et fermez la page.

Sortie du déclencheur

La configuration de l'abonnement à l'événement par le déclencheur Zendesk prend quelques minutes. Vous pouvez consulter l'état de votre abonnement à l'événement dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Le déclencheur Zendesk indique l'état d'un abonnement à des événements à l'aide des états suivants :

  • Creating: indique que le déclencheur s'abonne à l'abonnement à l'événement.
  • Active: indique que le déclencheur a bien été abonné à un abonnement à un événement.
  • Error: indique un problème avec l'abonnement à un événement configuré.

En plus de l'état de l'abonnement à l'événement, la section Détails de l'abonnement aux événements affiche également d'autres informations telles que la région et le nom de la connexion, ainsi que le nom de l'abonnement à l'événement.

L'image suivante présente un exemple de mise en page du volet de configuration du déclencheur Zendesk :

Image montrant le volet de configuration du déclencheur Zendesk Image montrant le volet de configuration du déclencheur Zendesk

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur Zendesk génère une variable de sortie ConnectorEventPayload que vous pouvez utiliser dans vos tâches en aval. La variable de sortie est au format JSON et contient le schéma de la charge utile Zendesk de sortie.

Exemple 1 : Charge utile de sortie pour l'événement Zendesk : Agent Assignment Changed (Modification de l'attribution de l'agent)

  {
    "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
        }
    }
}
}
}

Exemple 2 : Charge utile de sortie enrichie en données pour l'événement Zendesk – 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"
                        },
                        "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
            }
          }
        }
      }
    }
    
  

Afficher les abonnements à des événements

Pour afficher et gérer tous les abonnements aux événements associés à une connexion dans Integration Connectors, procédez comme suit :

  1. Accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions).

    Accéder à la page "Connexions"

  2. Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.
  3. Cliquez sur l'onglet Abonnements aux événements.

    Tous les abonnements à des événements associés à la connexion s'affichent.

Modifier le déclencheur Zendesk

Vous pouvez modifier un déclencheur Zendesk pour modifier ou mettre à jour la configuration de la connexion et les détails de l'abonnement aux événements.

Pour modifier un déclencheur Zendesk, procédez comme suit:

  1. Cliquez sur l'élément Déclencheur Zendesk dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
  2. Cliquez sur Configurer un déclencheur Zendesk.
  3. Procédez comme suit sur la page Éditeur de déclencheurs d'événements de connecteur:
    1. Pour conserver l'abonnement à l'événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
    2. Mettez à jour les détails de la configuration de la connexion et de l'abonnement aux événements selon vos besoins.
    3. Cliquez sur OK.
  4. Vous pouvez afficher les détails mis à jour de la connexion et de l'abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Types d'abonnements aux événements acceptés

Vous pouvez utiliser le déclencheur Zendesk pour appeler une intégration pour les types d'abonnements aux événements suivants:

Types d'abonnements aux événements Description
organization.ExternalChanged L'ID externe d'une organisation a changé.
organization.OrganizationCreated Une organisation est créée.
organization.TagsChanged Les tags d'une organisation ont été modifiés.
ticket.AgentAssignmentChanged Une demande est réattribuée à un autre agent du service d'assistance.
ticket.AttachmentLinkedToComment Une pièce jointe est liée à un commentaire de demande d'assistance dans l'assistance.
ticket.AttachmentRedactedFromComment Une pièce jointe est masquée dans un commentaire existant dans une demande d'assistance.
ticket.BrandChanged La marque est modifiée. Une marque est une identité visible par les clients, qui peut être représentée par plusieurs produits ou services, ou par plusieurs marques appartenant à l'entreprise.
ticket.CcsChanged Des utilisateurs ont été ajoutés à un billet ou supprimés de celui-ci.
ticket.CommentAdded Un commentaire est ajouté lors de la création ou de la mise à jour d'une demande d'assistance.
ticket.CommentMadePrivate Un commentaire privé est ajouté à une demande d'assistance.
ticket.CommentRedacted Des mots ou des chaînes ont été définitivement supprimés d'un commentaire lié à une demande d'assistance.
ticket.DescriptionChanged La description est modifiée dans un ticket.
ticket.ExternalIdChanged L'ID de la demande externe est modifié.
ticket.FollowersChanged Les abonnés ont été modifiés sur un ticket.
ticket.GroupAssignmentChanged Une demande est réattribuée à un autre groupe d'agents.
ticket.MarkedAsSpam Une demande est marquée comme spam.
ticket.OrganizationChanged L'organisation est modifiée dans la demande.
ticket.PriorityChanged La priorité est modifiée sur un ticket.
ticket.ProblemLinkChanged L'ID de problème associé à un ticket de type d'incident est modifié.
ticket.RequesterChanged Le demandeur d'un ticket est modifié.
ticket.StatusChanged L'état d'une demande d'assistance est modifié.
ticket.SubjectChanged L'objet d'un ticket est modifié.
ticket.SubmitterChanged L'émetteur d'une demande est modifié.
ticket.TagsChanged Des tags ont été modifiés dans une demande d'assistance.
ticket.TaskDueAtChanged La date et l'heure d'échéance d'une tâche sur un ticket sont modifiées.
ticket.TicketCreated Une demande d'assistance est créée.
ticket.TicketFormChanged Le formulaire est modifié dans la demande.
ticket.TicketMerged Les demandes d'assistance sont fusionnées avec une autre.
ticket.TicketPermanentlyDeleted Un ticket est définitivement supprimé.
ticket.TicketSoftDeleted Une demande d'assistance est supprimée de sorte qu'elle n'est plus visible par les utilisateurs, y compris les administrateurs qui utilisent l'interface du produit ou l'API.
ticket.TicketTypeChanged Un type de billet est modifié.
ticket.TicketUndeleted Une demande est rétablie.
user.CustomRoleChanged Le rôle personnalisé d'un utilisateur a été modifié.
user.ExternalidChanged L'ID externe d'un utilisateur a été modifié.
user.LastLoginChanged L'heure de la dernière connexion d'un utilisateur a changé.
user.OnlyPrivateCommentsChanged La possibilité pour un utilisateur de créer des commentaires publics a changé.
user.TageChanged Les tags d'un utilisateur ont été modifiés.
userTimeZoneChanged Le fuseau horaire d'un utilisateur a changé.
user.UserAliasChanged L'alias d'un utilisateur a été modifié.
user.UserCreated Un utilisateur est créé.
user.UserDetailsChanged Les informations d'un utilisateur ont été modifiées.
user.UserGroupAdded Un utilisateur est ajouté à un groupe.
user.UserGroupRemoved Un utilisateur est supprimé d'un groupe.
user.UserIdentityChanged L'identité d'un utilisateur a été modifiée.
user.UserIdentityCreated L'identité d'un utilisateur est créée.
user.UserIdentityRemoved L'identité d'un utilisateur est supprimée.
user.UserActiveChanged L'état d'activité d'un utilisateur a changé.
user.UserMerged Un utilisateur est fusionné avec un autre utilisateur.
user.UserNameChanged Le nom d'un utilisateur a changé.
user.UserNotesChanged Les notes d'un utilisateur ont été modifiées.
user.UserOrganizationAdded Un utilisateur est ajouté à une organisation.
user.UserOrganizationRemoved Un utilisateur est supprimé d'une organisation.
user.UserPhotoChanged La photo d'un utilisateur a changé.
user.UserRoleChanged Le rôle d'un utilisateur a été modifié.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante