Suscripciones a eventos

Además de permitirte realizar operaciones de lectura y escritura en tu backend, Integration Connectors te permiten 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. Puedes lograr esto configurando 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

Habilitar suscripciones a eventos en conexiones

Las conexiones que creas se pueden usar para cualquiera de los siguientes fines:

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

Las opciones para habilitar suscripciones a eventos y configurar detalles relacionados con eventos están disponibles 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 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 entradas en Zendesk, podrás se notifica cuando se crea un ticket. Sin embargo, la carga útil de notificación de eventos solo los detalles básicos del boleto. 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 más información, consulta Configura la suscripción al evento. El Las siguientes muestras muestran 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 cambio, debes permitir la entrada de tráfico de red al objeto de escucha de eventos a través de un adjunto de servicio de PSC que se te proporcionará por Integration Connectors.

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 adjunto de servicio de PSC a tu aplicación de backend a través de cualquier enfoque que puedas. Una posible es usar el adjunto de servicio de PSC en un balanceador de cargas y, luego, configurar balanceador de cargas para aceptar 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 adjunto de servicio como se muestra en el campo Nombre del adjunto de servicio de PSC.
  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 la red de PSC. y el grupo de extremos creado en el paso anterior como backend.
  6. Configura el balanceador de cargas para aceptar solicitudes de la dirección IP de tu proveedor de eventos (aplicación de backend).

    Los setps posteriores (de 7 a 11) solo son aplicables en los conectores cuyo backend admite 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 Event subscription settings.
  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 para resolver problemas empresariales complejos. Por ejemplo, puedes empezar la ejecución de toda tu integración basada en un evento ServiceNow. Application Integration proporciona los siguientes activadores, detectar notificaciones de eventos de tus aplicaciones de backend:

Para configurar los activadores, debes habilitar la suscripción al evento para tus conexiones. Puedes habilitar la suscripción al evento en una conexión existente o en una nueva. Para obtener instrucciones detalladas Para configurar estos activadores de Application Integration, consulta el archivo documentación del activador.

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. Cómo ver todas las suscripciones para 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 este puede tener cualquiera de los siguientes estados:

    • Creación: Una integración está creando la suscripción.
    • Activa: 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, la autenticación durante la creación de la suscripción.

Precios de la suscripción a eventos

No se cobran los datos (carga útil de eventos) procesados para las suscripciones a eventos en los activadores de vista previa. Sin embargo, se te cobrarán los datos de suscripción a eventos procesados en activadores de disponibilidad general.