Formstep

n8n ile belge toplama: her dosyanın ihtiyacı olan belgeleri isteyin

n8n'de belge toplayın: formu istekteki bir kontrol listesinden oluşturun, herkes yalnızca dosyasının gerektirdiğini göndersin, her yüklemeyi kaydedin.

Yazar , Formstep'in kurucusu · Yayınlandı · Güncellendi

n8n ile belge toplamanın bir form sorunu var. Su hasarı talebi için fotoğraflar ve bir onarım teklifi gerekir; hırsızlık talebi için ise polis raporu ve fişler. n8n’de bu gibi müşterilerden belge toplamak için ya koşullu mantıkla tek bir uzun form ya da talep türü başına bir form kurarsınız. İkisinde de elinizdeki şey bir kontrol listesiyken formları bakımda tutarsınız.

Bu iş akışı formu önceden kurmaz. Kontrol listesi bir Code node’unda durur, form isteğin içinde gider ve talep sahibi yalnızca kendi talebinin gerektirdiğini görür. Aynı adımlar onboarding sürecine, kredilere, kiralamalara ve vizelere de uyar: evrakın dosyaya göre değiştiği her yerde.

Bitmiş iş akışını formstep-claim-documents.json dosyasından içe aktarabilirsiniz; Formstep’te önceden form gerektirmez. Kendi sunucumdaki n8n 2.44’te, node’un 0.13.0 sürümüyle denedim.

Kısaca: kontrol listesini bir Code node’unda tutun ve istekle birlikte gönderin. Formu Formstep oluşturur, talep sahibi yalnızca talebinin gerektirdiğini görür, iş akışı sonucu bekler.

Çalıştırmadan sonra tamamlanmış n8n iş akışı: bir manuel tetikleyici, Claim, Build the checklist, Ask for the documents, Wait for the documents ve Completed?, ardından One item per file, Download each file ve Save to the claim folder, bir No answer dalıyla

Tüm iş akışı. Wait for the documents’ta, talep sahibi yükleyene kadar durur, sonra her dosyayı kaydeder. Tam boyutta görmek için seçin.

Bugün n8n’de müşterilerden belge nasıl toplanıyor

n8n’in Wait node formu dosya almaz, Form Trigger’ın da kendine ait sınırları var. 5 Kasım 2026’da okundu; n8n sık güncelleniyor, bir madde seçiminizi belirliyorsa kontrol edin.

  • Form Trigger’ın bir File öğesi var. Form Trigger onu on iki öğe türü arasında sayar, Form node’u ise multipleFiles ve acceptFileTypes seçenekleriyle sayfalar ekler. İş akışını başlatan kişi için uygundur.
  • Wait node’un formunda File alanı yok. Duraklatılmış bir iş akışı, On Form Submitted olarak ayarlanmış Wait üzerinde bekler; belgelenmiş türler Date, Dropdown List, Number, Password, Text ve Textarea’dır. Talebi sizin sisteminiz açar, yani belgeler gerektiğinde iş akışı zaten çalışmaktadır.
  • Yüklemeler boyut sınırlarına takılır. Kendi sunucunuzdaki n8n’de N8N_PAYLOAD_SIZE_MAX varsayılan olarak 16 MiB, N8N_FORMDATA_FILE_SIZE_MAX 200 MiB’dır; bir de proxy sınırı eklenir. Bir form bir VPS’te ikisi de yükseltilene kadar çalışmadı, n8n Cloud’da ise 100 ila 300 MB’lık videolar 413 hatası aldı ve kayıtlı bir çözüm yok.
  • Dosyaların bir yere taşınması gerekir. N8N_DEFAULT_BINARY_DATA_MODE değerini filesystem ya da S3 yapmazsanız ikili veri bellekte kalır, yürütme verileri ise varsayılan olarak 336 saat sonra silinir.

İş akışınız duraklatılmışken bir bağlantıyı açan müşteri için Formstep yüklemeyi barındırır, dosya başına 1 GiB’a kadar dosya alır ve iş akışınız devam ettiğinde indirmesi için her dosyanın URL’sini verir.

Başlamadan önce

Herkese açık HTTPS adresi olan, kendi sunucunuzda çalışan bir n8n üzerinde Formstep node’una ve bir Formstep kimlik bilgisine ihtiyacınız var. Node yalnızca kendi sunucunuzdaki n8n içindir: n8n Cloud yalnızca doğrulanmış topluluk node’larını yükler, bizimki henüz doğrulanmış değil. Dosyaları saklayacak bir yer de gerekir: örnek bunları n8n’in diskine yazar.

1. Talepten başlayın

Örnek, Claim adlı bir Edit Fields node’uyla açılır: claimId, claimType (water_damage ya da theft), claimLabel, firstName ve email. Sizin iş akışınızda bu, bir CRM fırsatı, yeni bir satır ya da talep sisteminizden gelen bir webhook’tur.

2. Kontrol listesini bloklara çevirin

Build the checklist adlı bir Code node’u, talep türüne göre belgeleri bulur ve formu bloklar olarak yazar: bir karşılama, karşılamanın okuduğu iki gizli alan, belge başına bir dosya sorusu ve bir not.

