ClickUp

Connectez ClickUp à AI SmartTalk pour synchroniser les tâches et les documents avec votre base de connaissances, et automatisez la gestion des tâches avec les actions SmartFlow.

---

Aperçu

L'intégration ClickUp vous permet de :

• Synchroniser les tâches et les documents dans votre base de connaissances
• Interroger l'état du projet de manière conversationnelle
• Automatiser la création et les mises à jour des tâches via SmartFlow
• Rationaliser les flux de travail entre le chat et la gestion de projet

---

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Un compte AI SmartTalk actif
• Un compte ClickUp avec accès à l'espace de travail
• Des autorisations d'administrateur ou de membre dans l'espace de travail

---

Configuration étape par étape

Étape 1 : Connecter votre compte ClickUp

1. Connectez-vous à votre compte AI SmartTalk
2. Accédez à Paramètres → Intégrations
3. Trouvez ClickUp et cliquez sur Connecter
4. La fenêtre OAuth de ClickUp s'ouvre
5. Cliquez sur Connecter l'espace de travail et autorisez l'accès

Étape 2 : Sélectionner les espaces de travail et les espaces

Après l'autorisation :

1. Choisissez les Espaces de travail à connecter
2. Sélectionnez les Espaces au sein de chaque espace de travail
3. Choisissez les Dossiers et Listes à synchroniser
4. Cliquez sur Continuer

Étape 3 : Configurer les paramètres de synchronisation

Paramètre	Description
Tâches	Synchroniser les noms, descriptions, et statuts des tâches
Documents	Synchroniser le contenu des Docs ClickUp
Commentaires	Inclure les commentaires des tâches (optionnel)
Pièces jointes	Référencer les URL des pièces jointes

Étape 4 : Démarrer la synchronisation initiale

1. Cliquez sur Démarrer la synchronisation
2. AI SmartTalk importe votre contenu ClickUp
3. La barre de progression affiche l'état de la synchronisation
4. Vérifiez le contenu dans la section Connaissances

---

Ce qui est synchronisé

Tâches

Champ	Synchronisé
Nom de la tâche	✅
Description	✅
Statut	✅
Assignés	✅
Dates d'échéance	✅
Priorité	✅
Étiquettes	✅
Champs personnalisés	✅
Commentaires	Optionnel
Sous-tâches	✅

Documents

Champ	Synchronisé
Titre du document	✅
Contenu du document	✅
Pages imbriquées	✅
Dernière mise à jour	✅

---

Actions SmartFlow

ClickUp exporte des actions SmartFlow puissantes pour automatiser la gestion de projet :

Actions Disponibles

Action	Description	Paramètres
Créer une Tâche	Ajouter une nouvelle tâche à une liste	name, description, list_id, assignees, due_date
Mettre à Jour une Tâche	Modifier une tâche existante	task_id, status, priority, assignees
Ajouter un Commentaire	Commenter une tâche	task_id, comment_text
Changer le Statut	Déplacer une tâche entre les statuts	task_id, new_status
Assigner une Tâche	Changer les assignés d'une tâche	task_id, user_ids
Obtenir une Tâche	Récupérer les détails d'une tâche	task_id

Exemple : Créer une Tâche depuis le Chat

Lorsqu'un client signale un problème, créez automatiquement une tâche ClickUp :

Trigger: Chat Service
Condition: Message contains "bug" or "issue"
Actions:
  1. AI Request:
       Extract issue summary from conversation
  2. ClickUp - Create Task:
       List: Bug Reports
       Name: {{extracted_summary}}
       Description: "Reported via chat by {{customer_name}}"
       Priority: High
  3. Chat Response:
       "I've created a bug report for our team. Reference: {{task_id}}"

Exemple : Notification de Mise à Jour de Statut

Lorsqu'un statut de tâche change, informez le client :

Trigger: Webhook (ClickUp task updated)
Condition: Status changed to "Done"
Actions:
  1. Get Customer Email:
       From task custom field
  2. Send Email:
       To: {{customer_email}}
       Subject: Your request has been completed
       Body: Task "{{task_name}}" is now complete

