Consultez les connecteurs compatibles avec Application Integration.

Déclencheur HubSpot

Preview — HubSpot 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 HubSpot est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration en fonction des événements HubSpot personnalisés que vous avez définis dans votre instance HubSpot.

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

• 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.

Types d'événements acceptés

Les abonnements aux webhooks vous permettent de sélectionner les événements que votre application recevra. Les types d'abonnements suivants sont acceptés :

• deal.creation
• deal.propertyChange
• deal.deletion
• contact.creation
• contact.propertyChange
• contact.deletion

Ajouter le déclencheur HubSpot

Pour ajouter un déclencheur HubSpot à 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 HubSpot et placez-le dans l'éditeur d'intégrations.

Pour configurer le déclencheur HubSpot, vous pouvez utiliser une connexion HubSpot 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 HubSpot à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur HubSpot à l'aide d'une connexion HubSpot existante dans Integration Connectors. Le déclencheur HubSpot est un déclencheur d'événement de connecteur. Vous ne pouvez donc utiliser une connexion HubSpot que si l'abonnement aux événements est activé pour configurer le déclencheur.

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

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

1. Cliquez sur l'élément Déclencheur HubSpot 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 HubSpot.
   2. Connexion : sélectionnez la connexion HubSpot que vous souhaitez utiliser.

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

   3. Type d'événement : sélectionnez le type d'événement que vous souhaitez utiliser pour déclencher l'intégration. Pour obtenir la liste des types d'événements acceptés, consultez la section Types d'événements acceptés.
   4. Compte de service : sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur HubSpot.
4. Cliquez sur Terminé pour terminer la configuration du déclencheur et fermer la page.

Configurer un déclencheur HubSpot à l'aide d'une nouvelle connexion

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

