Se usó la API de Cloud Translation para traducir esta página.

Zendesk

Versión de integración: 8.0

Configura Zendesk para que funcione con Google Security Operations

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

Navega a la barra lateral de la interfaz de Zendesk y haz clic en el ícono de Administrador. Luego, selecciona Canales > API.

Haz clic en la pestaña Configuración y habilita el acceso con token.
Haz clic en el botón + a la derecha de Tokens de API activos.
De manera opcional, ingresa una descripción en API Token Description.
Copia el token para usarlo más adelante y pégalo en un lugar seguro. El token completo nunca se volverá a mostrar después de que se cierre la ventana.
Haz clic en Guardar para volver a la página de la API.

Configura la integración de Zendesk en Google SecOps

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.

Acciones

Agregar comentario al ticket

Descripción

Agregar un comentario a un ticket existente

Parámetros

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

Casos de uso

N/A

Ejecutar en

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

Aplica macros en el ticket

Descripción

Aplicar una macro a un ticket

Parámetros

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

Casos de uso

N/A

Ejecutar en

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 ticket

Descripción

Crea un ticket con propiedades específicas.

Limitaciones conocidas

La API de Zendesk no admite correos electrónicos con caracteres Unicode. Afecta el parámetro "Email CC". La acción simplemente los ignorará

Parámetros

Parámetro	Tipo	Valor predeterminado	Descripción
Asunto	String	N/A	N/A
Descripción	String	N/A	N/A
Usuario asignado	String	N/A	Nombre completo del usuario.
Grupo de asignación	String	N/A	Nombre del grupo.
Prioridad	String	N/A	La prioridad será una de las siguientes: urgente, alta, normal o baja.
Tipo de entrada	String	N/A	La prioridad será una de las siguientes: urgente, alta, normal o baja.
Etiqueta	String	N/A	N/A
Internal Note	Casilla de verificación	Sin marcar	Especifica si el comentario debe ser público o interno. Si no está marcada, significa que será pública; si está marcada, significa que será solo para uso interno.
Cc de correos electrónicos	CSV	N/A	Especifica una lista de direcciones de correo electrónico separadas por comas que también deben recibir la notificación de la creación del ticket. Nota: Se pueden agregar hasta 48 direcciones de correo electrónico en CC. Esta es una limitación de Zendesk.
Validar los CC de correos electrónicos	Booleano	Marcado	Si se habilita, la acción intentará verificar que existan los usuarios con los correos electrónicos proporcionados en el parámetro "CC de correo electrónico". Si no existe al menos un usuario, la acción fallará. Si este parámetro está inhabilitado, la acción no realizará esta verificación.

Casos de uso

N/A

Ejecutar en

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

Muro de casos

Tipo de resultado	Valor/Descripción	Tipo
Mensaje de salida*	Si la opción "Validate Email CCs" está habilitada y no se encontró al menos un correo electrónico (falla): Se produjo un error al ejecutar la acción "{action name}". Motivo: No se encontraron usuarios con las siguientes direcciones de correo electrónico: {entity.identifier}. Verifica la ortografía o inhabilita el parámetro "Validate Email CCs". Si al menos una entrada no es una dirección de correo electrónico válida: Error al ejecutar la acción "{action name}". Motivo: No se encontraron usuarios con las siguientes direcciones de correo electrónico: {entity.identifier}. Verifica 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 "Validate Email CCs" está habilitada y no se encontró al menos un correo electrónico (falla): Se produjo un error al ejecutar la acción "{action name}". Motivo: No se encontraron usuarios con las siguientes direcciones de correo electrónico: {entity.identifier}. Verifica la ortografía o inhabilita el parámetro "Validate Email CCs".

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

General

Obtén detalles del ticket

Descripción

Obtén los detalles, los comentarios y los archivos adjuntos de un ticket por su ID.

Parámetros

Parámetro	Tipo	Valor predeterminado	Descripción
ID del ticket	String	N/A	Es el ID del ticket.

Casos de uso

N/A

Ejecutar en

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 la conectividad.

Parámetros

N/A

Casos de uso

N/A

Ejecutar en

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 boletos

Descripción

Buscar tickets por palabra clave

Parámetros

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

Casos de uso

N/A

Ejecutar en

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

Actualiza los detalles de un ticket existente

Parámetros

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

Casos de uso

N/A

Ejecutar en

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? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.