Pour partager des données ClickUp avec des applications externes, vous pouvez utiliser deux types de Webhooks dans ClickUp :

1. Les Webhooks créés via l'API publique ClickUp.
2. Les Webhooks déclenchés par des Automatisations.

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

Webhooks d'API

Utilisez les Webhooks d'API lorsque vous souhaitez suivre globalement tous les événements de création, de mise à jour et de suppression pour les tâches, les Listes, les sous-dossiers, les Dossiers, les Espaces, les Objectifs et les cibles.

En savoir plus sur les Webhooks de l'API ClickUp, notamment :

• Consultez des exemples de charges utiles.
• Consultez la spécification des points de terminaison Webhook de l'API publique ClickUp.
• Envoyez votre première requête Créer un Webhook depuis votre navigateur.

Webhooks d'automatisation

Utilisez les Webhooks d'Automatisations lorsque vous souhaitez contrôler entièrement les Déclencheurs et les Conditions qui envoient vos données vers des applications externes.

Il existe deux types de Webhooks d'Automatisation que vous pouvez créer dans ClickUp :

• Webhooks de tâche : envoient des données lorsque des tâches sont mises à jour.
• Webhooks de Discussion : envoient des données lorsque des messages sont publiés dans le chat.

Créer un Webhook

Vous devez créer un Webhook pour chaque destination qui recevra des données ClickUp provenant des Automatisations.

Vous pouvez réutiliser les Webhooks créés dans les Automatisations dans tout votre Environnement de travail, mais vous devez configurer des Webhooks distincts pour les Automatisations de tâches et de Discussion.

Testez votre Webhook avant de l'ajouter aux Automatisations qui enverront de vraies données.

Utiliser des variables dynamiques dans votre Webhook

Les variables dynamiques dans l'URL permettent à votre application de traiter efficacement les données reçues depuis ClickUp.

Vous pouvez utiliser des variables dynamiques dans l'URL de votre Webhook, comme l'identifiant de tâche.

Utiliser des en-têtes

Les en-têtes peuvent contenir des métadonnées qui permettent à votre application de traiter les charges utiles des Webhooks entrants de manière sécurisée et précise. Par défaut, ClickUp inclut l'en-tête suivant :

Content-type: application/json

Utiliser des paramètres d'URL

Vous pouvez également définir des paramètres d'URL pour chaque Webhook afin d'aider votre application à traiter les données avec précision.

Contrairement aux variables dynamiques, les paramètres d'URL sont statiques. Les valeurs ne changent pas à chaque déclenchement de votre Automatisation.

Tester les Webhooks

Lorsque vous commencez à utiliser les Webhooks, nous vous recommandons de les tester avant d'envoyer de vraies données depuis votre Environnement de travail ClickUp.

Des outils gratuits sont disponibles en ligne pour tester vos Webhooks et expérimenter avec eux. Par exemple, vous pouvez utiliser webhook.site pour générer une URL de Webhook et visualiser les charges utiles envoyées depuis ClickUp.

Pour les Webhooks d'API :

• Filtrez votre premier Webhook sur des événements spécifiques, tels que taskCreated et taskUpdated.
• Filtrez votre premier Webhook sur un emplacement précis, par exemple une Liste dédiée contenant uniquement des tâches de test avec des données génériques mais représentatives.

Pour les Webhooks d'automatisation :

• Appliquez des Déclencheurs et des Conditions précis, par exemple un champ personnalisé de type Case à cocher pour contrôler le moment où les données sont envoyées.
• Ajoutez d'abord l'Automatisation à une Liste ou à un canal spécifique, avec des tâches et des messages génériques mais représentatifs.