Zoho Desk

Version de l'intégration : 4.0

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 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 le 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 pour 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 Ajouter un client, puis sélectionnez Client propre.
  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 Generate Code (Générer le code), indiquez les portées suivantes : 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 de la portée.
  5. Pour obtenir un code d'autorisation, cliquez sur Créer.
  6. Revenez à Google Security Operations, simulez un cas et accédez à l'action Get Refresh Token (Obtenir le 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

Effectuez une action de triage.

Actions

Ajouter un commentaire à une demande

Description

Ajoutez un commentaire à une demande dans Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut 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 Indiquez 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.

Date d'exécution

Cette action ne s'applique pas aux 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 signalé (is_success = true) : "Le commentaire "{text}" a bien été ajouté à la demande {ticket id} dans 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". Raison : {0}''.format(error.Stacktrace)

Si des erreurs sont signalées : "Erreur lors de l'exécution de l'action "Ajouter un commentaire au ticket". Motif : {errors/errorMessage}

Général

Créer une demande

Description

Créez une demande dans Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut 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 département Chaîne N/A Non Spécifiez le nom du service qui doit être défini pour la demande.
Contact Chaîne N/A Non Spécifiez l'adresse e-mail du contact pour la demande.
Type de personne responsable LDD

Sélectionnez une réponse

Valeurs possibles :

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

Spécifiez le type de responsable.

Si vous sélectionnez "Agent" ou "Équipe", le paramètre "Nom de l'attributaire" est obligatoire.

Nom de la personne désignée Chaîne N/A Non Spécifiez le nom de la personne à laquelle la demande est attribuée. 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.
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 pour la demande.
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

Indiquez la date limite du billet.

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.

Date d'exécution

Cette action ne s'applique pas aux 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 signalé (is_success=true) : "Un ticket portant 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, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Créer un ticket". Raison : {0}''.format(error.Stacktrace)

Si l'agent n'est pas trouvé : "Erreur lors de l'exécution de l'action "Créer un ticket". Motif : L'agent {agent_name} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si l'équipe est introuvable : "Erreur lors de l'exécution de l'action "Créer un 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 l'attributaire" n'est pas fourni : "Erreur lors de l'exécution de l'action "Créer un ticket". Motif : "Le nom du responsable doit être indiqué."

Si le service n'est pas trouvé : "Erreur lors de l'exécution de l'action "Créer un ticket". Motif : le service {department_name} est introuvable dans Zoho Desk."

Si le contact n'est pas trouvé : "Erreur lors de l'exécution de l'action "Créer un ticket". Motif : le contact {contact} n'a pas été trouvé dans Zoho Desk. Veuillez vérifier l'orthographe."

Si le produit n'est pas trouvé : "Erreur lors de l'exécution de l'action "Créer un 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 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.

Date d'exécution

Cette action ne s'applique pas aux 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 :

Si l'opération réussit : "Le jeton d'actualisation a bien été généré. 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, des identifiants incorrects, aucune connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Obtenir le jeton d'actualisation". Raison : {0}''.format(error.Stacktrace)

Si une erreur est signalée : "Erreur lors de l'exécution de l'action "Obtenir le jeton d'actualisation". Motif : {error}''

Général

Obtenir les détails d'une demande

Description

Obtenez des informations détaillées sur la demande depuis Zoho Desk.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
ID des demandes Chaîne N/A Oui Spécifiez une liste d'ID séparés par une virgule pour lesquels vous souhaitez renvoyer des détails.
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 associés aux demandes.
Nombre maximal de commentaires à renvoyer Integer 50 Non

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

Maximum : 100

Date d'exécution

Cette action ne s'applique pas aux 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) : "Les informations concernant les tickets suivants dans Zoho Desk ont été renvoyées : {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 les informations liées aux tickets suivants dans Zoho Desk : {ticket ids}".

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

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, une absence de connexion au serveur ou autre) : "Erreur lors de l'exécution de l'action "Obtenir les détails du ticket". Raison : {0}''.format(error.Stacktrace)

Général
Tableau du mur des cas

Nom de la table : "Détails du ticket" Colonnes de la table :

  • Numéro : ticketNumber
  • État : état Sujet : sujet
  • Heure de création : createdTime
  • Résolution : résolution
  • E-mail : email
  • Contact : {firstName} + {lastName}
Général

Marquer un ticket comme spam

Description

Marquez le ticket comme spam dans Zoho Desk.

Paramètres

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

Date d'exécution

Cette action ne s'applique pas aux 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 signalé (is_success = true) : "Le ticket a bien été marqué comme spam 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, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Marquer le ticket comme spam". Raison : {0}''.format(error.Stacktrace)

Si des erreurs sont signalées : "Erreur lors de l'exécution de l'action "Marquer la demande comme 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 l'onglet Google Security Operations Marketplace.

Paramètres

N/A

Date d'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 :

Si l'opération réussit (is_success=true) : "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 :

Si l'opération échoue (is_success= false) : "Échec de la connexion au serveur Zoho Desk. Error is {0}".format(exception.stacktrace)

Général

Modifier un billet

Description

Mettre à jour une demande dans Zoho Desk

Paramètres

Nom à afficher du paramètre Type Valeur par défaut 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.
Description Chaîne N/A Non Spécifiez la description de la demande.
Nom du département Chaîne N/A Non Spécifiez le nom du service qui doit être défini pour la demande.
Contact Chaîne N/A Non Spécifiez l'adresse e-mail du contact pour la demande.
Type de personne responsable LDD

Sélectionnez une réponse

Valeurs possibles :

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

Spécifiez le type de responsable.

Si vous sélectionnez "Agent" ou "Équipe", le paramètre "Nom de l'attributaire" est obligatoire.

Nom de la personne désignée Chaîne N/A Non Spécifiez le nom de la personne à laquelle la demande est attribuée. 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 de la demande.
É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 demande.
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 pour la demande.
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

Indiquez la date limite du billet.

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

Remarque : Ce paramètre n'a aucun impact 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.

Date d'exécution

Cette action ne s'applique pas aux 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 signalé (is_success = true) : "Le ticket avec l'ID {ticket id} a bien été modifié 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, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Mettre à jour le ticket". Raison : {0}''.format(error.Stacktrace)

Si l'agent n'est pas trouvé : "Erreur lors de l'exécution de l'action "Mettre à jour la demande". Motif : L'agent {agent_name} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si l'équipe est introuvable : "Erreur lors de l'exécution de l'action "Mettre à jour la demande". Motif : L'équipe {team_name} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si le service n'est pas trouvé : "Erreur lors de l'exécution de l'action "Mettre à jour la demande". Motif : le service {department} est introuvable dans Zoho Desk. Veuillez vérifier l'orthographe."

Si le contact n'est pas trouvé : "Erreur lors de l'exécution de l'action "Mettre à jour le ticket". Motif : le contact {contact} n'a pas été trouvé dans Zoho Desk. Veuillez vérifier l'orthographe."

Si le produit n'est pas trouvé : "Erreur lors de l'exécution de l'action "Mettre à jour la demande". 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 l'attributaire" n'est pas fourni : "Erreur lors de l'exécution de l'action "Mettre à jour la demande". Motif : "Le nom du responsable doit être indiqué."

Général

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