Czy istnieje węzeł PaperOffice dla n8n?
Nie. Nie ma dedykowanego węzła, gotowych danych uwierzytelniających ani opublikowanych szablonów. Należy korzystać ze standardowych węzłów HTTP Request, Webhook oraz klienta MCP, łącząc się z udokumentowanym interfejsem REST-API i serwerem MCP.
Jaki klucz jest wymagany?
Należy go wygenerować w aplikacji w sekcji Konto → API. Dla REST można wykorzystać klucz API (poai_) lub token użytkownika (po_ut_), dla MCP: po_ut_, po_gt_ lub OAuth 2.1; serwery MCP odrzucają klucze API (poai_), po_sk_ i po_pk_. Wystarczy potwierdzony adres e-mail. API jest dostępne we wszystkich planach, również w Free.
Jak n8n dowiaduje się o zakończeniu przetwarzania dokumentu?
Poprzez subskrypcję webhooków, od wersji Professional. Należy zasubskrybować zdarzenie document.processed podając URL produkcyjny węzła webhook. Dostawa zawiera pofid, workspace_id, typ dokumentu, key_fields oraz wyodrębnione pola. Dla zadań uruchamianych samodzielnie przez n8n należy zapytać o GET /job/get/{job_id}.
Jakie zdarzenia może otrzymać n8n?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed, document.legal_hold_placed oraz document.legal_hold_released. Aby sprawdzić, czy zadanie API zostało ukończone, należy skorzystać z funkcji job/get.
Czy instancja n8n musi być publicznie dostępna?
Tak, w przypadku webhooków. PaperOffice wysyła dane tylko do adresów publicznych przez http lub https i nie podąża za przekierowaniami. Adresy prywatne, localhost oraz hosty metadanych są zablokowane. Do połączeń z serwerem REST-API i MCP instancja n8n wymaga tylko wychodzącego dostępu do api.paperoffice.ai i mcp.paperoffice.ai.
Czy można tworzyć subskrypcje webhooków w aplikacji?
Nie. Subskrypcje webhooków tworzy się za pomocą API poprzez POST /webhooks/subscribe lub narzędzie MCP po_webhooks_subscribe. Poprzez POST /webhooks/test można wysłać test.ping do węzła webhook.
Jak sprawdzić, że dostawa pochodzi od PaperOffice?
Każda dostawa zawiera sygnaturę X-PaperOffice z sha256= oraz HMAC-SHA256 obliczoną na surowym tekście. Sekret znajduje się w odpowiedzi na subskrypcję. Dodatkowo można poprosić o wysłanie własnego nagłówka i włączyć uwierzytelnianie nagłówków w węźle Webhook.
Czy agent AI może korzystać z n8n w PaperOffice?
Tak, poprzez klienta MCP z adresem URL serwera https://mcp.paperoffice.ai/dms oraz transportem Streamable HTTP lub SSE. Logowanie odbywa się za pomocą OAuth 2.1 lub tokena po_ut_ / po_gt_. Dostępne narzędzia zależą od Państwa planu.
Czy n8n może wysyłać dane biznesowe do PaperOffice?
Tak, z Plus. W ramach Knowledge Base AI należy utworzyć źródło danych biznesowych typu Push (URL do ingestu). n8n wysyła zamówienia, przesyłki, faktury lub wyceny jako dane JSON, maksymalnie 500 rekordów na wywołanie oraz 60 wywołań na 10 minut na jedno źródło. Czat internetowy oraz Conversation Agent odczytują te dane z Professional i nie zapisują niczego z powrotem.
Czy istnieją ograniczenia dotyczące liczby wywołań?
Tak. W każdym planie możliwe są co najmniej 5 wywołań na sekundę, 30 na minutę, 100 na godzinę i 500 na dzień – w taryfie Free limit dotyczy każdego klucza, w płatnych taryfach limit dotyczy całego konta. Dopóki dostępne są Credits, w płatnych taryfach nie obowiązują limity szybkości. Zapytania statusu za pomocą GET /job/get nie są wliczane do limitu.
Czy jest to możliwe również z Make lub Zapier?
Tak, według tego samego schematu: w Make za pomocą modułu HTTP, w Zapier za pomocą Custom Request wobec REST-API, a dla agentów AI z klientem MCP wobec https://mcp.paperoffice.ai/dms. Własne aplikacje lub moduły dla Make i Zapier nie są dostępne.
Gdzie przechowywane są dane?
Dokumenty wysyłane przez n8n do PaperOffice przetwarzane są przez PaperOffice we własnym centrum danych w UE. To, gdzie przechowywane są dane samego n8n, zależy od lokalizacji instancji n8n, czy jest ona hostowana samodzielnie, czy w chmurze n8n.