Abonnements aux événements

Outre la possibilité d'effectuer des opérations de lecture et d'écriture sur votre backend, les Integration Connectors vous permettent également de vous abonner aux événements qui se produisent dans vos applications backend. Par exemple, imaginons que vous souhaitiez être averti lorsqu'une demande d'assistance Jira est créée. Pour ce faire, configurez le connecteur Cloud Jira pour les abonnements à des événements. En utilisant les abonnements à des événements et Application Integration, vous pouvez créer des intégrations utiles pour répondre aux besoins de votre entreprise. Pour en savoir plus, consultez Utiliser des abonnements à des é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 aux fins suivantes:

Pour effectuer des opérations de connecteur (entités et actions) uniquement
Pour les abonnements à des événements uniquement
Pour effectuer des opérations de connecteurs et des abonnements à des é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 la réutiliser pour l'abonnement à des événements, vous pouvez modifier et reconfigurer la connexion.

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

Enrichissement des 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 les 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 demandes dans Zendesk, vous serez averti lorsqu'une demande sera créée. Cependant, la charge utile des notifications d'événements ne comprend que les détails de base du billet. Les détails supplémentaires tels que la description de la demande, la personne responsable et l'état ne sont pas présents 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 un abonnement à un événement. Les exemples suivants montrent la charge utile de réponse sans et avec enrichissement des données.

Charge utile sans enrichissement des données

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

Charge utile avec enrichissement des données

L'exemple suivant montre la charge utile de réponse de l'événement de création de tickets de Zendesk avec enrichissement des 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 les abonnements à des événements

Pour renforcer la sécurité, vous pouvez configurer une connectivité privée entre votre application backend et votre connexion. Dans le cas d'une connectivité privée, l'écouteur d'événements de votre connexion ne sera pas rendu public directement. À la place, vous devez 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 à un événement, 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 le mieux. 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 du backend sur l'adresse de l'équilibreur de charge. La procédure générale suivante montre comment utiliser un équilibreur de charge pour configurer une connectivité privée:

Accédez à la page d'informations de la connexion que vous venez de créer.
Cliquez sur Modifier le point de terminaison d'entrée. Le volet Paramètres d'abonnement aux événements s'affiche.
Copiez le nom du rattachement de service tel qu'il apparaît dans le champ Nom du rattachement de service PSC.
Créez un groupe de points de terminaison du réseau PSC pointant vers le rattachement de service obtenu à l'étape précédente.
Créez un équilibreur de charge externe en utilisant le groupe de points de terminaison du réseau PSC créé à l'étape précédente en tant que backend.
Conseil : Si vous disposez déjà d'un équilibreur de charge externe, vous pouvez l'utiliser pour configurer une connectivité privée au lieu d'en créer un.
Configurez l'équilibreur de charge pour qu'il accepte les requêtes provenant de l'adresse IP (application backend) de votre fournisseur d'événements.
Les setps suivants (7 à 11) ne s'appliquent qu'aux connecteurs dont le backend est compatible avec l'enregistrement automatique d'un abonnement à un événement. Par exemple, Zendesk et Jira.
Accédez à la page d'informations de la connexion que vous venez de créer.
Cliquez sur Modifier le point de terminaison d'entrée. Le volet Paramètres d'abonnement aux événements s'affiche.
Saisissez l'adresse de l'équilibreur de charge dans le champ Point de terminaison d'entrée de l'écouteur d'événements.
Cliquez sur OK.
Cliquez sur Save (Enregistrer) pour enregistrer les modifications apportées à la connexion.

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

Lorsque vous utilisez des abonnements à des é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 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 HubSpot : écoute les événements HubSpot.
Déclencheur IBM MQ : écoute les événements IBM MQ.
Déclencheur Jira Cloud : écoute les événements Cloud Jira.
Déclencheur Rabbit MQ : écoute les événements Rabbit MQ.
Déclencheur ServiceNow : écoute les événements ServiceNow.
Déclencheur de 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 à un événement dans une connexion existante ou dans une nouvelle connexion. Pour connaître la procédure détaillée permettant de configurer ces déclencheurs Application Integration, consultez la documentation correspondante.

Afficher les abonnements actifs

Lorsque vous utilisez un abonnement à un événement 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:

Ouvrez la page "Toutes les connexions" pour votre projet Google Cloud.
Accéder à la page "Connexions"
Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.
La page Détails de la connexion s'ouvre.
Cliquez sur l'onglet Abonnements.
Tous les abonnements pour la connexion s'affichent. Un abonnement figurant sur cette page peut présenter l'un des états suivants:
- Création en cours : l'abonnement est en cours de création par une intégration.
- Actif : l'abonnement est valide et fonctionnel.
- Suspendue : la connexion est suspendue.
- Erreur : la création de l'abonnement a échoué. (échec d'authentification lors de la création d'un abonnement, par exemple).

Tarifs des abonnements à des événements

Les données (charge utile de l'événement) traitées pour les abonnements à des événements dans les déclencheurs d'aperçu ne sont pas facturées. Toutefois, les données d'abonnement à un événement traitées par un déclencheur en disponibilité générale vous seront facturées.