ClickUp

Połącz ClickUp z AI SmartTalk, aby synchronizować zadania i dokumenty z Twoją bazą wiedzy oraz zautomatyzować zarządzanie zadaniami za pomocą akcji SmartFlow.

---

Przegląd

Integracja ClickUp umożliwia:

• Synchronizację zadań i dokumentów w Twojej bazie wiedzy
• Zapytania o status projektu w sposób konwersacyjny
• Automatyzację tworzenia i aktualizacji zadań za pomocą SmartFlow
• Usprawnienie przepływów pracy między czatem a zarządzaniem projektami

---

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

• Aktywne konto AI SmartTalk
• Konto ClickUp z dostępem do przestrzeni roboczej
• Uprawnienia administratora lub członka w przestrzeni roboczej

---

Instrukcja krok po kroku

Krok 1: Połącz swoje konto ClickUp

1. Zaloguj się na swoje konto AI SmartTalk
2. Przejdź do Ustawienia → Integracje
3. Znajdź ClickUp i kliknij Połącz
4. Otwiera się okno OAuth ClickUp
5. Kliknij Połącz przestrzeń roboczą i autoryzuj dostęp

Krok 2: Wybierz przestrzenie robocze i przestrzenie

Po autoryzacji:

1. Wybierz, które Przestrzenie robocze chcesz połączyć
2. Wybierz Przestrzenie w każdej przestrzeni roboczej
3. Wybierz Foldery i Listy do synchronizacji
4. Kliknij Kontynuuj

Krok 3: Skonfiguruj ustawienia synchronizacji

Ustawienie	Opis
Zadania	Synchronizuj nazwy zadań, opisy, status
Dokumenty	Synchronizuj treść dokumentów ClickUp
Komentarze	Dołącz komentarze do zadań (opcjonalnie)
Załączniki	Referencje do URL załączników

Krok 4: Rozpocznij początkową synchronizację

1. Kliknij Rozpocznij synchronizację
2. AI SmartTalk importuje Twoje treści ClickUp
3. Pasek postępu pokazuje status synchronizacji
4. Zweryfikuj treści w sekcji Wiedza

---

Co jest synchronizowane

Zadania

Pole	Synchronizowane
Nazwa zadania	✅
Opis	✅
Status	✅
Osoby przypisane	✅
Terminy	✅
Priorytet	✅
Tagii	✅
Pola niestandardowe	✅
Komentarze	Opcjonalne
Podzadania	✅

Dokumenty

Pole	Synchronizowane
Tytuł dokumentu	✅
Treść dokumentu	✅
Strony zagnieżdżone	✅
Ostatnia aktualizacja	✅

---

SmartFlow Actions

ClickUp eksportuje potężne akcje SmartFlow do automatyzacji zarządzania projektami:

Available Actions

Action	Description	Parameters
Create Task	Dodaj nowe zadanie do listy	name, description, list_id, assignees, due_date
Update Task	Zmodyfikuj istniejące zadanie	task_id, status, priority, assignees
Add Comment	Skomentuj zadanie	task_id, comment_text
Change Status	Przenieś zadanie między statusami	task_id, new_status
Assign Task	Zmień przypisania zadania	task_id, user_ids
Get Task	Pobierz szczegóły zadania	task_id

Example: Create Task from Chat

Gdy klient zgłasza problem, automatycznie twórz zadanie 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}}"

Example: Status Update Notification

Gdy status zadania się zmienia, powiadom klienta:

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

---

Use Cases

Customer Support

Synchronizuj zadania wsparcia, aby AI mogło odpowiadać:

• "Jaki jest status mojego zgłoszenia wsparcia?"
• "Ile mamy otwartych problemów?"
• "Kiedy moje zgłoszenie zostało przypisane?"

Internal Assistant

Pomagaj członkom zespołu w zapytaniach projektowych:

