Integracje / Teamwork

Komunikacja, projekty i biuro

Integracja AI: Teamwork

Podłączamy Teamwork przez REST API v3: czytamy wpisy z Time Log, Task Lists z polami estimatedHours oraz wątki z Messages. Asystent zestawia zalogowane godziny z budżetem projektu, wskazuje zadania po terminie i co piątek składa szkic raportu statusowego przed startem dnia.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Projekty Teamwork” w portalu redAi, ekran z danymi z programu Teamwork
Narzędzie „Projekty Teamwork” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem Teamwork?

Łączymy się przez REST API v3 pod adresem nazwafirmy.teamwork.com/projects/api/v3/. Klucz API generujecie w profilu w zakładce API & Webhooks, dziedziczy uprawnienia konta, z którego go wygenerowaliście.

Na start potrzebujemy
Konto Teamwork na planie płatnym z włączonym dostępem do API i Webhooks
Czego asystent nie robi
Nie loguje godzin w Time Log samodzielnie: każdy wpis czasu wymaga potwierdzenia osoby, która ją przepracowała
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z Teamwork w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Projekty Teamwork. Moduł zbiera dane ze wszystkich aktywnych projektów w Teamwork i zestawia zużycie budżetu z procentem ukończonych zadań. Widzicie na jednym ekranie, gdzie budżet ucieka szybciej niż postęp, i otwieracie kartę projektu jednym kliknięciem. Asystent wykrywa listy zadań, które pochłonęły więcej czasu niż szacowano, i dostarcza powiadomienie z kontekstem przed Waszą rozmową z klientem.

  • Zestawia godziny billable z budżetem estimatedHours per projekt i Task Lista
  • Flaguje projekty, gdzie zużycie czasu wyprzedza procent ukończenia zadań
  • Pokazuje liczbę zadań po terminie per projekt z filtrem overdueTasksOnly
  • Pobiera stan kamieni milowych i dołącza je do przeglądu portfela
  • Otwiera kartę projektu z rozbiciem na Task Listy i wpisy z Time Log
Rozmowa z asystentem AI w portalu redAi o danych z programu Teamwork: Ustalenia z wątków Messages: ten tydzień

Pytanie w czacie

Asystent czyta wątki Messages z Teamwork i wyciąga pytania bez odpowiedzi, zanim klient upomni się sam.

Co ustaliliśmy z klientami w tym tygodniu w wątkach Messages w Teamwork? Interesują mnie szczególnie pytania, które wciąż czekają na odpowiedź.
Karta CervoTech: rebrand w narzędziu Projekty Teamwork w portalu redAi

Karta w narzędziu

Macie jeden widok zamiast trzech zakładek w Teamwork: Task Lists, Time Log i Messages razem w karcie projektu.

Jeden ekran zamiast otwierania każdego projektu osobno w Teamwork. Asystent sam wyłapuje, gdzie budżet ucieka szybciej niż postęp.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie Teamwork włączamy dopiero wtedy, gdy sami tego chcecie.

Task Lists z budżetem

Czytamynazwy list zadań, pole estimatedHours, procent ukończonych zadań i suma zalogowanych godzin billable per lista

AsystentZestawia zużyte godziny z budżetem i flaguje projekty, gdzie zużycie czasu wyprzedza procent ukończenia zadań

Time Log: wpisy godzinowe

Czytamypola hours, billable, taskId, personId, date i opis każdego wpisu w wybranym zakresie dat

AsystentSumuje godziny billable per projekt i per osoba, wykrywa Task List pochłaniającą czas ponad szacunek

Messages i komentarze

Czytamyposty z treścią HTML, komentarze, data i autor z ostatnich 7 dni wybranego projektu

AsystentStreszcza ustalenia tygodnia, wyciąga pytania bez odpowiedzi i składa szkic raportu dla klienta

Zadania z przeterminowanym dueDate

Czytamytytuł, dueDate, assignee i liczba dni zwłoki dla zadań z filtrem overdueTasksOnly=true

AsystentGrupuje opóźnienia per osoba z liczbą dni zwłoki i dostarcza powiadomienie z kontekstem, nie tabelkę do samodzielnego interpretowania

Notebooks: dokumenty wewnętrzne

Czytamypełna treść dokumentów wewnętrznych projektu w formacie HTML pobierana przez API

AsystentCzyta dokumenty projektowe i włącza je jako kontekst do analiz, bez konieczności kopiowania treści do rozmowy

Files i załączniki klienta

Czytamylista plików z polem download_url i datą przesłania, posortowana od najnowszych

AsystentPobiera pliki PDF i Word przez download_url i odczytuje ich treść, nie tylko nazwę, bo sam URL nic nie powie

Milestones projektów

Czytamykamienie milowe z nazwą, datą zakończenia i przypisaniem do konkretnego projektu

AsystentSprawdza zbliżające się i przekroczone milestony i dołącza je do piątkowego raportu statusowego

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Które projekty przekroczyły 80% budżetu godzin przy mniej niż połowie zadań?”
  • „Co ustaliliśmy z klientem w tym tygodniu w wątkach Messages?”
  • „Kto ma zadania po terminie i jak wiele dni już czekają?”
  • „Złóż szkic raportu statusowego na piątkowy mail do klienta”

Co się zmienia

Piątkowy raport statusowy i zestawienie godzin kontra budżet gotowe rano, zanim account manager usiądzie do komputera, bez ręcznego przeglądu Messages.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

Teamwork to platforma do zarządzania projektami skierowana do agencji kreatywnych i firm usługowych rozliczających pracę godzinami. Projekty dzielą się na Task Lists z polem estimatedHours, zadania mają priorytety, terminy, Milestones i flagę billable. Na co dzień zespół loguje czas w Time Log, prowadzi wątki w Messages i trzyma dokumenty robocze w Notebooks.

