Suscripciones a eventos

Además de permitirte realizar operaciones de lectura y escritura en tu backend, Integration Connectors también te permite suscribirte a eventos que se producen en tus aplicaciones de backend. Por ejemplo, supongamos que quieres recibir una notificación cuando se cree un nuevo ticket de Jira. Para ello, configura el conector de Jira Cloud para las suscripciones a eventos. Si usas las suscripciones a eventos junto con Application Integration, puedes crear integraciones útiles para satisfacer las necesidades de tu empresa. Para obtener más información, consulta Usar suscripciones a eventos en tus integraciones.

Habilitar las suscripciones a eventos en las conexiones

Una conexión que crees se puede usar para cualquiera de los siguientes fines:

  • Solo para realizar operaciones de conectores (entidades y acciones)
  • Solo para suscripciones a eventos
  • Para realizar operaciones de conectores y suscripciones a eventos

Puedes habilitar las suscripciones a eventos y configurar los detalles relacionados con los eventos durante la creación de la conexión. Sin embargo, si ya tienes una conexión y quieres reutilizarla para la suscripción a eventos, puedes hacerlo editando y volviendo a configurar la conexión.

Los siguientes conectores admiten suscripciones a eventos:

Enriquecimiento de datos en las notificaciones de eventos

Puede configurar una conexión para añadir información adicional en una respuesta de notificación de evento. La información adicional es específica de la entidad para la que ha configurado el evento. Para obtener información adicional, debe habilitar la opción Enriquecimiento de datos en su conexión.

Por ejemplo, si te has suscrito al evento de creación de una incidencia en Zendesk, recibirás una notificación cuando se cree una incidencia. Sin embargo, la carga útil de la notificación de eventos solo incluye los detalles básicos de la entrada. En la carga útil no se incluyen detalles adicionales, como la descripción de la incidencia, el asignado y el estado. Para obtener estos detalles adicionales de la entidad ticket, debe habilitar el enriquecimiento de datos en una conexión de Zendesk. Para obtener más información, consulta Configurar la suscripción a eventos. En los siguientes ejemplos se muestra la carga útil de la respuesta sin y con enriquecimiento de datos.

Carga útil sin enriquecimiento de datos

En el siguiente ejemplo se muestra la carga útil de la respuesta del evento de creación de ticket de Zendesk sin enriquecimiento de datos.

{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }

Carga útil con enriquecimiento de datos

En el siguiente ejemplo se muestra la carga útil de la respuesta del evento de creación de ticket de Zendesk con el enriquecimiento de datos.

{
    "context-data": {
    "AllowChannelback": false,
    "Assignee": null,
    "AssigneeId": 1.6696812051473E13,
    "Brand": null,
    "BrandId": 1.6696812163985E13,
    "Cc": null,
    "CollaboratorIds": null,
    "Commenter": null,
    "HasAttachment": null,
    "CreatedAt": "2023-07-08 11:37:19.0",
    "CustomFields": null,
    "Description": "Test desc 2",
....
....
    "Status": "open",
    "Subject": "Test Zendesk Ticket Created -2 -DA",
    "Submitter": null,
    "SubmitterId": 1.6696812051473E13,
    "Tags": "tag-changed-after-cache,ticket-created",
....
....
    "ViaChannel": "web",
    "ViaFollowupSourceId": null,
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "View_Id": null
  },
   "data":{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }
 }

Conectividad privada para la suscripción a eventos

Para reforzar la seguridad, puedes configurar una conectividad privada entre tu aplicación backend y tu conexión. En la conectividad privada, el receptor de eventos de tu conexión no se hará público directamente. En su lugar, debe permitir el tráfico de red entrante al receptor de eventos a través de una vinculación de servicio de PSC que le proporcionará Integration Connectors.

Durante la creación de la conexión, si has seleccionado Habilitar conectividad privada para la suscripción a eventos, Integration Connectors crea una vinculación de servicio de PSC. Debes exponer el adjunto de servicio de PSC a tu aplicación backend mediante el método que te resulte más adecuado. Una posible opción es usar la vinculación de servicio de PSC en un balanceador de carga y, a continuación, configurar el balanceador de carga para que acepte eventos de tu aplicación de backend. A continuación, la conexión escucha los eventos de tu backend en la dirección del balanceador de carga. En los siguientes pasos generales se muestra cómo puede usar un balanceador de carga para configurar la conectividad privada:

  1. Vaya a la página de detalles de la conexión que acaba de crear.
  2. Haz clic en Editar endpoint de entrada. Se muestra el panel Configuración de suscripción a eventos.
  3. Copia el nombre de la vinculación de servicio tal como se muestra en el campo Nombre de la vinculación de servicio de PSC.
  4. Crea un grupo de endpoints de red de PSC que apunte a la vinculación de servicio que has obtenido en el paso anterior.
  5. Crea un balanceador de carga externo con el grupo de endpoints de red de PSC creado en el paso anterior como backend.
  6. Configura el balanceador de carga para que acepte solicitudes de la dirección IP de tu proveedor de eventos (aplicación backend).

    Los pasos posteriores (del 7 al 11) solo se aplican a los conectores cuyo backend admite el registro automático de suscripciones a eventos. Por ejemplo, Zendesk y Jira.

  7. Vaya a la página de detalles de la conexión que acaba de crear.
  8. Haz clic en Editar endpoint de entrada. Se muestra el panel Configuración de suscripción a eventos.
  9. Escribe la dirección del balanceador de carga en el campo Endpoint de entrada del procesador de eventos.
  10. Haz clic en Listo.
  11. Haz clic en Guardar para guardar los cambios en la conexión.

Usar suscripciones a eventos en tus integraciones

Si usas suscripciones a eventos junto con tus integraciones, puedes crear integraciones para resolver problemas empresariales complejos. Por ejemplo, puedes iniciar la ejecución de toda la integración en función de un evento de ServiceNow. La integración de aplicaciones proporciona los siguientes activadores que detectan notificaciones de eventos de tus aplicaciones de backend:

Para configurar los activadores, debe habilitar la suscripción a eventos en sus conexiones. Puedes habilitar la suscripción a eventos en una conexión que ya tengas o en una nueva. Para ver los pasos detallados sobre cómo configurar estos activadores de integración de aplicaciones, consulta la documentación correspondiente.

Ver suscripciones activas

Cuando usas una suscripción a eventos en la integración de tu aplicación, Integration Connectors crea una entrada para la suscripción en la conexión correspondiente. Para ver todas las suscripciones de una conexión, sigue estos pasos:

  1. Abre la página Todas las conexiones de tu proyecto de Google Cloud.

    Ve a la página Conexiones

  2. Haz clic en la conexión de la que quieras ver las suscripciones.

    Se abrirá la página Detalles de la conexión.

  3. Haz clic en la pestaña Suscripciones.

    Se muestran todas las suscripciones de la conexión. Las suscripciones que aparecen en esta página pueden tener cualquiera de los siguientes estados:

    • Creando: una integración está creando la suscripción.
    • Activa: la suscripción es válida y funciona.
    • Suspendida: la conexión está suspendida.
    • Error: no se ha podido crear la suscripción. Por ejemplo, un error de autenticación durante la creación de una suscripción.

Precios de las suscripciones a eventos

Los datos (carga útil del evento) procesados para las suscripciones a eventos en los activadores de la vista previa no se cobran. Sin embargo, se te cobrará por los datos de suscripción a eventos procesados en activadores disponibles de forma general.