Consulte los conectores compatibles para la integración de aplicaciones.

Disparador de Zendesk

El disparador de Zendesk es un disparador de eventos de conector que le permite invocar una integración en función de los eventos de Zendesk a los que se ha suscrito en su conexión de Zendesk.

Antes de empezar

Si planea crear o configurar una nueva conexión para el disparador de Zendesk , asegúrese de tener el siguiente rol de IAM en el proyecto:

  • Administrador del conector ( roles/connectors.admin )
  • Para obtener información sobre cómo otorgar roles, consulte Administrar acceso .

Otorgue los siguientes roles de IAM a la cuenta de servicio que desea utilizar para el activador de Zendesk :

  • Invocador de integración de aplicaciones ( roles/integrations.integrationInvoker )
  • Para obtener información sobre cómo otorgar roles a una cuenta de servicio, consulte Administrar el acceso a cuentas de servicio .

Agregar el disparador de Zendesk

Para agregar un disparador de Zendesk a su integración, realice los siguientes pasos:

  1. En el Google Cloud consola, vaya a la página Integración de aplicaciones .

    Ir a Integración de aplicaciones

  2. En el menú de navegación, haga clic en Integraciones

    Aparece la página Lista de integraciones que enumera todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Seleccione una integración existente o haga clic en Crear integración para crear una nueva.

    Si está creando una nueva integración:

    1. Introduzca un nombre y una descripción en el panel Crear integración .
    2. Seleccione una región para la integración.
    3. Seleccione una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración" en la barra de herramientas de integración.
    4. Haga clic en Crear .

    La integración recién creada se abre en el editor de integraciones .

  4. En la barra de navegación del editor de integración , haga clic en Desencadenadores para ver la lista de desencadenadores disponibles.
  5. Haga clic y coloque el elemento disparador de Zendesk en el editor de integración.
  6. Para configurar el disparador de Zendesk , puede utilizar una conexión de Zendesk existente disponible en Conectores de integración o crear una nueva conexión de Zendesk utilizando la opción de creación de conexión en línea.

Configurar el disparador de Zendesk usando una conexión existente

Puede configurar el disparador de Zendesk usando una conexión de Zendesk existente en Conectores de Integración. Tenga en cuenta que el disparador de Zendesk es un disparador de evento del conector ; por lo tanto, solo puede usar una conexión de Zendesk con la suscripción a eventos habilitada para configurarlo.

Para obtener información sobre cómo configurar un disparador de Zendesk usando una nueva conexión de Zendesk, consulte Configurar un disparador de Zendesk usando una nueva conexión.

Para configurar un disparador de Zendesk utilizando una conexión de Zendesk existente, realice los siguientes pasos:

  1. Haga clic en el elemento disparador de Zendesk en el editor de integración para abrir el panel de configuración del disparador.
  2. Haga clic en Configurar disparador .
  3. Proporcione los siguientes detalles de configuración en la página Editor de activadores de eventos del conector :
    1. Región: seleccione la región de su conexión de Zendesk.
    2. Conexión: seleccione la conexión de Zendesk que desea utilizar.

      La integración de aplicaciones solo muestra aquellas conexiones de Zendesk que están activas y tienen una suscripción a eventos habilitada.

    3. Tipo de suscripción a eventos: Seleccione el tipo de suscripción a eventos que activa la integración. Para obtener información sobre los tipos de suscripción a eventos compatibles con este activador, consulte Tipos de suscripción a eventos compatibles .
    4. Cuenta de servicio : seleccione una cuenta de servicio con los roles de IAM necesarios para el disparador de Zendesk.
  4. Haga clic en Listo para completar la configuración del disparador y cerrar la página.

Configurar el disparador de Zendesk usando una nueva conexión

