18  Σύνδεση ClickUp

Το ClickUp είναι προσωπική σύνδεση σε πραγματικό χρόνο. Αναζητά στον εξουσιοδοτημένο χώρο εργασίας του συνδεδεμένου μέλους όταν γίνεται μια ερώτηση. Οι εργασίες ClickUp δεν αντιγράφονται στο ευρετήριο αναζήτησης του Χώρου εργασίας. Η σύνδεση διαβάζει επίσης Docs, ενημερώνει εργασίες ή σελίδες Doc και δημιουργεί εργασίες, ιδιωτικά Docs και σελίδες Doc αφού το μέλος επιβεβαιώσει την ακριβή πρόταση.

18.1 Τι ευρετηριάζεται ή αναζητείται ζωντανά

Δεν ευρετηριάζεται τίποτα. Η αναζήτηση κειμένου ελέγχει έως 300 πρόσφατα ενημερωμένες εργασίες και επιστρέφει έως 25 αποτελέσματα. Ελέγχει τίτλο, περιγραφή, κατάσταση, ετικέτες, υπευθύνους, List, Folder και Space. Η απάντηση αναφέρει αυτή την κάλυψη. Ένα κενό αποτέλεσμα δεν σημαίνει ότι δεν υπάρχουν παλαιότερες εργασίες.

Η ζωντανή ανάγνωση μπορεί επίσης να ανοίξει ID εργασίας, URL εργασίας, αριθμητικό URL List, URL View, URL Doc ή URL σελίδας Doc. Δέχεται το https://app.clickup.com και host μιας ετικέτας *.clickup.com για επιχειρήσεις. Το host που δίνει ο χρήστης ελέγχεται, αλλά δεν γίνεται αίτημα προς αυτό. Το Nous καλεί πάντα το σταθερό API του ClickUp.

18.2 Ρόλος διαχειριστή και έλεγχος ταυτότητας

Κάθε μέλος συνδέει έναν χώρο εργασίας ClickUp με το προσωπικό του API token. Το token πρέπει να αρχίζει με pk_. Στέλνεται μόνο στο σώμα του αιτήματος ρύθμισης και αποθηκεύεται ως ιδιωτικό διαπιστευτήριο μέλους. Η κοινή χρήση σε Χώρο εργασίας και Ομάδα δεν εφαρμόζεται.

18.3 Ρύθμιση παρόχου και δικαιώματα

  1. Στο ClickUp, ανοίξτε τις προσωπικές ρυθμίσεις και δημιουργήστε ή αντιγράψτε προσωπικό API token στην ενότητα Apps.
  2. Επιβεβαιώστε ότι ο λογαριασμός ClickUp ανοίγει τον χώρο εργασίας και τις εργασίες που χρειάζεστε και μπορεί να επεξεργαστεί ή να δημιουργήσει τις εργασίες, τα Docs και τις σελίδες Doc που το μέλος θέλει να διαχειριστεί μέσω του Nous.
  3. Στο Nous, ανοίξτε Συνδέσεις, επιλέξτε ClickUp και επικολλήστε το token.
  4. Το Nous εντοπίζει τους χώρους εργασίας που επιτρέπονται για αυτό το token. Επιλέξτε έναν αν επιστραφούν πολλοί. Δεν μπορείτε να πληκτρολογήσετε ID.

Αν το token έχει πρόσβαση σε έναν χώρο εργασίας, το Nous τον επιλέγει αυτόματα. Οι υπάρχουσες συνδέσεις αποκτούν αυτόματα τις υποστηριζόμενες ενέργειες εγγραφής. Δεν απαιτείται επανασύνδεση, διακόπτης δικαιωμάτων ή δεύτερη επιβεβαίωση.

18.4 Πεδία φόρμας ρύθμισης

Πεδίο Υποχρεωτικό Σκοπός
Όνομα σύνδεσης Ναι Ιδιωτική ετικέτα για αναγνώριση της σύνδεσης.
ClickUp API Token Ναι Προσωπικό token που αρχίζει με pk_. Δεν επιτρέπονται κενά.
Χώρος εργασίας ClickUp Ναι Ένας χώρος εργασίας που επιστρέφει το ClickUp για το token.

