Zendesk

El conector de Zendesk te permite realizar operaciones de inserción, eliminación, actualización y lectura en la base de datos de Zendesk.

Versiones compatibles

Este conector admite las APIs de la versión 2 de Zendesk.

Antes de comenzar

Antes de usar el conector de Zendesk, realiza las siguientes tareas:

  • En tu proyecto de Google Cloud, haz lo siguiente:
    • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
    • Otorga el rol de IAM roles/connectors.admin al usuario que configure el conector.
    • Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

    • Habilita los siguientes servicios:
      • secretmanager.googleapis.com (API de Secret Manager)
      • connectors.googleapis.com (API de conectores)

      Para comprender cómo habilitar servicios, consulta Habilita servicios.

    Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

  • Si deseas usar tu dirección de correo electrónico y contraseña para acceder a la API de Zendesk, habilita password access en el centro de administración de Zendesk. Para obtener más información, consulta Autenticación básica.
  • Para obtener información sobre cómo crear una cuenta de Zendesk, consulta Cómo crear una cuenta de Zendesk.

Configura el conector

Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, sigue estos pasos:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Zendesk en la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de las conexiones no pueden superar los 49 caracteres.
      • En el caso de los conectores que admiten la suscripción a eventos, los nombres de las conexiones no pueden comenzar con el prefijo "goog".
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. Para usar la conexión para suscripciones a eventos, selecciona Habilitar la suscripción a eventos. Si lo haces, se mostrarán las siguientes opciones:
      • Habilitar la suscripción a eventos con entidad y acciones: Selecciona esta opción para usar la conexión en operaciones de suscripción a eventos y de conector (entidades y acciones).
      • Habilitar solo la suscripción a eventos: Selecciona esta opción para usar la conexión solo para la suscripción a eventos. Si seleccionas esta opción, haz clic en Siguiente y, luego, configura la suscripción al evento.
    8. De manera opcional, configura los parámetros de nodo de conexión:

      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    9. Usar proxy: selecciona esta casilla de verificación a fin de configurar un servidor proxy para la conexión y configurar los siguientes valores:
      • Esquema de autenticación del proxy: Selecciona el tipo de autenticación para autenticar con el servidor proxy. Se admiten los siguientes tipos de autenticación:
        • Básico: Autenticación HTTP básica.
        • Resumen: Autenticación de HTTP de resumen.
      • Usuario de proxy: Un nombre de usuario que se usará para autenticarse con el servidor proxy.
      • Contraseña de proxy: el secreto de Secret Manager de la contraseña del usuario.
      • Tipo de SSL del proxy: el tipo de SSL que se usará para conectarse al servidor del proxy. Se admiten los siguientes tipos de autenticación:
        • Automático: Configuración predeterminada. Si la URL es HTTPS, se usa la opción Túnel. Si la URL es una URL HTTP, se usa la opción NUNCA.
        • Siempre: La conexión siempre está habilitada para SSL.
        • Nunca: La conexión no está habilitada para SSL.
        • Túnel: La conexión se realiza a través de un proxy de túnel. El servidor proxy abre una conexión con el host remoto y el tráfico fluye de un lado a otro a través del proxy.
      • En la sección Proxy Server, ingresa los detalles del servidor proxy.
        1. Haz clic en Agregar destino.
        2. Selecciona un Tipo de destino.
          • Dirección del host: Especifica el nombre de host o la dirección IP del destino.

            Si deseas establecer una conexión privada a tu sistema de backend, haz lo siguiente:

    10. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
    11. Haga clic en SIGUIENTE.
  5. En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
    1. Tipo de destino: Selecciona un Tipo de destino.
      • Selecciona Dirección de host en la lista para especificar el nombre de host o la dirección IP del destino.
      • Si deseas establecer una conexión privada a tus sistemas de backend, selecciona Adjunto de extremo en la lista y, luego, selecciona el archivo adjunto de extremo requerido en la lista Adjunto de extremo.

      Si deseas establecer una conexión pública a tus sistemas de backend con seguridad adicional, puedes configurar direcciones IP salientes estáticas para tus conexiones y, luego, configurar tus reglas de firewall para incluir en la lista de entidades permitidas solo las direcciones IP estáticas específicas.

      Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.

    2. Haga clic en SIGUIENTE.
  6. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de Zendesk admite los siguientes tipos de autenticación:

      • Nombre de usuario y contraseña
      • Token de API
      • Código de autorización de OAuth 2.0

      2. Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

    2. Haz clic en SIGUIENTE.
  7. Si habilitaste la suscripción a eventos, aparecerá la sección Detalles de la suscripción a eventos en la página de creación de la conexión. Para comprender cómo configurar los detalles de la suscripción a eventos, consulta Cómo configurar la suscripción a eventos.
  8. Revisa: Revisa tus detalles de conexión y autenticación.
  9. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

  • Nombre de usuario y contraseña
    • Nombre de usuario: El nombre de usuario de Zendesk que se usará para la conexión.
    • Contraseña: El Secret de Secret Manager que contiene la contraseña asociada con el nombre de usuario de Zendesk.
  • Token de API
    • Usuario: La cuenta de usuario de Zendesk que se usa para la autenticación.
    • Token de API: Es el token de API del usuario autenticado.
    • Versión del Secret: Es la versión del Secret.
  • Código de autorización de OAuth 2.0
    • ID de cliente: el ID de cliente que proporciona el conector para la app que creaste.
    • Permisos: Es una lista de permisos deseados separados por comas.
    • Secreto de cliente: Secret de Secret Manager que contiene el secreto del cliente para la app conectada que creaste.
    • Versión del Secret: Es la versión del Secret.
    • URL de autorización: Es la URL de autorización que se genera cuando se crea un cliente en la instancia de Zendesk.