---

Cas d'Utilisation

Support Client

Synchronisez les tâches de support afin que l'IA puisse répondre :

• "Quel est le statut de mon ticket de support ?"
• "Combien de problèmes ouverts avons-nous ?"
• "Quand ma demande a-t-elle été assignée ?"

Assistant Interne

Aidez les membres de l'équipe avec des requêtes de projet :

• "Quelles tâches sont dues cette semaine ?"
• "Montrez-moi tous les bugs de haute priorité"
• "Sur quoi travaille @John ?"

Rapport de Statut de Projet

L'IA peut résumer l'état du projet :

• "Donnez-moi un résumé des progrès du Sprint 14"
• "Combien de tâches sont bloquées ?"
• "Qu'est-ce que l'équipe a complété la semaine dernière ?"

Flux de Travail Automatisés

Déclenchez des actions ClickUp depuis le chat :

• Demande client → Créer une tâche
• Mot-clé d'escalade → Assigner au manager
• Problème résolu → Mettre à jour le statut de la tâche

---

Comportement de Synchronisation

Synchronisation Automatique

L'IA SmartTalk synchronise périodiquement les données ClickUp :

• De nouvelles tâches sont ajoutées
• Les tâches mises à jour sont rafraîchies
• Les tâches supprimées/archivées sont retirées

Synchronisation Manuelle

Forcez un rafraîchissement immédiat :

1. Allez dans Paramètres → Intégrations → ClickUp
2. Cliquez sur Synchroniser Maintenant

Mises à Jour en Temps Réel via Webhooks

Pour des mises à jour instantanées, configurez les webhooks ClickUp :

1. Dans ClickUp, allez dans Paramètres → Intégrations
2. Configurez un webhook vers le point de terminaison AI SmartTalk
3. Les changements de tâche déclenchent des mises à jour immédiates de la base de connaissances

---

Dépannage

Problèmes de connexion

Problème	Solution
"Échec de l'autorisation"	Réautoriser via OAuth
"Espace de travail introuvable"	Vérifiez les autorisations de l'espace de travail
"Accès refusé"	Assurez-vous d'avoir le rôle de membre/admin

Problèmes de synchronisation

Problème	Solution
Tâches manquantes	Vérifiez que les tâches sont dans les listes sélectionnées
Données obsolètes	Cliquez sur Synchroniser maintenant pour rafraîchir
Docs non synchronisés	Activez Docs dans les paramètres de synchronisation

Problèmes d'actions SmartFlow

Problème	Solution
"Échec de la création de tâche"	Vérifiez que list_id est valide
"Statut invalide"	Utilisez le nom de statut exact de ClickUp
"Utilisateur introuvable"	Vérifiez l'user_id de l'assigné

---

Gestion de la connexion

Action	Comment
Ajouter des espaces	Modifier la connexion → Sélectionner des espaces supplémentaires
Supprimer des espaces	Décochez les espaces dont vous n'avez pas besoin
Rafraîchir les jetons	Réautoriser si le jeton expire
Déconnecter	Paramètres → Intégrations → ClickUp → Déconnecter

---

Meilleures pratiques

Pour la synchronisation des connaissances

1. Soyez sélectif : Ne synchronisez que les espaces/listes pertinents
2. Utilisez des descriptions : Tâches bien documentées = meilleures réponses de l'IA
3. Nommage cohérent : Des noms de tâches clairs aident l'IA à comprendre le contexte
4. Synchronisation régulière : Gardez les données à jour pour des réponses précises

Pour les actions SmartFlow

1. Tester en staging : Testez la création de tâches dans une liste de test d'abord
2. Gérer les erreurs : Ajoutez une gestion des erreurs pour les appels API échoués
3. Utiliser des modèles : Créez des modèles de tâches réutilisables
4. Journaliser les actions : Suivez les créations de tâches automatisées pour l'audit

---

Documentation connexe

• Aperçu des intégrations
• Intégration JIRA — Intégration de gestion de projet similaire
• Actions SmartFlow
• Webhooks SmartFlow