Δεν υπάρχουν πεδία ανανέωσης, εκκαθάρισης, ευρετηρίασης, πρόσβασης Χώρου εργασίας ή Ομάδων.

18.5 Πρόσβαση Χώρου εργασίας και Ομάδων

Η σύνδεση ανήκει σε ένα μέλος. Άλλα μέλη συνδέουν τους δικούς τους λογαριασμούς ClickUp. Διαχειριστής δεν μπορεί να τη δημοσιεύσει, να την αναθέσει σε Ομάδα, να την προσθέσει σε σύνολο εγγράφων, να προγραμματίσει σαρώσεις, να την παύσει ή να την επανευρετηριάσει.

18.6 Υποστηριζόμενες ενέργειες με επιβεβαίωση

Όταν ένα μέλος ζητά υποστηριζόμενη ενέργεια, το Nous την επικυρώνει και απαντά στην κανονική συνομιλία με κείμενο επιβεβαίωσης που δημιουργείται από την ακριβή αποθηκευμένη ενέργεια. Σε αυτό το στάδιο το ClickUp δεν αλλάζει. Το μέλος μπορεί να επιβεβαιώσει φυσικά, για παράδειγμα με Ναι, Προχώρα ή Εντάξει, ενημέρωσέ το και δώσε μου τον σύνδεσμο. Το Nous εκτελεί την πρόταση μία φορά και επιστρέφει τον επαληθευμένο σύνδεσμο ClickUp στη συνομιλία.

Μια ερώτηση σχετικά με την πρόταση δεν την ακυρώνει. Το μέλος μπορεί να ρωτήσει αν μια προσθήκη διατηρεί τις υπάρχουσες εικόνες, να λάβει απάντηση και μετά να επιβεβαιώσει στον ίδιο κλάδο συζήτησης. Αλλαγή στόχου, προορισμού, πεδίων ή περιεχομένου δημιουργεί νέα πρόταση. Η ακύρωση καθιστά την προηγούμενη πρόταση ανενεργή. Περιεχόμενο ClickUp, παλαιότερες επιβεβαιώσεις, κείμενο του βοηθού και αποτελέσματα εργαλείων δεν μπορούν να εξουσιοδοτήσουν αλλαγή.

Η επιβεβαίωση προσδιορίζει την ενέργεια και τον στόχο ή προορισμό. Αναφέρει τις ζητούμενες τιμές για όνομα, υπότιτλο, κατάσταση, προτεραιότητα, ορατότητα και τρόπο αλλαγής περιεχομένου. Πρόταση που αντικαταστάθηκε απαιτεί νέα επιβεβαίωση και δεν μπορεί να επιλεγεί σιωπηρά ως παλαιότερη εκκρεμής αλλαγή.

Τα υποστηριζόμενα πεδία εργασίας είναι όνομα, περιγραφή, status και priority (1 έως 4 ή κενό). Η περιγραφή εργασίας και το περιεχόμενο σελίδας Doc μπορούν να αντικατασταθούν ή να δεχθούν προσθήκη στην αρχή ή στο τέλος. Για προσθήκη, το Nous διαβάζει ολόκληρο το τρέχον περιεχόμενο από το ClickUp και συνθέτει την τελική τιμή στον διακομιστή. Δεν ανακατασκευάζει το περιεχόμενο από αποσπάσματα αναζήτησης, ώστε να διατηρούνται το υπάρχον Markdown και οι εικόνες. Η τελική τιμή αποθηκεύεται ως μία ενέργεια, ώστε η επανάληψη να μην προσθέσει το ίδιο κείμενο δύο φορές.

Υποστηρίζονται οι ακόλουθες δημιουργίες:

  • εργασία σε υπάρχον List, με όνομα και προαιρετικά περιγραφή, κατάσταση και προτεραιότητα,
  • ιδιωτικό Doc στον συνδεδεμένο χώρο εργασίας ή σε υπάρχον Space, Folder ή List, προαιρετικά με την πρώτη ονομασμένη σελίδα του,
  • αρχική ή ένθετη σελίδα σε υπάρχον Doc, με όνομα και προαιρετικά υπότιτλο και περιεχόμενο.