Configura la suscripción a eventos

Si habilitaste la suscripción al evento, ingresa los siguientes valores en la sección Detalles de la suscripción al evento:

  1. Selecciona un Tipo de destino.
    • Dirección de host: Ingresa la URL de registro de tu sistema de backend en el campo host.
  2. Ingresa los detalles de autenticación.
    1. Nombre de usuario: Ingresa el nombre de usuario.
    2. Contraseña: Selecciona el Secret de Secret Manager que contiene la contraseña asociada con el nombre de usuario.
    3. Versión del Secret: Selecciona la versión del Secret.
  3. De manera opcional, selecciona Habilitar el enriquecimiento de datos si deseas que se adjunte información adicional a la respuesta del sistema de backend.

    La información adicional es específica de la entidad para la que configuraste el evento. Para obtener más información, consulta Enriquecimiento de datos en notificaciones de eventos.

  4. Selecciona Habilitar conectividad privada para obtener una conectividad segura entre tu aplicación de backend y tu conexión. Si seleccionas esta opción, debes realizar pasos de configuración adicionales después de crear la conexión. Para obtener más información, consulta Conectividad privada para la suscripción a eventos.
  5. Ingresa la configuración de mensajes no entregados. Si configuras el buzón de mensajes no entregados, la conexión escribirá los eventos sin procesar en el tema de Pub/Sub especificado. Ingresa los siguientes detalles:
    1. ID del proyecto de buzón de destino: Es el ID del proyecto de Google Cloud en el que configuraste el tema de buzón de destino de Pub/Sub.
    2. Tema de mensajes no entregados: Es el tema de Pub/Sub en el que deseas escribir los detalles del evento no procesado.
  6. Si deseas usar un proxy para conectarte a tu backend (para la suscripción a eventos), ingresa los siguientes detalles:
    1. Tipo de SSL del proxy: el tipo de SSL que se usará para conectarse al servidor del proxy. Selecciona cualquiera de los siguientes tipos de autenticación:
      • Siempre: La conexión siempre está habilitada para SSL para la suscripción a eventos.
      • Nunca: La conexión no está habilitada para SSL para la suscripción a eventos.
    2. Esquema de autenticación del proxy: Selecciona el tipo de autenticación para autenticar con el servidor proxy. Se admiten los siguientes tipos de autenticación:
      • Básico: Autenticación HTTP básica.
    3. Usuario de proxy: Ingresa el nombre de usuario que se usará para autenticarse con el servidor proxy.
    4. Contraseña de proxy: Selecciona el secreto de Secret Manager de la contraseña del usuario.
    5. Versión del Secret: Selecciona la versión del Secret.
    6. En la sección Proxy Server, ingresa los detalles del servidor proxy.
      1. Haz clic en + Agregar destino y, luego, selecciona el Tipo de destino como Dirección de host.
      2. Ingresa el nombre de host o la dirección IP del servidor proxy, y el número de puerto del servidor proxy.

Muestras de configuración de conexión

Tipo de conexión de autenticación básica

