Existe-t-il un nœud PaperOffice pour n8n?
Non. Il n'existe pas de nœud dédié, ni d'identifiants prêts à l'emploi, ni de modèles publiés. Vous travaillez avec les nœuds standard HTTP Request, Webhook et le client MCP vers la REST-API documentée et le serveur MCP.
Quelle clé dois-je utiliser ?
Vous la générez dans l'application sous Compte → API. Pour REST, utilisez po_sk_ ou po_ut_, pour MCP utilisez po_ut_, po_gt_ ou OAuth 2.1; le serveur MCP rejette po_sk_ et po_pk_. Une adresse e-mail confirmée suffit. La fonctionnalité API est disponible dans tous les plans, y compris Free.
Comment n8n sait-il qu'un document est terminé?
Via un abonnement Webhook, à partir de Professional. Vous vous abonnez à document.processed avec l'URL de production de votre nœud Webhook. La livraison inclut pofid, workspace_id, le type de document, key_fields et les champs extraits. Pour les tâches que n8n lance lui-même, interrogez GET /job/get/{job_id}.
Quels événements n8n peut-il recevoir?
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, document.legal_hold_released, document.generated et task.completed. La fin d'une tâche API est interrogée via job/get.
Mon instance n8n doit-elle être accessible publiquement?
Oui pour les Webhooks. PaperOffice ne livre qu'aux adresses publiques via http ou https et ne suit pas de redirections. Les adresses privées, localhost et les hôtes de métadonnées sont bloqués. Pour les appels vers le serveur REST-API et MCP, n8n a seulement besoin d'un accès sortant vers api.paperoffice.ai et mcp.paperoffice.ai.
Puis-je créer des abonnements Webhook dans l'application ?
Non. Les abonnements Webhook se créent via API avec POST /webhooks/subscribe ou via l'outil MCP po_webhooks_subscribe. Avec POST /webhooks/test, vous envoyez un test.ping à votre nœud Webhook.
Comment vérifier qu'une livraison provient de PaperOffice?
Chaque livraison porte la signature X-PaperOffice avec sha256= et l'HMAC-SHA256 sur le texte brut. Le secret se trouve dans la réponse à l'abonnement. De plus, vous pouvez faire ajouter un en-tête personnalisé et activer l'authentification des en-têtes dans le nœud Webhook.
Un agent IA peut-il utiliser n8n PaperOffice?
Oui, via le client MCP avec l'URL du serveur https://mcp.paperoffice.ai/dms et le transport Streamable HTTP ou SSE. L'authentification se fait via OAuth 2.1 ou un jeton po_ut_ ou po_gt_. Les outils disponibles dépendent de votre plan.
n8n peut-il envoyer des données commerciales à PaperOffice?
Oui, à partir de Plus. Sous Knowledge Base AI, vous créez une source opérationnelle de type Push (URL d'ingestion). n8n envoie des commandes, expéditions, factures ou devis en tant que JSON, au maximum 500 enregistrements par appel et 60 appels par 10 minutes et source. Les agents de chat et de téléphone lisent ces données à partir de Professional, mais n'écrivent rien en retour.
Y a-t-il des limites pour les appels ?
Oui. Par clé, au moins 5 appels par seconde, 30 par minute, 100 par heure et 500 par jour sont possibles dans chaque plan, davantage dans les plans payants. Les boucles de requête comptent également ; prévoyez donc des pauses de 5 à 10 secondes.
Cela fonctionne-t-il également avec Make ou Zapier?
Oui, selon le même schéma: dans Make avec le module HTTP, dans Zapier avec une requête personnalisée vers la REST-API, pour les agents IA avec un client MCP vers https://mcp.paperoffice.ai/dms. Il n'existe pas d'applications ou de modules personnalisés pour Make et Zapier.
Où sont stockées les données ?
Les documents que n8n envoie à PaperOffice sont traités par PaperOffice dans son propre centre de données en UE. Ce que n8n stocke lui-même se trouve là où votre instance n8n s'exécute, qu'elle soit auto-hébergée ou dans le cloud n8n.