> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Form şablonları

> Form oluşturucuyla soru eklemeyi, soru türlerini, görünürlük kurallarını ve form şablonunun ön kayıt formu olarak kullanımını anlatır.

Form şablonu, hastalarınıza doldurttuğunuz bir anketin tasarımıdır: ön kayıt formu, anamnez formu, onam formu gibi. Şablonda bir ad, isteğe bağlı bir açıklama ve sıralı sorular bulunur. Bu sayfa yöneticiler ve formları hazırlayan personel içindir.

Menü yolu: **İletişim Ayarları → Form Şablonları → Tüm Şablonlar**. Hastaların doldurduğu formları görmek için bkz. [Doldurulan formlar](/panel/iletisim/doldurulan-formlar).

<Info>
  Gereken izinler rol editöründe **Form Şablonları** grubunda yer alır: **Görüntüleme**, **Oluşturma**, **Güncelleme**, **Silme** ve **Bağlantı oluşturma**. Şablon oluşturmak için **Görüntüleme** ve **Oluşturma**, düzenlemek ve soru eklemek için **Görüntüleme** ve **Güncelleme** gerekir. İzinleri [Roller](/panel/sistem/roller) sayfasından yönetirsiniz.
</Info>

## Form şablonları listesi

Liste, kliniğinizin tüm şablonlarını gösterir. Varsayılan sıralama oluşturulma tarihine göredir (en yeni üstte).

| Öğe | Açıklama |
| - | - |
| Arama | Form adı ve açıklaması içinde arar. |
| **Aktiflik** filtresi | **Aktif** veya **Pasif** şablonları süzer. **Temizle** ile filtre kalkar. |
| **Form Adı**, **Aktiflik**, **Oluşturulma Tarihi**, **Güncellenme Tarihi** | Bu sütunlara göre sıralayabilirsiniz. |
| **Sistem Adı** | Şablonun otomatik üretilen kısa anahtarı. |
| **Doldurulan Form Sayısı** | Bu sütun şu anda her satırda `0` gösterir. Gerçek sayı için **Doldurulan Formlar** sayfasına bakın. |

Satırın **İşlemler** menüsünde şunlar bulunur:

* **Düzenle**: Şablonu açar. Satıra tıklamak da aynı işi yapar.
* **Doldurulan Formlar**: Doldurulan formlar listesini bu şablona göre süzülmüş açar.
* **Aktivite Geçmişi**: Şablonda yapılan değişiklikleri gösterir.
* **Sil**: Şablonu siler. Toplu silmek için satırları işaretleyin ve **Sil**'e basın.

<Note>
  Silinen şablonun daha önce doldurulmuş formları silinmez, kayıtlı kalır.
</Note>

## Şablon oluşturma

<Steps>
  <Step title="Yeni şablon açın">
    **Form Şablonu Oluştur** düğmesine basın.
  </Step>

  <Step title="Temel bilgileri girin">
    **Form Adı**'nı yazın (örneğin "Hasta Onam Formu"). **Sistem Adı** siz yazdıkça kendiliğinden dolar. İsterseniz **Açıklama** alanına formun başında hastaya gösterilecek bir giriş metni yazın.
  </Step>

  <Step title="Aktif durumunu seçin">
    **Aktif** anahtarı varsayılan olarak açıktır.
  </Step>

  <Step title="Oluşturun">
    **Oluştur**'a basın. Panel sizi şablonun düzenleme sayfasına götürür. Sorular ancak şablon oluştuktan sonra eklenir.
  </Step>
</Steps>

| Alan | Zorunlu | Kural |
| - | - | - |
| **Form Adı** | Evet | En fazla 255 karakter. Kliniğinizdeki silinmemiş şablonlar arasında benzersiz olmalıdır. |
| **Sistem Adı** | Evet | Küçük harf, rakam, tire veya alt çizgi. Kayıt sırasında sistem, form adından kendisi üretir. |
| **Açıklama** | Hayır | Kalın yazı destekler. Hastaya formun başında gösterilir. |
| **Aktif** | Hayır | Varsayılan açık. |

<Warning>
  **Sistem Adı** değiştirilebilir görünse de sunucu bu değeri kaydetmez. Adı sonradan değiştirmeniz sistem adını değiştirmez.
</Warning>

Yeni kliniklere hazır bir **Varsayılan Ön Kayıt Formu** gelir. İçinde **Yaşınız kaç?**, **Cinsiyetiniz nedir?** ve **Boyunuz kaç cm?** soruları bulunur. Kendi formunuza başlarken örnek olarak inceleyebilirsiniz.

### Soru ekleme

