Zoho Desk

Ce document explique comment intégrer Zoho Desk à Google SecOps.

Configurer l'intégration de Zoho Desk dans Google Security Operations

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Racine de l'API Chaîne https://desk.zoho.{region} Oui Racine de l'API de l'instance Zoho Desk.
ID client Chaîne N/A Oui ID client du compte Zoho Desk.
Code secret du client Mot de passe N/A Oui Code secret du client du compte Zoho Desk.
Jeton d'actualisation Mot de passe N/A Non Jeton d'actualisation du compte Zoho Desk. Vous devez exécuter l'action "Obtenir un jeton d'actualisation" pour le générer.
Vérifier le protocole SSL Case à cocher Cochée Oui Si cette option est activée, elle vérifie que le certificat SSL de la connexion au serveur Zoho Desk est valide.

Obtenir des identifiants d'API

  1. Accédez à la console de l'API Zoho Desk.
  2. Cliquez sur Add Client (Ajouter un client), puis sélectionnez Self Client (Client personnel).
  3. Dans l'onglet Code secret du client, copiez la valeur des paramètres "ID client" et "Code secret du client", puis collez-la dans les champs correspondants de la fenêtre de configuration de l'intégration.
  4. Dans l'onglet Générer le code, indiquez les champs d'application suivants : Desk.tickets.READ,Desk.tickets.CREATE,Desk.tickets.UPDATE,Desk.tickets.DELETE,Desk.settings.READ,Desk.basic.READ,Desk.products.READ,Desk.contacts.READ et ajoutez une description du champ d'application.
  5. Pour obtenir un code d'autorisation, cliquez sur Créer.
  6. Revenez à Google SecOps, simulez une demande et accédez à l'action Get Refresh Token (Obtenir un jeton d'actualisation) dans l'intégration Zoho Desk.
  7. Pour configurer l'action, saisissez votre code d'autorisation et votre lien d'autorisation.
  8. Copiez le jeton à partir du résultat JSON de l'action, collez-le dans le champ correspondant de la fenêtre de configuration de l'intégration, puis exécutez un test.

Cas d'utilisation

Effectuer une action de tri.

Actions

Ajouter un commentaire à la demande

Description

Ajouter un commentaire à un ticket dans Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID de la demande Chaîne N/A Oui Spécifiez l'ID de la demande à laquelle vous souhaitez ajouter un commentaire.
Visibilité LDD

Public

Valeurs possibles :

  • Public
  • Privé
Non Indiquez si le commentaire doit être public ou privé.
Type Chaîne

Texte brut

Valeurs possibles :

  • Texte brut
  • HTML
Non Spécifiez le type de commentaire.
Texte Chaîne N/A Non Spécifiez le contenu du commentaire.
Attendre une réponse Case à cocher Décochée Non Si cette option est activée, l'action attend une réponse.

Exécution

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "content": "zsu[@user:11550965]zsu Please fix this ASAP",
    "commentedTime": "2022-07-01T11:18:43.935Z",
    "modifiedTime": "2022-07-01T11:18:43.935Z",
    "contentType": "plainText",
    "impersonatedUser": null,
    "encodedContent": "zsu[@user:11550965]zsu Please fix this ASAP",
    "id": "97709000000179081",
    "commenterId": "97709000000092001",
    "commenter": {
        "id": "97709000000092001",
        "name": "TIP Labops",
        "email": "tip.labops@siemplify.co",
        "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
        "type": "AGENT",
        "firstName": "TIP",
        "lastName": "Labops",
        "roleName": "CEO"
    },
    "attachments": [],
    "isPublic": false
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état 200 est renvoyé (is_success = true) : "Successfully added comment "{text}" to ticket {ticket id}in Zoho Desk."

Message asynchrone : "En attente d'une réponse..."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur critique est signalée : "Erreur lors de l'exécution de l'action "Ajouter un commentaire au ticket". Reason: {0}''.format(error.Stacktrace)

Si des erreurs sont signalées : "Error executing action "Add Comment To Ticket". Motif : {errors/errorMessage}

Général

Créer une demande

Description

Créez un ticket dans Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Title Chaîne N/A Non Spécifiez le titre de la demande.
Description Chaîne N/A Non Spécifiez la description de la demande.
Nom du service Chaîne N/A Non Spécifiez le nom du service à définir pour la demande d'assistance.
Contact Chaîne N/A Non Spécifiez l'adresse e-mail du contact pour la demande.
Type de cessionnaire LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Agent
  • Équipe
Non

Spécifiez le type de cessionnaire.

Si "Agent" ou "Équipe" est sélectionné, le paramètre "Nom de la personne responsable" est obligatoire.