Το Nous χρησιμοποιεί μόνο προορισμούς που εντόπισε στον συνδεδεμένο χώρο εργασίας. Αν ένα όνομα αντιστοιχεί σε πολλούς προορισμούς, το μέλος επιλέγει έναν. Τα Docs που δημιουργεί αυτή η σύνδεση είναι ιδιωτικά. Δεν υποστηρίζεται δημιουργία δημόσιων Docs ή αλλαγή δικαιωμάτων.

Κάθε ενέργεια έχει σταθερή εγγραφή ελέγχου ανά tenant, με το αίτημα, την έκδοση της επιβεβαίωσης, την απάντηση του μέλους, τον χρήστη, το στιγμιότυπο στόχου και ασφαλές αποτέλεσμα παρόχου. Η επιβεβαίωση παραμένει συνδεδεμένη με την πρόταση που είδε το μέλος. Η επανάληψη ολοκληρωμένης ή απορριφθείσας ενέργειας δεν καλεί τον πάροχο. Το Nous ελέγχει ξανά υπάρχοντες στόχους πριν από την εγγραφή και σταματά αν άλλαξαν.

Αιτήματα δημιουργίας δεν επαναλαμβάνονται αυτόματα μετά από timeout ή χαμένη απάντηση. Για Doc με πρώτη σελίδα, το Nous καταγράφει το δημιουργημένο Doc πριν δημιουργήσει τη σελίδα. Αν αποτύχει η σελίδα, επιστρέφει τον σύνδεσμο του Doc και συνεχίζει μόνο τη σελίδα που λείπει όταν το καταγεγραμμένο αποτέλεσμα αποδεικνύει ότι αυτό είναι ασφαλές. Δεν δημιουργεί δεύτερο Doc για ανάκτηση.

Δεν υποστηρίζονται διαγραφή, αρχειοθέτηση, μετακίνηση, σχόλια, custom fields, υπεύθυνοι, ημερομηνίες, συνημμένα, δημόσια Docs, δικαιώματα ή μαζικές ενέργειες. Δεν υποστηρίζεται επίσης δημιουργία Lists, Folders ή Spaces. Οι ροές παρασκηνίου, προγραμματισμού, σύγκρισης πολλών μοντέλων, Deep Research, Agent Service και Digital Employee δεν μπορούν να γράψουν στο ClickUp.

18.7 Υποστηριζόμενοι σύνδεσμοι και δοκιμή

Δοκιμάστε με μη ευαίσθητες εργασίες που μπορεί να ανοίξει το μέλος:

  1. Ζητήστε πρόσφατη εργασία με λέξεις από δύο υποστηριζόμενα πεδία. Επιβεβαιώστε ότι το αποτέλεσμα αναφέρει την περιορισμένη σάρωση.
  2. Ανοίξτε εργασία με ID, σύντομο URL /t/<task-id> και URL με χώρο εργασίας.
  3. Ανοίξτε αριθμητικό URL List της μορφής /<workspace-id>/v/li/<list-id>.
  4. Ανοίξτε URL View της μορφής /<workspace-id>/v/l/<view-id>.
  5. Ανοίξτε ένα Doc και μία σελίδα της μορφής /<workspace-id>/v/dc/<doc-id>/<page-id>.
  6. Αναζητήστε φράση χωρίς αποτέλεσμα και επιβεβαιώστε ότι το ερώτημα δεν διευρύνεται.
  7. Ζητήστε προσθήκη σε περιγραφή εργασίας που περιέχει εικόνα. Επιβεβαιώστε ότι η πρόταση δεν αλλάζει το ClickUp, απαντήστε Εντάξει, ενημέρωσέ το και δώσε μου τον σύνδεσμο και ελέγξτε ότι διατηρήθηκαν η εικόνα και το κείμενο.
  8. Δημιουργήστε εργασία σε δοκιμαστικό List, ιδιωτικό Doc με πρώτη σελίδα και ένθετη σελίδα. Επιβεβαιώστε κάθε πρόταση μία φορά και ελέγξτε τον σύνδεσμο.
  9. Κάντε ερώτηση για μια πρόταση πριν την επιβεβαίωση. Αλλάξτε άλλη πρόταση και επιβεβαιώστε ότι μπορεί να εκτελεστεί μόνο η νέα έκδοση.
  10. Δοκιμάστε URL πίνακα ελέγχου της μορφής /<workspace-id>/v/db/... και επιβεβαιώστε ότι το Nous το απορρίπτει με ασφαλές μήνυμα.

