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 Application Integration vous permet 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 à des é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 que vous disposez déjà d'une connexion et que vous souhaitez la réutiliser pour un abonnement à des événements, vous pouvez Il faut donc modifier et reconfigurer la connexion.
Les connecteurs suivants sont compatibles avec les abonnements aux événements :
- Apache Kafka
- Hubspot
- IBM MQ
- Jira Cloud
- Rabbit MQ
- Passerelle SAP
- ERP SAP
- ServiceNow
- Solace
- TIBCOEMS
- Webhook
- Zendesk
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 est spécifique à 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
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 des données
L'exemple suivant montre la charge utile de réponse de la méthode Zendesk à créer un événement de ticket sans enrichir les 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 une connectivité privée, l'écouteur d'événements de votre connexion n'est pas directement rendu public. À 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 à des é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 étapes générales suivantes expliquent 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 que vous avez obtenu à l'étape précédente.
- Créez un équilibreur de charge externe avec le réseau PSC. groupe de points de terminaison créé à l'étape précédente en tant que backend.
- 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 prend en charge l'inscription automatique de l'abonnement à un événement. (Zendesk et Jira, par exemple).
- 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 aux événements dans vos intégrations
Lorsque vous utilisez des abonnements d'é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'intégration d'applications 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 Jira Cloud.
- Déclencheur Rabbit MQ : écoute les événements Rabbit MQ.
- Déclencheur ServiceNow : écoute les événements ServiceNow.
- Déclencheur TIBCOEMS : écoute les événements TIBCOEMS.
- Déclencheur de webhook : écoute les événements de webhooks 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 connaître la procédure détaillée pour configurer ces déclencheurs Application Integration, consultez la documentation documentation sur les déclencheurs.
Afficher les abonnements actifs
Lorsque vous utilisez un abonnement d'é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" de votre projet Google Cloud.
- 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 associés à la connexion s'affichent. Un abonnement listé sur cette 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 opérationnel.
- Suspendu : la connexion est suspendue.
- Erreur : la création de l'abonnement a échoué. Par exemple, 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 à des é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 par des déclencheurs en disponibilité générale vous seront facturées.