ClickUp

Conectați ClickUp la AI SmartTalk pentru a sincroniza sarcinile și documentele în baza dumneavoastră de cunoștințe și pentru a automatiza gestionarea sarcinilor cu acțiunile SmartFlow.

---

Prezentare generală

Integrarea ClickUp vă permite să:

• Sincronizați sarcinile și documentele în baza dumneavoastră de cunoștințe
• Interogați starea proiectului conversațional
• Automatizați crearea și actualizările sarcinilor prin SmartFlow
• Optimizati fluxurile de lucru între chat și gestionarea proiectelor

---

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

• Un cont activ AI SmartTalk
• Un cont ClickUp cu acces la spațiul de lucru
• Permisiuni de administrator sau membru în spațiul de lucru

---

Configurare Pas cu Pas

Pasul 1: Conectați-vă contul ClickUp

1. Conectați-vă la contul dumneavoastră AI SmartTalk
2. Navigați la Setări → Integrări
3. Găsiți ClickUp și faceți clic pe Conectare
4. Fereastra OAuth ClickUp se deschide
5. Faceți clic pe Conectare Spațiu de lucru și autorizați accesul

Pasul 2: Selectați Spațiile de lucru și Spațiile

După autorizare:

1. Alegeți ce Spații de lucru să conectați
2. Selectați Spații în cadrul fiecărui spațiu de lucru
3. Alegeți Foldere și Liste de sincronizat
4. Faceți clic pe Continuare

Pasul 3: Configurați Setările de Sincronizare

Setare	Descriere
Sarcini	Sincronizați numele sarcinilor, descrierile, starea
Documente	Sincronizați conținutul Documentelor ClickUp
Comentarii	Includeți comentariile sarcinilor (opțional)
Atașamente	Referință URL-urilor atașamentelor

Pasul 4: Începeți Sincronizarea Inițială

1. Faceți clic pe Începeți Sincronizarea
2. AI SmartTalk importă conținutul dumneavoastră ClickUp
3. Bara de progres arată starea sincronizării
4. Verificați conținutul în secțiunea Cunoștințe

---

Ce se Sincronizează

Sarcini

Câmp	Sincronizat
Numele sarcinii	✅
Descriere	✅
Stare	✅
Responsabili	✅
Date limită	✅
Prioritate	✅
Etichete	✅
Câmpuri personalizate	✅
Comentarii	Opțional
Subtask-uri	✅

Documente

Câmp	Sincronizat
Titlul documentului	✅
Conținutul documentului	✅
Pagini înnăscute	✅
Ultima actualizare	✅

---

SmartFlow Actions

ClickUp exportă acțiuni puternice SmartFlow pentru automatizarea managementului de proiect:

Acțiuni Disponibile

Acțiune	Descriere	Parametrii
Creare Task	Adaugă un task nou într-o listă	name, description, list_id, assignees, due_date
Actualizare Task	Modifică un task existent	task_id, status, priority, assignees
Adăugare Comentariu	Comentează un task	task_id, comment_text
Schimbare Status	Mută task-ul între statusuri	task_id, new_status
Atribuire Task	Schimbă asignee-urile task-ului	task_id, user_ids
Obține Task	Recuperează detalii despre task	task_id

Exemplu: Creare Task din Chat

Când un client raportează o problemă, creează automat un task 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}}"

Exemplu: Notificare de Actualizare a Statusului

Când statusul unui task se schimbă, notifică clientul:

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

---

Cazuri de Utilizare

Suport pentru Clienți

Sincronizează task-urile de suport astfel încât AI să poată răspunde:

• "Care este statusul tichetului meu de suport?"
• "Câte probleme deschise avem?"
• "Când a fost atribuită cererea mea?"

Asistent Intern

Ajută membrii echipei cu întrebări legate de proiect:

• "Ce task-uri sunt datorate săptămâna aceasta?"
• "Arată-mi toate bug-urile cu prioritate mare"
• "La ce lucrează @John?"

Raportare Status Proiect

AI poate rezuma starea proiectului:

• "Dă-mi un rezumat al progresului Sprint 14"
• "Câte task-uri sunt blocate?"
• "Ce a finalizat echipa săptămâna trecută?"

Fluxuri de Lucru Automatizate

Declanșează acțiuni ClickUp din chat:

• Cerere client → Creare task
• Cuvânt cheie de escaladare → Atribuire managerului
• Problemă rezolvată → Actualizare status task

---

Comportamentul de Sincronizare

Sincronizare Automată

AI SmartTalk sincronizează periodic datele ClickUp:

• Task-uri noi sunt adăugate
• Task-uri actualizate sunt reîmprospătate
• Task-uri șterse/archivate sunt eliminate

Sincronizare Manuală

Forțează o reîmprospătare imediată:

1. Mergi la Setări → Integrări → ClickUp
2. Fă clic pe Sincronizează Acum

Actualizări în Timp Real prin Webhooks

Pentru actualizări instantanee, configurează webhooks ClickUp:

1. În ClickUp, mergi la Setări → Integrări
2. Configurează webhook către endpoint-ul AI SmartTalk
3. Schimbările de task declanșează actualizări imediate ale bazei de cunoștințe

---

Depanarea problemelor

Probleme de conexiune

Problemă	Soluție
"Autorizarea a eșuat"	Re-autorizare prin OAuth
"Spațiul de lucru nu a fost găsit"	Verificați permisiunile spațiului de lucru
"Acces interzis"	Asigurați-vă că aveți rol de membru/admin

Probleme de sincronizare

Problemă	Soluție
Sarcini lipsă	Verificați dacă sarcinile sunt în listele selectate
Date învechite	Faceți clic pe Sincronizare acum pentru a actualiza
Documente ne-sincronizate	Activați Documentele în setările de sincronizare

Probleme cu acțiunile SmartFlow

Problemă	Soluție
"Crearea sarcinii a eșuat"	Verificați dacă list_id este valid
"Status invalid"	Utilizați numele exact al statusului din ClickUp
"Utilizatorul nu a fost găsit"	Verificați user_id-ul persoanei desemnate

---

Gestionarea conexiunii

Acțiune	Cum
Adăugați spații	Editați conexiunea → Selectați spații suplimentare
Eliminați spații	Debifați spațiile de care nu aveți nevoie
Actualizați token-uri	Re-autorizare dacă token-ul expiră
Deconectați	Setări → Integrare → ClickUp → Deconectare

---

Cele mai bune practici

Pentru sincronizarea cunoștințelor

1. Fiți selectivi: Sincronizați doar spațiile/listelor relevante
2. Utilizați descrieri: Sarcini bine documentate = răspunsuri mai bune de la AI
3. Nomenclatură consistentă: Numele clare ale sarcinilor ajută AI-ul să înțeleagă contextul
4. Sincronizare regulată: Mențineți datele actualizate pentru răspunsuri precise

Pentru acțiunile SmartFlow

1. Testați în staging: Testați crearea sarcinilor într-o listă de test mai întâi
2. Gestionați erorile: Adăugați gestionarea erorilor pentru apelurile API eșuate
3. Utilizați șabloane: Creați șabloane reutilizabile pentru sarcini
4. Înregistrați acțiunile: Urmăriți crearea automată a sarcinilor pentru auditare

---

Documentație conexă

• Prezentare generală a integrărilor
• Integrarea JIRA — Integrare similară pentru managementul proiectelor
• Acțiunile SmartFlow
• Webhook-urile SmartFlow