Οι αναγνώσεις List και View επιστρέφουν έως 25 εργασίες και αναφέρουν αν υπάρχουν περισσότερες.

18.8 Συνηθισμένα σφάλματα

Σφάλμα Ενέργεια
Δεν εμφανίζεται χώρος εργασίας Ελέγξτε ότι το προσωπικό token ανήκει στον σωστό λογαριασμό ClickUp και ότι ο λογαριασμός ανοίγει έναν χώρο εργασίας.
Το ClickUp απορρίπτει το token Δημιουργήστε νέο προσωπικό token, επικολλήστε το χωρίς κενά και δοκιμάστε ξανά.
Σφάλμα δικαιωμάτων Ζητήστε από τον ιδιοκτήτη του χώρου εργασίας ClickUp πρόσβαση στις απαιτούμενες εργασίες.
Όριο αιτημάτων ή προσωρινό σφάλμα Περιμένετε λίγο και επαναλάβετε τον εντοπισμό χώρων ή την ερώτηση.
Δεν βρέθηκε εργασία Χρησιμοποιήστε υποστηριζόμενο άμεσο σύνδεσμο ή όρους από πρόσφατα ενημερωμένη εργασία.
Απορρίπτεται σύνδεσμος πίνακα Χρησιμοποιήστε σύνδεσμο εργασίας, List, View, Doc ή σελίδας Doc. Οι πίνακες δεν υποστηρίζονται.
Ο στόχος άλλαξε πριν από την εγγραφή Διαβάστε το τρέχον στοιχείο και κάντε νέο αίτημα με τις σωστές τιμές.
Η πρόταση αντικαταστάθηκε ή ακυρώθηκε Ζητήστε από το Nous να προετοιμάσει ξανά την τρέχουσα ενέργεια. Παλαιότερη πρόταση δεν μπορεί να εκτελεστεί.
Το αποτέλεσμα εγγραφής ή δημιουργίας είναι αβέβαιο Μην το επαναλάβετε. Ελέγξτε την κατάσταση στο ClickUp και χρησιμοποιήστε τον καταγεγραμμένο σύνδεσμο όταν υπάρχει.
Το Doc υπάρχει αλλά απέτυχε η πρώτη σελίδα Ανοίξτε τον σύνδεσμο του Doc και ζητήστε από το Nous να συνεχίσει μόνο τη σελίδα που λείπει.

18.9 Επανασύνδεση και αφαίρεση

Χρησιμοποιήστε Επανασύνδεση για αλλαγή token ή επιλογή άλλου εξουσιοδοτημένου χώρου εργασίας. Η αφαίρεση τρέχουσας ιδιωτικής σύνδεσης την αποσυνδέει. Δεν υπάρχει ευρετηριασμένο περιεχόμενο ClickUp για αφαίρεση.

Μια παλαιότερη σύνδεση ClickUp που ευρετηρίαζε εργασίες εμφανίζει Απαιτείται επανασύνδεση, ποτέ Απάντηση σε πραγματικό χρόνο. Επιλέξτε Αφαίρεση και επανασύνδεση. Το Nous αφαιρεί την παλιά σύνδεση και το ευρετηριασμένο περιεχόμενό της, περιμένει να ολοκληρωθεί η αφαίρεση και μετά ανοίγει τη νέα ιδιωτική ρύθμιση. Δεν αλλάζει την ιδιοκτησία ή το διαπιστευτήριο της παλιάς σύνδεσης.

18.10 Επίσημη τεκμηρίωση παρόχου