ClickUp

Lidhni ClickUp me AI SmartTalk për të sinkronizuar detyrat dhe dokumentet në bazën tuaj të njohurive, dhe për të automatizuar menaxhimin e detyrave me veprimet SmartFlow.

---

Përmbledhje

Integrimi i ClickUp ju mundëson të:

• Sinkronizoni detyrat dhe dokumentet në bazën tuaj të njohurive
• Pyesni statusin e projektit në mënyrë konverzionale
• Automatizoni krijimin dhe përditësimet e detyrave përmes SmartFlow
• Rregulloni flukset e punës midis bisedës dhe menaxhimit të projekteve

---

Kushtet e Nevojshme

Para se të filloni, sigurohuni që keni:

• Një llogari aktive në AI SmartTalk
• Një llogari në ClickUp me akses në hapësirën e punës
• Leje admini ose anëtari në hapësirën e punës

---

Hapat për Konfigurim

Hapi 1: Lidhni Llogarinë Tuaj në ClickUp

1. Hyni në llogarinë tuaj në AI SmartTalk
2. Shkoni te Cilësimet → Integrimet
3. Gjeni ClickUp dhe klikoni Lidhni
4. Dritarja e OAuth të ClickUp hapet
5. Klikoni Lidhni Hapësirën e Punës dhe autorizoni aksesin

Hapi 2: Zgjidhni Hapësirat e Punës dhe Hapësirat

Pas autorizimit:

1. Zgjidhni cilat Hapësira Pune të lidhni
2. Zgjidhni Hapësirat brenda çdo hapësire pune
3. Zgjidhni Dosjet dhe Listat për t'i sinkronizuar
4. Klikoni Vazhdoni

Hapi 3: Konfiguroni Cilësimet e Sinkronizimit

Cilësimi	Përshkrimi
Detyrat	Sinkronizoni emrat e detyrave, përshkrimet, statusin
Dokumentet	Sinkronizoni përmbajtjen e Dokumenteve të ClickUp
Komentet	Përfshini komentet e detyrave (opsionale)
Prerjet	Referenconi URL-të e prerjeve

Hapi 4: Filloni Sinkronizimin Fillestar

1. Klikoni Filloni Sinkronizimin
2. AI SmartTalk importon përmbajtjen tuaj nga ClickUp
3. Shiritin e progresit tregon statusin e sinkronizimit
4. Verifikoni përmbajtjen në seksionin Njohuri

---

Çfarë Sinkronizohet

Detyrat

Fusha	E Sinkronizuar
Emri i detyrës	✅
Përshkrimi	✅
Statusi	✅
Të caktuarit	✅
Datat e skadimit	✅
Prioriteti	✅
Etiketat	✅
Fushat e personalizuara	✅
Komentet	Opsionale
Nëndetyrat	✅

Dokumentet

Fusha	E Sinkronizuar
Titulli i dokumentit	✅
Përmbajtja e dokumentit	✅
Faqet e ngulitura	✅
E fundit e përditësuar	✅

---

SmartFlow Actions

ClickUp eksporton veprime të fuqishme SmartFlow për automatizimin e menaxhimit të projekteve:

Veprimet e Disponueshme

Veprimi	Përshkrimi	Parametrat
Krijo Detyrë	Shto detyrë të re në një listë	name, description, list_id, assignees, due_date
Përditëso Detyrën	Modifiko detyrën ekzistuese	task_id, status, priority, assignees
Shto Koment	Komento mbi një detyrë	task_id, comment_text
Ndrysho Statusin	Shkalo detyrën midis statusesh	task_id, new_status
Cakto Detyrën	Ndrysho caktuesit e detyrës	task_id, user_ids
Merr Detyrën	Merr detajet e detyrës	task_id

Shembulli: Krijo Detyrë nga Biseda

Kur një klient raporton një problem, krijo automatikisht një detyrë në 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}}"

Shembulli: Njoftimi për Përditësimin e Statusit

Kur statusi i një detyre ndryshon, njofto klientin:

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

---

Rastet e Përdorimit