Nombre del campo Detalles
Ubicación us-east4
Conector Zendesk
Versión del conector 1
Nombre de la conexión CONNECTION_NAME
Habilita Cloud Logging Sí
Cuenta de servicio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Host HOST_ADDRESS
UserPassword Sí
Nombre de usuario NOMBRE DE USUARIO
Contraseña CONTRASEÑA
Versión del Secret 1

Tipo de conexión del token de API

Nombre del campo Detalles
Ubicación europe-west1
Conector Zendesk
Versión del conector 1
Nombre de la conexión zendesk-apitoken
Habilita Cloud Logging Sí
Cuenta de servicio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Tipo de destino Dirección del host
Host1 https://yoursubdomain.zendesk.com
Autenticación Token de API
Usuario UserName
Token de API Token de API que proporciona tu app
Versión del Secret 1

OAuth 2.0: Tipo de conexión del código de autorización

Nombre del campo Detalles
Ubicación europe-west1
Conector Zendesk
Versión del conector 1
Nombre de la conexión zendesk-auth-code
Habilita Cloud Logging Sí
Cuenta de servicio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Tipo de destino Dirección del host
Host1 https://yoursubdomain.zendesk.com
Autenticación Código de autorización de OAuth 2.0
ID de cliente CLIENT_ID
Permisos Alcances obligatorios para tu caso de uso
Secreto del cliente CLIENT_SECRET
Versión del Secret 1
URL de autorización https://d3v2one1625553311.zendesk.com/oauth/authorizations/new

La conexión a Zendesk usa SSL de forma predeterminada, y no se necesita ninguna configuración adicional si usas la URL estándar de Zendesk, como https://tusubdominio.zendesk.com.

Entidades, operaciones y acciones

Todos los Integration Connectors proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se expone como entidades, operaciones y acciones.

  • Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

    Sin embargo, es posible que un conector no admita o tenga ninguna entidad, en cuyo caso la lista Entities estará vacía.

  • Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:

    Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, estas operaciones no compatibles no se incluyen en la lista Operations.

  • Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Por lo general, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Limitaciones del sistema

El conector de Zendesk puede procesar 5 transacciones por segundo por nodo y limita las transacciones que superen este límite. De forma predeterminada, los conectores de integración asignan 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Acciones

El conector de Zendesk proporciona acciones para administrar tus tickets según el ticket ID. Para comprender cómo configurar las acciones, consulta Ejemplos de acciones.

Ejemplos de acciones

En esta sección, se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: Cómo borrar un ticket

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción DeleteTicketsPermanently y haz clic en Listo.
  3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "Id": "18"
}

    4. En este ejemplo, se borra el ticket de forma permanente. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

    [{
  "Success": "true"
}]

Ejemplo: Cómo combinar tickets

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción MergeTickets y haz clic en Listo.
  3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "Id": "25",
  "Id": "26"
}

    4. En este ejemplo, se combinan los dos tickets. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

    [{
  "Success": null,
  "Message": null
}]

Ejemplo: Cómo restablecer un ticket

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción RestoreTicket y haz clic en Listo.
  3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "id": "20"
}

    4. En este ejemplo, se restablece un ticket. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

    [{
  "Success": "true"
}]

Ejemplo: Cómo recuperar un ticket suspendido

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción RecoverSuspendedTicket y haz clic en Listo.
  3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "id": "18726501985809"
}

    4. En este ejemplo, se recupera el ticket suspendido. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

    [{
  "Id": "60921"
}]

Ejemplos de operaciones de entidades

Ejemplo: Operación de lista en Tickets

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Tickets en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.

    4. Puedes realizar la operación List en las siguientes entidades:

    Archivos adjuntos, comentarios de tickets, formularios de tickets, campos de tickets, solicitudes, auditorías de tickets, métricas de tickets, tickets suspendidos, acuerdos de uso compartido, usuarios, UserIdentities, UserRelatedInformation, UserFields, OrganizationFields y JobStatus

Ejemplo: Operación Get en Tickets

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Tickets en la lista Entity.
  3. Selecciona la operación Get y haz clic enListo.
  4. Aquí, el entityId se establece en 34.0. Para establecer el entityId, en la sección Task Input de la tarea Connectors, haz clic en entityId y, luego, ingresa 34.0 en el campo Default Value.

    5. Puedes realizar la operación Get en las siguientes entidades:

    Formularios de tickets, campos de tickets, solicitudes, auditorías de tickets, tickets suspendidos, campos de usuario, UserIdentities y usuarios

