# Formstep düğümünü n8n'e kurun

Kendi sunucunuzda barındırılan bir n8n'e herkese açık bir HTTPS adresi verin, n8n-nodes-formstep topluluk düğümünü kurun ve tetikleyicilerinin ve eylemlerinin göründüğünü kontrol edin.

## Formstep düğümünü n8n'e kurun

Formstep için n8n, npm üzerinde n8n-nodes-formstep olarak yayımlanan bir topluluk düğümüdür. Bu kılavuz onu kendi sunucunuzda barındırılan bir n8n'e kurar ve Formstep'in workflow’larınıza ulaşmak için kullandığı adresi ayarlar.

<p>
  Her n8n kılavuzu, Docker'da çalışan, kendi sunucusunda barındırılan n8n 2.40'ta, düğümün 0.10.1 sürümüyle kontrol edildi. n8n'in nerede
  çalıştığına bağlı olan her şey bu sayfadadır. Düğüm kurulduktan sonra diğer kılavuzlar aynı şekilde çalışır.
</p>

<h2 id="before-you-start">Başlamadan önce</h2>

<ul>
  <li>n8n 2.30 veya üstü. Formstep bağlantı bilgisi bunu gerektirir.</li>
  <li>
    Bir Formstep hesabı. Bu kılavuzlardaki her şey Free planında çalışır; e-posta davetleri, hatırlatmalar ve yarım bırakılan gönderimler
    hariç — bunlar Pro veya Business gerektirir. Ücretsiz plan denemek için 10 davet e-postası alır.
  </li>
</ul>

<h2 id="self-hosted">Kendi sunucunuzda barındırılan n8n</h2>

<p>Kendi sunucunuzda barındırılan bir n8n'in düğümü kurabilmesi için önce iki şeye ihtiyacı vardır:</p>

<ul>
  <li>Sahip hesabı veya bir yönetici hesabı. Topluluk düğümlerini yalnızca sahip ve yöneticiler kurabilir.</li>
  <li>
    Bir ters proxy'den veya bir tünelden gelen herkese açık bir HTTPS adresi. Formstep olayları ve istek geri çağırmalarını yalnızca herkese
    açık internetteki <code>https://</code> URL'lerine gönderir. Yalnızca <code>localhost</code> üzerinden erişilebilen bir n8n bağlanabilir
    ama hiçbir şey almaz.
  </li>
</ul>

<h3 id="public-address">1. n8n'e herkese açık adresini bildirin</h3>

<p>
  n8n, Formstep'e verdiği URL'leri tarayıcınızdaki adresten değil kendi ayarlarından oluşturur. Şu ortam değişkenlerini n8n konteynerinde
  veya sürecinde ayarlayın:
</p>

<ul>
  <li>
    <code>WEBHOOK_URL</code>: sonunda eğik çizgi olan herkese açık HTTPS adresi, <code>https://n8n.example.com/</code> gibi. n8n, bundan
    yayınlanmış bir tetikleyicinin URL'sini ve <a href="/tr/guides/n8n/request-outcome#wait-for-the-outcome">Wait for the Outcome</a>'un
    devam URL'sini oluşturur.
  </li>
  <li>
    <code>N8N_EDITOR_BASE_URL</code>: aynı adres. n8n, bundan bir tetikleyicinin <strong>Execute step</strong> için test URL'sini ve
    Formstep bağlantı bilgisinin <strong>OAuth Redirect URL</strong>'sini oluşturur.
  </li>
  <li>
    <code>N8N_PROXY_HOPS</code>: n8n tek bir ters proxy veya tünelin arkasında çalışırken bunu <code>1</code>'e ayarlayın, böylece n8n
    proxy'nin ilettiği başlıkları okur.
  </li>
</ul>

<p>Docker ile bu şöyle görünür:</p>

```
docker run -d --name n8n -p 5678:5678 \
  -e WEBHOOK_URL=https://n8n.example.com/ \
  -e N8N_EDITOR_BASE_URL=https://n8n.example.com/ \
  -e N8N_PROXY_HOPS=1 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n
```

