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 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 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 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 à toutes les fins suivantes:

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

L'option permettant d'activer les abonnements à des é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 un abonnement à des événements, vous pouvez la modifier et la reconfigurer.

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

• Hubspot
• IBM MQ
• Jira
• Rabbit MQ
• ServiceNow
• 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 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 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 du billet. Des 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 détails 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 à des événements. Les exemples suivants montrent la charge utile de la réponse sans et avec l'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 à un événement

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 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 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:

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 apparaît 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 (application backend) de votre fournisseur d'événements.

   Les setps suivants (7 à 11) ne sont applicables que dans les connecteurs dont le backend prend en charge l'enregistrement automatique de l'abonnement à un événement. (par exemple, Zendesk et Jira).

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 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 à 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 démarrer l'exécution de l'intégralité 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.
• Jira Cloud trigger (Déclencheur Cloud Jira) : é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 à un événement dans une connexion existante ou dans une nouvelle connexion. Pour connaître la procédure détaillée de configuration de ces déclencheurs 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 associés à la connexion s'affichent. Un abonnement répertorié 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 opérationnel.
   • Suspendue : la connexion est suspendue.
   • Erreur : la création de l'abonnement a échoué. Par exemple, un échec d'authentification lors de la création de l'abonnement.

Tarifs de l'abonnement à un événement

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, des frais vous seront facturés pour les données d'abonnement aux événements traitées par des déclencheurs en disponibilité générale.