Connecter ClickUp
À quoi sert cette connexion ?
Section intitulée « À quoi sert cette connexion ? »ClickUp permet à ELChat de parcourir les espaces et listes, consulter les tâches, en créer, changer leur statut et ajouter des commentaires.
Ce dont vous avez besoin
Section intitulée « Ce dont vous avez besoin »ELChat demande un jeton API personnel ClickUp. Ce jeton représente votre utilisateur et hérite de ses droits. Exemple fictif : pk_xxxxxxxxxxxxxxxxxxxxx.
La documentation officielle ClickUp réserve le jeton personnel à un usage personnel/interne ; OAuth est recommandé pour une application utilisée par plusieurs comptes. ELChat implémente ici le jeton personnel.
Obtenir le jeton
Section intitulée « Obtenir le jeton »- Connectez-vous à ClickUp avec le compte qui accède aux workspaces souhaités.
- Ouvrez vos Réglages personnels.
- Accédez à Apps.
- Dans API Token, cliquez sur Generate ou copiez le jeton existant.
- Conservez-le comme un mot de passe.
Connecter et vérifier
Section intitulée « Connecter et vérifier »- Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
- Cliquez sur Connecter sur la carte ClickUp.
- Collez le jeton API personnel et validez.
- Demandez à ELChat de lister les workspaces accessibles.
- Choisissez ensuite un espace ou dossier, listez ses listes, puis contrôlez une tâche connue.
ELChat ne demande pas d’ID dans le formulaire : il découvre d’abord les workspaces, puis utilise les IDs des espaces, dossiers, listes et tâches retournés par ClickUp.
Capacités disponibles
Section intitulée « Capacités disponibles »| Capacité réelle | Type |
|---|---|
| Lister les workspaces accessibles | Lecture |
| Lister les listes d’un espace ou dossier | Lecture |
| Lister les tâches d’une liste, avec filtre de statut | Lecture |
| Consulter le détail d’une tâche | Lecture |
| Créer une tâche dans une liste | Écriture |
| Changer le statut d’une tâche | Écriture |
| Ajouter un commentaire | Écriture |
ELChat ne supprime pas de tâche et ne gère pas les documents, tableaux de bord, temps suivi ou automatisations ClickUp.
Reconnecter, déconnecter et dépanner
Section intitulée « Reconnecter, déconnecter et dépanner »Générez un nouveau jeton, reconnectez, testez Lister les workspaces, puis révoquez l’ancien. La désactivation ELChat n’invalide pas le jeton dans ClickUp.
- Aucun workspace : le propriétaire du jeton n’appartient à aucun workspace accessible.
- Liste introuvable : vérifiez l’espace ou le dossier choisi.
- Statut refusé : le nom doit correspondre exactement à un statut configuré dans la liste.
- Erreur 429 : attendez la réinitialisation ; les limites ClickUp varient selon le forfait.
Sécurité
Section intitulée « Sécurité »Le jeton personnel peut agir sur tout ce que voit l’utilisateur. Utilisez un compte dédié ou réduisez son accès aux workspaces nécessaires.
Exemple : limiter ClickUp à une équipe
Section intitulée « Exemple : limiter ClickUp à une équipe »Connectez un utilisateur dédié qui n’appartient qu’au workspace Maison Atlas — Support, puis demandez la liste des workspaces. Choisissez l’espace et la liste retournés par ClickUp, et testez la lecture d’une tâche connue avant de créer ou modifier une tâche.
ClickUp découvre les IDs après la connexion : il ne faut pas en inventer dans le formulaire. La lecture confirme le workspace, l’espace, la liste et les droits du jeton ; les écritures doivent être activées seulement après cette vérification.