Créez une Automatisation de Webhook de Discussion pour communiquer avec une application externe intégrée lorsqu'un événement spécifique se produit dans ClickUp. Par exemple, lorsqu'un message de Discussion est publié dans un Channel particulier, il est également publié automatiquement dans Zapier ou Make.

Vous pouvez également utiliser des webhooks avec les Automatisations de tâches.

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

Utiliser les déclencheurs, les actions, les en-têtes d'URL et les paramètres d'Automatisation

Les déclencheurs sont des événements qui démarrent une Automatisation.

Le message est publié est le seul déclencheur de webhook de Discussion.

Les actions sont les événements que l'Automatisation déclenche après avoir été activée. Pour appeler un webhook, utilisez l'action Appeler le webhook.

Utilisez les en-têtes et 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.

Créer une Automatisation de Webhook de Discussion

Pour créer une Automatisation de Webhook de Discussion, depuis un channel :

1. En haut à droite, cliquez sur l'icône robot.
2. Cliquez sur Créer une Automatisation.
3. Configurez votre déclencheur, vos conditions et vos actions :
   • Sélectionnez l'action Appeler le webhook.
   • Sélectionnez un webhook existant ou Créer un webhook :
   • Donnez un nom à votre webhook et ajoutez une description facultative.
   • Saisissez l'URL de votre webhook.
   • Sélectionnez les champs dynamiques suivants pour les inclure dans l'URL.
   • ID de commentaire : ajoutez l'ID du commentaire de Discussion individuel.
   • ID de channel : ajoutez l'ID du Channel de Discussion.
   • Ajoutez des en-têtes personnalisés facultatifs :
   • Cliquez sur Ajouter, puis saisissez une clé et une valeur.
   • Par défaut, les en-têtes du webhook incluent Content-type=application/json.
   • 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.
4. Cliquez sur Créer un webhook.

Tester une Automatisation de Webhook de Discussion

Après avoir créé le webhook, vous pouvez le tester depuis ClickUp.

Pour tester une Automatisation de Webhook de Discussion :

1. Juste après avoir créé le webhook, dans le coin supérieur gauche de la fenêtre modale d'Automatisation, cliquez sur le chevron. Ou, depuis un channel :
   • Cliquez sur l'icône robot.
   • Sélectionnez Gérer les Automatisations de Discussion.
   • Cliquez sur l'onglet Webhooks.
2. Survolez le webhook et cliquez sur Tester.
   • Un message s'affiche pour indiquer si le test a réussi ou échoué.

Si le test échoue

Vous pouvez vérifier si l'application externe est opérationnelle. Si elle est hors service, 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 de Discussion dans une Automatisation.

Créer une Automatisation de Discussion avec un webhook existant

Après avoir testé le webhook de Discussion, vous allez l'activer dans votre Environnement de travail.

Pour activer le webhook de Discussion :

1. Juste après avoir testé le webhook, dans la fenêtre modale des Automatisations, sélectionnez l'onglet Gérer.
2. Cliquez sur Ajouter une Automatisation.
3. Configurez votre déclencheur, vos conditions et vos actions :
   • Sélectionnez l'action Appeler le webhook.
   • Sélectionnez votre webhook.
4. Cliquez sur Créer.

Échec d'un appel de webhook

Si votre webhook est actif et qu'un appel échoue lors de la première tentative, nous réessayons pendant 1 heure et 15 minutes. Pendant ce temps, l'appel apparaît dans votre onglet Activité des Automatisations avec le statut En attente.

Désactiver le webhook de Discussion

Une fois le webhook de Discussion activé, vous pouvez le rendre inactif.

Pour désactiver le webhook de Discussion, depuis un channel :

1. En haut à droite, cliquez sur l'icône robot.
2. Sélectionnez Gérer les Automatisations de Discussion.
3. Cliquez sur l'onglet Webhooks.
4. À droite de votre webhook, cliquez sur le bouton bascule pour le désactiver.
5. Lisez l'avertissement indiquant que les Automatisations utilisant ce webhook seront également désactivées.
6. Cliquez sur Désactiver.
7. Le webhook de Discussion apparaît désormais dans l'onglet Inactif.

Pour réactiver le webhook de Discussion, ouvrez l'onglet Inactif et cliquez sur le bouton bascule pour l'activer.

Clés et valeurs d'en-tête

Voici les en-têtes disponibles ainsi que quelques conseils pour créer des en-têtes personnalisés :