Ejemplo: Operación de creación en Tickets

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Tickets en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Subject": "Zendesk_Create_Ticket",
    "RawSubject": "Zendesk_Create",
    "Description": "this ticket is related to application integration Create operation",
    "Type": "incident",
    "Priority": "urgent",
    "Status": "open",
    "Recipient": null,
    "HasIncidents": false,
    "DueAt": null,
    "RequesterId": 3.84625885158E11,
    "SubmitterId": 3.84625883418E11,
    "AssigneeId": 3.84625883418E11,
    "OrganizationId": "16665992392721",
    "GroupId": 3.60008282358E11,
    "TicketFormId": 3.60001719218E11,
    "BrandId": 3.60003285058E11,
    "Tags": null,
    "ViaChannel": "web",
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "CustomFields": null,
    "SatisfactionRating": null,
    "SharingAgreementIds": null,
    "AllowChannelback": false,
    "IsPublic": true,
    "Url": "https://altostrat.zendesk.com/api/v2/tickets/1.json"
  }

    Si la integración se realiza de forma correcta, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

     {
    "Id": 38.0
  }

Ejemplo: Operación de creación en TicketForms

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona TicketForms en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Name": "Altostrat_Zendesk1",
    "RawName": "Altostrat_Zendesk1",
    "DisplayName": "Altostrat_Issues1",
    "RawDisplayName": "Altostrat_Issues1",
    "Position": 2.0,
    "Active": true,
    "EndUserVisible": true,
    "Default": false,
    "InAllBrands": true,
    "RestrictedBrandIds": null,
    "FallbackToDefault": null,
    "AssociatedToBrand": null
  }

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea TicketForms tendrá un valor similar al siguiente:

    {
    "Id":1.8104712053393E13
  }

Ejemplo: Operación de creación en TicketFields

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona TicketFields en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Type": "text",
    "Title": "New field created",
    "RawTitle": null,
    "Description": "Please create the new field",
    "RawDescription": null,
    "Position": 2.0,
    "Active": true,
    "Required": false,
    "CollapsedForAgents": false,
    "RegexpForValidation": null,
    "VisibleInPortal": true,
    "EditableInPortal": true,
    "Tag": null,
    "CreatedAt": "2021-07-06 06:35:19.0",
    "UpdatedAt": "2021-07-06 06:35:19.0",
    "SystemFieldOptions": null,
    "CustomFieldOptions": null,
    "Removable": false
  }

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea TicketFields tendrá un valor similar al siguiente:

    {
    "Id": 1.7139061374865E13
  }

Ejemplo: Operación de creación en SharingAgreements

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona SharingAgreements en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Name": "altostrat.zendesk.com",
    "RemoteSubdomain": "altostrat"
  }

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea SharingAgreements tendrá un valor similar al siguiente:

    {
    "Id": 1.7142672288273E13
  }

Ejemplo: Operación de creación en Usuarios

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Users en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Email": "cloudysanfrancisco@gmail.com",
    "Name": "Altostrat Team"
  }

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea Users tendrá un valor similar al siguiente:

    {
    "Id": 1.7156912480273E13
  }

Ejemplo: Operación de creación en UserIdentities

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona UserIdentities en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "UserId": 3.84637722338E11,
    "Type": "email",
    "Value": "cloudysanfrancisco@gmail.com",
    "Verified": false,
    "Primary": true,
    "DeliverableState": "reserved_example",
    "Url": "https://d3valtostrat1625553311.zendesk.com/api/v2/users/384637722338/identities/368240277818.json"
  }

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea UserIdentities tendrá un valor similar al siguiente:

    {
    "Id": 1.6961185982353E13
  }

Ejemplo: Operación de creación en UserFields

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona UserFields en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Title": "Support description",
    "Type": "text",
    "Key": "support_description"
  }

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea UserFields tendrá un valor similar al siguiente:

    {
    "Id": 1.7157236761873E13
  }

Ejemplo: Operación de actualización en tickets

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Tickets en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Subject": "Google_Altostrat_Zendesk Update",
    "RawSubject": "Google_Altostrat_Zendesk Update",
    "Description": "this ticket is related to googlecloud application integration update check",
    "RequesterId": 1.6854335860497E13
  }
  5. Aquí, el entityId se establece en 35.0. Para establecer el entityId, haz clic en entityId y, luego, ingresa 35 en el campo Default Value.

    En lugar de especificar entityId, también puedes establecer filterClause en 35.

    Si la integración se realiza de forma correcta, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

    {
      Id": 35.0
  }