<Steps>
  <Step title="Soru penceresini açın">
    Şablonun düzenleme sayfasında **Sorular** bölümünde **Soru Oluştur**'a basın.
  </Step>

  <Step title="Soruyu tanımlayın">
    **Soru Metni**'ni yazın, **Soru Tipi**'ni seçin. İsterseniz **Yardımcı Metin** ekleyin; hastaya sorunun altında görünür. Cevap şart ise **Zorunlu**'yu açın.
  </Step>

  <Step title="Seçenekleri ekleyin">
    **Seçim Listesi**, **Radyo Buton** ve **Onay Kutusu** türlerinde **Seçenek Ekle** ile en az bir seçenek girin.
  </Step>

  <Step title="Kaydedin">
    **Oluştur**'a basın. Düzenlerken düğme **Kaydet** olarak görünür.
  </Step>
</Steps>

Soru metni panelde 500 karakter girmeye izin verir, ancak sunucu en fazla 255 karakteri kabul eder. Soru metnini 255 karakterin altında tutun.

Soruların sırasını değiştirmek için **Kayıtları sırala** düğmesine basın, satırları sürükleyip bırakın ve **Sıralamayı bitir**'e basın. Yeni soru listenin sonuna eklenir. **Soru ara** kutusuyla sorular arasında arama yapabilirsiniz. Bir soruyu silmek için satırın **İşlemler** menüsünden **Sil**'i seçin; birden çok soru için satırları işaretleyip **Sil**'e basın.

## Soru türleri

| Soru Tipi | Hasta ne görür | Not |
| - | - | - |
| **Metin** | Tek satırlık alan | En fazla 1000 karakter. |
| **Çok Satırlı Metin** | Çok satırlı alan | En fazla 10 000 karakter. |
| **Seçim Listesi** | Açılır liste | Tek seçim. Seçenek gerekir. |
| **Radyo Buton** | Seçenek düğmeleri | Tek seçim. Seçenek gerekir. |
| **Onay Kutusu** | Birden çok seçilebilen liste | Zorunluysa en az biri seçilmelidir. Seçenek gerekir. |
| **Sayı** | Sayı alanı | Alt ve üst sınır panelden ayarlanamaz. |
| **Tarih** | Tarih seçici | |
| **Evet/Hayır** | Açma/kapama anahtarı | Cevaplanmazsa "Hayır" sayılır. |

## Seçenekler ve görünürlük kuralları

### Seçenekler

Seçenek satırlarını sürükleyerek sıralayabilir, **Seçeneği Sil** ile kaldırabilirsiniz. Bir soruyu türüne göre seçenek gerektirmeyen bir türe çevirirseniz mevcut seçenekler silinir. Her seçenek etiketi en fazla 255 karakterdir.

<Warning>
  Seçenekli bir soruyu her kaydedişinizde seçenekler yeniden oluşturulur ve yeni kimlik numarası alır. Başka bir sorunun görünürlük kuralı bu sorunun seçeneğine bakıyorsa kuralı kaydettikten sonra kontrol edin.
</Warning>

### Görünürlük kuralları

Görünürlük kuralı, bir sorunun yalnızca başka bir sorunun cevabına göre gösterilmesini sağlar. Örneğin "Düzenli ilaç kullanıyor musunuz?" (**Evet/Hayır**) sorusuna "Evet" denmişse "Hangi ilaçları kullanıyorsunuz?" sorusunu gösterebilirsiniz. Kural eklemezseniz soru her zaman görünür.

Soru penceresinde **Görünürlük Kuralı Ekle**'ye basın ve alanları doldurun:

| Alan | Açıklama |
| - | - |
| **Bağlı Olduğu Soru** | Cevabına bakılacak soru. Soru kendine bağlanamaz. |
| **Operatör** | **Eşittir**, **Eşit Değildir**, **İçinde**, **İçinde Değil**, **Büyüktür**, **Küçüktür**, **İçerir**. |
| **Değer** | Karşılaştırılacak değer. **İçinde** ve **İçinde Değil** için JSON listesi yazın: `["değer1", "değer2"]`. |
| **Eşleşme Tipi** | **Tümü** veya **Herhangi Biri**. |

Değer yazarken şunlara dikkat edin:

* **Evet/Hayır** sorularında Evet için `1`, Hayır için `0` yazın.
* **Sayı** sorularında **Büyüktür** ve **Küçüktür** yalnızca sayısal cevaplarla çalışır.
* **Seçim Listesi**, **Radyo Buton** ve **Onay Kutusu** sorularında değer, seçeneğin etiketi değil kimlik numarasıdır. Panel seçeneklerin kimlik numarasını göstermez. Bu yüzden seçenek tabanlı kurallar için **Evet/Hayır** veya **Sayı** sorularına bağlı kurallar daha güvenlidir.
* Bir sorunun birden çok kuralı varsa hepsi, ilk kuraldaki **Eşleşme Tipi** ile birleştirilir. **Tümü** seçiliyse tüm kurallar, **Herhangi Biri** seçiliyse en az bir kural sağlanmalıdır.

<Note>
  Görünmeyen soru doldurma sırasında zorunlu olsa bile doğrulanmaz ve cevabı kaydedilmez. Görünmeyen bir soruya bağlı soru da görünmez.
