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: janvier 3, 2019

Disponible avec :

Marketing Hub Enterprise
Sales Hub Enterprise
Services Hub Enterprise

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

Remarque : les utilisateurs qui ont acheté Hub Marketing Pro ou Hub Sales Pro avant le 1er novembre 2018 bénéficient d'un accès à l'action de workflow Déclencher un webhook. Les utilisateurs, après le 1er novembre 2018, devront acheter Hub Marketing Entreprise ou Hub Sales Entreprise pour bénéficier d'un accès à l'action de workflow Déclencher un webhook.

Qu'est-ce qu'un webhook ?

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. 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 basé sur un contact

Ces étapes s'appliquent uniquement aux workflows basés sur les contacts.

  • Depuis votre compte HubSpot, accédez à Automatisation > Workflows.
  • Cliquez sur le nom du workflow basé sur le contact.
  • Cliquez sur l' icône plus (+) pour ajouter une action.
  • Dans la fenêtre droite, cliquez sur Déclencher un webhook.
  • Cliquez sur le menu déroulant Méthode et sélectionnez GET ou POST.
    • GET - envoie une requête GET à l'URL indiquée.
    • POST - envoie une requête POST (transmet des données) à l'URL indiquée.
  • Saisir l'URL du webhook.

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

  • Si la demande à votre système nécessite une authentification, sélectionnez la case Utiliser l'authentification ? et ajoutez un nom d'utilisateur et un mot de passe.
  • Cliquez sur Enregistrer.

Configurer un webhook dans d'autres types de workflows

Ces étapes s'appliquent aux workflows basés sur des entreprises, basés sur la transaction, basés sur les tickets et basés sur les devis.

  • Depuis votre compte HubSpot, accédez à Automatisation > Workflows.
  • Cliquez sur le nom du workflow basé sur une entreprise, basé sur une transaction, basé sur un ticket ou basé sur un devis pour le modifier.
  • Cliquez sur l' icône + pour ajouter une action et dans la bonne fenêtre, cliquez sur 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.

  • Cliquez sur Enregistrer.

Remarque : l'action Déclencher un webhook dans les workflows basés sur une entreprise, une transaction, un ticket ou un devis prend en charge uniquement 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://webhok.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
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.