Automatyzacja n8n
TECHNICZNE ZADANIE
Automatyzacja przetwarzania dokumentów przez bota Telegram na platformie n8n
1. OGÓLNY OPIS PROJEKTU
Należy stworzyć zautomatyzowany workflow na platformie n8n, który zapewni przetwarzanie dokumentów przez bota Telegram z dalszą analizą za pomocą Claude API, porównywaniem z wzorcową listą dokumentów w Google Arkuszach, automatycznym zaznaczaniem checkboxów oraz formowaniem archiwum dokumentów.
2. TECHNICZNY STACK
- Platforma automatyzacji: n8n
- Komunikator: Telegram Bot API
- Analiza AI: Claude API (prompt dostarczany przez Zamawiającego)
- Przechowywanie danych: Google Sheets
- Generowanie archiwum: Google Apps Script (już gotowy)
- Formaty plików: PDF, DOCX
3. WYMAGANIA FUNKCJONALNE
3.1 Odbieranie plików przez Telegram
Dane wejściowe:
- Użytkownik wysyła od 1 do 6 plików przez bota Telegram
- Typy plików: PDF, DOCX
- Liczba pracowników-użytkowników: kilka osób
Wymagania techniczne:
- Bot ma przyjmować wielokrotne przesyłanie plików (do 6 sztuk w jednym zapytaniu)
- Przechowywać pliki do dalszego przetwarzania
- Potwierdzać otrzymanie plików użytkownikowi
3.2 Analiza dokumentów za pomocą Claude API
Proces:
- Wszystkie otrzymane pliki są przesyłane do analizy do Claude API
- Wykorzystywana jest gotowa instrukcja (prompt), którą dostarcza Zamawiający
- Claude analizuje treść dokumentów i wyciąga informacje
Format odpowiedzi:
- Struktura JSON (format określony przez Zamawiającego)
- Zawiera nazwy/typy dokumentów, wykrytych w plikach
Wymagania techniczne:
- Przetwarzanie wszystkich typów plików (PDF, DOCX)
- Przechowywanie odpowiedzi JSON do dalszego przetwarzania
3.3 Porównanie z wzorcową listą i zaznaczanie checkboxów
Źródło wzorcowych danych:
- Google Arkusz (konkretna tabela będzie dostarczona przez Zamawiającego)
- Struktura: jeden wiersz = jeden dokument = jeden checkbox
- Wzorcowa lista nazw dokumentów jest przechowywana w tej samej tabeli
Logika porównania:
- Porównanie nazw dokumentów z odpowiedzi JSON z wzorcową listą
- Zasada porównania: zgodność treści (niekoniecznie dokładne dopasowanie tekstowe)
- Wszystkie nazwy w wzorcowej liście są unikalne (gwarantowane przez Zamawiającego)
Działania przy znalezieniu zgodności:
- W odpowiednim wierszu Google Arkusza zaznaczany jest aktywny checkbox (checked)
Wynik:
- Lista dokumentów dzieli się na dwie kategorie:
- Znalezione: dokumenty, które zgadzają się z wzorcową listą (checkboxy zaznaczone)
- Nie znalezione: dokumenty, które nie zgadzają się z żadną pozycją w wzorcu
3.4 Generowanie archiwum dokumentów
Proces:
- Po zaznaczeniu checkboxów wywoływany jest gotowy Google Apps Script
- Skrypt generuje archiwum ZIP z dokumentami PDF na podstawie zaznaczonych checkboxów
- Archiwum jest formowane automatycznie
Wymagania techniczne:
- n8n ma wywołać wykonanie istniejącego Google Apps Script
- Uzyskać link lub plik z wygenerowanym archiwum
3.5 Zwracanie wyniku w Telegramie
Co jest zwracane użytkownikowi:
- Archiwum dokumentów (plik ZIP, otrzymany od Google Apps Script)
- Lista nieznalezionych dokumentów - prosty tekstowy wykaz nazw dokumentów, które nie zgadzały się z wzorcową listą
Format wiadomości:
✅ Przetwarzanie zakończone!
📦 Archiwum dokumentów: [plik]
❌ Nie znalezione dokumenty:
- [Nazwa dokumentu 1]
- [Nazwa dokumentu 2]
- [Nazwa dokumentu N](jeśli wszystkie dokumenty zostały znalezione, blok „Nie znalezione dokumenty” nie jest wyświetlany)
4. WYMAGANIA NIEFUNKCJONALNE
4.1 Wydajność
- Maksymalny czas przetwarzania jednego zapytania: do 5 minut
- Workflow ma przetwarzać zapytania sekwencyjnie (kolejka)
4.2 Logowanie
- Obowiązkowe logowanie wszystkich etapów przetwarzania:
- Kto (Telegram User ID/Nazwa użytkownika)
- Kiedy (data i czas)
- Jakie pliki zostały przesłane (nazwy, liczba)
- Wynik analizy Claude
- Jakie checkboxy zostały zaznaczone
- Jakie dokumenty nie zostały znalezione
- Status wykonania (sukces/błąd)
- Logi przechowywać w osobnym arkuszu Google Arkusza lub innym wygodnym formacie
4.3 Obsługa błędów
- Szczegóły obsługi błędów (Claude API niedostępny, błędy przetwarzania plików, błędy Google Sheets) będą uzgodnione z wykonawcą na etapie rozwoju
- Użytkownik ma otrzymywać zrozumiałe komunikaty o błędach
5. PODZIAŁ ODPOWIEDZIALNOŚCI
Wykonuje Zamawiający:
- ✅ Dostarcza gotową instrukcję (prompt) dla Claude API
- ✅ Udostępnia dostęp do Google Arkusza ze strukturą
- ✅ Dostarcza gotowy Google Apps Script do generowania archiwum
- ✅ Realizuje autoryzację/identyfikację użytkowników w bocie Telegram
- ✅ Określa format odpowiedzi JSON od Claude
Wykonuje Wykonawca:
- ✅ Tworzy workflow na platformie n8n
- ✅ Konfiguruje integrację z Telegram Bot
- ✅ Konfiguruje integrację z Claude API
- ✅ Konfiguruje integrację z Google Sheets API
- ✅ Realizuje logikę porównania dokumentów
- ✅ Realizuje automatyczne zaznaczanie checkboxów
- ✅ Konfiguruje wywołanie Google Apps Script
- ✅ Realizuje logowanie procesu
- ✅ Uzgadnia z Zamawiającym obsługę błędów
- ✅ Przeprowadza testowanie workflow
-
Dzień dobry!
Mam ponad 3-letnie doświadczenie w pracy z n8n, Telegram Bot API. Jestem gotów zrealizować pełny workflow: przyjmowanie dokumentów w Telegramie, analiza przez Claude API, porównanie z wzorcową listą w Google Arkuszach, zaznaczanie checkboxów, wywołanie gotowego Google Apps Script do formowania archiwum oraz zwracanie wyników i logowanie w osobnym arkuszu.
Czy możemy omówić szczegóły?
-
1315 7 0 Dzień dobry.
Jestem gotów podjąć się realizacji Państwa projektu.
Mogę opracować dla Państwa taką automatyzację za pomocą n8n.
Proszę pisać na prywatną wiadomość, omówimy wszystkie szczegóły i będziemy mogli przystąpić do realizacji.
-
2848 17 0 1 Cześć, Danilo!
Zadanie jest całkowicie zrozumiałe. Realizacja techniczna zajmie około 3 dni, jeśli zajdzie potrzeba zmodernizowania promptu, to również mogę w tym pomóc. W pozostałych kwestiach nie ma pytań. Jedyną rzeczą, która może się zdarzyć, jest to, że dokumenty mają dużą objętość i AI nie będzie ich jakościowo przetwarzać (ale tutaj powiesz, czy w ogóle taka sytuacja jest możliwa). Ale na to też są rozwiązania, więc nie będzie problemu.
Mam ogromne doświadczenie, więc zostanie to wykonane dobrze i na czas)
Ogólnie rzecz biorąc, co do terminów: 3 dni robocze.
Co do kosztów, 10000 UAH będzie dobrze, ale możemy to omówić.
-
206 Dokładnie zapoznaliśmy się z zadaniem technicznym i jesteśmy gotowi zrealizować ten workflow na n8n pod klucz.
Posiadamy praktyczne doświadczenie w pracy z n8n, Telegram Bot API, integracjami przez REST API, Google Sheets oraz usługami AI (Claude / GPT). Rozumiemy specyfikę przetwarzania PDF i DOCX, budowy stabilnego JSON-wyjścia od AI oraz realizacji logiki semantycznego porównania dokumentów.
Szczególną uwagę poświęcimy:
stabilności odpowiedzi JSON od Claude
poprawnemu dopasowaniu semantycznemu z wzorcową listą
…
przetwarzaniu błędów oraz logice ponownego próbowania
kolejce przetwarzania zapytań (aby zmieścić się w 5 minutach)
szczegółowemu logowaniu każdego etapu
Mamy doświadczenie w budowie rozwiązań automatyzacji produkcji, gdzie ważna jest nie tylko funkcjonalność, ale także niezawodność i przejrzystość procesu.
Orientacyjny czas realizacji: 8-9 dni roboczych (z testowaniem).
Jesteśmy gotowi omówić szczegóły, wyjaśnić niuanse porównania semantycznego i rozpocząć pracę w najbliższym czasie.
-
432 1 0 Cześć, Danilo!
Mogę zrealizować pełny workflow w n8n dla zautomatyzowanego przetwarzania dokumentów przez Telegram z integracją Claude API, Google Sheets i Google Apps Script.
Będę zadowolony, aby omówić szczegóły, aby zaproponować optymalne rozwiązanie.
-
890 1 0 Dzień dobry, Danilo.
Jestem gotów stworzyć zautomatyzowany workflow na platformie n8n do przetwarzania dokumentów przez Telegram. Zintegruję Telegram Bot API, Claude API do analizy, Google Sheets API do porównania oraz wywołam Twój Google Apps Script do generowania archiwum. Zapewnię logowanie wszystkich etapów oraz obsługę błędów dla stabilnej pracy systemu.
---
Głównym problemem jest konieczność bezproblemowego połączenia Telegram, Claude API oraz Google Sheets w celu automatyzacji rutynowej weryfikacji dokumentów. Zbuduję workflow w n8n, który niezawodnie grupować będzie pliki wejściowe (do 6 sztuk), konwertować PDF/DOCX na tekst dla Claude oraz przetwarzać odpowiedź JSON w celu synchronizacji z Twoją tabelą.
Szczególną uwagę poświęcę logice porównania: zamiast sztywnego wyszukiwania wdrożę elastyczne dopasowanie nazw, aby Claude poprawnie identyfikował punkty z listy odniesienia. Po zaznaczeniu checkboxów przez Google Sheets API, n8n zainicjuje Twój Apps Script przez HTTP Request i zwróci gotowe archiwum użytkownikowi wraz z raportem o brakujących pozycjach.
…
Dla stabilności skonfiguruję kolejkę przetwarzania oraz szczegółowe logowanie każdego kroku (od ID użytkownika do statusów API) w osobnym arkuszu Google Sheets, jak wskazano w Tz. Wykorzystam n8n, Telegram Bot API oraz Claude API do stworzenia systemu odpornego na awarie.
---
Dokładną cenę oraz terminy będziemy mogli uzgodnić podczas omawiania szczegółów zadania.