1. Cliquez sur l'élément Déclencheur HubSpot 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 déroulant.
5. Procédez comme suit dans le volet Créer une connexion :
   1. À l'étape Emplacement, choisissez l'emplacement de la nouvelle connexion HubSpot :
      1. Région : sélectionnez une région dans la liste déroulante.
      2. Cliquez sur Suivant.
   2. Dans la section Détails de connexion, procédez comme suit :
      1. Connecteur : sélectionnez HubSpot 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. Dans le champ Nom de connexion, indiquez le nom de l'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. (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. Pour utiliser la connexion pour les abonnements aux événements, sélectionnez Activer l'abonnement aux événements. Les options suivantes s'affichent alors :
         • Activer l'abonnement aux événements avec entité et actions : sélectionnez cette option pour utiliser la connexion à la fois pour l'abonnement aux événements et les opérations de connecteur (entités et actions).
         • Activer uniquement l'abonnement aux événements : sélectionnez cette option afin d'utiliser la connexion uniquement pour l'abonnement aux événements. Si vous sélectionnez cette option, cliquez sur Suivant, puis configurez l'abonnement aux événements.
      7. Schéma : spécifiez la version de l'API HubSpot à utiliser. HubSpotV4 est la nouvelle API.
      8. BrowsableSchemas : cette propriété restreint les schémas signalés à un sous-ensemble des schémas disponibles. Par exemple : BrowsableSchemas=SchemaA,SchemaB,SchemaC.
      9. Propriétés des contacts : saisissez les noms de champs de l'entité Contacts que vous souhaitez sélectionner dans l'opération d'entité List, séparés par une virgule. Par exemple : fieldA, fieldB, fieldC.
      10. Propriétés des entreprises : saisissez les noms de champ de l'entité Companies que vous souhaitez sélectionner dans l'opération d'entité List, séparés par une virgule. Par exemple : fieldA, fieldB, fieldC.
      11. Propriétés des offres : saisissez les noms de champ de l'entité Deals que vous souhaitez sélectionner dans l'opération d'entité List, séparés par une virgule. Par exemple : fieldA, fieldB, fieldC.
      12. Utiliser un proxy : cochez cette case pour configurer un serveur proxy pour la connexion.
      13. Schéma d'authentification du proxy : type d'authentification à utiliser pour s'authentifier auprès du proxy ProxyServer.
      14. Utilisateur du proxy : nom d'utilisateur permettant de s'authentifier auprès du proxy ProxyServer.
      15. Mot de passe du proxy : mot de passe à utiliser pour s'authentifier auprès du proxy ProxyServer.
      16. Type SSL du proxy : type SSL à utiliser pour se connecter au proxy ProxyServer.
      17. (Facultatif) Configurez les paramètres des nœuds de connexion :
          • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
          • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

          Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

      Remarque : Vous ne pouvez personnaliser les valeurs des nœuds de connexion que si vous avez opté pour le paiement à l'usage.
      18. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
      19. Cliquez sur Suivant.
   3. Dans la section Destinations, saisissez des informations sur l'hôte distant (système backend) auquel vous souhaitez vous connecter.
      1. Type de destination : vous pouvez spécifier les détails de destination sous la forme d'une adresse d'hôte ou d'un rattachement de service. Sélectionnez l'un des types de destination suivants :
         • Adresse de l'hôte : si vous souhaitez spécifier le nom d'hôte ou l'adresse IP de la destination.
         • Rattachement de service : si vous souhaitez spécifier le point de terminaison privé pour vos adresses IP internes. Le rattachement de service vous permet de masquer vos adresses IP internes dans le réseau externe. Vous pouvez créer un rattachement de service dans Google Cloud à l'aide de la fonctionnalité Private Service Connect. Pour en savoir plus sur la configuration d'une instance Private Service Connect, consultez Publier des services gérés.

         En fonction du type de destination sélectionné, saisissez l'adresse de l'hôte ou le nom du rattachement de service.

         Pour saisir d'autres destinations, cliquez sur + Ajouter une destination.

      2. Cliquez sur Suivant.
   4. Dans la section Authentification, saisissez les informations d'authentification.
      1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

         Le type d'authentification suivant est compatible avec la connexion HubSpot :

         • Jeton d'accès à l'application privée : sélectionnez le secret Secret Manager contenant le jeton d'accès à l'application privée.

           Les applications privées vous permettent d'utiliser les API HubSpot pour accéder à des données spécifiques de votre compte HubSpot. Vous pouvez autoriser ce que chaque application privée peut demander ou modifier dans votre compte, ce qui génère un jeton d'accès unique pour votre application privée. Dans votre application privée, assurez-vous d'avoir accordé l'autorisation de lecture au moins aux niveaux d'accès suivants :

           • crm.schemas.line_items.read
           • crm.schemas.quotes.read
           • crm.schemas.deals.read
           • crm.schemas.companies.read
           • crm.schemas.custom.read
           • crm.schemas.contacts.read

           Pour en savoir plus, consultez Applications privées.

      2. Cliquez sur Suivant.
   5. Si vous avez activé l'abonnement aux événements, la section Détails de l'abonnement aux événements s'affiche sur la page de création de la connexion. À l'étape Détails de l'abonnement à l'événement, fournissez les informations d'authentification qui seront utilisées pour valider la charge utile du jeton HubSpot :
      1. Code secret du client (facultatif) : sélectionnez le secret Secret Manager du code secret du client de votre application privée, puis la version de secret correspondante dans le menu déroulant Version du secret.

      Pour en savoir plus, consultez Applications privées.

      2. 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.
      3. 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.
      4. Cliquez sur Suivant.
   6. Vérifier : vérifiez vos informations de connexion et d'authentification.
   7. Cliquez sur Créer.

Créer et modifier des abonnements aux webhooks

Pour terminer la configuration de l'abonnement aux événements, vous devez enregistrer l'URL de webhook auprès de votre application HubSpot. Par conséquent, une fois la connexion créée, effectuez les étapes supplémentaires suivantes :

1. Accédez à la page de détails de la connexion que vous venez de créer et copiez l'URL de webhook pour l'abonnement aux événements. Vous aurez besoin de l'URL du webhook lorsque vous créerez un abonnement au webhook à l'étape suivante.

   L'image suivante montre le champ Point de terminaison de l'écouteur d'événements sur la page des détails de la connexion HubSpot :

   
2. Suivez la procédure pour créer et modifier des abonnements aux webhooks dans HubSpot.

Sortie du déclencheur

Le déclencheur HubSpot prend quelques minutes pour configurer 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 HubSpot 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.

L'image suivante présente un exemple de mise en page du volet de configuration du déclencheur HubSpot :

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur HubSpot 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 HubSpot 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 HubSpot

Vous pouvez modifier un déclencheur HubSpot 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 HubSpot, vous pouvez conserver l'abonnement aux événements précédemment configuré qui lui est associé 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 HubSpot :

1. Cliquez sur l'élément Déclencheur HubSpot dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer le déclencheur HubSpot.
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