• "Jakie zadania są do wykonania w tym tygodniu?"
• "Pokaż mi wszystkie błędy o wysokim priorytecie"
• "Nad czym pracuje @John?"

Project Status Reporting

AI może podsumować stan projektu:

• "Podaj mi podsumowanie postępów Sprintu 14"
• "Ile zadań jest zablokowanych?"
• "Co zespół zakończył w zeszłym tygodniu?"

Automated Workflows

Wyzwalaj akcje ClickUp z czatu:

• Prośba klienta → Utwórz zadanie
• Słowo kluczowe eskalacji → Przypisz do menedżera
• Problem rozwiązany → Zaktualizuj status zadania

---

Sync Behavior

Automatic Sync

AI SmartTalk okresowo synchronizuje dane ClickUp:

• Nowe zadania są dodawane
• Zaktualizowane zadania są odświeżane
• Usunięte/archiwizowane zadania są usuwane

Manual Sync

Wymuś natychmiastowe odświeżenie:

1. Przejdź do Settings → Integrations → ClickUp
2. Kliknij Sync Now

Real-time Updates via Webhooks

Aby uzyskać natychmiastowe aktualizacje, skonfiguruj webhooks ClickUp:

1. W ClickUp przejdź do Settings → Integrations
2. Skonfiguruj webhook do punktu końcowego AI SmartTalk
3. Zmiany w zadaniach wyzwalają natychmiastowe aktualizacje bazy wiedzy

---

Rozwiązywanie problemów

Problemy z połączeniem

Problem	Rozwiązanie
"Autoryzacja nie powiodła się"	Ponownie autoryzuj przez OAuth
"Nie znaleziono przestrzeni roboczej"	Sprawdź uprawnienia przestrzeni roboczej
"Dostęp zabroniony"	Upewnij się, że masz rolę członka/admina

Problemy z synchronizacją

Problem	Rozwiązanie
Brakujące zadania	Zweryfikuj, czy zadania są w wybranych listach
Nieaktualne dane	Kliknij Synchronizuj teraz, aby odświeżyć
Dokumenty nie synchronizują się	Włącz Dokumenty w ustawieniach synchronizacji

Problemy z akcjami SmartFlow

Problem	Rozwiązanie
"Tworzenie zadania nie powiodło się"	Sprawdź, czy list_id jest ważne
"Nieprawidłowy status"	Użyj dokładnej nazwy statusu z ClickUp
"Użytkownik nie znaleziony"	Zweryfikuj user_id przypisanego użytkownika

---

Zarządzanie połączeniem

Akcja	Jak
Dodaj przestrzenie	Edytuj połączenie → Wybierz dodatkowe przestrzenie
Usuń przestrzenie	Odznacz przestrzenie, których nie potrzebujesz
Odśwież tokeny	Ponownie autoryzuj, jeśli token wygasa
Rozłącz	Ustawienia → Integracje → ClickUp → Rozłącz

---

Najlepsze praktyki

Dla synchronizacji wiedzy

1. Bądź selektywny: Synchronizuj tylko istotne przestrzenie/listy
2. Używaj opisów: Dobrze udokumentowane zadania = lepsze odpowiedzi AI
3. Spójne nazewnictwo: Jasne nazwy zadań pomagają AI zrozumieć kontekst
4. Regularna synchronizacja: Utrzymuj dane świeże dla dokładnych odpowiedzi

Dla akcji SmartFlow

1. Testuj w stagingu: Najpierw przetestuj tworzenie zadań w liście testowej
2. Obsługuj błędy: Dodaj obsługę błędów dla nieudanych wywołań API
3. Używaj szablonów: Twórz wielokrotnego użytku szablony zadań
4. Rejestruj akcje: Śledź automatyczne tworzenie zadań do audytu

---

Powiązana dokumentacja

• Przegląd integracji
• Integracja JIRA — Podobna integracja zarządzania projektami
• Akcje SmartFlow
• Webhooki SmartFlow