Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.
Workflows

Utiliser des webhooks avec les workflows HubSpot

Dernière mise à jour: août 22, 2022

Disponible avec :

Operations Hub Pro, Entreprise

Utilisez les webhooks dans les workflows pour envoyer ou récupérer des informations entre HubSpot et d'autres outils externes. Les webhooks peuvent être utilisés de diverses manières. Les cas d'utilisation les plus fréquents incluent :

  • Publication des données d'un contact HubSpot dans un autre système, comme un CRM, lorsque ce contact remplit un formulaire précis de votre site.

  • Envoi des données de transaction à un système de gestion des envois externe pour créer un bon de commande.

  • Envoi d'alertes sur le chat depuis votre système externe vers le flux de chat de votre entreprise afin que vos salariés soient informés des événements importants.

  • Récupération des données d'un autre système pour mettre à jour vos fiches d'informations HubSpot. 

Vous pouvez envoyer à la fois des requêtes POST et GET à l'aide des workflows. HubSpot régule le trafic des webhooks séparément des autres processus de workflow, afin de simplifier le workflow et les performances des webhooks. Lorsqu'un webhook est lent ou expire, l'exécution de l'action du workflow peut prendre plus de temps que prévu.

Remarque : HubSpot réessayera les webhooks ayant échoué pendant trois jours maximum, en commençant une minute après l'échec. Les tentatives après les échecs ultérieurs seront effectuées à intervalles croissants, avec un écart maximum de huit heures entre les tentatives. Découvrez-en davantage sur les exceptions de code d'erreur dans la documentation des développeurs de HubSpot.