Nom du cessionnaire Chaîne N/A Non Spécifiez le nom de la personne responsable de la demande. Pour le type d'agent, vous pouvez fournir une adresse e-mail ou un nom à afficher.
Priorité LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Aucune priorité
  • Faible
  • Moyen
  • Élevée
Non Spécifiez la priorité de la demande.
Сlassification LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Aucune classification
  • Question
  • Problème
  • Fonctionnalité
  • Autres
Non Spécifiez le type de classification du ticket.
Canal LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • E-mail
  • Téléphone
  • Web
  • Twitter
  • Facebook
  • Chat
  • Forums
Non Spécifiez le canal du ticket.
Catégorie Chaîne N/A Non Spécifiez la catégorie de la demande.
Sous-catégorie Chaîne N/A Non Spécifiez la sous-catégorie de la demande.
Date limite Chaîne N/A Non

Spécifiez la date d'échéance de la demande.

Format : ISO 8601. Exemple : 2022-07-06T07:05:43Z.

Champs personnalisés JSON N/A Non

Spécifiez un objet JSON contenant les champs personnalisés à mettre à jour.

Remarque : Vous devez fournir les noms d'API des clés.

Exécution

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "modifiedTime": "2022-07-01T11:00:33.000Z",
    "subCategory": null,
    "statusType": "On Hold",
    "subject": "Here's your first ticket.",
    "dueDate": null,
    "departmentId": "97709000000007061",
    "channel": "Chat",
    "onholdTime": "2022-07-01T09:32:14.717Z",
    "language": "English",
    "source": {
        "appName": null,
        "extId": null,
        "permalink": null,
        "type": "SYSTEM",
        "appPhotoURL": null
    },
    "resolution": "Koko",
    "sharedDepartments": [],
    "closedTime": null,
    "approvalCount": "0",
    "isOverDue": true,
    "isTrashed": false,
    "createdTime": "2022-06-27T17:02:17.000Z",
    "id": "97709000000160077",
    "isResponseOverdue": false,
    "customerResponseTime": "2022-06-27T17:02:17.000Z",
    "productId": null,
    "contactId": "97709000000160029",
    "threadCount": "1",
    "secondaryContacts": [],
    "priority": null,
    "classification": null,
    "commentCount": "1",
    "taskCount": "0",
    "accountId": "97709000000160001",
    "phone": "1 888 900 9646",
    "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000160077",
    "isSpam": false,
    "status": "On Hold",
    "entitySkills": [],
    "ticketNumber": "101",
    "customFields": {},
    "isArchived": false,
    "description": "Hello<",
    "timeEntryCount": "0",
    "channelRelatedInfo": null,
    "responseDueDate": null,
    "isDeleted": false,
    "modifiedBy": "97709000000092001",
    "email": "support@zohosupport.com",
    "layoutDetails": {
        "id": "97709000000023011",
        "layoutName": "Siemplify"
    },
    "channelCode": null,
    "cf": {},
    "slaId": null,
    "layoutId": "97709000000023011",
    "assigneeId": null,
    "teamId": "97709000000182001",
    "attachmentCount": "0",
    "isEscalated": false,
    "category": null
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état 200 est renvoyé (is_success=true) : "Successfully created a ticket with ID {ticket id} in Zoho Desk." (Le ticket avec l'ID {ticket id} a bien été créé dans Zoho Desk).

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Create Ticket". Reason: {0}''.format(error.Stacktrace)

Si l'agent n'est pas trouvé : "Error executing action "Create Ticket". Motif : l'agent {agent_name} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."'

Si l'équipe est introuvable : "Error executing action "Create Ticket". Motif : l'équipe {team_name} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si "Agent" ou "Équipe" est sélectionné, mais que le paramètre "Nom de la personne responsable" n'est pas fourni : "Erreur lors de l'exécution de l'action 'Créer un ticket'. Motif : vous devez indiquer le nom du cessionnaire.

Si le service n'est pas trouvé : "Error executing action "Create Ticket". Motif : Le service {department_name} est introuvable dans Zoho Desk."

Si le contact est introuvable : "Error executing action "Create Ticket". Motif : le contact {contact} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si le produit n'est pas trouvé : "Error executing action "Create Ticket". Motif : le produit {product} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Général

Obtenir un jeton d'actualisation

Description

Obtenez un jeton d'actualisation pour la configuration.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Lien d'autorisation Chaîne https://accounts.zoho.{region} Oui Spécifiez le lien d'autorisation pour l'intégration.
Code d'autorisation Mot de passe N/A Oui Spécifiez le code d'autorisation généré dans la console de développement de Zoho.

Exécution

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "refresh_token": "1000.90567b1fc0c54f540e56200ae4388cef.a8f6b313297d558774bee07d60cc6863"
}
Mur des cas
Type de résultat Valeur/Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de réussite : "Jeton d'actualisation généré avec succès. Copiez la valeur dans le paramètre "Jeton d'actualisation" de la configuration de l'intégration.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, identifiants incorrects, aucune connexion au serveur, etc.) : "Error executing action "Get jeton d'actualisation". Reason: {0}''.format(error.Stacktrace)