<p>
  Docker compose veya bir npm kurulumuyla, aynı değişkenleri n8n'in ortamında ayarlayın. Proxy'nizi veya tünelinizi <code>5678</code>{' '}
  portuna yönlendirin, <code>/webhook/</code>, <code>/webhook-test/</code> ve <code>/webhook-waiting/</code>'i değiştirmeden geçirin ve o
  andan sonra n8n'i herkese açık adres üzerinden açın.
</p>

> ⚠️ **VALIDATION_ERROR: targetUrl must use https**
> <p>
>     Formstep, bir <code>http://</code> URL'sine veya özel bir ağ adresine olay göndermeyi reddeder. Bir tetikleyici bu hatayı{' '}
>     <strong>Execute step</strong>'te gösteriyorsa <code>N8N_EDITOR_BASE_URL</code> ayarlı değildir; <strong>Publish</strong>'te gösteriyorsa{' '}
>     <code>WEBHOOK_URL</code> ayarlı değildir. O değişkeni ayarlayın, n8n'i yeniden başlatın ve tekrar deneyin. <code>WEBHOOK_URL</code>'yi
>     daha sonra değiştirirseniz, tetikleyicisinin yeni adresi kaydetmesi için her Formstep workflow’unun yayınını kaldırıp yeniden
>     yayınlayın.
>   </p>

<h3 id="install">2. Topluluk düğümünü kurun</h3>

<p>
  <strong>Settings</strong> › <strong>Community nodes</strong>'u açın ve <strong>Install</strong>'a tıklayın.{' '}
  <strong>npm Package Name</strong> altına <code>n8n-nodes-formstep</code> yazın, doğrulanmamış kod kurmanın risklerini anladığınızı
  belirten kutuyu işaretleyin ve <strong>Install</strong>'a tıklayın.
</p>

<p>Birkaç saniye sonra paket, iki düğümüyle birlikte listede görünür:</p>

<p>
  Paketi aynı listeden güncelleyin veya kaldırın. <strong>Community nodes</strong>, Settings'te yoksa, n8n'iniz{' '}
  <code>N8N_COMMUNITY_PACKAGES_ENABLED=false</code> ile başlatılmıştır; bu ayarı kaldırın.
</p>

<h2 id="n8n-cloud">n8n Cloud</h2>

> ℹ️ **n8n Cloud'da henüz kullanılamıyor**
> <p>
>     n8n Cloud yalnızca n8n'in doğruladığı topluluk düğümlerini kurar ve Formstep düğümü henüz doğrulanmadı. Doğrulanana kadar kendi
>     sunucunuzda barındırılan bir n8n kullanın, ya da <a href="/tr/guides/rest-api/send-a-request">REST API</a>'yi bir{' '}
>     <strong>HTTP Request</strong> düğümünden çağırın. Bir Cloud örneğinin zaten herkese açık bir HTTPS adresi vardır, bu yüzden düğüm orada
>     kullanılabilir olduğunda yalnızca bu sayfadaki kurulum adımları değişir.
>   </p>

<h2 id="check">Düğümü kontrol edin</h2>

<p>
  Bir workflow açın, <strong>+</strong>'ya tıklayın ve <strong>Formstep</strong>'i arayın. Düğüm ayrıntıları altı eylem ve altı tetikleyici
  gösterir:
</p>

<ul>
  <li>
    <strong>Formstep Trigger</strong>, oluşturulan, güncellenen veya yarım bırakılan bir genel bağlantı gönderiminde, ya da tamamlanan,
    süresi dolan veya iptal edilen bir istekte bir workflow başlatır.
  </li>
  <li>
    <strong>Formstep</strong>, bir istek oluşturur, birini veya birçoğunu alır, alıcıyı hatırlatır, bir isteği iptal eder ve geri
    çağırmasını yeniden oynatır.
  </li>
</ul>

<h2 id="next">Sırada</h2>

<div class="not-prose grid gap-3 sm:grid-cols-2 mb-8">
  - [Formstep'i n8n'e bağlayın](/tr/guides/n8n/connect) — Bağlantı bilgisini oluşturun, oturum açın ve çalışma alanını seçin.
  - [Tüm kılavuzlar](/tr/guides/overview)
</div>