Utilisez le Déclencheur Webhook reçu pour lancer une Automatisation ClickUp lorsqu'une application externe envoie une requête. Des applications comme Stripe, GitHub ou une intégration personnalisée peuvent envoyer des données dans ClickUp pour déclencher votre Automatisation, sans passer par un connecteur tiers.

Si vous souhaitez qu'une Automatisation démarre depuis une application externe, utilisez le Déclencheur Webhook reçu. Ce Déclencheur lance une Automatisation standard ou une Automatisation Discussion lorsqu'une application externe envoie une requête POST à ClickUp. Pour envoyer des données hors de ClickUp, utilisez plutôt l'Action Appeler un webhook.

Le Déclencheur Webhook reçu est disponible à partir du plan Business. La disponibilité des fonctionnalités et les limites varient selon le plan et le rôle de l'utilisateur. En savoir plus

Qu'est-ce que le Déclencheur Webhook reçu ?

Le Déclencheur Webhook reçu permet à une application externe d'envoyer des informations dans ClickUp pour lancer une Automatisation.

Les informations envoyées par l'application externe constituent la charge utile (payload). ClickUp génère une URL unique pour chaque Automatisation utilisant ce Déclencheur. Lorsqu'une application envoie une requête POST à cette URL, l'Automatisation s'exécute.

Chaque URL est associée à une seule Automatisation et n'expire pas.

Activer le ClickApp Webhook reçu

Avant que les administrateurs puissent créer des Automatisations avec ce Déclencheur, le ClickApp doit être activé :

1. Dans le coin supérieur gauche, cliquez sur le nom de votre Environnement de travail et sélectionnez Applications.
2. Recherchez Webhook reçu et activez le bouton bascule correspondant.

Fonctionnement de l'authentification

ClickUp crée une clé API pour votre Environnement de travail. Toutes les URL de webhook de l'Environnement de travail utilisent cette même clé API. Envoyez la clé API dans l'en-tête d'autorisation de chaque requête adressée à l'URL du webhook. Les requêtes sans clé API valide sont rejetées.

Par défaut, seuls les propriétaires et les administrateurs de l'Environnement de travail peuvent consulter la clé API.

Dans la section Déclencheur, utilisez Afficher pour consulter la clé API ou Copier pour la copier. Vous pouvez également retrouver la clé API sous la carte du ClickApp Webhook reçu et utiliser Afficher ou Copier depuis cet emplacement.

Créer une Automatisation avec le Déclencheur Webhook reçu

Depuis un Espace, un Dossier, un sous-dossier, une Liste ou un canal Discussion :

1. Dans le coin supérieur droit, cliquez sur l'icône robot.
2. Cliquez sur Créer une automatisation.
3. Sélectionnez le Déclencheur Webhook reçu. Une URL de webhook unique est générée et la clé API de votre Environnement de travail s'affiche.
4. Cliquez sur Copier en regard de URL du webhook pour copier l'URL. Cliquez sur Copier en regard de Clé API pour copier la clé.
5. Dans Charge utile d'exemple, collez un exemple de corps JSON. ClickUp transforme ses champs en variables que vous pouvez insérer dans les Actions ci-dessous.
6. Choisissez une Action disponible.
7. Cliquez sur Créer.
8. Pour exécuter l'Automatisation, envoyez une requête POST à l'URL du webhook.
9. Envoyez la clé API en tant que valeur brute dans l'en-tête Authorization. Une requête valide renvoie 202.
10. Dans la section Déclencheur, cliquez sur Régénérer en regard de URL du webhook pour créer une nouvelle URL. L'ancienne URL cesse de fonctionner et renvoie 404.

Les requêtes entrantes sont limitées à 1 Mo. Le débit est limité à 60 requêtes par minute par jeton API et à 200 par minute par Environnement de travail.

Effectuer une rotation de la clé API

Pour effectuer une rotation de la clé API de l'Environnement de travail :

1. Dans le coin supérieur gauche, cliquez sur le nom de votre Environnement de travail et sélectionnez Applications.
2. Recherchez et sélectionnez Webhook reçu.
3. Sous Clé API, cliquez sur Rotation.
4. La nouvelle clé s'applique à toutes les URL de webhook de l'Environnement de travail. L'ancienne clé renvoie 401 pour chaque URL.

Mettez à jour la clé API dans chaque application externe qui envoie des requêtes à l'Environnement de travail.