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 ocurren en tus aplicaciones de backend. Por ejemplo, considera que deseas recibir una notificación cuando se cree un nuevo ticket de Jira. Para lograrlo, 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 abordar las necesidades de tu empresa. Para obtener más información, consulta Usa suscripciones a eventos en tus integraciones

Habilita las suscripciones a eventos en las conexiones

La 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

La opción para habilitar suscripciones a eventos y configurar detalles relacionados con los eventos está disponible durante la creación de la conexión. Sin embargo, si ya tienes una conexión existente y quieres readaptarla para la suscripción al evento, puedes hacerlo editando y reconfigurando la conexión.

Los siguientes conectores admiten suscripciones a eventos:

Enriquecimiento de datos en las notificaciones de eventos

Puedes configurar una conexión para adjuntar información adicional en una respuesta de notificación de evento. La información adicional es específica de la entidad para la que configuraste el evento. Para obtener la información adicional, debes habilitar el Enriquecimiento de datos en tu conexión.

Por ejemplo, si te suscribiste a un evento de creación de tickets en Zendesk, recibirás una notificación cuando se cree un ticket. Sin embargo, la carga útil de la notificación del evento solo consiste en los detalles básicos del ticket. Los detalles adicionales, como la descripción del ticket, usuario asignado y el estado no están presentes en la carga útil. Para obtener estos detalles adicionales del ticket, debes habilitar el enriquecimiento de datos en una conexión de Zendesk. Para obtener más información, consulta Cómo configurar la suscripción a eventos. En los siguientes ejemplos, se muestra la carga útil de la respuesta sin enriquecimiento de datos y con él.

Carga útil sin enriquecimiento de datos

En el siguiente ejemplo, se muestra la carga útil de respuesta de un evento de creación de tickets 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 respuesta de un evento de creación de tickets de Zendesk con 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 mejorar la seguridad, puedes configurar la conectividad privada entre tu aplicación de backend y tu conexión. En la conectividad privada, el objeto de escucha de eventos de tu conexión no se hará público directamente. En su lugar, debes permitir el tráfico de red entrante al objeto de escucha de eventos a través de un archivo adjunto de servicio de PSC que te proporcionarán los conectores de integración.

Si seleccionaste Habilitar conectividad privada para la suscripción a eventos durante la creación de la conexión, Integration Connectors creará Un adjunto de servicio de PDC. Debes exponer el archivo adjunto del servicio de PSC a tu aplicación de backend con cualquier enfoque que te resulte adecuado. Un enfoque posible es usar el archivo adjunto del servicio de PSC en un balanceador de cargas y, luego, configurar el balanceador de cargas para que acepte eventos de tu aplicación de backend. Luego, la conexión escucha los eventos de tu backend en la dirección del balanceador de cargas. En los siguientes pasos de alto nivel, se muestra cómo puedes usar un balanceador de cargas para configurar la conectividad privada:

  1. Ve a la página de detalles de la conexión recién creada.
  2. Haz clic en Editar extremo de entrada. Se mostrará el panel Event subscription settings.
  3. Copia el nombre del archivo adjunto del servicio tal como se muestra en el campo PSC service attachment name.
  4. Crea un grupo de extremos de red de PSC que apunte a al adjunto de servicio que obtuviste en el paso anterior.
  5. Crea un balanceador de cargas externo con el grupo de extremos de red de PSC que se creó en el paso anterior como backend.
  6. Configura el balanceador de cargas para que acepte solicitudes de la dirección IP de tu proveedor de eventos (aplicación de backend).

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

  7. Ve a la página de detalles de la conexión recién creada.
  8. Haz clic en Editar extremo de entrada. Se mostrará el panel Configuración de suscripción a eventos.
  9. Ingresa la dirección del balanceador de cargas en el campo Extremo de entrada del objeto de escucha de eventos.
  10. Haz clic en Listo.
  11. Haz clic en Guardar para guardar los cambios en la conexión.

Usa suscripciones a eventos en tus integraciones

Cuando 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 según un evento de ServiceNow. La integración de aplicaciones proporciona los siguientes activadores que escuchan las notificaciones de eventos de tus aplicaciones de backend:

Para configurar los activadores, debes habilitar la suscripción a eventos para tus conexiones. Puedes habilitar la suscripción al evento en una conexión existente o en una nueva. Si deseas obtener pasos detallados para configurar estos activadores de integración de aplicaciones, consulta la documentación correspondiente.

Ver las 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.

    Ir a la página Conexiones

  2. Haz clic en la conexión para la que deseas ver las suscripciones.

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

  3. Haz clic en la pestaña Suscripciones.

    Se mostrarán todas las suscripciones de la conexión. Una suscripción que aparece en esta página puede tener cualquiera de los siguientes estados:

    • Creándose: Una integración está creando la suscripción.
    • Activo: La suscripción es válida y está en funcionamiento.
    • Suspendida: la conexión se encuentra en estado suspendido.
    • Error: No se pudo crear la suscripción. Por ejemplo, una falla de autenticación durante la creación de la suscripción.

Precios de la suscripción al evento

No se cobran los datos (carga útil del evento) procesados para las suscripciones a eventos en los activadores de la versión preliminar. Sin embargo, se te cobrará por los datos de suscripción a eventos procesados en activadores de disponibilidad general.