Consultez les connecteurs compatibles avec Application Integration.

Déclencheur de webhook

Preview — Webhook trigger

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Le déclencheur de webhook est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration en fonction de n'importe quel événement du backend compatible avec les webhooks. Ce déclencheur reçoit des événements provenant d'applications SaaS tierces compatibles avec les événements de webhook. Il prend en charge plusieurs types d'authentification pour votre écouteur d'événements.

Important : Integration Connectors sont un composant facturable de Google Cloud. Pour en savoir plus sur les coûts et les frais d'utilisation d'Integration Connectors, consultez la page Tarifs Integration Connectors.

Avant de commencer

Si vous prévoyez de créer ou de configurer une connexion pour le déclencheur de webhook, assurez-vous de disposer du rôle Identity and Access Management (IAM) suivant dans le projet :

• Administrateur des connecteurs (roles/connectors.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer les accès.

Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur de webhook :

• Demandeur Application Integration (roles/integrations.integrationInvoker)

Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.

Ajouter le déclencheur Webhook

Pour ajouter un déclencheur de webhook à votre intégration, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Liste des intégrations s'affiche et répertorie toutes les intégrations disponibles dans le projet Google Cloud.

3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

   Si vous créez une intégration :

   1. Saisissez un nom et une description dans le volet Créer une intégration.
   2. Sélectionnez une région pour l'intégration.
      Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
   3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de la barre d'outils d'intégration.
      Remarque : L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
   4. Cliquez sur Créer.

   L'intégration que vous venez de créer s'ouvre dans l'éditeur d'intégration.

4. Dans la barre de navigation de l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
5. Cliquez sur l'élément Déclencheur de webhook et placez-le dans l'éditeur d'intégrations.

Pour configurer le déclencheur Webhook, vous pouvez utiliser une connexion Webhook existante disponible dans Integration Connectors ou en créer une à l'aide de l'option de création de connexion intégrée.

Configurer un déclencheur de webhook à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur Webhook à l'aide d'une connexion Webhook existante dans Integration Connectors. Notez que le déclencheur Webhook est un déclencheur d'événement de connecteur. Par conséquent, vous ne pouvez utiliser une connexion Webhook qu'avec l'abonnement aux événements activé pour configurer le déclencheur.

Pour savoir comment configurer un déclencheur Webhook à l'aide d'une nouvelle connexion Webhook, consultez Configurer un déclencheur Webhook à l'aide d'une nouvelle connexion.

Pour configurer un déclencheur Webhook à l'aide d'une connexion Webhook existante, procédez comme suit :

1. Cliquez sur l'élément Déclencheur de webhook dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Fournissez les informations de configuration suivantes sur la page Éditeur de déclencheur d'événement de connecteur :
   1. Région : sélectionnez la région de votre connexion Webhook.
   2. Connexion : sélectionnez la connexion Webhook que vous souhaitez utiliser.

      L'Application Integration n'affiche que les connexions Webhook actives et pour lesquelles l'abonnement aux événements est activé.

   3. Type d'abonnement aux événements : saisissez le type d'événement que vous souhaitez utiliser pour déclencher l'intégration.
   4. Compte de service : sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur de webhook.
4. Cliquez sur Terminé pour terminer la configuration du déclencheur et fermer la page.

Pour en savoir plus, consultez la documentation sur la connexion Webhook.

Configurer le déclencheur Webhook à l'aide d'une nouvelle connexion

Pour configurer le déclencheur Webhook à l'aide d'une nouvelle connexion Webhook, procédez comme suit :

1. Cliquez sur l'élément Déclencheur de webhook dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Ignorez le champ Région.
4. Cliquez sur Connexion, puis sélectionnez l'option Créer une connexion dans le menu.
5. Procédez comme suit dans le volet Créer une connexion :
   1. Dans la section Emplacement, choisissez l'emplacement de la connexion.
      1. Région : sélectionnez un emplacement dans la liste.

         Les régions disponibles pour les connecteurs sont les suivantes :

         Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

      2. Cliquez sur Suivant.
   2. Dans la section Détails de connexion, procédez comme suit :
      1. Connecteur : sélectionnez Webhook dans la liste déroulante des connecteurs disponibles.
      2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
      3. Nom de connexion : saisissez un nom pour la nouvelle instance de connexion.

         Les noms de connexion doivent répondre aux critères suivants :

         • Ils peuvent contenir des lettres, des chiffres ou des traits d'union.
         • Les lettres doivent être en minuscules.
         • Ils doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
         • Ils ne peuvent pas dépasser 49 caractères.
         • Pour les connecteurs qui acceptent les abonnements aux événements, les noms de connexion ne peuvent pas commencer par le préfixe "goog".
      4. Description : (Facultatif) Saisissez une description de l'instance de connexion.
      5. Compte de service : sélectionnez un compte de service disposant des rôles requis.
      6. Abonnement aux événements : l'abonnement aux événements est activé par défaut. Il est obligatoire pour le connecteur Webhook.
         Remarque : L'option Enable event subscription, entity and actions n'est pas compatible avec cette connexion.
      7. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
      8. Cliquez sur Suivant.
   3. Dans la section Détails de l'abonnement aux événements, procédez comme suit :
      1. Authentification de l'écouteur : sélectionnez un type d'authentification pour l'écouteur d'événements et saisissez les informations appropriées.

         Les types d'authentification suivants sont compatibles avec l'écouteur de webhook :

         • Aucune authentification
         • Authentification Google : assurez-vous que le compte de service dispose du rôle roles/connectors.listener dont le jeton d'accès est utilisé pour l'authentification.
         • Authentification par clé API
         • Authentification de base
      2. Emplacement du champ du type d'événement : champ obligatoire qui indique l'emplacement (en-tête, paramètre de requête ou corps de requête) où le type d'événement associé à la requête d'événement entrante sera présent.
      3. Nom du champ du type d'événement : champ obligatoire dans l'emplacement configuré. Il identifie le type d'événement associé à la requête d'événement entrante.

      {
      "event_type": "user.created",
      ...
      // other request fields
      ...
      }

      Dans l'exemple ci-dessus, le champ event_type dans le corps de la requête indique que la requête concerne un événement "user.created".
      4. Sélectionnez Activer la connectivité privée pour la connectivité sécurisée entre votre application backend et votre connexion. Si vous sélectionnez cette option, vous devez effectuer des étapes de configuration supplémentaires après avoir créé la connexion. Pour en savoir plus, consultez Connectivité privée pour l'abonnement aux événements.
      5. Saisissez la configuration de lettres mortes. Si vous configurez les lettres mortes, la connexion écrit les événements non traités dans le sujet Pub/Sub spécifié. Saisissez les informations suivantes :
         1. ID du projet de lettres mortes : ID du projet Google Cloud dans lequel vous avez configuré la file d'attente Pub/Sub de lettres mortes.
         2. File d'attente de lettres mortes : sujet Pub/Sub dans lequel vous souhaitez écrire les détails des événements non traités.
      6. Cliquez sur Suivant.
   4. Vérifier : vérifiez vos informations de connexion et d'authentification d'écouteur.
   5. Cliquez sur Créer.

Sortie du déclencheur

Le déclencheur de webhook prend quelques minutes pour terminer la configuration de l'abonnement aux événements. Vous pouvez consulter l'état de votre abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Le déclencheur de webhook indique l'état d'un abonnement à un événement à l'aide des états suivants :

• Creating : indique que le déclencheur s'abonne à l'abonnement aux événements.
• Active : indique que le déclencheur est correctement abonné à un abonnement aux événements.
• Error : indique qu'il existe un problème avec l'abonnement aux événements configuré.

En plus de l'état de l'abonnement aux événements, la section Détails de l'abonnement aux événements affiche également d'autres informations, telles que la région et le nom de la connexion, le nom de l'abonnement aux événements, etc.

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur de webhook génère une variable de sortie ConnectorEventPayload que vous pouvez utiliser dans vos tâches en aval. La variable de sortie est au format JSON et contient le schéma de charge utile du Webhook de sortie.

Afficher les abonnements aux événements

Pour afficher et gérer tous les abonnements aux événements associés à une connexion dans Integration Connectors, procédez comme suit :

1. Accédez à la page Connecteurs d'intégration > Connexions.

   Accéder à la page "Connexions"

2. Cliquez sur la connexion dont vous souhaitez afficher les abonnements.
3. Cliquez sur l'onglet Abonnements aux événements.

   Tous les abonnements aux événements de la connexion s'affichent.

Modifier le déclencheur de webhook

Vous pouvez modifier un déclencheur de webhook pour modifier ou mettre à jour la configuration de la connexion et les détails de l'abonnement aux événements.

Important : Lorsque vous modifiez un déclencheur de webhook, vous pouvez conserver l'abonnement aux événements précédemment configuré qui est associé au déclencheur ou le supprimer. La suppression d'un abonnement à un événement affectera toutes les intégrations publiées qui l'utilisent.

Pour modifier un déclencheur de webhook, procédez comme suit :

1. Cliquez sur l'élément Déclencheur de webhook dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer le déclencheur de webhook.
3. Procédez comme suit sur la page Éditeur de déclencheurs d'événements de connecteur :
   1. Pour conserver l'abonnement aux événements précédemment configuré, cliquez sur Conserver. Sinon, cliquez sur Supprimer.
      Avertissement : La suppression d'un abonnement à un événement affectera toutes les intégrations publiées qui l'utilisent. Cette opération est irréversible.
   2. Mettez à jour la configuration de la connexion et les détails de l'abonnement aux événements selon vos besoins.
   3. Cliquez sur OK.

Vous pouvez afficher les détails mis à jour de la connexion et de l'abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante

• Découvrez toutes les tâches et tous les déclencheurs.
• Découvrez comment tester et publier une intégration.
• En savoir plus sur la gestion des erreurs
• En savoir plus sur les journaux d'exécution d'intégration