Zoho Desk

Versión de integración: 4.0

Configurar la integración de Zoho Desk en Google Security Operations

Para obtener instrucciones detalladas sobre cómo configurar una integración en Google SecOps, consulta Configurar integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API Cadena https://desk.zoho.{region} Sí Raíz de la API de la instancia de Zoho Desk.
ID de cliente Cadena N/A Sí ID de cliente de la cuenta de Zoho Desk.
Secreto de cliente Contraseña N/A Sí Secreto de cliente de la cuenta de Zoho Desk.
Token de actualización Contraseña N/A No Token de actualización de la cuenta de Zoho Desk. Para generarlo, debes ejecutar la acción "Get Refresh Token" (Obtener token de actualización).
Verificar SSL Casilla Marcada Sí Si está habilitada, verifica que el certificado SSL de la conexión al servidor de Zoho Desk sea válido.

Obtener credenciales de API

  1. Ve a la consola de la API de Zoho Desk.
  2. Haz clic en Añadir cliente y selecciona Cliente propio.
  3. En la pestaña Secreto de cliente, copie el valor de los parámetros "ID de cliente" y "Secreto de cliente" y péguelo en los campos correspondientes de la ventana de configuración de la integración.
  4. En la pestaña Generar código, proporciona los siguientes permisos: Desk.tickets.READ,Desk.tickets.CREATE,Desk.tickets.UPDATE,Desk.tickets.DELETE,Desk.settings.READ,Desk.basic.READ,Desk.products.READ,Desk.contacts.READ y añade una descripción del permiso.
  5. Para obtener un código de autorización, haz clic en Crear.
  6. Vuelve a Google Security Operations, simula un caso y ve a la acción Obtener token de actualización en la integración de Zoho Desk.
  7. Para configurar la acción, introduce tu código de autorización y el enlace de autorización.
  8. Copia el token del resultado JSON de la acción, pégalo en el campo correspondiente de la ventana de configuración de la integración y haz una prueba.

Casos prácticos

Realiza la acción de triaje.

Acciones

Add Comment To Ticket

Descripción

Añade un comentario a una incidencia en Zoho Desk.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de incidencia Cadena N/A Sí Especifica el ID de la incidencia a la que quieres añadir un comentario.
Visibilidad DDL

Público

Valores posibles:

  • Público
  • Privado
 No Especifica si el comentario debe ser público o privado.
Tipo Cadena

Texto sin formato

Valores posibles:

  • Texto sin formato
  • HTML
 No Especifica el tipo de comentario.
Texto Cadena N/A No Especifica el contenido del comentario.
Esperar respuesta Casilla Desmarcada No Si se habilita, la acción espera una respuesta.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de 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
}
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se devuelve el código de estado 200 (is_success = true): "Se ha añadido el comentario "{text}" a la incidencia {ticket id} en Zoho Desk."

Mensaje asíncrono: "Esperando una respuesta..."

La acción debería fallar y detener la ejecución de la guía:

Si se informa de un error crítico: "Error al ejecutar la acción "Añadir comentario a la incidencia". Motivo: {0}''.format(error.Stacktrace)

Si se informa de errores: "Error al ejecutar la acción "Añadir comentario a la incidencia". Motivo: {errors/errorMessage}

 General

Crear incidencia

Descripción

Crea una incidencia en Zoho Desk.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Título Cadena N/A No Especifica el título de la incidencia.
Descripción Cadena N/A No Especifica la descripción del ticket.
Nombre del departamento Cadena N/A No Especifica el nombre del departamento que se debe asignar a la incidencia.
Contacto Cadena N/A No Especifica el correo del contacto del ticket.
Tipo de usuario asignado DDL

Selecciona una opción.

Posibles valores:

  • Selecciona una opción.
  • Agente
  • Equipo
 No

Especifica el tipo de usuario asignado.

Si se selecciona "Agente" o "Equipo", es obligatorio indicar el parámetro "Nombre del asignado".
Nombre del usuario asignado Cadena N/A No Especifica el nombre del asignatario de la incidencia. En el tipo de agente, puedes proporcionar una dirección de correo o un nombre visible.
Prioridad DDL

Selecciona una opción.

Valores posibles:

  • Selecciona una opción.
  • Sin prioridad
  • Bajo
  • Medio
  • Alta
 No Especifica la prioridad de la incidencia.
Clasificación DDL

Selecciona una opción.

Valores posibles:

  • Selecciona una opción.
  • Sin clasificación
  • Pregunta
  • Problema
  • Función
  • Otras
 No Especifica el tipo de clasificación del ticket.
Canal DDL

Selecciona una opción.

Valores posibles:

  • Selecciona una opción.
  • Correo electrónico
  • Teléfono
  • Web
  • Twitter
  • Facebook
  • Chat
  • Foros
 No Especifica el canal de la incidencia.
Categoría Cadena N/A No Especifica la categoría del ticket.
Subcategoría Cadena N/A No Especifica la subcategoría del ticket.
Fecha de finalización Cadena N/A No

Especifica la fecha de vencimiento del ticket.