Si une erreur est signalée : "Error executing action "Get jeton d'actualisation". Motif : {error}''

Général

Obtenir les détails du ticket

Description

Obtenez des informations détaillées sur le ticket depuis Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID des demandes Chaîne N/A Oui Spécifiez une liste d'ID pour lesquels vous souhaitez renvoyer des détails, séparés par une virgule.
Créer un insight Case à cocher Décochée Non Si cette option est activée, l'action crée un insight contenant des informations sur les tickets.
Champs supplémentaires à renvoyer CSV contacts, products, assignee, departments, contract, isRead, team, skills Non

Spécifiez les champs supplémentaires à renvoyer.

Valeurs possibles : contacts, products, assignee, departments, contract, isRead, team, skills.

Récupérer les commentaires Case à cocher Cochée Non Si cette option est activée, l'action récupère les commentaires liés aux tickets.
Nombre maximal de commentaires à renvoyer Integer 50 Non

Spécifiez le nombre de commentaires à renvoyer par demande.

Maximum : 100

Exécution

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
  "modifiedTime": "2022-06-27T17:12:35.000Z",
  "subCategory": null,
  "statusType": "Open",
  "subject": "tesa",
  "dueDate": null,
  "departmentId": "97709000000007061",
  "channel": "Phone",
  "onholdTime": null,
  "language": null,
  "source": {
      "appName": null,
      "extId": null,
      "permalink": null,
      "type": "SYSTEM",
      "appPhotoURL": null
  },
  "resolution": null,
  "sharedDepartments": [],
  "closedTime": null,
  "approvalCount": "0",
  "isOverDue": false,
  "isTrashed": false,
  "contact": {
      "firstName": null,
      "lastName": "test",
      "phone": null,
      "mobile": null,
      "id": "97709000000159194",
      "isSpam": false,
      "type": null,
      "email": "test@test.com",
      "account": {
          "website": null,
          "accountName": "test!@test.com",
          "id": "97709000000159182"
      }
  },
  "createdTime": "2022-06-27T17:12:35.000Z",
  "id": "97709000000159224",
  "isResponseOverdue": false,
  "customerResponseTime": "2022-06-27T17:12:35.000Z",
  "productId": null,
  "contactId": "97709000000159194",
  "threadCount": "1",
  "secondaryContacts": [],
  "priority": null,
  "classification": null,
  "commentCount": "0",
  "taskCount": "0",
  "accountId": "97709000000159182",
  "phone": null,
  "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000159224",
  "assignee": {
      "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
      "firstName": "TIP",
      "lastName": "Labops",
      "id": "97709000000092001",
      "email": "tip.labops@siemplify.co"
  },
  "isSpam": false,
  "status": "Open",
  "entitySkills": [],
  "ticketNumber": "102",
  "sentiment": null,
  "customFields": {},
  "isArchived": false,
  "skillsInfo": [],
  "isRead": false,
  "description": "<div style=\"font-size: 13px; font-family: Regular, Lato, Arial, Helvetica, sans-serif\"><div>tetsta</div></div>",
  "timeEntryCount": "0",
  "channelRelatedInfo": null,
  "responseDueDate": null,
  "isDeleted": false,
  "modifiedBy": "97709000000092001",
  "department": {
      "name": "Siemplify",
      "id": "97709000000007061"
  },
  "followerCount": "0",
  "email": "test@test.com",
  "layoutDetails": {
      "id": "97709000000023011",
      "layoutName": "Siemplify"
  },
  "channelCode": null,
  "product": null,
  "isFollowing": false,
  "cf": {},
  "slaId": null,
  "team": null,
  "layoutId": "97709000000023011",
  "assigneeId": "97709000000092001",
  "createdBy": "97709000000092001",
  "teamId": null,
  "contractId": null,
  "tagCount": "0",
  "attachmentCount": "0",
  "isEscalated": false,
  "category": null
  "comments":          {
            "content": "<div style=\"font-size: 14px; font-family: LatoRegular, Regular, Lato, &quot;Lato 2&quot;, Arial, Helvetica, sans-serif\"><div style=\"font-size: 14px; font-family: LatoRegular, Regular, Lato, &quot;Lato 2&quot;, Arial, Helvetica, sans-serif\"><ul><li>asdasdasdasd<br /></li></ul></div><div><br /></div></div>",
            "commentedTime": "2022-06-29T10:21:24.000Z",
            "modifiedTime": "2022-06-29T10:23:42.000Z",
            "contentType": "html",
            "impersonatedUser": null,
            "encodedContent": "&lt;div style&#x3d;&quot;font-size&#x3a; 14px&#x3b; font-family&#x3a; LatoRegular, Regular, Lato, &amp;quot&#x3b;Lato 2&amp;quot&#x3b;, Arial, Helvetica, sans-serif&quot;&gt;&lt;div style&#x3d;&quot;font-size&#x3a; 14px&#x3b; font-family&#x3a; LatoRegular, Regular, Lato, &amp;quot&#x3b;Lato 2&amp;quot&#x3b;, Arial, Helvetica, sans-serif&quot;&gt;&lt;ul&gt;&lt;li&gt;asdasdasdasd&lt;br &#x2f;&gt;&lt;&#x2f;li&gt;&lt;&#x2f;ul&gt;&lt;&#x2f;div&gt;&lt;div&gt;&lt;br &#x2f;&gt;&lt;&#x2f;div&gt;&lt;&#x2f;div&gt;",
            "id": "97709000000172003",
            "commenterId": "97709000000092001",
            "commenter": {
                "id": "97709000000092001",
                "name": "TIP Labops",
                "email": "tip.labops@siemplify.co",
                "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
                "type": "AGENT",
                "firstName": "TIP",
                "lastName": "Labops",
                "roleName": "CEO"
            },
            "attachments": [],
            "isPublic": false
        }

}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles pour au moins un ID (is_success = true) : "Successfully returned details related to the following tickets in Zoho Desk: {ticket ids}".

