Workflows

Comment utiliser les webhooks avec l'outil Workflows de HubSpot ?

Dernière mise à jour: July 7, 2017

Disponible avec :

Produit: HubSpot Marketing
Abonnement: Pro et Entreprise

Cet article s'adresse aux développeurs web qui souhaitent utiliser la fonctionnalité webhooks de l'outil Workflows pour transmettre des informations entre HubSpot et une autre application web.


Que sont les webhooks ?

Les webhooks servent à envoyer des données d'une application web à une autre dès qu'une action est effectuée dans l'application source. À l'image des e-mails, qui sont des messages envoyés entre deux êtres humains, les webhooks sont des messages transmis entre deux plateformes logicielles via une requête http. Vous pouvez les utiliser pour envoyer des données, notifications, alertes ou autres informations en temps réel. En bref, les webhooks sont une méthode vraiment très performante d'automatisation du marketing car ils permettent d'envoyer des données d'un système ou d'une application à un autre.

Cas d'utilisation fréquents et exemples

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 crée pour lui un essai du logiciel.

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

Comment configurer un webhook dans HubSpot ?

Créez votre workflow et ajoutez une action Déclencher un webhook.

GET - envoie une requête GET à l'URL indiquée

POST - envoie une requête POST (transmet des données) à l'URL indiquée

Image ajoutée par l'utilisateur
Choisissez la méthode HTTP voulue, puis ajoutez l'URL du webhook avec laquelle interagir.

Si les requêtes vers votre système nécessitent une authentification, cochez la case correspondante dans l'action et ajoutez un nom d'utilisateur ainsi que le mot de passe. Dans ce cas, l'agent de l'utilisateur recourt au titre de l'authentification. En règle générale, le nom d'utilisateur et le mot de passe sont combinés dans une chaîne ("username:password") qui est ensuite chiffrée (Basic Base64).

Comment tester votre webhook ?

Dès que vous avez créé un workflow avec une action webhook, vous pouvez le tester rapidement avec une fausse URL de webhook. Accédez au site http://requestb.in/ et créez une requête. Notez que le site est susceptible de tronquer les résultats s'ils dépassent un certain nombre de caractères. Utilisez cette URL comme l'URL de votre webhook dans votre action.

Image ajoutée par l'utilisateur
Inscrivez maintenant un contact en allant sur sa fiche d'informations personnelle > Workflows >Sélectionner un workflow actif > Inscrire le contact.

Voici un exemple de corps de requête pour le webhook ci-dessus, qui révèle des meta-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
Image ajoutée par l'utilisateur

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

Pour obtenir plus d'informations, consultez la documentation de référence sur les webhooks. Si vous avez des questions sur le processus de mise en place de vos webhooks avec HubSpot, veuillez les poser sur developers.hubspot.com/forum.