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

Utilisez les webhooks avec les workflows HubSpot

Dernière mise à jour: avril 15, 2019

Disponible avec :

Hub Marketing Enterprise
Hub Sales Enterprise
Hub Services Enterprise

Utilisez les webhooks dans les workflows pour transmettre des informations de HubSpot à une autre application web.

Remarque : Les licences utilisateur Hub Marketing Pro ou Hub Sales Pro achetés avant le 1er novembre 2018 auront un accès hérité à l'action de workflow Déclencher un webhook. 


Comprendre les webhooks

Les webhooks envoient des données d'une application web à une autre dès qu'une action a été réalisée dans l'application source. Vous pouvez les utiliser pour envoyer des données, notifications, alertes ou autres informations en temps réel.

Exemples d'utilisation fréquente de webhooks :

  • Poster les données d'un contact HubSpot dans un autre système, comme un CRM, dès qu'il remplit un formulaire précis de votre site.

  • Envoyer les données d'un contact à un système externe qui enclenche la période d'essai du logiciel sur l'appareil du contact.

  • Envoyer des alertes de chat entre votre système externe et le flux de chat de votre entreprise afin que vos salariés sachent que quelque chose d'important vient de se produire.

 

 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 de droite, sélectionnez Déclencher un webhook.
  • Saisir l'URL du webhook.

Remarque : les URL de webhook sont limitées à un protocole sécurisé et doivent commencer par HTTPS.

  • Cochez la case Utiliser la signature de requête pour authentifier toute demande à votre webhook et saisissez votre ID App. Découvrez comment vérifier les signatures de requête.
  • Cliquez sur Enregistrer.

Remarque : l'action Déclencher un webhook ne prend en charge que la méthode POST.

 

Testez votre webhook

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 créée automatiquement. Dans le champ URL du webhook dans l'action de votre webhook, collez l'URL.

Voici un exemple de corps de requête pour le webhook ci-dessus, qui révèle des méta-informations sur ce contact précis, comme ses coordonnées, les soumissions de formulaires, les abonnements à des listes, etc. Lorsque l'action du workflow est déclenchée, HubSpot envoie les données complètes de ce contact en format JSON à l'URL indiquée.

Image ajoutée par l'utilisateur

Le système destinataire peut ensuite analyser les données JSON et les utiliser pour sa propre application.

En savoir plus 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.

 

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

Une fois que vous avez sélectionné signature de requête 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é. En savoir plus sur ce point dans la documentation des développeurs.

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