Formato: ISO 8601. Ejemplo: 2022-07-06T07:05:43Z.

Campos personalizados JSON N/A No

Especifica un objeto JSON que contenga los campos personalizados que se deban actualizar.

Nota: Debe proporcionar los nombres de API de las claves.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de 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
}
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se devuelve el código de estado 200 (is_success=true): "Se ha creado correctamente una incidencia con el ID {ticket id} en Zoho Desk".

La acción debería fallar y detener la ejecución de la guía:

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Crear incidencia". Motivo: {0}''.format(error.Stacktrace)

Si no se encuentra el agente: "Error al ejecutar la acción "Crear incidencia". Motivo: no se ha encontrado el agente {agent_name} en Zoho Desk. Comprueba la ortografía".

Si no se encuentra el equipo: "Error al ejecutar la acción "Crear incidencia". Motivo: no se ha encontrado el equipo {team_name} en Zoho Desk. Comprueba la ortografía".

Si se selecciona "Agente" o "Equipo", pero no se proporciona el parámetro "Nombre del asignatario": "Error al ejecutar la acción "Crear incidencia". Motivo: "Assignee Name" needs to be provided." ("Se debe proporcionar el nombre del asignatario").

Si no se encuentra el departamento: "Error al ejecutar la acción "Crear incidencia". Motivo: no se ha encontrado el departamento {department_name} en Zoho Desk."

Si no se encuentra el contacto: "Error al ejecutar la acción "Crear incidencia". Motivo: no se ha encontrado el contacto {contact} en Zoho Desk. Comprueba la ortografía".

Si no se encuentra el producto: "Error al ejecutar la acción "Crear incidencia". Motivo: no se ha encontrado el producto {product} en Zoho Desk. Comprueba la ortografía".

 General

Obtener token de actualización

Descripción

Obtener un token de actualización para la configuración.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Enlace de autorización Cadena https://accounts.zoho.{region} Sí Especifica el enlace de autorización de la integración.
Código de autorización Contraseña N/A Sí Especifica el código de autorización que se ha generado en la consola de desarrollo de Zoho.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de JSON
{
    "refresh_token": "1000.90567b1fc0c54f540e56200ae4388cef.a8f6b313297d558774bee07d60cc6863"
}
Panel de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si la acción se realiza correctamente: "Se ha generado correctamente el token de actualización. Copia el valor en el parámetro "Refresh Token" de la configuración de la integración.

The action should fail and stop a playbook execution:

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Obtener token de actualización". Motivo: {0}''.format(error.Stacktrace)

Si se informa de un error: "Error al ejecutar la acción "Obtener token de actualización". Motivo: {error}''

 General

Get Ticket Details

Descripción

Obtén información detallada sobre la incidencia en Zoho Desk.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
IDs de incidencia Cadena N/A Sí Especifica una lista de IDs separados por comas de los que quieras obtener información.
Crear estadística Casilla Desmarcada No Si se habilita, la acción crea una estadística que contiene información sobre las incidencias.
Campos adicionales que se van a devolver CSV contacts, products, assignee, departments, contract, isRead, team, skills No

Especifica los campos adicionales que se van a devolver.

Valores posibles: contacts, products, assignee, departments, contract, isRead, team, skills.
Obtener comentarios Casilla Marcada No Si está habilitada, la acción obtiene los comentarios relacionados con las incidencias.
Número máximo de comentarios que se devolverán Entero 50 No

Especifica el número de comentarios que se deben devolver por incidencia.

Máximo: 100

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de 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
        }

}
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles para al menos un ID (is_success = true): "Successfully returned details related to the following tickets in Zoho Desk: {ticket ids}" ("Se han devuelto correctamente los detalles relacionados con las siguientes incidencias en Zoho Desk: {ticket ids}").

Si no hay datos disponibles para al menos un ID (is_success=true): "No se han podido encontrar detalles relacionados con las siguientes incidencias en Zoho Desk: {ticket ids}".

Si no hay datos disponibles para todos los IDs (is_success=false): "No se han encontrado entradas".

La acción debería fallar y detener la ejecución de la guía:

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Get Ticket Details". Motivo: {0}''.format(error.Stacktrace)

 General
Tabla del panel de casos

Nombre de la tabla: Detalles de la entrada Columnas de la tabla:

  • Número: ticketNumber
  • Estado: status Asunto: subject
  • Hora de creación: createdTime
  • Resolución: resolución
  • Correo: email
  • Contacto: {firstName} + {lastName}
 General

Marcar la incidencia como spam

Descripción

Marcar una incidencia como spam en Zoho Desk.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de incidencia Cadena N/A Sí Especifica el ID de la incidencia que debe marcarse como spam.
Marcar contacto Casilla Marcada No Si está habilitada, el contacto que ha creado la incidencia se marca como spammer.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se devuelve el código de estado 200 (is_success = true): "Se ha marcado correctamente un ticket como spam en Zoho Desk.

La acción debería fallar y detener la ejecución de la guía:

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Marcar ticket como spam". Motivo: {0}''.format(error.Stacktrace)

Si se informa de errores: "Error al ejecutar la acción "Marcar ticket como spam". Motivo: {errors/errorMessage}

 General

