Définir des déclencheurs de workflow « Lorsqu’un webhook est reçu »

Définissez des critères d’inscription pour inscrire automatiquement des fiches d’informations dans un workflow lorsqu’un webhook provient d’un tiers externe. Découvrez-en davantage sur la configuration de votre inscription dans un workflow.

Pour déclencher un workflow à partir d'un webhook :

1. Depuis votre compte HubSpot, accédez à Automatisation > Workflows.
2. Cliquez sur le nom d'un workflow existant ou créez un nouveau workflow.
3. Si vous créez un workflow à partir de zéro :
   • Dans le panneau de gauche, cliquez pour développer la section Événements & externes personnalisés .
   • Cliquez sur A reçu un webhook d’une application externe. 
4. Si vous travaillez sur un workflow existant :
   • Dans l’éditeur de workflow, cliquez sur la carte Déclencher l’inscription pour [objet].
   • S’il existe des déclencheurs de workflow, dans le panneau de gauche, cliquez sur Modifier le déclencheur de démarrage. Cette action effacera tous les déclencheurs d’inscription actuels.
   • Dans la boîte de dialogue, cliquez sur Confirmer.

1. • Dans le panneau de gauche, sous Options avancées, cliquez sur Lorsqu’un webhook est reçu.
2. Pour ajouter un nouveau webhook, cliquez sur + Ajouter un webhook . Vous pouvez créer jusqu’à 100 événements webhook uniques.
   
   

6. Ajoutez un nom d’événement Webhook. Cliquez ensuite sur Suivant.
7. Copiez l'URL du webhook et collez-la dans la page Paramètres de webhook de l'application que vous souhaitez intégrer. Depuis votre application, utilisez l’URL du webhook pour envoyer un événement de test.
   
    
   
    
8. Dans la section Vérifier votre événement de test, consultez l'événement webhook et modifiez-le si nécessaire. Cliquez ensuite sur Suivant.
9. Mappez les données pour les propriétés de votre webhook :
   • Modifiez le libellé de la propriété HubSpot si nécessaire.
   • Cliquez sur le menu déroulant Type de données pour sélectionner un type de données pour chaque libellé de propriété.
     • Vous pouvez utiliser des valeurs de chaîne, d'énumération, de nombre et un booléen.
     • Les propriétés de date et d'heure ne sont pas prises en charge et doivent être mappées en tant que valeurs de chaîne à la place. Ensuite, vous pouvez utiliser une action de code personnalisé avec strtotime pour convertir en objet date-heure, puis utiliser unixtimestamp pour obtenir un horodatage. 
   • Pour supprimer un libellé de propriété, cliquez sur l'icône Supprimer l'icône.
10. Cliquez sur Suivant.
11. Faites correspondre votre propriété d'inscription en sélectionnant une propriété de votre webhook tiers qui correspond exactement à l'une de vos propriétés personnalisées HubSpot. Cliquez ensuite sur Suivant. 
    
    • Le workflow ne peut être déclenché que si la propriété du webhook tiers sélectionnée a une valeur non nulle dans les données du webhook entrant.
    • La case à cocher Exiger des valeurs uniques pour la propriété personnalisée doit être cochée. Autrement, créez une nouvelle propriété avec une valeur unique requise. 
12. Cliquez sur Poursuivre la configuration du critère d'inscription.
13. Pour utiliser le webhook comme critère d'inscription, cliquez sur le nom du webhook dans le panneau de gauche. Cliquez ensuite sur Enregistrer.