Si les données ne sont pas disponibles pour au moins un ID (is_success=true) : "L'action n'a pas pu trouver d'informations sur les tickets suivants dans Zoho Desk : {ticket ids}".

Si les données ne sont pas disponibles pour tous les ID (is_success=false) : "Aucun billet n'a été trouvé."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Get Ticket Details". Reason: {0}''.format(error.Stacktrace)

Général
Tableau du mur des cas

Nom de la table : Ticket Details Colonnes de la table :

  • Numéro : ticketNumber
  • État : status Objet : subject
  • Date et heure de création : createdTime
  • Résolution : résolution
  • Adresse e-mail : email
  • Contact : {firstName} + {lastName}
Général

Marquer la demande comme spam

Description

Marque le ticket comme spam dans Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID de la demande Chaîne N/A Oui Spécifiez l'ID de la demande à marquer comme spam.
Marquer le contact Case à cocher Cochée Non Si cette option est activée, le contact qui a créé la demande est marqué comme spammeur.

Exécution

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état 200 est renvoyé (is_success = true) : "Successfully marked a ticket as spam in Zoho Desk.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (identifiants incorrects, aucune connexion au serveur, etc.) : "Error executing action "Mark Ticket As Spam". Reason: {0}''.format(error.Stacktrace)

Si des erreurs sont signalées : "Error executing action "Mark Ticket As Spam". Motif : {errors/errorMessage}

Général

Ping

Description

Testez la connectivité à Zoho Desk avec les paramètres fournis sur la page de configuration de l'intégration dans la page Hub de contenus Google SecOps.

Paramètres

N/A

Exécution

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie\*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

En cas de réussite (is_success=true) : "Successfully connected to the Zoho Desk server with the provided connection parameters!" (Connexion au serveur Zoho Desk établie avec les paramètres de connexion fournis)

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec (is_success= false) : "Échec de la connexion au serveur Zoho Desk ! Error is {0}".format(exception.stacktrace)

Général

Mettre à jour le ticket

Description

Mettre à jour un ticket dans Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID de la demande Chaîne N/A Oui Spécifiez l'ID de la demande à mettre à jour.
Titre Chaîne N/A Non Spécifiez le titre à définir pour la demande d'assistance.
Description Chaîne N/A Non Spécifiez la description de la demande.
Nom du service Chaîne N/A Non Spécifiez le nom du service à définir pour la demande d'assistance.
Contact Chaîne N/A Non Spécifiez l'adresse e-mail du contact pour la demande.
Type de cessionnaire LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Agent
  • Équipe
Non

Spécifiez le type de cessionnaire.

Si "Agent" ou "Équipe" est sélectionné, le paramètre "Nom de la personne responsable" est obligatoire.

