Abonnements aux événements

Integration Connectors vous permet non seulement d'effectuer des opérations de lecture et d'écriture sur votre backend, mais aussi de vous abonner aux événements qui se produisent dans vos applications backend. Par exemple, imaginons que vous souhaitiez être averti lorsqu'un ticket Jira est créé. Pour cela, configurez le connecteur Jira Cloud pour les abonnements aux événements. En utilisant les abonnements aux événements avec Application Integration, vous pouvez créer des intégrations utiles pour répondre à vos besoins métier. Pour en savoir plus, consultez Utiliser des abonnements aux événements dans vos intégrations.

Activer les abonnements aux événements dans les connexions

Une connexion que vous créez peut être utilisée dans les cas suivants :

• Pour effectuer des opérations de connecteur (entités et actions) uniquement
• Pour les abonnements aux événements uniquement
• Pour effectuer des opérations de connecteur et pour les abonnements aux événements

L'option permettant d'activer les abonnements aux événements et de configurer les détails liés aux événements est disponible lors de la création de la connexion. Toutefois, si vous disposez déjà d'une connexion et que vous souhaitez l'utiliser pour l'abonnement aux événements, vous pouvez modifier et reconfigurer la connexion.

Les connecteurs suivants sont compatibles avec les abonnements aux événements :

• Apache Kafka
• Azure AD (Entra ID)
• Hubspot
• HL7
• IBM MQ
• Jira Cloud
• RabbitMQ
• SAP Gateway
• SAP ERP
• ServiceNow
• Solace
• TIBCO EMS
• Webhook
• Zendesk

Enrichissement des données dans les notifications d'événements

Vous pouvez configurer une connexion pour ajouter des informations supplémentaires dans la réponse à une notification d'événement. Les informations supplémentaires sont propres à l'entité pour laquelle vous avez configuré l'événement. Pour obtenir ces informations supplémentaires, vous devez activer l'enrichissement des données dans votre connexion.

Par exemple, si vous vous êtes abonné à un événement de création de ticket dans Zendesk, vous recevrez une notification lors de la création d'un ticket. Toutefois, la charge utile de la notification d'événement ne contient que les informations de base sur le ticket. Des informations supplémentaires telles que la description, la personne responsable et l'état du ticket ne sont pas présentes dans la charge utile. Pour obtenir ces informations supplémentaires sur l'entité ticket, vous devez activer l'enrichissement des données dans une connexion Zendesk. Pour en savoir plus, consultez Configurer l'abonnement aux événements. Les exemples suivants montrent la charge utile de la réponse sans et avec enrichissement des données.

{
  "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"
        }
      }
    }
  }

{
    "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"
        }
      }
    }
  }
 }

Connectivité privée pour l'abonnement aux événements

Pour renforcer la sécurité, vous pouvez configurer une connectivité privée entre votre application backend et votre connexion. Dans la connectivité privée, l'écouteur d'événements de votre connexion n'est pas rendu public directement. Vous devez autoriser le trafic réseau entrant vers l'écouteur d'événements par le biais d'un rattachement de service PSC qui sera assuré par Integration Connectors.

Lors de la création de la connexion, si vous avez sélectionné Activer la connectivité privée pour l'abonnement aux événements, Integration Connectors crée un rattachement de service PSC. Vous devez exposer le rattachement de service PSC à votre application backend en utilisant l'approche qui vous convient. Une approche possible consiste à utiliser le rattachement de service PSC dans un équilibreur de charge, puis à configurer l'équilibreur de charge pour qu'il accepte les événements de votre application backend. La connexion écoute ensuite les événements de votre backend sur l'adresse de l'équilibreur de charge. Les grandes étapes suivantes montrent comment utiliser un équilibreur de charge pour configurer la connectivité privée :

