Consultez la liste des connecteurs compatibles avec Application Integration.

Déclencheur HubSpot

Le déclencheur HubSpot est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration basée sur les événements HubSpot personnalisés que vous avez définis dans votre instance HubSpot.

Avant de commencer

Si vous envisagez de créer ou de configurer une connexion pour le déclencheur HubSpot, assurez-vous de disposer du rôle IAM (Identity and Access Management) suivant sur 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

Avec les abonnements webhook, vous pouvez sélectionner les événements que votre application peut recevoir. Les types d'abonnements suivants sont acceptés:

  • deal.creation
  • deal.propertyChange
  • deal.deletion
  • contact.creation
  • contact.propertyChange
  • contact.deletion
Pour obtenir la liste complète des types d'événements, consultez la section Abonnements au webhook.

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 Integrations (Intégrations).

    La page Liste des intégrations s'affiche. Elle 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.
    3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les détails du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de dans la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    La page de l'éditeur d'intégration s'affiche.

  4. Dans la barre de navigation de l'éditeur d'intégration, 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.
  6. Pour configurer le déclencheur HubSpot, vous pouvez soit utiliser une connexion HubSpot existante disponible dans Integration Connectors, soit créer une connexion HubSpot à 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. Par conséquent, vous ne pouvez utiliser une connexion HubSpot qu'avec un abonnement aux événements activé pour le configurer.

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énements de connecteur :
    1. Region (Région) : sélectionnez la région de votre connexion HubSpot.
    2. Connexion:sélectionnez la connexion HubSpot que vous souhaitez utiliser.

      Application Integration n'affiche que les connexions HubSpot qui sont actives et pour lesquelles un abonnement à un événement 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 compatibles, consultez Types d'événements compatibles.
    4. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur HubSpot.
  4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer le 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 Create Connection (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 la 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, saisissez un nom pour l'instance de connexion.

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

        • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
        • Les lettres doivent être en minuscules.
        • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
        • Les noms de connexion ne peuvent pas dépasser 63 caractères.
      4. Saisissez éventuellement une Description pour 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 à des événements, sélectionnez Activer l'abonnement aux événements. Si vous sélectionnez cette option, les options suivantes s'affichent :
        • 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 pour utiliser la connexion uniquement pour l'abonnement à des événements.

        Pour ces deux sélections, vous serez invité à configurer les détails de l'événement lors des étapes suivantes.

      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. Contacts Properties (Propriétés des contacts) : saisissez les noms de champs séparés par une virgule de l'entité Contacts que vous souhaitez sélectionner dans l'opération d'entité List. Par exemple : fieldA, fieldB, fieldC
      10. Sociétés: saisissez les noms de champs séparés par une virgule de l'entité Companies que vous souhaitez sélectionner dans l'opération d'entité List. Par exemple : fieldA, fieldB, fieldC
      11. Deals Properties (Propriétés des accords) : saisissez les noms des champs séparés par une virgule de l'entité Deals que vous souhaitez sélectionner dans l'opération d'entité List. Par exemple : fieldA, fieldB, fieldC
      12. Utiliser un proxy : cochez cette case pour configurer un serveur proxy pour la connexion.
      13. Proxy Auth Scheme (Schéma d'authentification du proxy) : type d'authentification à utiliser pour l'authentification auprès du proxy ProxyServer.
      14. Utilisateur proxy: nom d'utilisateur à utiliser pour s'authentifier auprès du proxy ProxyServer.
      15. Mot de passe proxy: mot de passe à utiliser pour s'authentifier auprès du proxy ProxyServer.
      16. Type SSL du proxy: type de SSL à utiliser lors de la connexion au proxy ProxyServer.
      17. Vous pouvez également configurer les paramètres du nœud 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. Un plus grand nombre de nœuds est nécessaire afin de traiter plus de transactions pour une connexion. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre l'impact des nœuds sur la tarification de votre connecteur, consultez la section 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 une meilleure disponibilité) et le nombre maximal sur 50.

      18. Vous pouvez également cliquer 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 les informations concernant 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 hôte ou d'un rattachement de service. Sélectionnez l'un des types de destination suivants :
        • Adresse 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 la page Publier des services gérés.

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

        Pour ajouter des destinations supplémentaires, 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.

        Les types d'authentification suivants sont compatibles avec la connexion HubSpot:

        • Private App Access Token (Jeton d'accès privé à l'application) : sélectionnez le secret Secret Manager contenant le jeton d'accès privé à l'application.

          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 propre à 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 la section Applications privées.

      2. Cliquez sur Suivant.
    5. Si vous avez activé les abonnements aux événements, la section Event Subscription Details (Détails des abonnements 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 client de votre application privée, ainsi que la version correspondante dans la liste déroulante Version du secret.
      2. Pour en savoir plus, consultez la section Applications privées.

      3. Sélectionnez Activer la connectivité privée pour une 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 la section Connectivité privée pour les abonnements à des événements.
      4. Saisissez la configuration de lettre morte. Si vous configurez des 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 lettre morte : ID du projet Google Cloud dans lequel vous avez configuré le sujet Pub/Sub de lettre morte.
        2. Sujet de lettre morte : le sujet Pub/Sub dans lequel vous souhaitez écrire les détails de l'événement non traité.
      5. Cliquez sur Suivant.
    6. Vérifiez vos informations de connexion et d'authentification.
    7. Cliquez sur Créer.

Créer et modifier des abonnements webhook

Pour terminer la configuration de l'abonnement à un événement, vous devez enregistrer l'URL de webhook dans votre application HubSpot. Par conséquent, une fois la connexion créée, effectuez les étapes supplémentaires suivantes:

  1. Accédez à la page d'informations de la connexion que vous venez de créer, puis copiez l'URL de webhook pour l'abonnement à l'événement. L'URL de webhook est requise lors de la création d'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 d'informations de la connexion HubSpot:

    image montrant la page d'informations de la connexion HubSpot image montrant la page d'informations de la connexion HubSpot
  2. Suivez la procédure pour créer et modifier des abonnements webhook dans HubSpot.

Sortie du déclencheur

Le déclencheur HubSpot prend quelques minutes pour terminer la configuration de l'abonnement à l'événement. Vous pouvez afficher l'état de votre abonnement à un événement dans le volet de configuration du déclencheur, sous Détails de l'abonnement à un événement.

Le déclencheur HubSpot indique l'état d'un abonnement à un événement selon les états suivants:

  • Creating: indique que le déclencheur s'abonne à l'abonnement à l'événement.
  • Active: indique que le déclencheur a bien été abonné à un abonnement à un événement.
  • Error: indique qu'il y a un problème avec l'abonnement à un événement configuré.

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

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

image montrant le volet de configuration d'un déclencheur HubSpot image montrant le volet de configuration d'un 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 à des événements

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

  1. Accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions).

    Accéder à la page "Connexions"

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

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

Modifier le déclencheur HubSpot

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

Pour modifier un déclencheur 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 HubSpot.
  3. Procédez comme suit sur la page Éditeur de déclencheur d'événements de connecteur :
    1. Pour conserver l'abonnement à un événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
    2. Mettez à jour la configuration de la connexion et les détails de l'abonnement à l'événement, comme vous le souhaitez.
    3. Cliquez sur OK.
  4. Vous pouvez afficher les détails de la connexion et de l'abonnement aux événements mis à jour dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.