Consultez la liste des connecteurs compatibles avec Application Integration.

Déclencheur Zendesk

Le déclencheur Zendesk est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration basée sur les événements Zendesk auxquels vous êtes abonné dans votre connexion Zendesk.

Avant de commencer

Si vous envisagez de créer ou de configurer une 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 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 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 détails du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de dans la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    La page de l'éditeur d'intégration s'affiche.

  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 soit utiliser une connexion Zendesk existante disponible dans Integration Connectors, soit créer une connexion Zendesk à l'aide de l'option de création de connexion intégrée.

Configurer un 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égrations pour ouvrir le volet de configuration du déclencheur.
  2. Cliquez sur Configurer un déclencheur.
  3. Fournissez les informations de configuration suivantes sur la page Éditeur de déclencheur 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 un abonnement à un événement est activé.

    3. Type d'abonnement à un événement:sélectionnez le type d'abonnement à un événement 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 à des é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égrations 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 Create Connection (Créer une connexion) :
    1. À l'étape Location (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 des informations sur la nouvelle connexion Zendesk :
      1. Version du connecteur:sélectionnez 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 journaux de la connexion.
      5. Compte de service: sélectionnez un compte de service doté 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 aux événements pour la connexion Zendesk. Vous pouvez soit activer uniquement les abonnements aux événements, soit inclure des entités, opérations et 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 du nœud de connexion Zendesk, consultez la documentation sur les connexions Zendesk.

      8. (Facultatif) Cliquez sur + Ajouter un libellé pour ajouter un libellé à 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. Type de destination:sélectionnez 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, fournissez les informations d'authentification pour l'instance Zendesk :
      1. Sélectionnez le type d'authentification souhaité, puis saisissez les informations requises 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 à l'événement), indiquez les détails de l'instance Zendesk dans laquelle les abonnements à des événements seront créés.
      1. Type de destination:sélectionnez Adresse de l'hôte.
      2. Host (Hôte) : saisissez l'URL d'enregistrement de votre instance Zendesk. Des abonnements à des événements seront créés pour cette URL.
      3. Nom d'utilisateur:saisissez le nom d'utilisateur pour accéder à l'URL d'inscription fournie.
      4. Password (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. Enable data enrichment (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 Résultat du déclencheur pour obtenir des exemples.
      7. Cliquez sur Suivant.
    6. Vérification: vérifiez les détails de connexion Zendesk fournis.
    7. Cliquez sur Créer pour terminer la création de la connexion Zendesk.
  6. Type d'abonnement à un événement:sélectionnez le type d'abonnement à un événement 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 à des événements compatibles.
  7. Cliquez sur OK et fermez la page.

Sortie du déclencheur

Le déclencheur Zendesk prend quelques minutes pour terminer la configuration de l'abonnement aux événements. Vous pouvez afficher l'état de votre abonnement à un événement dans le volet de configuration du déclencheur, sous Détails de l'abonnement à un événement.

Le déclencheur Zendesk indique l'état d'un abonnement à un événement avec les é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 qu'il y a un problème avec l'abonnement à un événement configuré.

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

L'image suivante illustre 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 charge utile de sortie Zendesk.

Exemple 1: Charge utile de sortie pour l'événement Zendesk: Attribution d'agent modifiée

  {
    "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 pour les données pour l'événement Zendesk: affectation d'un agent modifiée

    {
      "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 à des é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 aux événements pour la connexion s'affichent.

Modifier le déclencheur Zendesk

Vous pouvez modifier un déclencheur Zendesk pour changer 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éclencheur d'événements de connecteur :
    1. Pour conserver l'abonnement à un événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
    2. Mettez à jour la configuration de la connexion et les détails de l'abonnement à l'événement, comme vous le souhaitez.
    3. Cliquez sur OK.
  4. Vous pouvez afficher les détails de la connexion et de l'abonnement aux événements mis à jour dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Types d'abonnements à des événements compatibles

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

Types d'abonnements à des événements Description
organization.ExternalChanged L'ID externe d'une organisation a été modifié.
organization.OrganizationCreated Une organisation est créée.
organization.TagsChanged Les tags d'une organisation ont été modifiés.
ticket.AgentAssignmentChanged Une demande est réaffectée à un autre agent de l'assistance.
ticket.AttachmentLinkedToComment Une pièce jointe est liée à un commentaire sur une demande d'assistance.
ticket.AttachmentRedactedFromComment Une pièce jointe est masquée dans un commentaire existant d'une demande d'assistance.
ticket.BrandChanged La marque change. Une marque est une identité destinée aux clients qui peut être représentée par plusieurs produits ou services, ou par plusieurs marques détenues par l'entreprise.
ticket.CcsChanged Des utilisateurs ont été ajoutés à une demande d'assistance ou supprimés.
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 sur une demande d'assistance.
ticket.DescriptionChanged La description est modifiée dans une demande d'assistance.
ticket.ExternalIdChanged L'ID externe de la demande a été modifié.
ticket.FollowersChanged Des abonnés ont été modifiés sur un ticket.
ticket.GroupAssignmentChanged Un ticket est réattribué à un autre groupe d'agents.
ticket.MarkedAsSpam Une demande d'assistance est marquée comme spam.
ticket.OrganizationChanged L'organisation est modifiée dans la demande d'assistance.
ticket.PriorityChanged La priorité d'une demande d'assistance est modifiée.
ticket.ProblemLinkChanged L'identifiant de problème associé à un ticket de type incident est modifié.
ticket.RequesterChanged Le demandeur d'une demande est modifié.
ticket.StatusChanged L'état d'une demande d'assistance est modifié.
ticket.SubjectChanged L'objet d'une demande d'assistance est modifié.
ticket.SubmitterChanged L'auteur d'une demande d'assistance est modifié.
ticket.TagsChanged Des tags ont été modifiés dans une demande d'assistance.
ticket.TaskDueAtChanged La date et l'heure limite de la 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 d'assistance.
ticket.TicketMerged Un billet est fusionné avec un autre.
ticket.TicketPermanentlyDeleted Un billet est définitivement supprimé.
ticket.TicketSoftDeleted Une demande d'assistance est supprimée de sorte qu'elle n'est plus visible par aucun utilisateur, y compris les administrateurs utilisant l'interface produit ou l'API.
ticket.TicketTypeChanged Un type de billet a été modifié.
ticket.TicketUndeleted La suppression d'une demande d'assistance est annulée.
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 capacité d'un utilisateur à créer des commentaires publics a été modifiée.
user.TageChanged Les tags d'un utilisateur ont été modifiés.
userTimeZoneChanged Le fuseau horaire d'un utilisateur a été modifié.
user.UserAliasChanged L'alias d'un utilisateur a été modifié.
user.UserCreated Un utilisateur est créé.
user.UserDetailsChanged Les informations d'un utilisateur ont changé.
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 changé.
user.UserIdentityCreated L'identité d'un utilisateur est créée.
user.UserIdentityRemoved L'identité d'un utilisateur est supprimée.
user.UserActiveChanged L'état actif d'un utilisateur a changé.
user.UserMerged Un utilisateur est fusionné avec un autre.
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é.