Esiste un nodo PaperOffice per n8n?
No. Non esiste un nodo dedicato, né credenziali pronte o modelli pubblicati. Si lavora con i nodi standard HTTP Request, Webhook e il client MCP verso la documentata REST-API e il server MCP.
Quale chiave è necessaria?
La si genera nell'app sotto Account → API. Per REST si utilizza po_sk_ o po_ut_, per MCP po_ut_, po_gt_ o OAuth 2.1; il server MCP rifiuta po_sk_ e po_pk_. È sufficiente un'email confermata. La chiave API è disponibile in tutti i piani, incluso Free.
Come fa n8n a sapere che un documento è pronto?
Attraverso un abbonamento webhook, da Professional. Si sottoscrive document.processed con l'URL di produzione del Suo nodo webhook. La consegna include pofid, workspace_id, tipo di documento, key_fields e i campi estratti. Per i job avviati direttamente da n8n, si interroga GET /job/get/{job_id}.
Quali eventi può ricevere 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 e document.legal_hold_released. È possibile verificare la fine di un lavoro API tramite job/get.
La Sua istanza n8n deve essere raggiungibile pubblicamente?
Per i webhook sì. PaperOffice effettua connessioni solo verso indirizzi pubblici tramite http o https e non segue i reindirizzamenti. Gli indirizzi privati, localhost e gli host dei metadati sono bloccati. Per le chiamate al server REST-API e MCP, n8n richiede solo accesso in uscita a api.paperoffice.ai e mcp.paperoffice.ai.
Posso creare abbonamenti webhook nell'app?
No. Gli abbonamenti webhook si creano tramite API con POST /webhooks/subscribe o tramite lo strumento MCP po_webhooks_subscribe. Con POST /webhooks/test si invia un test.ping al Suo nodo webhook.
Come verificare che una consegna provenga da PaperOffice?
Ogni consegna include la firma X-PaperOffice con sha256= e l'HMAC-SHA256 sul testo grezzo. Il segreto si trova nella risposta all'abbonamento. Inoltre, è possibile richiedere l'invio di un'intestazione personalizzata e attivare l'autenticazione delle intestazioni nel nodo webhook.
Un agente IA può utilizzare n8n PaperOffice?
Sì, tramite il client MCP con l'URL del server https://mcp.paperoffice.ai/dms e il trasporto Streamable HTTP o SSE. L'autenticazione avviene tramite OAuth 2.1 o un token po_ut_ o po_gt_. Gli strumenti disponibili dipendono dal piano scelto.
n8n può inviare dati aziendali a PaperOffice?
Sì, a partire da Plus. In Knowledge Base AI è possibile creare una fonte operativa di tipo Push (URL di ingestione). n8n invia ordini, spedizioni, fatture o preventivi come JSON, con un massimo di 500 record per chiamata e 60 chiamate ogni 10 minuti per fonte. Gli agenti di chat e telefono possono leggere questi dati a partire da Professional, ma non possono scrivere nulla.
Esistono limiti per le chiamate?
Sì. Per ogni chiave, in ciascun piano sono consentiti almeno 5 chiamate al secondo, 30 al minuto, 100 all'ora e 500 al giorno; nei piani a pagamento i limiti sono superiori. Le chiamate nei loop di interrogazione vengono conteggiate, pertanto si consiglia di inserire pause di 5-10 secondi.
È possibile farlo anche con Make o Zapier?
Sì, seguendo lo stesso schema: in Make tramite il modulo HTTP, in Zapier con una richiesta personalizzata verso la REST-API, e per gli agenti IA con un client MCP verso https://mcp.paperoffice.ai/dms. Non esistono applicazioni o moduli personalizzati per Make e Zapier.
Dove sono archiviati i dati?
I documenti che n8n invia a PaperOffice vengono elaborati da PaperOffice nel proprio data center in UE. Ciò che n8n archivia direttamente si trova dove viene eseguita l'istanza di n8n, sia essa gestita autonomamente o nella cloud di n8n.