Nom du cessionnaire Chaîne N/A Non Spécifiez le nom de la personne responsable de la demande. Pour le type d'agent, vous pouvez fournir une adresse e-mail ou un nom à afficher.
Solution Chaîne N/A Non Spécifiez la résolution de la demande.
Priorité LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Aucune priorité
  • Faible
  • Moyen
  • Élevée
Non Spécifiez la priorité de la demande.
État LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Ouvrir
  • En attente
  • Escaladé
  • Fermé
Non Spécifiez l'état du ticket.
État de la marque LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Lire
  • Non lu
Non Spécifiez l'état de la marque pour le ticket.
Classification LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • Aucune classification
  • Question
  • Problème
  • Fonctionnalité
  • Autres
Non Spécifiez le type de classification du ticket.
Canal LDD

Sélectionnez une réponse

Valeurs possibles :

  • Sélectionnez une réponse
  • E-mail
  • Téléphone
  • Web
  • Twitter
  • Facebook
  • Chat
  • Forums
Non Spécifiez le canal du ticket.
Catégorie Chaîne N/A Non Spécifiez la catégorie de la demande.
Sous-catégorie Chaîne N/A Non Spécifiez la sous-catégorie de la demande.
Date limite Chaîne N/A Non

Spécifiez la date d'échéance de la demande.

Format : ISO 8601. Exemple : 2022-07-06T07:05:43Z.

Remarque : Ce paramètre n'a aucune incidence lorsque l'état "En attente" est défini.

Champs personnalisés JSON N/A Non

Spécifiez un objet JSON contenant les champs personnalisés à mettre à jour.

Remarque : Vous devez fournir les noms d'API des clés.

Exécution

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat JSON
{
    "modifiedTime": "2022-07-01T11:00:33.000Z",
    "subCategory": null,
    "statusType": "On Hold",
    "subject": "Here's your first ticket.",
    "dueDate": null,
    "departmentId": "97709000000007061",
    "channel": "Chat",
    "onholdTime": "2022-07-01T09:32:14.717Z",
    "language": "English",
    "source": {
        "appName": null,
        "extId": null,
        "permalink": null,
        "type": "SYSTEM",
        "appPhotoURL": null
    },
    "resolution": "Koko",
    "sharedDepartments": [],
    "closedTime": null,
    "approvalCount": "0",
    "isOverDue": true,
    "isTrashed": false,
    "createdTime": "2022-06-27T17:02:17.000Z",
    "id": "97709000000160077",
    "isResponseOverdue": false,
    "customerResponseTime": "2022-06-27T17:02:17.000Z",
    "productId": null,
    "contactId": "97709000000160029",
    "threadCount": "1",
    "secondaryContacts": [],
    "priority": null,
    "classification": null,
    "commentCount": "1",
    "taskCount": "0",
    "accountId": "97709000000160001",
    "phone": "1 888 900 9646",
    "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000160077",
    "isSpam": false,
    "status": "On Hold",
    "entitySkills": [],
    "ticketNumber": "101",
    "customFields": {},
    "isArchived": false,
    "description": "Hello<",
    "timeEntryCount": "0",
    "channelRelatedInfo": null,
    "responseDueDate": null,
    "isDeleted": false,
    "modifiedBy": "97709000000092001",
    "email": "support@zohosupport.com",
    "layoutDetails": {
        "id": "97709000000023011",
        "layoutName": "Siemplify"
    },
    "channelCode": null,
    "cf": {},
    "slaId": null,
    "layoutId": "97709000000023011",
    "assigneeId": null,
    "teamId": "97709000000182001",
    "attachmentCount": "0",
    "isEscalated": false,
    "category": null
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état 200 est renvoyé (is_success = true) : "Le ticket associé à l'ID {ticket id} a bien été mis à jour dans Zoho Desk.".

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Update Ticket". Reason: {0}''.format(error.Stacktrace)

Si l'agent est introuvable : "Error executing action "Update Ticket". Motif : l'agent {agent_name} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."'

Si l'équipe est introuvable : "Error executing action "Update Ticket". Motif : l'équipe {team_name} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si le service n'est pas trouvé : "Error executing action "Update Ticket". Motif : le service {department} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."'

Si le contact est introuvable : "Error executing action "Update Ticket". Motif : le contact {contact} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si le produit n'est pas trouvé : "Error executing action "Update Ticket". Motif : le produit {product} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si "Agent" ou "Équipe" est sélectionné, mais que le paramètre "Nom de la personne responsable" n'est pas fourni : "Erreur lors de l'exécution de l'action "Mettre à jour le ticket". Motif : vous devez indiquer le nom du cessionnaire.

Général

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.