Ping

Descripción

Prueba la conectividad con Zoho Desk con los parámetros proporcionados en la página de configuración de la integración, en la pestaña Google Security Operations Marketplace.

Parámetros

N/A

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida\*

La acción no debe fallar ni detener la ejecución de una guía:

Si la conexión se ha realizado correctamente (is_success=true): "Successfully connected to the Zoho Desk server with the provided connection parameters!" ("Se ha conectado correctamente al servidor de Zoho Desk con los parámetros de conexión proporcionados").

La acción debería fallar y detener la ejecución de la guía:

Si no se ha completado correctamente (is_success= false): "No se ha podido conectar con el servidor de Zoho Desk. Error: {0}".format(exception.stacktrace)

 General

Actualizar entrada

Descripción

Actualiza una incidencia en Zoho Desk.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de incidencia Cadena N/A Sí Especifica el ID del ticket que se debe actualizar.
Título Cadena N/A No Especifica el título que se debe asignar a la incidencia.
Descripción Cadena N/A No Especifica la descripción del billete.
Nombre del departamento Cadena N/A No Especifica el nombre del departamento que se debe asignar a la incidencia.
Contacto Cadena N/A No Especifica el correo del contacto del ticket.
Tipo de usuario asignado DDL

Selecciona una opción.

Posibles valores:

  • Selecciona una opción.
  • Agente
  • Equipo
 No

Especifica el tipo de usuario asignado.

Si se selecciona "Agente" o "Equipo", es obligatorio indicar el parámetro "Nombre del asignado".
Nombre del usuario asignado Cadena N/A No Especifica el nombre del asignatario de la incidencia. En el tipo de agente, puedes proporcionar una dirección de correo o un nombre visible.
Resolución Cadena N/A No Especifica la resolución de la incidencia.
Prioridad DDL

Selecciona una opción.

Valores posibles:

  • Selecciona una opción.
  • Sin prioridad
  • Bajo
  • Medio
  • Alta
 No Especifica la prioridad de la incidencia.
Estado DDL

Selecciona una opción.

Valores posibles:

  • Selecciona una opción.
  • Abrir
  • En espera
  • Derivado
  • Cerrado
 No Especifica el estado del ticket.
Estado de la marca DDL

Selecciona una opción.

Posibles valores:

  • Selecciona una opción.
  • Leer
  • No leído
 No Especifica el estado de la marca del ticket.
Clasificación DDL

Selecciona una opción.

Valores posibles:

  • Selecciona una opción.
  • Sin clasificación
  • Pregunta
  • Problema
  • Función
  • Otras
 No Especifica el tipo de clasificación del ticket.
Canal DDL

Selecciona una opción.

Valores posibles:

  • Selecciona una opción.
  • Correo electrónico
  • Teléfono
  • Web
  • Twitter
  • Facebook
  • Chat
  • Foros
 No Especifica el canal de la incidencia.
Categoría Cadena N/A No Especifica la categoría del ticket.
Subcategoría Cadena N/A No Especifica la subcategoría del ticket.
Fecha de finalización Cadena N/A No

Especifica la fecha de vencimiento del ticket.

Formato: ISO 8601. Ejemplo: 2022-07-06T07:05:43Z.

Nota: Este parámetro no tiene ningún efecto cuando se define el estado "En espera".
Campos personalizados JSON N/A No

Especifica un objeto JSON que contenga los campos personalizados que se deban actualizar.

Nota: Debe proporcionar los nombres de API de las claves.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de 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
}
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se devuelve el código de estado 200 (is_success = true): "Successfully updated ticket with ID {ticket id} in Zoho Desk." ("Se ha actualizado correctamente la incidencia con el ID {ticket id} en Zoho Desk").

La acción debería fallar y detener la ejecución de la guía:

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Actualizar incidencia". Motivo: {0}''.format(error.Stacktrace)

Si no se encuentra el agente: "Error al ejecutar la acción "Update Ticket". Motivo: no se ha encontrado el agente {agent_name} en Zoho Desk. Comprueba la ortografía".

Si no se encuentra el equipo: "Error al ejecutar la acción "Update Ticket". Motivo: no se ha encontrado el equipo {team_name} en Zoho Desk. Comprueba la ortografía".

Si no se encuentra el departamento: "Error al ejecutar la acción "Update Ticket". Motivo: no se ha encontrado el departamento {department} en Zoho Desk. Comprueba la ortografía".

Si no se encuentra el contacto: "Error al ejecutar la acción "Update Ticket". Motivo: no se ha encontrado el contacto {contact} en Zoho Desk. Comprueba la ortografía".

Si no se encuentra el producto: "Error al ejecutar la acción "Update Ticket". Motivo: no se ha encontrado el producto {product} en Zoho Desk. Comprueba la ortografía".

Si se selecciona "Agente" o "Equipo", pero no se proporciona el parámetro "Nombre del asignatario": "Error al ejecutar la acción "Actualizar incidencia". Motivo: "Assignee Name" needs to be provided." ("Se debe proporcionar el nombre del asignatario").

 General

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.