Existuje uzel PaperOffice pro n8n?
Ne. Neexistuje žádný vlastní uzel, žádné hotové pověření ani zveřejněné šablony. Pracujete se standardními uzly HTTP Request, Webhook a klientem MCP proti zdokumentovanému rozhraní REST-API a serveru MCP.
Jaký klíč potřebuji?
Vygenerujete jej v aplikaci pod Účet → API. Pro REST použijte API klíč (poai_) nebo uživatelský token (po_ut_), pro MCP pak po_ut_, po_gt_ nebo OAuth 2.1; API klíče (poai_), po_sk_ a po_pk_ server MCP odmítá. Postačuje potvrzená e-mailová adresa. API je dostupné ve všech plánech, včetně Free.
Jak se n8n dozví, že je dokument hotový?
Předplatným webhooku, od verze Professional. Předplatíte událost document.processed s výrobní URL vašeho uzlu webhooku. Doručení obsahuje pofid, workspace_id, typ dokumentu, key_fields a extrahovaná pole. Pro úlohy, které spouští n8n samo, dotazujte se GET /job/get/{job_id}.
Jaké události může n8n přijímat?
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 a document.legal_hold_released. Stav úlohy API můžete zkontrolovat pomocí funkce job/get.
Musí být vaše instance n8n veřejně dostupná?
Pro webhooky ano. PaperOffice doručuje pouze na veřejné adresy přes http nebo https a nesleduje žádné přesměrování. Soukromé adresy, localhost a hostitelé metadat jsou blokovány. Pro volání na server REST-API a MCP potřebuje n8n pouze odchozí přístup k api.paperoffice.ai a mcp.paperoffice.ai.
Mohu vytvářet předplatná webhooků v aplikaci?
Ne. Předplatná webhooků vytváříte pomocí API s POST /webhooks/subscribe nebo přes nástroj MCP po_webhooks_subscribe. Pomocí POST /webhooks/test odešlete test.ping na váš uzel webhooku.
Jak ověřím, že doručení pochází od PaperOffice?
Každé doručení nese podpis X-PaperOffice s sha256= a HMAC-SHA256 přes čistý text. Tajný klíč je obsažen v odpovědi na předplatné. Navíc můžete nechat poslat vlastní hlavičku a v uzlu webhooku aktivovat ověření hlavičky.
Může KI-agent v n8n využívat PaperOffice?
Ano, prostřednictvím klienta MCP s adresou serveru https://mcp.paperoffice.ai/dms a přenosem Streamable HTTP nebo SSE. Přihlášení probíhá přes OAuth 2.1 nebo token po_ut_ nebo po_gt_. Které nástroje jsou k dispozici, závisí na vašem plánu.
Může n8n odesílat obchodní data do PaperOffice?
Ano, z Plus. V rámci Knowledge Base AI vytvoříte obchodní datový zdroj typu Push (ingest URL). n8n odesílá objednávky, zásilky, faktury nebo nabídky ve formátu JSON, maximálně 500 záznamů na volání a 60 volání za 10 minut na zdroj. Webový chat a Conversation Agent čtou tato data z Professional a nic nevracejí.
Existují limity pro volání?
Ano. V každém plánu je možné provést alespoň 5 volání za sekundu, 30 za minutu, 100 za hodinu a 500 za den – v tarifu Free na klíč, v placených tarifech na účet. Dokud jsou k dispozici Credits, neplatí v placených tarifech žádná omezení rychlosti. Dotazy na stav pomocí GET /job/get se do tohoto limitu nezapočítávají.
Lze to provést také s Make nebo Zapier?
Ano, podle stejného vzoru: v Make s modulem HTTP, v Zapier s vlastním požadavkem proti REST-API, pro KI-agenty s klientem MCP proti https://mcp.paperoffice.ai/dms. Vlastní aplikace nebo moduly pro Make a Zapier neexistují.
Kde jsou uložena data?
Dokumenty, které n8n odesílá do PaperOffice, zpracovává PaperOffice ve svém vlastním datovém centru v EU. To, co n8n ukládá samo, se nachází tam, kde běží instance n8n, ať už je provozována samostatně nebo v cloudu n8n.