Platforma działa jako aplikacja chmurowa pod subdomeną firmy, np. nazwafirmy.teamwork.com, gdzie trzyma wszystkie dane projektów, zadań, wpisów czasu i wiadomości. Oprócz zarządzania zadaniami obejmuje Files do plików klienta i wbudowany dostęp dla klientów z konfigurowalnymi uprawnieniami, gdzie każdy element ma przełącznik widoczności. Webhooks na poziomie konta reagują na zdarzenia w czasie rzeczywistym.

Gdzie to działa najlepiej

Account manager agencji

Piątek, 7:30. Manager otwiera portal i zamiast spędzać 40 minut na przeglądaniu wątków Messages i zbieraniu statusów, widzi gotowy szkic raportu dla klienta z listą ukończonych zadań i pytaniami bez odpowiedzi.

Z asystentem: Sprawdza szkic, poprawia ton w dwóch zdaniach i publikuje jako post w Messages. Raport idzie do klienta przed 8:00, zanim PM usiądzie do komputera.

Project manager projektu

Środa rano, PM dostaje powiadomienie: projekt X zużył 85% budżetu przy 60% ukończeniu zadań. W Time Log widzi, że Task List 'Rewizje materiałów' pochłonęła dwa razy więcej godzin niż szacowano.

Z asystentem: Asystent grupuje godziny per lista zadań i wskazuje, gdzie budżet ucieka. PM wchodzi do rozmowy z klientem z konkretnymi liczbami, nie domysłami.

Właściciel agencji

Poniedziałek, właściciel chce sprawdzić stan aktywnych projektów: które mają zadania po terminie i kto za nie odpowiada, bez otwierania każdego projektu osobno w Teamwork.

Z asystentem: Asystent pobiera listę przeterminowanych zadań filtrem overdueTasksOnly, grupuje per osoba z liczbą dni zwłoki. Właściciel widzi stan portfela w jednym raporcie.

Jak się łączymy

Łączymy się przez REST API v3 pod adresem nazwafirmy.teamwork.com/projects/api/v3/. Klucz API generujecie w profilu w zakładce API & Webhooks, dziedziczy uprawnienia konta, z którego go wygenerowaliście. Zalecamy konto z rolą Observer albo Collaborator: widzi wszystkie projekty, ale nie może edytować danych. Zapytania działają w trybie odczytu, zapis wymaga zatwierdzenia.

Portal z plikami, bazami i historią rozmów stoi na serwerze klienta. Do modelu AI trafia polecenie i fragmenty danych potrzebne do konkretnej odpowiedzi, bez trenowania cudzych modeli na danych klienta. Webhooks Teamwork reagują natychmiast na zdarzenia takie jak TASK_COMPLETED albo TIMERLOG_CREATED, więc asystent nie musi odpytywać systemu co godzinę.

Czego potrzebujemy od Was

  • Konto Teamwork na planie płatnym z włączonym dostępem do API i Webhooks
  • Klucz API na koncie z rolą Observer lub Collaborator, z dostępem do wszystkich projektów
  • Lista ID projektów do obserwacji, widoczna w URL lub w odpowiedzi API
  • Wypełnione pola dueDate i estimatedHours w zadaniach i Task Lists, żeby analiza dawała użyteczne wyniki
  • Osoba po stronie firmy zatwierdzająca szkice raportów przez pierwsze tygodnie integracji

Czego asystent nie robi

  • Nie loguje godzin w Time Log samodzielnie: każdy wpis czasu wymaga potwierdzenia osoby, która ją przepracowała
  • Nie publikuje raportów ani postów w Messages bez akceptacji account managera lub PM
  • Nie czyta danych z Teamwork Desk: helpdesk to osobny produkt z osobnym API, poza zakresem tej integracji
  • Nie analizuje treści załączników bez ich wcześniejszego pobrania przez download_url, sam URL pliku nie wystarcza

Częste pytania

Czy AI będzie widziało stawki godzinowe i wyceny naszych projektów?

Klucz API dziedziczy uprawnienia konta, z którego go wygenerowaliście. Jeśli to konto widzi stawki w Time Log, AI też je zobaczy. Dlatego zalecamy konto z rolą Observer: ma dostęp do danych operacyjnych, ale bez ustawień finansowych i rozliczeniowych całego konta.

Co się stanie, jeśli w naszym Teamwork brakuje dueDate albo estimatedHours?

Asystent podaje wynik tylko z danych, które są wypełnione. Braki liczy i raportuje osobno, np. '12 zadań bez daty terminu w projekcie X'. To często pierwszy efekt integracji: firma widzi, gdzie trzeba poprawić dyscyplinę wypełniania pól, zanim analiza budżetu i terminów będzie miała sens.

Czy możemy zacząć od jednego projektu testowego i dodawać kolejne stopniowo?

Tak. Integracja pracuje na liście ID projektów, którą podajecie na wejściu. Możecie zacząć od jednego projektu pilotażowego, sprawdzić jakość raportów i dyscyplinę danych w zespole, a potem rozszerzyć zakres na kolejne projekty bez przebudowy ustawień integracji.

Jak długo zajmie pierwsze pobranie danych i jak sprawdzimy, że wszystko działa?

Dla projektów z kilkuletnią historią pierwsze pobranie może zająć kilkanaście minut. Zalecamy ograniczyć zakres dat do ostatnich 90 dni. Po uruchomieniu asystent generuje testowy raport z jednego projektu: account manager sprawdza, czy dane i format odpowiadają oczekiwaniom, zanim integracja ruszy na pełnym zakresie.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z Teamwork

Jedno zdanie wystarczy: czego szukacie w Teamwork albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Teamwork jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.