Para configurar el disparador de Zendesk mediante una nueva conexión de Zendesk, realice los siguientes pasos:

  1. Haga clic en el elemento disparador de Zendesk en el editor de integración para abrir el panel de configuración del disparador.
  2. Haga clic en Configurar disparador .
  3. Omitir el campo Región .
  4. Haga clic en Conexión y seleccione la opción Crear conexión en el menú desplegable.
  5. Complete los siguientes pasos en el panel Crear conexión :
    1. En el paso Ubicación , elija la ubicación para la nueva conexión de Zendesk:
      1. Región: seleccione una región de la lista desplegable.
      2. Haga clic en Siguiente .
    2. En el paso Detalles de conexión , proporcione detalles sobre la nueva conexión de Zendesk:
      1. Versión del conector: elija una versión disponible del conector Zendesk en la lista desplegable.
      2. Nombre de la conexión: ingrese un nombre para la conexión de Zendesk.
      3. (Opcional) Descripción: Ingrese una descripción para la conexión.
      4. (Opcional) Habilitar registro en la nube: seleccione esta casilla de verificación para almacenar todos los datos de registro de la conexión.
      5. Cuenta de servicio : seleccione una cuenta de servicio con los roles de IAM necesarios para la conexión de Zendesk.
      6. Habilitar suscripción a eventos: Seleccione esta opción para crear y habilitar una nueva suscripción a eventos para la conexión de Zendesk. Puede habilitar solo suscripciones a eventos o también incluir entidades, operaciones y acciones de conexión.
      7. (Opcional) Expanda Configuración avanzada para configurar los ajustes del nodo de conexión.

        Para obtener más información sobre la configuración del nodo de conexión para Zendesk, consulte la documentación de conexión de Zendesk .

      8. (Opcional) Haga clic en + Agregar etiqueta para agregar una etiqueta a la conexión en forma de par clave-valor.
      9. Haga clic en Siguiente .
    3. En el paso Destinos , proporcione los detalles de la instancia de Zendesk:
      1. Tipo de destino: seleccione la dirección de host .
      2. Host: ingrese el nombre de host o la dirección IP de su instancia de Zendesk.
      3. Haga clic en Siguiente .
    4. En el paso de Autenticación , proporcione los detalles de autenticación para la instancia de Zendesk:
      1. Seleccione el tipo de autenticación que desee e ingrese los detalles relevantes para acceder a la URL del host de Zendesk proporcionada.

        Para comprender cómo configurar estos tipos de autenticación, consulte Configurar la autenticación .

      2. Haga clic en Siguiente .
    5. En el paso Detalles de suscripción de eventos , proporcione detalles de la instancia de Zendesk donde se crearán las suscripciones de eventos.
      1. Tipo de destino: seleccione la dirección de host .
      2. Host: Ingrese la URL de registro de su instancia de Zendesk. Se crearán suscripciones a eventos para esta URL.
      3. Nombre de usuario: Ingrese el nombre de usuario para acceder a la URL de registro proporcionada.
      4. Contraseña: seleccione el secreto del Administrador de secretos que contiene la contraseña asociada al nombre de usuario.
      5. Versión secreta: seleccione una versión secreta.
      6. Habilitar enriquecimiento de datos: Seleccione esta casilla si desea que el disparador de Zendesk recupere la carga útil completa del evento de la instancia de Zendesk. Consulte la sección "Salida del disparador" para ver ejemplos.
      7. Haga clic en Siguiente .
    6. Revisar : revise los detalles de conexión de Zendesk proporcionados.
    7. Haga clic en Crear para completar la creación de una nueva conexión de Zendesk.
  6. Tipo de suscripción a eventos: Seleccione el tipo de suscripción a eventos que activa la integración. Para obtener información sobre los tipos de suscripción a eventos compatibles con este activador, consulte Tipos de suscripción a eventos compatibles .
  7. Haga clic en Listo y cierre la página.

Salida del disparador

El disparador de Zendesk tarda un par de minutos en completar la configuración de la suscripción a eventos. Puede ver el estado de su suscripción a eventos en el panel de configuración del disparador, en "Detalles de la suscripción a eventos" .

El disparador de Zendesk indica el estado de una suscripción a un evento mediante los siguientes estados:

  • Creating : Indica que el disparador se está suscribiendo a la suscripción de eventos.
  • Active : indica que el disparador se suscribió correctamente a una suscripción de evento.
  • Error : Indica que hay un problema con la suscripción al evento configurada.

Además del estado de suscripción al evento, la sección Detalles de suscripción al evento también muestra otros detalles como la región de conexión, el nombre de la conexión, el nombre de la suscripción al evento y más.

La siguiente imagen muestra un ejemplo de diseño del panel de configuración de activadores de Zendesk:

imagen que muestra el panel de configuración de activadores de Zendeskimagen que muestra el panel de configuración de activadores de Zendesk

Variable de salida del disparador

Para cada evento, el disparador de Zendesk genera una variable de salida ConnectorEventPayload que puede usar en sus tareas posteriores. Esta variable de salida está en formato JSON y contiene el esquema de carga útil de salida de Zendesk.

Ejemplo 1: Carga útil de salida para el evento de Zendesk: Asignación de agente modificada

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

Ejemplo 2: Carga útil de salida enriquecida con datos para el evento de Zendesk: Asignación de agente modificada

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

Ver suscripciones a eventos

Para ver y administrar todas las suscripciones a eventos asociadas con una conexión en Conectores de integración, haga lo siguiente:

  1. Vaya a la página Conectores de integración > Conexiones .

    Ir a la página de Conexiones

  2. Haga clic en la conexión cuyas suscripciones desea ver.
  3. Haga clic en la pestaña Suscripciones a eventos .

    Aquí se muestran todas las suscripciones a eventos para la conexión.

Editar el disparador de Zendesk

Puede editar un disparador de Zendesk para cambiar o actualizar la configuración de la conexión y los detalles de suscripción a eventos.

