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: mars 16, 2022

Disponible avec :

Operations Hub Pro, Entreprise

Utilisez les webhooks dans des workflows pour envoyer des demandes POST ou GET depuis vos workflows.  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. 

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, ajoutez des paramètres de demande à l'URL du Webhook. Si aucun paramètre de demande n'a été ajouté, une demande POST ou GET générique sera envoyée.  
  • Pour authentifier toutes les demandes à votre webhook :
    • Cliquez sur le menu déroulant Type d'authentification, puis sélectionnez Inclure une signature de requête dans l'en-tête.
    • Saisissez votre ID d'application HubSpot. Découvrez comment vérifier les signatures de demande.
  • 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. 

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.