Découvrez-en davantage sur les webhooks dans la documentation sur les webhooks pour les développeurs. Si vous avez des questions concernant la mise en œuvre spécifique des webhooks avec HubSpot, contactez les Forums des développeurs de HubSpot.

 Configurer un webhook dans un workflow

  • Depuis votre compte HubSpot, accédez à Automatisation > Workflows.
  • Cliquez sur le nom du workflow.
  • Cliquez sur l' icône plus (+) pour ajouter une action.
  • Dans le volet droit, sélectionnez Envoyer un webhook.
  • Cliquez sur le menu déroulant Méthode, puis sélectionnez POST ou GET
  • Saisir l'URL du webhook. Les URL de webhook sont soumises à un protocole sécurisé et doivent commencer par HTTPS. Pour demander des informations spécifiques,  vous pouvez ajouter des paramètres de requête tels que ?queryparameter =abc à l'URL Webhook. Si aucun paramètre de demande n'a été ajouté, une demande POST ou GET générique sera envoyée.  
  • Configurez votre type d'authentification pour authentifier les requêtes à votre webhook : 
    • Pour utiliser une signature de requête dans l'en-tête de votre webhook : 
      • Cliquez sur le menu déroulant Authentification type (Type d'authentification). Sélectionnez ensuite Inclure la signature de la demande dans l'en-tête.
      • Ensuite, saisissez votre ID d'application HubSpot. Découvrez comment vérifier les signatures de demande.
    • Vous pouvez également utiliser une clé d'API pour l'authentification. Lors de l'utilisation d'une clé d'API pour l'authentification, le nom de la clé d'API et l'emplacement de la clé d'API utilisés dépendent de la façon dont le webhook est configuré. Pour des raisons de sécurité, la clé d'API ne s'affichera dans aucune requête de test. Pour utiliser une clé d'API : 
      • Cliquez sur le menu déroulant Authentification type (Type d'authentification). Ensuite, sélectionnez la clé API
      • Entrez votre nom de clé d'API.
      • Cliquez sur le menu déroulant Emplacement de la clé API (API key location) (emplacement de la clé API Ensuite, sélectionnez Paramètres de requête ou En-tête de requête. Découvrez-en davantage sur l'utilisation des clés API dans HubSpot.
  • Si vous configurez une demande de PUBLICATION, vous pouvez choisir d'inclure toutes les propriétés de l'enregistrement CRM ou de n'envoyer que des propriétés spécifiques :
    • Pour inclure toutes les propriétés, dans la section Personnaliser le corps de la requête, sélectionnez Inclure toutes les propriétés.  
    • Pour inclure uniquement des propriétés spécifiques : 
      • Dans la section Personnaliser le corps de la demande, sélectionnez Choisir des propriétés spécifiques.
      • Cliquez sur le menu déroulant Choisir un bien immobilier (Menu déroulant Choisir un bien immobilier). Ensuite, cliquez sur [objet] dans ce flux de travail et sélectionnez une propriété.
      • Pour modifier le nom d'une propriété dans le webhook, modifiez le champ de texte Nom de propriété. Cela mettra uniquement à jour le nom de la propriété dans la requête POST, il ne mettra pas à jour le nom de la propriété ou le nom interne dans HubSpot.  
      • Pour ajouter une autre propriété, cliquez sur Ajouter une propriété.
      • Pour supprimer une propriété, cliquez sur l'icône delete trash
           


  • Si vous configurez une requête GET, vous pouvez utiliser les propriétés en tant que paramètres de requête & # 160 ; : & # 160 ; : & # 160 ; : & # 160 ; : & # 
    • Dans la section Paramètres de la requête, cliquez sur le menu déroulant Choisir une propriété. Ensuite, cliquez sur [objet] dans ce flux de travail et sélectionnez une propriété.
    • Pour modifier le nom d'une propriété dans le paramètre de requête, modifiez le champ de texte Nom de propriété. Cela mettra uniquement à jour le nom de la propriété dans la requête GET, il ne mettra pas à jour le nom de la propriété ou le nom interne dans HubSpot.  
    • Pour ajouter une autre propriété, cliquez sur Ajouter un paramètre de requête, puis cliquez sur Ajouter un paramètre de requête (Add query
    • Pour supprimer une propriété, cliquez sur l'icône delete trash.     
  • Cliquez sur Enregistrer.



Personnaliser VOTRE DEMANDE

Si vous configurez une demande de PUBLICATION, vous pouvez choisir d'inclure toutes les propriétés de l'enregistrement CRM ou de n'envoyer que des propriétés spécifiques :

  • Pour inclure toutes les propriétés, dans la section Personnaliser le corps de la requête, sélectionnez Inclure toutes les propriétés.  
  • Pour inclure uniquement des propriétés spécifiques : 
    • Dans la section Personnaliser le corps de la demande, sélectionnez Choisir des propriétés spécifiques.
    • Cliquez sur le menu déroulant Choisir un bien immobilier (Menu déroulant Choisir un bien immobilier). Ensuite, cliquez sur [objet] dans ce flux de travail et sélectionnez une propriété.
    • Pour modifier le nom d'une propriété dans le webhook, modifiez le champ de texte Nom de propriété. Cela mettra uniquement à jour le nom de la propriété dans la requête POST, il ne mettra pas à jour le nom de la propriété ou le nom interne dans HubSpot.  
    • Pour ajouter une autre propriété, cliquez sur Ajouter une propriété.
    • Pour supprimer une propriété, cliquez sur l'icône delete trash
         


Personnaliser vos demandes GET

Si vous configurez une requête GET, vous pouvez utiliser les propriétés en tant que paramètres de requête pour récupérer des données spécifiques : 

  • Dans la section Paramètres de la requête, cliquez sur le menu déroulant Choisir une propriété. Ensuite, cliquez sur [objet] dans ce flux de travail et sélectionnez une propriété.
  • Pour modifier le nom d'une propriété dans le paramètre de requête, modifiez le champ de texte Nom de propriété. Cela mettra uniquement à jour le nom de la propriété dans la requête GET, il ne mettra pas à jour le nom de la propriété ou le nom interne dans HubSpot.  
  • Pour ajouter une autre propriété, cliquez sur Ajouter un paramètre de requête, puis cliquez sur Ajouter un paramètre de requête (Add query
  • Pour supprimer une propriété, cliquez sur l'icône delete trash.     
  • Cliquez sur Enregistrer.

Tester votre webhook dans HubSpot

Lorsque vous configurez votre webhook POST ou GET, vous pouvez exécuter un test pour visualiser la réponse du webhook. Pendant le test, alors que les données sont envoyées et récupérées par un tiers, les fiches d'informations existantes dans HubSpot ne seront pas affectées. Si vous utilisez une clé API pour l'authentification, la clé API ne s'affichera pas dans les requêtes de test.

Après avoir testé votre webhook, vous pouvez sélectionner les champs de résultat à utiliser comme entrées plus tard dans votre workflow. Sélectionnez uniquement les résultats disponibles dans chaque réponse. Si le résultat est utilisé dans une action ultérieure mais n'est pas disponible dans la réponse, l'action échouera.   

  • Dans le panneau latéral, cliquez sur Tester l'action pour développer la section. 
  • Cliquez sur le menu déroulant Objet, puis sélectionnez une Fiche d'informations à tester.
  • Cliquez sur Tester
  • Pour vérifier les détails du webhook, sélectionnez l'onglet Réponse ou Demande. Dans chaque onglet, vous pouvez cliquer sur Tout ouvrir pour développer toutes les sections ou sur Tout réduire pour réduire toutes les sections.
    • Dans l'onglet Réponse, cliquez sur headers: ou body: pour développer chaque section. 
    • Dans l'onglet Demande, cliquez sur httpHeaders: pour développer la section.

Tester votre webhook en externe

Après avoir créé un workflow avec une action webhook, vous pouvez effectuer un test rapide avec une URL de webhook.

  • Dans votre navigateur, accédez à https://webhook.site et copiez l'URL unique.
  • Dans le champ URL du webhook dans l'action de votre webhook, collez l'URL.

Si une action de webhook avec une demande POST est déclenchée, un corps de réponse JSON sera envoyé au webhook contenant toutes les informations sur le contact, y compris les soumissions de formulaires, les abonnements et toutes les valeurs des propriétés de contact. Le système destinataire peut ensuite analyser les données JSON et les utiliser pour sa propre application.

Si une action de webhook avec une demande GET est déclenchée, une demande GET générique sera envoyée, sauf si des paramètres de demande supplémentaires ont été appliqués.   

Remarque : L'historique des valeurs d'une propriété ne sera renvoyé que dans les workflows basés sur les contacts. Les webhooks utilisés dans tous les autres types de workflows renverront uniquement la valeur la plus récente.

Vérifier les signatures de demande dans les webhooks de workflows

Une fois que vous avez sélectionné Signature de demande dans la section Authentification pour votre action Déclencher un webhook, HubSpot remplira le webhook avec un en-tête X-HubSpot-Signature, avec une fonction de hachage SHA-256 de concaténation de l'app-secret pour votre application, la méthode HTTP, l'URI et le corps non analysé. Découvrez-en davantage sur ce point dans la documentation des développeurs.

Pour vérifier que les demandes reçues à votre URL proviennent de HubSpot :

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.