Suscripciones a los 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, supongamos que quieres recibir una notificación cuando se cree un ticket nuevo de Jira. Para ello, configura el conector de Jira Cloud para las suscripciones a eventos. Si usas las suscripciones a eventos junto con la integración de aplicaciones, puedes crear integraciones útiles para abordar las necesidades de tu empresa. Para obtener más información, consulta Cómo usar suscripciones de 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 cambiar su propósito para la suscripción a eventos, puedes editar y volver a configurar 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, el asignado y el estado, no están presentes en la carga útil. Para obtener estos detalles adicionales de la entidad 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 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 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 mayor 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 de entrada 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.

Durante la creación de la conexión, si seleccionaste Habilitar conectividad privada para la suscripción a eventos, Integration Connectors crea un adjunto de servicio de PSC. 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 Configuración de suscripción a eventos.
  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 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 a eventos 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.

Cómo 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 está en un 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.