Ejemplo: Operación de actualización en TicketForms

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona TicketForms en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Name": "Ticketforms Updated",
    "DisplayName": "Altostrat_Issues1",
    "RawDisplayName": "Altostrat_Issues1"
  }
  5. Aquí, el entityId se establece en 1.7137314972689E13. Para establecer el entityId, haz clic en entityId y, luego, ingresa 1.7137314972689E13 en el campo Default Value.

    En lugar de especificar entityId, también puedes establecer filterClause en 1.7137314972689E13.

    Ejecutar este ejemplo muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
      Id": 1.7137314972689E13
  }

Ejemplo: Operación de actualización en TicketFields

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona TicketFields en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Description": "Updated description for testing"
  }
  5. Aquí, el entityId se establece en 3.60022990118E11. Para establecer el entityId, haz clic en entityId y, luego, ingresa 3.60022990118E11 en el campo Default Value.

    En lugar de especificar entityId, también puedes establecer filterClause en 3.60022990118E11.

    Ejecutar este ejemplo muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
      Id": 3.60022990118E11
  }

Ejemplo: Operación de actualización en Usuarios

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Users en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Name": "The Customer update",
    "Last Name": "Alex",
    "First Name": "Charlie"
  }
  5. Aquí, el entityId se establece en 3.84625885158E11. Para establecer el entityId, haz clic en entityId y, luego, ingresa 3.84625885158E11 en el campo Default Value.

    En lugar de especificar entityId, también puedes establecer filterClause en 3.84625885158E11.

    Ejecutar este ejemplo muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
      Id": 3.84625885158E11
  }

Ejemplo: Operación de actualización en UserFields

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona UserFields en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Title": "Support description updated",
    "Type": "text",
    "Key": "support_description"
  }
  5. Aquí, el entityId se establece en 1.7157236761873E13. Para establecer el entityId, haz clic en entityId y, luego, ingresa 1.7157236761873E13 en el campo Default Value.

    En lugar de especificar entityId, también puedes establecer filterClause en 1.7157236761873E13.

    Ejecutar este ejemplo muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
      Id": 1.7157236761873E13
  }

Ejemplo: Operación de actualización en UserIdentities

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona UserIdentities en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
    "Verified": true
  }
  5. En esta entidad, la operación de actualización se puede realizar con la cláusula de filtro y las claves primarias compuestas, por lo que no se requiere el entityId.

    6. En lugar de especificar entityId, también puedes establecer filterClause como UserId='384625885158' and Id='368234205078'.

    Si ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
    "Id": 3.68234205078E11
  }

Ejemplo: Operación de eliminación en Tickets

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Tickets en la lista Entity.
  3. Selecciona la operación Delete y haz clic en Listo.
  4. Aquí, el entityId se establece en 35.0. Para establecer el entityId, en la sección Task Input de la tarea Connectors, haz clic en entityId y, luego, ingresa 35 en el campo Default Value.

    5. Puedes realizar la operación Borrar en las siguientes entidades:

    Campos de tickets, tickets suspendidos, UserIdentities, campos de usuario y usuarios

Usa Terraform para crear conexiones

Puedes usar el recurso de Terraform para crear una conexión nueva.

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Para ver una plantilla de Terraform de ejemplo para la creación de conexiones, consulta la plantilla de ejemplo.

Cuando crees esta conexión con Terraform, debes establecer las siguientes variables en tu archivo de configuración de Terraform:

Nombre del parámetro Tipo de datos Obligatorio Descripción
proxy_enabled BOOLEAN Falso Selecciona esta casilla de verificación para configurar un servidor proxy para la conexión.
proxy_auth_scheme ENUM Falso Es el tipo de autenticación que se usará para autenticarse en el proxy de ProxyServer. Los valores admitidos son: BASIC, DIGEST, NONE
proxy_user STRING Falso Es un nombre de usuario que se usará para autenticarse en el proxy de ProxyServer.
proxy_password SECRET Falso Es una contraseña que se usará para autenticarse en el proxy de ProxyServer.
proxy_ssltype ENUM Falso Es el tipo de SSL que se usará para conectarse al proxy de ProxyServer. Los valores admitidos son: AUTO, ALWAYS, NEVER, TUNNEL

Usa la conexión de Zendesk en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en la integración de aplicaciones. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea Connectors en la integración de Apigee, consulta Tarea Connectors.
  • Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?