Integrator w praktyce: łączenie się z klientem

Wynik na początek: Kranvik Precision jest zintegrowany

Dzień dobry i witamy w Akademii PaperOffice AI. Czwarty odcinek serii partnerskiej dotyczy pracy integratora w praktyce: łączymy się technicznie z klientem. Najpierw wynik. Dla naszego klienta Kranvik Precision w Londynie istnieje dedykowane Workspace na naszym koncie. Ich faktury trafiają tam automatycznie z ich skrzynki pocztowej, a ich zespół zadaje pytania dotyczące dokumentów w Claude, nie widząc niczego innego na naszym koncie. Osiąga się to w czterech krokach: Workspace dla klienta, grupa użytkowników z dokładnie tym Workspace, token grupowy dla Claude oraz automatyczne odbieranie dokumentów. Na końcu zobaczymy, gdzie kończy się użycie.

Rozdział 1: Jeden Workspace na klienta

Jako integrator Państwa rozwiązanie działa na Państwa własnym koncie PaperOffice. Klient płaci Państwu według Państwa ceny, a użycie otrzymuje korzyść integratora. Dla każdego klienta należy utworzyć dedykowany Workspace. Zapewnia to, że dokumenty, agenci i wiedza pozostają oddzielone dla każdego klienta. Odnosimy się do tego jako Kranvik Precision.

Rozdział 2: Grupa z dokładnie tym Workspace

Aby upewnić się, że zespół klienta widzi tylko swój Workspace, należy utworzyć grupę w sekcji Grupy użytkowników. Przy konfiguracji Dostępu do Workspace należy wybrać listę białą i przypisać do niej wyłącznie Kranvik Precision. Dla tego Workspace określa się, co grupa może robić z dokumentami, np. oglądać i pobierać, ale nie przesyłać. Obszary takie jak Storage Mounts lub Connectors należy ustawić na „Brak dostępu”. Pospolitym błędem jest grupa z pełnym dostępem. Wtedy token widzi wszystkie Workspaces na Państwa koncie, w tym tych od innych klientów. Dlatego należy sprawdzić na liście grup, czy dostęp jest ograniczony.

Rozdział 3: Token grupowy dla Claude

W sekcji API & Developer tworzy się token grupowy dla tej grupy. Służy on dla MCP Connect, czyli dla Claude, ChatGPT lub Cursor, i przejmuje dokładnie uprawnienia oraz Workspaces grupy. Token można skopiować w dowolnym momencie z listy kluczy API. Należy traktować go jak hasło i udostępniać wyłącznie przez bezpieczne kanały. W Claude klient dodaje PaperOffice jako łącznik i loguje się raz, używając tokena. Od tego momentu zespół klienta zapytuje o własne dokumenty bezpośrednio w Claude. Dla procesów serwerowych stosuje się natomiast klucz API. Dla Claude oraz innych asystentów AI dostępne są token grupowy lub token użytkownika. W przypadku odejścia osoby z zespołu klienta należy zmienić token. Aplikacja natychmiast generuje nowy, a stary traci ważność. Klient wprowadza nowy do Claude raz.

Rozdział 4: Dokumenty docierają automatycznie

Teraz dokumenty docierają samej siebie. Najprostszym sposobem jest skrzynka faktur klienta: w sekcji Storage Mounts należy połączyć skrzynkę poprzez IMAP, podając nazwę użytkownika oraz hasło aplikacji. Connector w trybie importu pobiera nowe wiadomości e-mail w stałych odstępach czasu i zapisuje je w Kranvik Precision o nazwie Workspace. Tam PaperOffice odczytuje dokumenty tak samo jak każdy inny dokument. Jeśli klient posiada NAS lub skaner, należy połączyć go za pomocą tej samej metody, na przykład poprzez SFTP. Dedikowane filmy na ten temat są dostępne w Akademii.

Rozdział 5: Własne przepływy pracy z n8n

Dla własnych procesów należy użyć API, na przykład z n8n: nowe faktury są wyodrębniane, sprawdzane i przekazywane dalej. Nasz film „Skrzynka, która myśli razem z Tobą” w Akademii pokazuje krok po kroku, jak zbudować taką skrzynkę.

Rozdział 6: Gdzie trafiają się użycia

Wszystkie połączenia są przetwarzane przez Państwa konto. Korzyść integratora widoczna jest na odznaczeniu partnera na karcie planu oraz przy każdej linii w użyciu API. Kwota, którą Państwo naliczają klientowi za tę usługę, pozostaje w Państwa gestii. Podsumowując: jeden Workspace na klienta, grupa zawierająca dokładnie ten Workspace, token grupowy dla Claude oraz dokumenty trafiają automatycznie poprzez skrzynkę pocztową lub NAS. Wszystko działa przez Państwa konto. Następny i ostatni odcinek dotyczy praktycznej pracy jako reseller: jak klient rozpoczyna samodzielnie. Do zobaczenia w kolejnym odcinku w Akademii PaperOffice AI.