n8n için bir PaperOffice düğümü var mı?
Hayır. Kendi başına bir düğüm, hazır kimlik bilgisi veya yayınlanmış şablon yoktur. Standart HTTP Request, Webhook ve MCP istemcisi düğümlerini belgelenmiş REST-API ve MCP sunucusuna karşı kullanırsınız.
Hangi anahtara ihtiyacım var?
Bunu Uygulama içinde Hesap → API bölümünde oluşturabilirsiniz. REST için bir API anahtarı (poai_) veya kullanıcı belirteci (po_ut_) kullanın; MCP için ise po_ut_, po_gt_ veya OAuth 2.1 kullanabilirsiniz. API anahtarları (poai_), po_sk_ ve po_pk_, MCP sunucusu tarafından reddedilir. Onaylanmış bir e-posta adresi yeterlidir. API, Free dahil tüm planlarda mevcuttur.
n8n, bir belgenin tamamlandığını nasıl öğrenir?
Bir webhook aboneliği aracılığıyla, Professional'ten itibaren. Webhook düğümünüzün üretim URL'si ile document.processed'i abone olursunuz. Teslimat pofid, workspace_id, belge türü, key_fields ve çıkarılan alanları içerir. n8n tarafından başlatılan işler için GET /job/get/{job_id} sorgusu yaparsınız.
n8n hangi olayları alabilir?
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 ve document.legal_hold_released. Bir API işinin sonunu job/get üzerinden kontrol edebilirsiniz.
n8n örneğimin herkese açık erişilebilir olması gerekiyor mu?
Webhooklar için evet. PaperOffice yalnızca genel adreslere http veya https üzerinden teslimat yapar ve yönlendirmeleri takip etmez. Özel adresler, localhost ve meta veri sunucuları engellenmiştir. REST-API ve MCP sunucusuna çağrılar için n8n'nin yalnızca api.paperoffice.ai ve mcp.paperoffice.ai'ya giden erişimi gerekir.
Webhook aboneliklerini uygulamada oluşturabilir miyim?
Hayır. Webhook aboneliklerini API ile POST /webhooks/subscribe veya MCP aracı po_webhooks_subscribe aracılığıyla oluşturursunuz. POST /webhooks/test ile webhook düğümünüze test.ping gönderirsiniz.
PaperOffice adresinden gelen bir teslimatın doğruluğunu nasıl kontrol edebilirim?
Her teslimat, sha256= ve ham metin üzerinden HMAC-SHA256 ile imzalanmış X-PaperOffice-Signature başlığını taşır. Gizli anahtar (secret), abonelik yanıtında yer alır. Ayrıca, kendi özel başlığınızı gönderilmesini sağlayabilir ve Webhook düğümünde Başlık Kimlik Doğrulamasını (Header Auth) etkinleştirebilirsiniz.
Bir AI ajanı n8n ortamında PaperOffice kullanabilir mi?
Evet, https://mcp.paperoffice.ai/dms sunucu URL'si ve Streamable HTTP veya SSE taşıma protokolü aracılığıyla MCP istemcisi üzerinden mümkündür. Kimlik doğrulama OAuth 2.1 veya bir po_ut_ / po_gt_ token ile gerçekleştirilir. Hangi araçların kullanılabilir olduğu planınıza bağlıdır.
n8n, PaperOffice'e iş verileri gönderebilir mi?
Evet, Plus üzerinden. Knowledge Base AI altında, Push (ingest URL) türünde bir iş veri kaynağı oluşturursunuz. n8n siparişleri, sevkiyatları, faturaları veya teklifleri JSON olarak gönderir; çağrı başına en fazla 500 kayıt ve kaynak başına 10 dakikada en fazla 60 çağrı yapılır. Website chat ve Conversation Agent bu verileri Professional üzerinden okur ve geriye hiçbir şey yazmaz.
Çağrılar için bir sınır var mı?
Evet. Her planda saniyede en az 5, dakikada 30, saatte 100 ve günde 500 çağrı mümkündür – Free tarifesinde anahtar başına, ücretli tarifelerde hesap başına. Credits mevcut olduğu sürece, ücretli tarifelerde hız sınırlamaları geçerli değildir. GET /job/get ile durum sorgulamaları buna dahil edilmez.
Bu işlem Make veya Zapier ile de mümkün müdür?
Evet, aynı desen izlenir: Make içinde HTTP modülü ile, Zapier içinde REST-API'e yönelik Özel İstek (Custom Request) ile; AI ajanları için ise https://mcp.paperoffice.ai/dms'e yönelik bir MCP istemcisi ile. Make ve Zapier için özel uygulamalar veya modüller bulunmamaktadır.
Veriler nerede saklanmaktadır?
n8n'ün PaperOffice'e gönderdiği belgeler, PaperOffice tarafından kendi AB (Avrupa Birliği) veri merkezinde işlenir. n8n'ün kendisinin depoladığı veriler ise, kendi işlettiğiniz veya n8n Cloud üzerinde çalışan n8n örneğinizin bulunduğu konumda yer alır.