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.

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

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 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.
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ń
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
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
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
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
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
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.
Jak zaczynamy
- 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.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
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ąć.
Inne programy: komunikacja, projekty i biuro
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.