const checklists = {
  water_damage: [
    { key: 'damage_photos', title: 'Photos of the damage', maxFiles: 10 },
    { key: 'repair_estimate', title: 'Repair estimate from a contractor', maxFiles: 1 },
  ],
  theft: [
    { key: 'police_report', title: 'Police report', maxFiles: 1 },
    { key: 'receipts', title: 'Receipts for the stolen items', maxFiles: 10 },
  ],
}
const documents = checklists[$json.claimType]
if (!documents) throw new Error(`No checklist for claim type ${$json.claimType}`)
const blocks = [
  { type: 'header', content: 'Hi {{first_name}}, a few documents for claim {{claim_id}}' },
  { type: 'paragraph', content: 'Upload each document below. Photos from your phone are fine.' },
  { type: 'hiddenField', key: 'first_name' },
  { type: 'hiddenField', key: 'claim_id' },
  ...documents.map((document) => ({ type: 'file', ...document })),
  { type: 'text', key: 'notes', title: 'Anything we should know?', required: false },
]
return { json: { ...$json, blocks } }

throw, bilinmeyen bir talep türünde soru içermeyen bir form göndermek yerine çalışmayı durdurur. Metindeki {{first_name}} bir gizli alanın değerini gösterir; tüm blok türleri Tek çağrıda form ve istek oluşturma sayfasında.

Yeni bir talep türü eklemek, nesneye yeni bir giriş eklemek demektir ve kurulacak bir form yoktur.

3. İsteği yeni bir formla gönderin

Bir Formstep Create request node’u ekleyin ve Form Source değerini New Form yapın:

  • Form Blocks, Code node’undan gelen {{ JSON.stringify($json.blocks) }} değeridir.
  • Context gizli alanları doldurur: {{ JSON.stringify({ first_name: $json.firstName, claim_id: $json.claimId }) }}.
  • Form Options forma markanızı verir.
  • Recipient Email talepten gelir. Wait for the Outcome seçeneğini açın.
  • Additional Fields altında Delivery, bir External ID ve {{ $now.plus({ days: 14 }).toISO() }} gibi bir Expires At ayarlayın.

Kişiye göre değişen şeyleri Context veya Prefill içinde tutun, bloklarda ya da form adında asla. Formstep bir tanımı ilk gördüğünde form oluşturur, sonra onu yeniden kullanır; yani ikinci su hasarı talebi birincinin formunu alır ve yanıtta form.reused: true yazar. Talep sahibinin adını bloklara yazarsanız her istek yeni bir form oluşturur; çalışma alanı başına günde en fazla 300 yeni form.

Delivery değeri Email the Invitation olduğunda Pro veya Business gerekir; Free’nin denemeniz için kendi adresinize gönderdiği 10 davet bunun dışındadır. Free’de değeri None bırakın ve isteğin url değerini sonraki bir node ile kendi e-postanız ya da sohbetiniz üzerinden gönderin. Reminders da aynı şekilde çalışır: Pro ve Business, talep sahibi bitirene ya da istek sona erene kadar belirli aralıklarla e-posta gönderir; Free’de takibi siz yaparsınız. Örnekte Test Mode açıktır, yani siz kapatana kadar hiçbir e-posta gönderilmez. Planlar için fiyatlandırmaya bakın.

Talep sahibinin açtığı form, başlığı Hi Ada, a few documents for claim CLM-3107; Photos of the damage ve Repair estimate from a contractor için yüklemeler ve bir not sorusu var

Su hasarı kontrol listesinden kurulan form, talep sahibinin gördüğü hâliyle. Ad ve talep numarası Context’ten gelir.

4. Bekleyin, sonra dosya başına bir öğe oluşturun

On Webhook Call olarak ayarlanmış bir Wait node’u ve {{ $json.body.type }} değerinin request.completed olup olmadığını kontrol eden bir If node’u ekleyin. Diğer çıkış, süresi dolmuş ya da iptal edilmiş bir isteği yakalar; orada talebi takip eder ya da kapatırsınız. Başka bir tarih belirlemezseniz bir isteğin süresi 30 gün sonra dolar; en fazla 365 gün.

Her dosya sorusunun yanıtı; name, size, type ve url içeren bir dosya listesidir. İkinci bir Code node’u bunları dosya başına bir öğeye çevirir, böylece sonraki node’lar her yükleme için bir kez çalışır:

// One item per uploaded file, named after the question it answers.
const event = $json.body.data
const items = []
for (const [question, answer] of Object.entries(event.answers)) {
  if (!Array.isArray(answer)) continue
  for (const file of answer) {
    if (file.url) items.push({ json: { question, name: `${question} - ${file.name}`, url: file.url } })
  }
}
return items

Soruları tek tek adlandırmak yerine yanıtların hepsini dolaşır, bu yüzden her talep türünde çalışır.

5. Her dosyayı indirin ve kaydedin

