Dernière mise à jour: juin 20, 2023
Disponible avec le ou les abonnements suivants, sauf mention contraire :
Operations Hub
Pro
,
Enterprise
|
Si vous utilisez les webhooks dans les workflows pour envoyer des requêtes POST ou GET depuis vos workflows, vous pouvez personnaliser vos webhooks pour contrôler les données envoyées et reçues.
Dans vos demandes POST, vous pouvez spécifier les propriétés envoyées à tout système externe, tel qu'un CRM. De même, dans vos requêtes GET, vous pouvez spécifier les propriétés demandées à l'aide de paramètres de requête.
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.
Veuillez noter : HubSpot réessayera les webhooks qui ont échoué pendant un maximum de trois jours, à partir d'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.
Configurer votre webhook
Pour créer et personnaliser vos webhooks :
- Dans votre compte HubSpot, accédez à Automatisations > 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. - Définissez votre type d'authentification pour authentifier les demandes adressées à votre webhook :
- Pour utiliser une signature de requête dans l'en-tête de 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.
- Puis, saisissez votre ID d'application HubSpot. Découvrez comment vérifier les signatures de demande.
- Pour utiliser une signature de requête dans l'en-tête de votre webhook :
-
- Vous pouvez également utiliser une clé API pour l'authentification. Lors de l'utilisation d'une clé d'API pour l'authentification, le nom de la clé d'API et son emplacement dépendent de la manière dont le webhook est configuré. Pour des raisons de sécurité, la clé d'API ne sera pas affichée dans les demandes de test. Pour utiliser une clé d'API :
- Cliquez sur le menu déroulant Type d'authentification. Sélectionnez ensuite la clé d'API.
- Vous pouvez également utiliser une clé API pour l'authentification. Lors de l'utilisation d'une clé d'API pour l'authentification, le nom de la clé d'API et son emplacement dépendent de la manière dont le webhook est configuré. Pour des raisons de sécurité, la clé d'API ne sera pas affichée dans les demandes de test. Pour utiliser une clé d'API :
-
-
- Saisissez le nom de votre clé d'API.
- Cliquez sur l'emplacement de la clé API dans le menu déroulant. Ensuite, sélectionnez Paramètres de demande ou En-tête de demande. En savoir plus sur l'utilisation des clés API dans HubSpot.
-
Personnaliser votre demande POST
Si vous configurez une requête POST, 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 recherche, sélectionnez Inclure toutes les propriétés.
- Pour inclure uniquement certaines propriétés :
- Dans la section Personnaliser le corps de la recherche, sélectionnez Sélectionner les propriétés spécifiques.
- Cliquez sur le menu déroulant Choisir une propriété. Ensuite, cliquez sur [objet] dans ce workflow et sélectionnez une propriété.
- Pour modifier le nom d'une propriété dans le webhook, modifiez le champ de texte Nom de la propriété. Cela mettra à jour uniquement le nom de la propriété dans la demande POST, et pas 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 Corbeille .
Personnaliser vos demandes GET
Si vous configurez une requête GET, vous pouvez utiliser des propriétés comme paramètres de requête pour récupérer des données spécifiques :- Dans la section Paramètres de demande, cliquez sur le menu déroulant Choisir une propriété. Ensuite, cliquez sur [objet] dans ce workflow et sélectionnez une propriété.
- Pour modifier le nom d'une propriété dans le paramètre de demande, modifiez le champ de texte Nom de la propriété. Cela mettra à jour uniquement le nom de la propriété dans la demande GET, et pas 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.
- Pour supprimer une propriété, cliquez sur l'icône Corbeille .
- Cliquez sur Enregistrer.
