Existe um nó PaperOffice para n8n?
Não. Não há um nó dedicado, credenciais prontas ou modelos publicados. O trabalho é realizado com os nós padrão HTTP Request, Webhook e cliente MCP contra a REST-API documentada e o servidor MCP.
Qual chave eu preciso?
O senhor gera isso no aplicativo em Conta → API. Para REST, utilize po_sk_ ou po_ut_, para MCP po_ut_, po_gt_ ou OAuth 2.1; o servidor MCP rejeita po_sk_ e po_pk_. Um e-mail confirmado é suficiente. A API está disponível em todos os planos, inclusive em Free.
Como n8n sabe que um documento está concluído?
Através de uma assinatura de webhook, a partir de Professional. O senhor assina document.processed com a URL de produção do nó do webhook. A entrega traz pofid, workspace_id, tipo de documento, key_fields e os campos extraídos. Para trabalhos iniciados pelo próprio n8n, consulte GET /job/get/{job_id}.
Quais eventos n8n pode receber?
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. Para verificar se um trabalho API foi concluído, utilize o job/get.
Minha instância n8n precisa ser acessível publicamente?
Para webhooks, sim. PaperOffice entrega apenas para endereços públicos via http ou https e não segue redirecionamentos. Endereços privados, localhost e hosts de metadados estão bloqueados. Para chamadas ao servidor REST-API e MCP, n8n precisa apenas de acesso de saída para api.paperoffice.ai e mcp.paperoffice.ai.
Posso criar assinaturas de webhook no aplicativo?
Não. As assinaturas de webhook são criadas via API com POST /webhooks/subscribe ou pela ferramenta MCP po_webhooks_subscribe. Com POST /webhooks/test, o senhor envia um test.ping para seu nó de webhook.
Como verifico que uma entrega vem de PaperOffice?
Cada entrega contém a assinatura X-PaperOffice com sha256= e o HMAC-SHA256 sobre o texto bruto. O segredo está na resposta à assinatura. Além disso, é possível solicitar um cabeçalho próprio e ativar a Autenticação de Cabeçalho no nó do webhook.
Um agente de IA pode utilizar n8n PaperOffice?
Sim, através do cliente MCP com a URL do servidor https://mcp.paperoffice.ai/dms e o transporte Streamable HTTP ou SSE. O login ocorre via OAuth 2.1 ou um token po_ut_ ou po_gt_. Quais ferramentas estão disponíveis dependem do seu plano.
n8n pode enviar dados empresariais para PaperOffice?
Sim, a partir de Plus. Em Knowledge Base AI, cria-se uma fonte operacional do tipo Push (URL de ingestão). n8n envia pedidos, remessas, faturas ou orçamentos como JSON, no máximo 500 registros por chamada e 60 chamadas por 10 minutos e fonte. Agentes de chat e telefone leem esses dados a partir de Professional, mas não escrevem nada de volta.
Existem limites para as chamadas?
Sim. Por chave, são possíveis no mínimo 5 chamadas por segundo, 30 por minuto, 100 por hora e 500 por dia em cada plano, sendo mais em planos pagos. Laços de consulta contam como chamadas; portanto, planeje pausas de 5 a 10 segundos.
Isso também é possível com Make ou Zapier?
Sim, seguindo o mesmo padrão: em Make com o módulo HTTP, em Zapier com solicitação personalizada contra a REST-API, para agentes de IA com um cliente MCP contra https://mcp.paperoffice.ai/dms. Não existem aplicativos ou módulos próprios para Make e Zapier.
Onde estão os dados?
Os documentos que n8n envia para PaperOffice são processados por PaperOffice em seu próprio data center na UE. O que n8n armazena fica onde sua instância n8n está em execução, seja operada internamente ou na nuvem n8n.