Mbështetje për Klientin

Sinkronizo detyrat e mbështetjes që AI të mund të përgjigjet:

• "Cili është statusi i biletës sime të mbështetjes?"
• "Sa probleme të hapura kemi?"
• "Kur u caktua kërkesa ime?"

Asistenti i Brendshëm

Ndihmo anëtarët e ekipit me pyetje mbi projektin:

• "Cilat detyra janë të skaduara këtë javë?"
• "Më trego të gjitha defektet me prioritet të lartë"
• "Çfarë po punon @John?"

Raportimi i Statusit të Projektit

AI mund të përmbledhë gjendjen e projektit:

• "Më jep një përmbledhje të përparimit të Sprint 14"
• "Sa detyra janë të bllokuara?"
• "Çfarë përfundoi ekipi javën e kaluar?"

Flukset e Automatizuar të Punës

Aktivizo veprimet e ClickUp nga biseda:

• Kërkesa e klientit → Krijo detyrë
• Fjalë kyçe eskalimi → Cakto te menaxheri
• Problemi i zgjidhur → Përditëso statusin e detyrës

---

Sjellja e Sinkronizimit

Sinkronizimi Automatik

AI SmartTalk sinkronizon periodikisht të dhënat e ClickUp:

• Detyrat e reja shtohen
• Detyrat e përditësuara rifreskohen
• Detyrat e fshira/arkivuara hiqen

Sinkronizimi Manual

Forco një rifreskim të menjëhershëm:

1. Shkoni te Settings → Integrations → ClickUp
2. Klikoni Sync Now

Përditësime në Kohë Reale përmes Webhooks

Për përditësime të menjëhershme, konfiguroni webhook-et e ClickUp:

1. Në ClickUp, shkoni te Settings → Integrations
2. Konfiguroni webhook për endpoint-in e AI SmartTalk
3. Ndryshimet në detyrë aktivizojnë përditësime të menjëhershme të bazës së njohurive

---

Troubleshooting

Connection Issues

Issue	Solution
"Authorization failed"	Rautorizo përmes OAuth
"Workspace not found"	Kontrolloni lejet e workspace-it
"Access denied"	Sigurohuni që keni rol anëtar/admin

Sync Issues

Issue	Solution
Tasks missing	Verifikoni që detyrat janë në Listat e zgjedhura
Stale data	Klikoni Sync Now për të rifreskuar
Docs not syncing	Aktivizoni Docs në cilësimet e sinkronizimit

SmartFlow Action Issues

Issue	Solution
"Task creation failed"	Kontrolloni që list_id është i vlefshëm
"Invalid status"	Përdorni emrin e saktë të statusit nga ClickUp
"User not found"	Verifikoni user_id e caktuar

---

Managing the Connection

Action	How
Add spaces	Redaktoni lidhjen → Zgjidhni hapësira shtesë
Remove spaces	Hiqni shenjat nga hapësirat që nuk ju nevojiten
Refresh tokens	Rautorizo nëse tokeni skadon
Disconnect	Cilësimet → Integrimet → ClickUp → Shkëput

---

Best Practices

For Knowledge Sync

1. Be selective: Vetëm sinkronizoni hapësira/lista relevante
2. Use descriptions: Detyrat e dokumentuara mirë = përgjigje më të mira nga AI
3. Consistent naming: Emrat e qartë të detyrave ndihmojnë AI-në të kuptojë kontekstin
4. Regular sync: Mbani të dhënat të freskëta për përgjigje të sakta

For SmartFlow Actions

1. Test in staging: Testoni krijimin e detyrave në një listë provuese së pari
2. Handle errors: Shtoni trajtimin e gabimeve për thirrjet e dështuara të API
3. Use templates: Krijoni shabllone detyrash të ripërdorshme
4. Log actions: Ndjekni krijimet automatike të detyrave për auditim

---

Related Documentation

• Integrations Overview
• JIRA Integration — Integrim i ngjashëm për menaxhimin e projekteve
• SmartFlow Actions
• SmartFlow Webhooks