Esta página se ha traducido con Cloud Translation API.

Zendesk

Versión de la integración: 8.0

Configurar Zendesk para que funcione con Google Security Operations

Un administrador genera un token de API. Para ello, debe seguir estos pasos:

Vaya a la barra lateral de la interfaz de Zendesk y haga clic en el icono Administrar. A continuación, seleccione Canales > API.

Haz clic en la pestaña Configuración y habilita Acceso con token.
Haz clic en el botón + situado a la derecha de Tokens de API activos.
También puedes introducir una descripción en Descripción del token de API.
Copia el token para usarlo más adelante y pégalo en un lugar seguro. El token completo no se volverá a mostrar después de cerrar la ventana.
Haga clic en Guardar para volver a la página de la API.

Configurar la integración de Zendesk en Google SecOps

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

Acciones

Añadir comentario a la entrada

Descripción

Añade un comentario a una incidencia.

Parámetros

Parámetro	Tipo	Valor predeterminado	Descripción
ID de incidencia	Cadena	N/A	Número de entrada.
Cuerpo del comentario	Cadena	N/A	N/A
Nombre del autor	Cadena	N/A	N/A
Internal Note	Booleano	N/A	N/A

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

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

N/A

Aplicar macros en una incidencia

Descripción

Aplica una macro a una incidencia.

Parámetros

Parámetro	Tipo	Valor predeterminado	Descripción
ID de incidencia	Cadena	N/A	Número de entrada.
Título de la macro	Cadena	N/A	N/A

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_applied	Verdadero/Falso	is_applied:False

Resultado de JSON

N/A

Crear incidencia

Descripción

Crea una incidencia con propiedades específicas.

Limitaciones conocidas

La API de Zendesk no admite correos con caracteres Unicode. Afecta al parámetro "Email CC". Action simplemente los ignorará

Parámetros

Parámetro	Tipo	Valor predeterminado	Descripción
Asunto	Cadena	N/A	N/A
Descripción	Cadena	N/A	N/A
Usuario asignado	Cadena	N/A	Nombre completo del usuario.
Grupo de asignación	Cadena	N/A	Nombre del grupo.
Prioridad	Cadena	N/A	La prioridad será una de las siguientes: urgente, alta, normal o baja.
Tipo de billete	Cadena	N/A	La prioridad será una de las siguientes: urgente, alta, normal o baja.
Etiqueta	Cadena	N/A	N/A
Internal Note	Casilla	Sin marcar	Especifica si el comentario debe ser público o interno. Si no está marcada, será pública. Si está marcada, será solo para uso interno.
Correos en copia	CSV	N/A	Especifica una lista de direcciones de correo separadas por comas que también deberían recibir la notificación de la creación de la incidencia. Nota: Se pueden añadir hasta 48 copias de correo. Esta es una limitación de Zendesk.
Validar CCs de correo electrónico	Booleano	Marcada	Si se habilita, la acción intentará comprobar que los usuarios cuyas direcciones de correo se hayan proporcionado en el parámetro "Email CCs" existen. Si al menos un usuario no existe, la acción fallará. Si este parámetro está inhabilitado, la acción no realizará esta comprobación.

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_id	N/A	N/A

Resultado de JSON

N/A

Panel de casos

Tipo de resultado	Valor/Descripción	Tipo
Mensaje de salida*	Si la opción "Validar CCs de correo" está habilitada y no se ha encontrado al menos un correo (error): error al ejecutar la acción "{action name}". Motivo: no se han encontrado los usuarios con las siguientes direcciones de correo: {entity.identifier}. Comprueba la ortografía o inhabilita el parámetro "Validate Email CCs". Si al menos una entrada no es una dirección de correo válida: Error al ejecutar la acción "{action name}". Motivo: no se han encontrado los usuarios con las siguientes direcciones de correo: {entity.identifier}. Comprueba la ortografía o inhabilita el parámetro "Validate Email CCs".	General

Tipo de resultado

Valor/Descripción

Tipo

Mensaje de salida*

Si la opción "Validar CCs de correo" está habilitada y no se ha encontrado al menos un correo (error): error al ejecutar la acción "{action name}". Motivo: no se han encontrado los usuarios con las siguientes direcciones de correo: {entity.identifier}. Comprueba la ortografía o inhabilita el parámetro "Validate Email CCs".

Si al menos una entrada no es una dirección de correo válida: Error al ejecutar la acción "{action name}". Motivo: no se han encontrado los usuarios con las siguientes direcciones de correo: {entity.identifier}. Comprueba la ortografía o inhabilita el parámetro "Validate Email CCs".

General

Get Ticket Details

Descripción

Obtiene los detalles, los comentarios y los archivos adjuntos de una incidencia a partir de su ID.

Parámetros

Parámetro	Tipo	Valor predeterminado	Descripción
ID de incidencia	Cadena	N/A	ID de la incidencia.

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_details	N/A	N/A

Resultado de JSON

{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

Ping

Descripción

Prueba de conectividad.

Parámetros

N/A

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_connected	Verdadero/Falso	is_connected:False

Resultado de JSON

N/A

Buscar entradas

Descripción

Buscar incidencias por palabra clave.

Parámetros

Parámetros	Tipo	Valor predeterminado	Descripción
Consulta de búsqueda	Cadena	N/A	Contenido de la consulta (por ejemplo, type:ticket status:pending).

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
results_count	N/A	N/A

Resultado de JSON

N/A

Actualizar entrada

Descripción

Actualizar los detalles de una incidencia

Parámetros

Parámetro	Tipo	Valor predeterminado	Descripción
ID de incidencia	Cadena	N/A	Número de entrada.
Asunto	Cadena	N/A	El asunto de la incidencia.
Usuario asignado	Cadena	N/A	Nombre completo del usuario.
Grupo de asignación	Cadena	N/A	Nombre del grupo.
Prioridad	Cadena	N/A	La prioridad será una de las siguientes: urgente, alta, normal o baja.
Tipo de billete	Cadena	N/A	El tipo de incidencia será uno de los siguientes: problema, incidente, pregunta o tarea.
Etiqueta	Cadena	N/A	Etiqueta que se va a añadir al ticket.
Estado	Cadena	N/A	El estado será uno de los siguientes: nuevo, abierto, pendiente, en espera, resuelto o cerrado.
Comentarios adicionales	Cadena	N/A	Si quieres añadir un comentario a la incidencia, especifica el texto que quieras añadir como comentario aquí.
Internal Note	Casilla	Sin marcar	Especifica si el comentario debe ser público o interno. Si no está marcada, será pública. Si está marcada, será solo para uso interno.

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_updated	Verdadero/Falso	is_updated:False

Resultado de JSON

N/A

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