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 quieres 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 satisfacer las necesidades de tu empresa. Para obtener más información, consulta Usa suscripciones a eventos en tus integraciones.

Nota: Si configuras un perímetro de servicio de VPC para tu proyecto de Google Cloud, debes habilitar la conectividad privada para las suscripciones a eventos.

Habilitar suscripciones a eventos en las conexiones

Una conexión que crees se puede 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 conector y suscripciones a eventos

La opción de habilitar las suscripciones a eventos y configurar los detalles relacionados con los eventos estará disponible durante la creación de la conexión. Sin embargo, si ya tienes una conexión y quieres cambiar el propósito para la suscripción a eventos, puedes editar y volver a configurar la conexión.

Los siguientes conectores admiten suscripciones a eventos:

• HubSpot
• IBM MQ
• Jira
• MQ de Rabbit
• ServiceNow
• Webhook
• Zendesk

Enriquecimiento de datos en notificaciones de eventos

Puedes configurar una conexión para agregar 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, se te notificará cuando se cree un ticket. Sin embargo, la carga útil de la notificación de eventos consta solo de los detalles básicos del ticket. Los detalles adicionales, como la descripción del ticket, el destinatario 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 respuesta sin y con enriquecimiento de datos.

Carga útil sin enriquecimiento de datos

En el siguiente ejemplo, se muestra la carga útil de respuesta de un 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 respuesta de un 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"
        }
      }
    }
  }
 }

Nota:

• Si habilitaste el enriquecimiento de datos, la carga útil de la respuesta contiene el campo context-data, además de la respuesta normal que obtendrías sin el enriquecimiento de datos. En el ejemplo anterior, el campo context-data contiene detalles adicionales del ticket recién creado en Zendesk.
• Solo el conector Zendesk admite el enriquecimiento de datos para las notificaciones de eventos.

Conectividad privada para la suscripción a eventos

Para mejorar la seguridad, puedes configurar la conectividad privada entre la aplicación de backend y la 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 adjunto de servicio de PSC que te proporcionará Integration Connectors.

Durante la creación de la conexión, si seleccionaste Habilitar conectividad privada para la suscripción al evento, Integration Connectors crea un adjunto de servicio PSC. Debes exponer el adjunto de servicio de PSC a tu aplicación de backend con cualquier enfoque que te resulte adecuado. Un posible enfoque es usar el adjunto de servicio de PSC en un balanceador de cargas y, luego, configurarlo 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 adjunto de servicio como se muestra en el campo Nombre del adjunto de servicio de PSC.
4. Crea un grupo de extremos de red 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 creaste en el paso anterior como backend.
   Sugerencia: Si ya tienes un balanceador de cargas externo, puedes usarlo para configurar la conectividad privada, en lugar de crear uno nuevo.
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 setps posteriores (7 a 11) solo se aplican en conectores cuyo backend admite el registro automático de 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 en función de un evento de ServiceNow. Application Integration proporciona los siguientes activadores que escuchan las notificaciones de eventos de tus aplicaciones de backend:

• HubSpot trigger: Detecta eventos de HubSpot.
• Activador de IBM MQ: Escucha eventos de IBM MQ.
• Jira Cloud trigger: Detecta eventos de Jira Cloud.
• Activador de MQ de Rabbit: Escucha eventos de MQ de Rabbit.
• Activador de ServiceNow: Escucha eventos de ServiceNow.
• Activador de webhook: Detecta eventos de webhook genéricos.
• Activador de Zendesk: Escucha eventos de Zendesk.

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 quieres conocer los pasos detallados para configurar estos activadores de Application Integration, consulta la documentación del activador correspondiente.

Ver las suscripciones activas

Cuando usas una suscripción a un evento 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 de 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. Las suscripciones que se mencionan en esta página pueden tener cualquiera de los siguientes estados:

   • En creación: La suscripción la crea una integración.
   • Activa: La suscripción es válida y está en funcionamiento.
   • Suspendida: La conexión está en estado de suspensión.
   • Error: No se pudo crear la suscripción. Por ejemplo, un error de autenticación durante la creación de la suscripción.

Nota: Si una conexión tiene suscripciones a eventos activas, no puedes borrarla ni editar el nombre de host del backend ni la dirección IP de la conexió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á por los datos de suscripción a eventos procesados en activadores disponibles para el público general.