Bir HTTP Request node’u, Response Format değeri File olarak, her öğe için bir kez {{ $json.url }} adresini indirir. Örnek sonra her dosyayı Read/Write Files from Disk ile /home/node/.n8n-files/{{ $('Claim').item.json.claimId }} {{ $json.name }} olarak yazar.

Google Drive kullanmak için bu node’u Google Drive › Upload file ile değiştirin: Input Data Field Name data, File Name {{ $json.name }} ve Parent Folder olarak talebin klasörü. S3, Dropbox ve SharePoint node’ları ikili alanı aynı şekilde alır. Dosyalar Formstep’e gitti, bu yüzden formunuzun yük sınırı hiç devreye girmedi ve her biri depolama alanınız dahilinde 1 GiB’a kadar olabilir.

Bir dosyanın url değerine parola gibi davranın. URL’ye sahip olan herkes dosyayı indirebilir ve URL’nin süresi dolmaz; bu yüzden dosyayı burada olduğu gibi indirin ve kendi kopyanızı paylaşın.

İstekte oluşturulan bir formun yapamadıkları

Bu tek talep sahibine özel bir dosya taşıyamaz; örneğin poliçesini ya da imzalanacak bir formu, çünkü böyle bir dosya zaten var olan bir forma yüklenir. Talep sahibine okuması veya imzalaması için bir şey de göndermek istiyorsanız, Yöneticiden onay alma rehberindeki gibi Documents bloğu olan yayınlanmış bir form kullanın. Olayın data.submission.pdfUrl alanı, yani tüm yanıtların PDF’i, yalnızca form bir PDF tutuyorsa dolar; bu yüzden bunun gibi yalnızca geri çağıran bir istekte yoktur.

n8n formunun daha iyi olduğu durum

Herkesten aynı dosyalar isteniyorsa, dosya soruları olan tek bir form yayınlayın. Belge toplama şablonuyla başlayın; dosyalar birkaç soruyla birlikte geliyorsa müşteri onboarding şablonuyla.

Yükleyen kişi bir meslektaşınızsa, n8n’in Form Trigger’ı n8n Cloud’da çalışır ve yığınınıza yeni bir hizmet eklemez. Formstep ve n8n’in formu bu seçimi madde madde karşılaştırır.

Bu döngünün tek formlu hali için müşteri bilgilerini onaylayana kadar iş akışını duraklatma yazısına bakın. Dosyalar fatura olduğunda AI onları okuyabilir ve gönderen değerleri onaylayabilir. Belgeleri geldikçe denetlemek için, Pro’dan başlayan ve AI kredileriyle ödenen AI doğrulamasını kullanın. n8n entegrasyon sayfası node’un neler yaptığını listeler, adım adım rehber ise formstep.io/docs adresinde.

Bu makale hakkında sorular

Aklınızda başka bir şey mi var? Dokümanlar her ayarı anlatıyor, e-postalara da yanıt veriyoruz.

5 Kasım 2026'da okuduğum dokümanlar, On Form Submitted için altı alan türü sayıyor: Date, Dropdown List, Number, Password, Text ve Textarea. Dokümanlarda File alanı yok. Form Trigger'ın File öğesi var, ama bir iş akışını duraklatmaz, başlatır.

Formstep'te dosya başına 1 GiB'a kadar, depolama alanınız dahilinde: Free'de 100 MB, Pro'da 100 GB, Business'ta 500 GB. Kendi sunucunuzda çalışan bir n8n formu N8N_PAYLOAD_SIZE_MAX (varsayılan 16 MiB) ve N8N_FORMDATA_FILE_SIZE_MAX (varsayılan 200 MiB) ile sınırlıdır; ters proxy'nizdeki sınırlar da cabası.

Hayır. Form Source New Form olarak ayarlandığında Create request node'u formu blok olarak alır, Formstep de aynı çağrıda formu oluşturup yayınlar. Çeviri içeren ya da elle hazırlanmış düzeni olan her şey için yayınlanmış bir form yine de daha uygundur.

Hayır. Formstep aynı tanımı yeniden görünce formu yeniden kullanır; yani ikinci su hasarı talebi birincinin formunu kullanır. Kişiye göre değişen şeyleri Context veya Prefill içinde tutun, bloklarda ya da form adında asla. Bir çalışma alanı bu yolla günde en fazla 300 yeni form oluşturabilir.

İstekte oluşturulan bir formdan olmaz: tek bir alıcıya ait dosya, zaten var olan bir forma yüklenir. Bunun yerine Documents bloğu olan yayınlanmış bir form kullanın ve dosyayı isteğe ekleyin.

Formstep node'uyla çalışmaz; o yalnızca kendi sunucunuzda çalışan n8n içindir. n8n Cloud'da bir HTTP Request node'undan Formstep REST API'sini çağırın ya da dosyayı yükleyen kişi ekibinizdense n8n'in kendi Form Trigger'ını kullanın.

Kimden olursa olsun, bilgi toplayın.

Örnek bir form yayınlayın, alıcınız gibi yanıtlayın ve yanıtların geri gelişini izleyin. Hesap gerekmez.

Dokümanları okuyun