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 permettent de vous abonner aux événements qui se produisent dans vos applications backend. Prenons l'exemple vous souhaitez recevoir une notification 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 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 à 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 des é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:
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 des 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 billets dans Zendesk,
notifié lorsqu'une demande est créée. Toutefois, la charge utile des notifications d'événements se compose
uniquement les détails
de base du billet. Les détails supplémentaires
tels que la description du billet,
la personne responsable et le statut
ne sont pas présents dans la charge utile. Pour obtenir ces informations supplémentaires
ticket, vous devez activer l'enrichissement des données dans une connexion Zendesk. Pour
Pour en savoir plus, consultez
Configurer l'abonnement à un événement La
Les exemples suivants illustrent la charge utile de la réponse sans et avec l'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 la méthode Zendesk à créer un événement de ticket avec l'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 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. Une possibilité consiste à utiliser le rattachement de service PSC dans un équilibreur de charge, puis à configurer pour accepter 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 au rattachement de service 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. (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 aux événements dans vos intégrations
Lorsque vous utilisez des abonnements aux événements avec vos intégrations, vous pouvez créer pour résoudre vos problématiques métier complexes. Par exemple, vous pouvez commencer l'exécution complète de votre intégration en fonction d'un événement ServiceNow. Application Integration fournit les déclencheurs suivants : Écoutez 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 à l'événement 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 à des é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 pour 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 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, l'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, les données d'abonnement aux événements traitées par des déclencheurs en disponibilité générale vous seront facturées.