Créez une Automatisation avec un Webhook pour communiquer avec une application intégrée externe lorsqu'un événement spécifique se produit dans une tâche ClickUp.

Cet article traite de l'envoi de données par ClickUp via l'Action Appeler le webhook. Pour qu'une application externe déclenche une Automatisation dans ClickUp, utilisez le Déclencheur Webhook reçu.

Consultez notre article Créer une Automatisation avec un Webhook Discussion pour en savoir plus sur nos Webhooks Discussion.

La disponibilité des fonctionnalités et les limites varient selon le forfait et le rôle de l'utilisateur. En savoir plus

Que sont les Webhooks ?

Les Webhooks sont un moyen automatisé d'envoyer des informations depuis ClickUp vers vos intégrations et autres systèmes.

Plutôt que de solliciter les informations auprès de ClickUp, les Webhooks les envoient de façon proactive pour maintenir les données à jour dans les autres systèmes.

Les informations envoyées par ClickUp lorsqu'un Webhook est déclenché, ou appelé, constituent ce qu'on appelle le payload.

Pour les Webhooks de tâches, le payload contient des informations sur la tâche qui a déclenché l'Automatisation dans ClickUp.

Vous pouvez également configurer des Webhooks via notre API publique.

Actions Appeler le webhook

Depuis un Espace, un Dossier, un sous-dossier ou une Liste dans ClickUp, vous pouvez créer une Automatisation déclenchée par l'activité d'une tâche qui appelle un Webhook en tant qu'Action d'Automatisation.

Le tableau suivant décrit les Actions disponibles :

Chaque action possède un payload différent. Nous vous recommandons d'utiliser l'action Appeler le webhook pour toute nouvelle intégration que vous créez.

Utiliser des en-têtes et des paramètres d'URL

Utilisez des en-têtes et des paramètres d'URL pour définir les détails du Webhook, par exemple :

• L'emplacement ClickUp depuis lequel le Webhook est envoyé
• Le point de terminaison de l'application externe
• Ou le type de média du corps de la requête

Les en-têtes d'URL sont sensibles. Une fois enregistrés, vous ne pouvez plus consulter leurs valeurs pour les modifier.

Voici les en-têtes que nous mettons à disposition, ainsi que quelques conseils pour créer des en-têtes personnalisés :

Créer un Webhook sans créer d'Automatisation

Pour créer un Webhook avant de configurer une Automatisation, depuis un Espace, un Dossier, un sous-dossier ou une Liste :

1. En haut à droite, cliquez sur l'icône robot.
2. Cliquez sur Gérer les Automatisations.
3. Cliquez sur l'onglet Webhooks.
4. Cliquez sur Créer un webhook.
5. Saisissez un titre unique.
6. Ajoutez une description.
7. Saisissez l'URL de votre Webhook.
8. Sélectionnez les champs dynamiques à inclure dans l'URL.
9. Ajoutez des en-têtes personnalisés :
   • Par défaut, les en-têtes du Webhook incluent Content-type=application/json.
   • Cliquez sur Ajouter pour ajouter d'autres paires clé-valeur.
10. Ajoutez des paramètres d'URL personnalisés facultatifs :
    • Saisissez une clé et une valeur pour ajouter des paramètres d'URL personnalisés.
    • Cliquez sur Ajouter pour ajouter d'autres paires clé-valeur.
11. Cliquez sur Tester le webhook pour envoyer un exemple de payload.
12. Cliquez sur Créer un webhook.

Utiliser un Webhook existant dans une Automatisation

Pour créer une Automatisation à partir d'un Webhook existant, depuis un Espace, un Dossier, un sous-dossier ou une Liste :

1. En haut à droite, cliquez sur l'icône robot.
2. Cliquez sur Créer une Automatisation.
3. Sélectionnez l'Action Appeler le webhook.
4. Sélectionnez votre Webhook dans la liste déroulante.
5. Cliquez sur Créer.

Créer un Webhook via l'action Appeler le webhook

Pour créer un Webhook lors de la création d'une Automatisation, depuis un Espace, un Dossier, un sous-dossier ou une Liste :

1. En haut à droite, cliquez sur l'icône robot.
2. Cliquez sur Créer une Automatisation.
3. Sélectionnez l'Action Appeler le webhook.
4. Cliquez sur Créer un webhook.
5. Saisissez un titre unique.
6. Ajoutez une description.
7. Saisissez l'URL de votre Webhook.
8. Sélectionnez les champs dynamiques à inclure dans l'URL.
9. Dans la section En-têtes, le type de contenu est défini par défaut sur application/json.
   • Pour ajouter un en-tête personnalisé, cliquez sur +Ajouter et saisissez une clé et une valeur.
10. Dans la section Paramètres d'URL, saisissez une clé et une valeur pour ajouter des paramètres personnalisés.
11. Cliquez sur Tester le webhook pour envoyer un exemple de payload avant d'activer votre Webhook.
12. Cliquez sur Créer un webhook.
13. Terminez la configuration du Déclencheur, des Conditions et des autres Actions de votre Automatisation.
14. Cliquez sur Créer.

Tester votre Webhook

Après avoir créé un Webhook, vous pouvez le tester, le modifier, le supprimer ou le désactiver depuis l'onglet Webhooks :

1. Pointez sur le Webhook et cliquez sur Tester.
2. Un message s'affiche pour indiquer si le test a réussi ou échoué.

Si le test échoue

Si le test échoue, vérifiez que l'application externe est opérationnelle. Si elle est indisponible, nous pouvons bloquer l'appel du Webhook pour des raisons de sécurité.

Si le test réussit

Si le test réussit, vous pouvez activer le Webhook en toute confiance et commencer à l'utiliser dans vos Automatisations !

Échec d'un appel de Webhook

Si votre Webhook est actif et qu'un appel échoue, nous réessayons pendant 1 heure et 15 minutes. Durant cette période, l'appel apparaît dans votre onglet Activité des Automatisations avec le statut en attente.

Désactiver le Webhook

Après l'activation d'un Webhook de tâche, vous pouvez le rendre inactif.

Depuis l'onglet Webhooks, cliquez sur le bouton bascule pour rendre un Webhook existant inactif.

Toutes les Automatisations utilisant ce Webhook seront également désactivées.

Utiliser l'action Appeler le webhook (Legacy)

Pour utiliser l'Action Appeler le webhook (Legacy), depuis un Espace, un Dossier, un sous-dossier ou une Liste :

1. En haut à droite, cliquez sur l'icône robot.
2. Cliquez sur Créer une Automatisation.
3. Sélectionnez l'Action Appeler le webhook (Legacy).
4. Saisissez l'URL de votre Webhook.
5. Sélectionnez les champs dynamiques à inclure dans l'URL.
6. Cliquez sur Créer.