Abonnements aux événements

En plus de vous permettre d'effectuer des opérations de lecture et d'écriture sur votre backend, Integration Connectors vous permet également de vous abonner aux événements qui se produisent dans vos applications backend. Par exemple, imaginons que vous souhaitiez recevoir une notification lorsqu'une nouvelle demande Jira est créée. Pour ce faire, 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 la section Utiliser des abonnements d'é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 pour les raisons suivantes:

  • 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 des abonnements d'événements

L'option permettant d'activer les abonnements aux événements et de configurer les informations associées 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 la réutiliser pour l'abonnement aux événements, vous pouvez le faire en modifiant et en reconfigurant la connexion.

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

Enrichir les données dans les notifications d'événements

Vous pouvez configurer une connexion pour ajouter des informations supplémentaires dans une réponse à une notification d'événement. Les informations supplémentaires sont spécifiques à 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 demande dans Zendesk, vous recevrez une notification lorsqu'une demande sera créée. Toutefois, la charge utile de la notification d'événement ne comprend que les informations de base sur la demande. Les informations supplémentaires telles que la description de la demande, l'agent responsable et l'état 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.

Charge utile sans enrichissement de données

L'exemple suivant montre la charge utile de réponse de l'événement de création d'une demande Zendesk sans enrichissement de 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"
        }
      }
    }
  }

Charge utile avec enrichissement des données

L'exemple suivant montre la charge utile de réponse de l'événement de création d'une demande Zendesk avec enrichissement de données.

{
    "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 plutôt autoriser le trafic réseau entrant vers l'écouteur d'événements via un rattachement de service PSC qui vous sera fourni 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 n'importe quelle 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 étapes générales suivantes montrent comment utiliser un équilibreur de charge pour configurer la connectivité privée:

  1. Accédez à la page d'informations 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 pointant vers le rattachement de service que vous avez 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 prend en charge l'enregistrement automatique de l'abonnement aux événements. (Zendesk et Jira, par exemple).

  7. Accédez à la page d'informations 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 d'é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èmes métier complexes. Par exemple, vous pouvez démarrer l'exécution de l'ensemble de votre intégration en fonction d'un événement ServiceNow. L'Application Integration fournit les déclencheurs suivants qui écoutent les notifications d'événements de vos applications backend:

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 découvrir comment configurer ces déclencheurs d'Application Integration, consultez la documentation correspondante.

Afficher les abonnements actifs

Lorsque vous utilisez un abonnement aux événements dans l'intégration de votre 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 "Toutes les connexions" de votre projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.

    La page Détails de la connexion s'ouvre.

  3. Cliquez sur l'onglet Abonnements.

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

    • Création : l'abonnement est en cours de création par une intégration.
    • Active : l'abonnement est valide et fonctionne.
    • Suspendu : la connexion est suspendue.
    • Erreur : la création de l'abonnement échoue. Par exemple, échec de l'authentification lors de la création de l'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 de prévisualisation ne sont pas facturées. Toutefois, les données d'abonnement aux événements traitées dans des déclencheurs disponibles pour tous les utilisateurs vous seront facturées.