1. Accédez à la page de détails de la connexion que vous venez de créer.
2. Cliquez sur Modifier le point de terminaison d'entrée. Le volet Paramètres d'abonnement aux événements s'affiche.
3. Copiez le nom du rattachement de service tel qu'il s'affiche dans le champ Nom du rattachement de service PSC.
4. Créez un groupe de points de terminaison du réseau PSC qui pointe vers le rattachement de service obtenu à l'étape précédente.
5. Créez un équilibreur de charge externe avec le groupe de points de terminaison du réseau PSC créé à l'étape précédente en tant que backend.
6. Configurez l'équilibreur de charge pour qu'il accepte les requêtes provenant de l'adresse IP de votre fournisseur d'événements (application backend).

   Les étapes suivantes (7 à 11) ne s'appliquent qu'aux connecteurs dont le backend accepte l'enregistrement automatique de l'abonnement aux événements (par exemple, Zendesk et Jira).

7. Accédez à la page de détails de la connexion que vous venez de créer.
8. Cliquez sur Modifier le point de terminaison d'entrée. Le volet Paramètres d'abonnement aux événements s'affiche.
9. Saisissez l'adresse de l'équilibreur de charge dans le champ Point de terminaison d'entrée de l'écouteur d'événements.
10. Cliquez sur OK.
11. Cliquez sur Enregistrer pour enregistrer les modifications apportées à la connexion.

Utiliser des abonnements aux événements dans vos intégrations

Lorsque vous utilisez des abonnements aux événements avec vos intégrations, vous pouvez créer des intégrations pour résoudre vos problématiques métier complexes. Par exemple, vous pouvez lancer l'exécution de l'ensemble de votre intégration en fonction d'un événement ServiceNow. Application Integration fournit les déclencheurs suivants qui écoutent les notifications d'événements de vos applications backend :

• Déclencheur Azure AD : écoute les événements Azure AD.
• Déclencheur HL7 : écoute les événements HL7.
• Déclencheur HubSpot : écoute les événements HubSpot.
• Déclencheur IBM MQ : écoute les événements IBM MQ.
• Déclencheur Jira Cloud : écoute les événements Jira Cloud.
• Déclencheur RabbitMQ : écoute les événements RabbitMQ.
• Déclencheur ServiceNow : écoute les événements ServiceNow.
• Déclencheur TIBCO EMS : écoute les événements TIBCO EMS.
• Déclencheur Webhook : écoute les événements de webhook génériques.
• Déclencheur Zendesk : écoute les événements Zendesk.

Pour configurer les déclencheurs, vous devez activer l'abonnement aux événements pour vos connexions. Vous pouvez activer l'abonnement aux événements dans une connexion existante ou dans une nouvelle connexion. Pour savoir comment configurer ces déclencheurs Application Integration, consultez la documentation correspondante.

Afficher les abonnements actifs

Lorsque vous utilisez un abonnement aux événements dans votre intégration d'application, Integration Connectors crée une entrée pour l'abonnement dans la connexion correspondante. Pour afficher tous les abonnements d'une connexion, procédez comme suit :

1. Ouvrez la page "Connexions" de votre projet Google Cloud.

   Accéder à la page "Connexions"

2. Cliquez sur la connexion dont vous souhaitez afficher les abonnements.

   La page Détails de connexion s'ouvre.

3. Cliquez sur l'onglet Abonnements.

   Tous les abonnements de la connexion s'affichent. Un abonnement listé sur cette page peut présenter l'un des états suivants :

   • Création : l'abonnement est en cours de création par une intégration.
   • Actif : l'abonnement est valide et fonctionne.
   • Suspendu : la connexion est suspendue.
   • Erreur : la création de l'abonnement a échoué. Par exemple, l'authentification a échoué lors de la création d'un abonnement.

Tarifs de l'abonnement aux événements

Les données (charge utile de l'événement) traitées pour les abonnements aux événements dans les déclencheurs en version preview ne sont pas facturées. En revanche, des frais s'appliquent pour les données d'abonnement aux événements traitées dans des déclencheurs en disponibilité générale.