</Note>

## Formun hastaya ulaşması

Hasta, forma kendisine özel bir bağlantıdan ulaşır. Bağlantıyı açan hasta giriş yapmadan formu doldurur ve gönderir. Her bağlantı tek kullanımlıktır: gönderilmiş bir forma bağlantıdan tekrar girilemez.

<Warning>
  Panelde **Bağlantı Oluştur** düğmeleri (şablon listesinde ve düzenleme sayfasında) şu anda bağlantı üretmez; yalnızca uyarı mesajı gösterir. Panelden form bağlantısı oluşturamazsınız.
</Warning>

Bağlantı şu yollarla hastaya ulaşır:

* **Chatbot ile:** Ön kayıt gereksinimleri açıksa chatbot, seçtiğiniz şablonla hastaya özel bir form bağlantısı oluşturur (aşağıdaki bölüme bakın).
* **API ile:** Entegrasyon geliştiriciniz `POST /api/v1/form-templates/{id}/links` çağrısıyla bağlantı üretebilir. `customer_id` verilirse bağlantı o hastaya bağlanır, verilmezse bağlantıya sahip herkes formu doldurabilir. Ayrıntılar için bkz. [Hasta formları API'si](/api/kaynaklar/hasta-formlari).

Hasta formu gönderdiğinde form **Tamamlandı** durumuna geçer ve hastaya bağlıysa **Doldurulan Formlar** listesinde görünür. Hastanın kartındaki **Formlar** sekmesinde de yer alır; bkz. [Hasta kartı](/panel/hastalar/hasta-karti).

<Note>
  Panelde doldurulmuş formun cevaplarını açıp okuyacak bir ekran şu an yoktur. Cevaplar API üzerinden okunabilir; mobil uygulamada bir sonraki mobil sürümde görüntülenecektir.
</Note>

## Ön kayıt formu olarak kullanma

Klinik, randevu öncesinde hastalardan fotoğraf ve ön kayıt formu isteyebilir. Bu durumda chatbot, seçtiğiniz şablonu kullanarak hastaya form bağlantısı gönderir.

<Steps>
  <Step title="Şablonu hazırlayın ve aktif yapın">
    **İletişim Ayarları → Form Şablonları** sayfasında sorularınızı ekleyin. Şablonun **Aktif** olduğundan emin olun.
  </Step>

  <Step title="Şablonun numarasını bulun">
    Şablonu düzenleme sayfasında açın. Tarayıcının adres çubuğundaki `/form-templates/{id}/edit` adresinde `{id}` yerindeki sayı şablonun numarasıdır.
  </Step>

  <Step title="Sohbet ayarlarını açın">
    **Sistem Ayarları → Ayarlar → Sohbet** sayfasına gidin. Sayfayı açmak için **Sohbet Ayarları** grubunda **Görüntüleme**, kaydetmek için **Güncelleme** izni gerekir.
  </Step>

  <Step title="Ön kayıt gereksinimlerini etkinleştirin">
    **Hasta Formları ve Ön Kayıt Gereksinimleri** kartında **Ön kayıt gereksinimlerini aktifleştir** anahtarını açın. **Varsayılan anamnez formu şablonu ID'si** alanına şablonun numarasını yazın.
  </Step>

  <Step title="Kaydedin">
    **Kaydet**'e basın ve istenen **Parola**'yı girin.
  </Step>
</Steps>

Bu anahtar açıkken hastalar randevu alabilmek için fotoğraf göndermeli ve ön kayıt formunu doldurmalıdır.

<Warning>
  Anahtar açıkken şablon aktif değilse kayıt şu hatayla reddedilir: "Randevu öncesi gereksinimleri açmak için aktif bir varsayılan form şablonu seçin." Anahtarı kapatırsanız şablon numarası da temizlenir.
</Warning>

<Note>
  Bu ayar chatbotun hangi agentlarla çalışacağını da değiştirir. Ayrıntılar için bkz. [Sohbet ayarları](/panel/sistem/ayarlar/sohbet).
</Note>

## İlgili sayfalar

<CardGroup cols={2}>
  <Card title="Doldurulan formlar" icon="clipboard-check" href="/panel/iletisim/doldurulan-formlar">
    Hastaların doldurduğu formları listeleyin ve süzün.
  </Card>

  <Card title="Mesaj şablonları" icon="message-square-text" href="/panel/iletisim/mesaj-sablonlari">
    Hastaya giden otomatik mesajların metinlerini düzenleyin.
  </Card>

  <Card title="Sohbet ayarları" icon="settings" href="/panel/sistem/ayarlar/sohbet">
    Ön kayıt gereksinimlerini ve yapay zeka modunu yönetin.
  </Card>

  <Card title="Hasta formları API'si" icon="code" href="/api/kaynaklar/hasta-formlari">
    Form bağlantısı oluşturma ve doldurma uçları.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.