Para editar un disparador de Zendesk, realice los siguientes pasos:

  1. Haga clic en el elemento disparador de Zendesk en el editor de integración para abrir el panel de configuración del disparador.
  2. Haga clic en Configurar disparador de Zendesk .
  3. Haga lo siguiente en la página Editor de activadores de eventos del conector :
    1. Para conservar la suscripción al evento configurada previamente, haga clic en Conservar ; de lo contrario, haga clic en Eliminar .
    2. Actualice la configuración de la conexión y los detalles de suscripción a eventos según lo desee.
    3. Haga clic en Listo .
  4. Puede ver los detalles actualizados de la conexión y la suscripción a eventos en el panel de configuración del disparador en Detalles de suscripción a eventos .

Tipos de suscripción a eventos admitidos

Puede utilizar el disparador de Zendesk para invocar una integración para los siguientes tipos de suscripción de eventos:

Tipos de suscripción a eventos Descripción
organization.ExternalChanged Se cambió el ID externo de una organización.
organization.OrganizationCreated Se crea una organización.
organization.TagsChanged Se cambiaron las etiquetas de una organización.
ticket.AgentAssignmentChanged Un ticket se reasigna a otro agente de soporte.
ticket.AttachmentLinkedToComment Un archivo adjunto está vinculado a un comentario de ticket en soporte.
ticket.AttachmentRedactedFromComment Se redacta un archivo adjunto a partir de un comentario existente en un ticket.
ticket.BrandChanged La marca ha cambiado. Una marca es una identidad de cara al cliente que puede representarse mediante múltiples productos o servicios, o mediante múltiples marcas propiedad de la empresa.
ticket.CcsChanged Se agregaron o eliminaron usuarios de un ticket.
ticket.CommentAdded Se agrega un comentario cuando se crea o actualiza un ticket de soporte.
ticket.CommentMadePrivate Se agrega un comentario privado en un ticket de soporte.
ticket.CommentRedacted Se eliminaron permanentemente palabras o cadenas de un comentario de un ticket.
ticket.DescriptionChanged La descripción se cambia en un ticket.
ticket.ExternalIdChanged Se cambia el ID del ticket externo.
ticket.FollowersChanged Los seguidores fueron cambiados en un ticket.
ticket.GroupAssignmentChanged Un ticket se reasigna a otro grupo de agentes.
ticket.MarkedAsSpam Un ticket está marcado como spam.
ticket.OrganizationChanged La organización se modifica en el ticket.
ticket.PriorityChanged Se cambia la prioridad de un ticket.
ticket.ProblemLinkChanged Se cambia el ID del problema asociado con un ticket de tipo incidente.
ticket.RequesterChanged Se cambia el solicitante de un ticket.
ticket.StatusChanged Se cambia el estado de un ticket.
ticket.SubjectChanged Se cambia el asunto de un ticket.
ticket.SubmitterChanged Se cambia el remitente de un ticket.
ticket.TagsChanged Se cambiaron las etiquetas en un ticket.
ticket.TaskDueAtChanged Se modifica la fecha y hora de vencimiento de la tarea en un ticket.
ticket.TicketCreated Se crea un ticket de soporte.
ticket.TicketFormChanged Se cambia el formato en el ticket.
ticket.TicketMerged Un ticket se fusiona con otro ticket.
ticket.TicketPermanentlyDeleted Un ticket se elimina de forma permanente.
ticket.TicketSoftDeleted Se elimina un ticket de tal manera que no es visible para ningún usuario, incluidos los administradores que utilizan la interfaz del producto o la API.
ticket.TicketTypeChanged Se cambia un tipo de ticket.
ticket.TicketUndeleted Un ticket no se ha eliminado.
user.CustomRoleChanged Se cambió el rol personalizado de un usuario.
user.ExternalidChanged Se cambió la identificación externa de un usuario.
user.LastLoginChanged La hora del último inicio de sesión de un usuario cambió.
user.OnlyPrivateCommentsChanged Se modificó la capacidad de los usuarios para crear comentarios públicos.
user.TageChanged Las etiquetas de un usuario cambiaron.
userTimeZoneChanged La zona horaria de un usuario cambió.
user.UserAliasChanged Se cambió el alias de un usuario.
user.UserCreated Se crea un usuario.
user.UserDetailsChanged Los detalles de un usuario cambiaron.
user.UserGroupAdded Se agrega un usuario a un grupo.
user.UserGroupRemoved Se elimina un usuario de un grupo.
user.UserIdentityChanged La identidad de un usuario cambió.
user.UserIdentityCreated Se crea la identidad de un usuario.
user.UserIdentityRemoved Se elimina la identidad de un usuario.
user.UserActiveChanged El estado activo de un usuario cambió.
user.UserMerged Un usuario se fusiona con otro usuario.
user.UserNameChanged Se cambió el nombre de un usuario.
user.UserNotesChanged Se cambiaron las notas de un usuario.
user.UserOrganizationAdded Se agrega un usuario a una organización.
user.UserOrganizationRemoved Se elimina un usuario de una organización.
user.UserPhotoChanged Se cambió la foto de un usuario.
user.UserRoleChanged El rol de un usuario cambió.

Cuotas y límites

Para obtener información sobre cuotas y límites, consulte Cuotas y límites .

¿Qué sigue?