> ## 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.

# Platform (panel ve API)

> Panel ve API'deki yeni özellikleri, değişiklikleri ve düzeltmeleri sürüm sürüm listeler.

Bu sayfa Flextell panelindeki ve API'deki değişiklikleri, en yeni sürüm en üstte olacak şekilde listeler. Mobil uygulama için [mobil sürüm notlarına](/surum-notlari/mobil), mevcut entegrasyonlarınızı etkileyebilecek API değişiklikleri için [API değişikliklerine](/surum-notlari/api-degisiklikleri) bakın.

<Note>
  Tarihler, sürümün etiketlendiği tarihtir. Bir sürümün kliniğinizde ne zaman devreye girdiği dağıtım takvimine göre değişebilir. **Dikkat** etiketi, mevcut kullanımı değiştiren bir değişikliği gösterir. Panel sürüm etiketleri v1.0.13'ten başlar; panel ve API aynı sürüm numarasını paylaşır.
</Note>

## Ekim 2026 (v1.1.0–v1.9.0)

### v1.9.0 — 13 Ekim 2026

**Panel**

* **Hesap Hareketleri** çalışma alanı: **Hesaplar** listesinde satır menüsünden açılır. Hareketleri arayabilir, **Tür**, **Ödeme Yöntemi** ve **İşlem Tarihi** ile süzebilir; hareket ekleyebilir, düzenleyebilir, tek tek veya toplu silebilirsiniz. Hareketi olan bir hesabı **Hesap Hareketlerini Temizle ve Sil** ile hareketleriyle birlikte silebilirsiniz. Bkz. [Hesaplar](/panel/finans/hesaplar).
* Hasta kartındaki **İşlemler** sekmesinde tahsilat ve ödeme satırları düzenlenebilir ve silinebilir. Silinen işlemin eşli hesap hareketi de silinir ve hasta bakiyesi güncellenir. Bkz. [Hasta kartı](/panel/hastalar/hasta-karti).
* **Bakiyeler** sayfasının altında filtreye uyan tüm hastaların para birimi bazındaki toplamını gösteren **Toplam Bakiye** çubuğu eklendi. Bkz. [Bakiyeler](/panel/finans/bakiyeler).
* **Muhasebe** ayarlarına KDV oranını geçersiz kılma anahtarı ve **Varsayılan Fatura Hesabı** eklendi. Panelin satış ve teklif formları KDV anahtarını bu sürümde uygulamaz. Bkz. [Muhasebe ayarları](/panel/sistem/ayarlar/muhasebe).
* **Klinik Yönetimi → Tedavi Grupları** sayfası eklendi: grup oluşturma, düzenleme, silme ve paket fiyatını otomatik hesaplama. Bkz. [Tedaviler](/panel/klinik/tedaviler).
* **Tedaviler** listesinde seçili tedavileri toplu **Aktif Et** ve **Pasif Yap** ile değiştirebilirsiniz. Doktor–tedavi bağlantısını tek tek veya toplu kaldırabilirsiniz (**Doktordan Ayır**, **Tedaviden Ayır**). Doktor formuna **Tercih Edilen Fatura Hesabı** eklendi; tedavinin **Doktorlar** sekmesindeki **E-Posta**, **Telefon** ve **Aktif** sütunları artık dolu gelir. Bkz. [Doktorlar](/panel/klinik/doktorlar).
* **Dikkat — kanal silme:** Kanal silme penceresi **Parolanız** ister. Yanlış parolada **Parola hatalı.** görünür. Kanal, lead, kullanıcı, asistan, doktor, satış temsilcisi ve tedavi silme pencereleri **Birlikte silinecek kayıtlar** ve **Kalacak kayıtlar** listesini gösterir. Toplu lead silme tek istekle yapılır.
* **Faturalarım → Abonelik** sekmesi eklendi: plan kartları, **Satın Al**, **Yenile**, **Yükselt**, **Sonraki Dönemde Geç** ve **Ödemeye Geç** akışı. Proforma **Belge Tipi** listesine **Abonelik** eklendi. Süresi dolan abonelik sizi bu sayfaya, tamamlanmamış kurulum **Klinik Kurulumu** sayfasına yönlendirir. Bkz. [Abonelik ve kurulum kilidi](/panel/sorun-giderme/abonelik-ve-kurulum-kilidi).
* Bildirim, push, e-posta ve Flexy bağlantıları ilgili kliniğe geçerek açılır. Üyesi olmadığınız bir klinikten bağlantı gelirse panel seçili kliniğinizde açılır ve sizi uyarır. Destek talebi bağlantısı talebi doğrudan açar. Bkz. [Bildirimler ve duyurular](/panel/baslarken/bildirimler-ve-duyurular).
* `SALE_INVOICED`, `QUOTA_EXHAUSTED`, `STORAGE_HARD_LIMIT_EXCEEDED`, `APPOINTMENT_ALREADY_CANCELLED`, `APPOINTMENT_NOT_CANCELLED`, `CHANNEL_INACTIVE` ve diğer iş hatası kodları için panel Türkçe neden mesajı gösterir. Panel metni sunucu metninin önüne geçer.
* Toplu işlemlerde başarısız her satırın nedeni gösterilir: **N kayıt silinemedi.** ve nedeni, birden çok neden varsa **n kayıt:** ve nedeni. **Lütfen tekrar deneyin.** yalnızca bağlantı kaynaklı hatalarda çıkar.
* **Dikkat — yeni sohbet izni:** **Yeni Sohbet** düğmeleri **Oluşturma: Sohbetler** iznine bağlandı; **Gönderme: Mesajlar** gerekmez. Hasta veya lead kaydındaki sohbet paneli **Görüntüleme: Sohbetler**, **Oluşturma: Sohbetler** ve **Gönderme: Mesajlar** izinlerinin üçünü de ister. Bkz. [Yeni sohbet](/panel/sohbetler/yeni-sohbet).
* Düzeltme: Tüm sohbetleri görüntüleme izni olmayan kullanıcılar sohbet listesinde canlı güncelleme alır. AI önerisi kartı canlı güncellenir. `403 CONVERSATION_NOT_ASSIGNED` hatası Türkçe açıklanır.
* Düzeltme: **Uygulamalar** ekranında **İzinler** adımı ve **Yetkileri Güncelle** penceresi çalışır; panelden yeni uygulama oluşturabilirsiniz. Bkz. [Uygulamalar](/panel/baglantilar/uygulamalar).
* Düzeltme: Yeni randevu formunun **Durum** seçeneklerinde **İptal Edildi** yoktur. İptal edilmiş randevudan kopyalanan randevu **Bekliyor** durumuyla başlar.

**API**

* **Dikkat — pasif kanal:** Kanalı kapalı (`is_active=false`) bir sohbette metin, medya, sesli mesaj, hızlı yanıt, tepki ve AI önerisi gönderimi `422 CHANNEL_INACTIVE` döndürür ve mesaj saklanmaz. Önceden `202` dönüp mesaj iletilmiyordu. İstek kuyruğa girdikten sonra kanal kapanırsa mesajın `metadata.delivery_status` değeri `failed` olur. Bkz. [Mesajlar](/api/kaynaklar/mesajlar).
* **Dikkat — bildirim alıcıları:** `tenant.chat.message_notification_roles` ayarının varsayılanı `["assistant"]` yerine `["super_admin","sales_director"]` (Süper Yönetici, Satış Direktörü) oldu. Bu ayarı hiç kaydetmemiş kliniklerde yeni mesaj bildirimi artık bu rollere gider. Kayıtlı ayarlar değişmez. Bkz. [Sohbet ayarları](/panel/sistem/ayarlar/sohbet).
* **Dikkat — hasta bakiyesi:** `GET /appointments/{id}` yanıtındaki `customer_balance` yalnızca `View:CustomerBalances` (Görüntüleme: Bakiyeler) izni olan ve hastası maskelenmemiş kullanıcıya verilir; aksi hâlde `null` döner. Bkz. [Randevular](/api/kaynaklar/randevular).
* Tedavi yanıtlarındaki `users[]` öğeleri `id` ve `name` yanında `email`, `phone` ve `is_active` taşır. Liste yalnızca geçerli kliniğin üyelerini içerir. Bkz. [Tedaviler](/api/kaynaklar/tedaviler).
* Düzeltme: İki adımlı doğrulama kodu Redis önbelleğinde de tekrar kullanılamaz. Kabul edilmiş kod süresi dolana kadar `422 TWO_FACTOR_INVALID_CODE` ile reddedilir.

### v1.8.0 — 12 Ekim 2026

**Panel**

* **Agentlar** düzenleyicisi yenilendi: Markdown editör, **Akış** / **Liste** görünümü, **Sürümler** sayfası (**Stabil Olarak İşaretle**, **Sürümü Geri Yükle**), dil (**Türkçe** / **İngilizce**) ve model alanları, **AI Araçları** penceresi. Agent formu, kaydedilmemiş değişiklik varken sayfadan ayrılırken uyarır. Bkz. [Agent promptları](/panel/sistem/agent-promptlari).
* Başka bir satış temsilcisine atanmış lead'e bağlı kayıtlarda hastanın kişisel bilgileri gizlenir ve kayıt salt okunur olur. Uyarı mesajı lead'in atandığı kullanıcıyı gösterir. Bkz. [Lead atama](/panel/leadler/atama).
* **Randevu Detayları** penceresi kaldırıldı; randevular detay sayfasında açılır.
* Kabul edilmiş veya satışa dönüşmüş teklif düzenlenemez. Bkz. [Teklif oluşturma ve satışa dönüştürme](/panel/teklifler/olusturma-ve-satisa-donusturme).
* İzniniz olmayan sayfalarda ve işlemlerde hata yerine bilgilendirme mesajı gösterilir. Bkz. [Yetki hataları](/panel/sorun-giderme/yetki-hatalari).

**API**

* **Dikkat — sohbet görünürlüğü:** `ViewAllConversations:Conversation` iznine sahip olmayan kullanıcılar yalnızca kendilerine atanmış lead'lerin sohbetlerini görür. Hastaların sohbetleri artık paylaşılmaz. `GET /conversations` için `scope=assigned|all` parametresi eklendi. Yeni sohbet bildirimleri ve sohbet dosyaları da aynı görünürlük kuralına uyar.
* **Dikkat — yeni sohbet:** `POST /conversations` artık `Create:Conversation` izni ister. Size atanmamış bir kişiyle sohbet başlatmak `403 CONVERSATION_NOT_ASSIGNED` döndürür. Hızlı yanıt göndermek `Send:Message` ister. AI önerisini puanlamak `ManageAiSuggestions:Conversation`, göndermek bu izin ile `Send:Message` ister. Bkz. [Sohbetler](/api/kaynaklar/sohbetler).
* **Dikkat — gerçek zamanlı kanallar:** `private-chat-log.{tenantId}` kanalına yalnızca tüm sohbetleri görebilen kullanıcılar abone olabilir. Diğer kullanıcılar yalnızca kayıt numaralarını (ID) taşıyan `private-chat-log-activity.{tenantId}` kanalını dinleyip REST ile yeniler. Bkz. [Kanallar ve olaylar](/api/gercek-zamanli/kanallar-ve-olaylar).
* **Randevu iptali:** `POST /appointments/{id}/cancel` (`cancellation_reason`) ve `POST /appointments/{id}/revert-cancel` (`status`: `pending` veya `approved`) eklendi. İptal için `Cancel:Appointment`, geri alma için `RevertCancel:Appointment` izni gerekir. Zaten iptal edilmiş randevu `409 APPOINTMENT_ALREADY_CANCELLED`, iptal edilmemiş randevunun geri alınması `409 APPOINTMENT_NOT_CANCELLED` döndürür.
* **Dikkat:** `PUT /appointments/{id}` ile iptale geçmek `Cancel:Appointment`, iptalden çıkmak `RevertCancel:Appointment` ister. `POST /appointments` isteğinde `status=cancelled` artık `422` döndürür; önce randevuyu oluşturun, sonra iptal edin.
* **Dikkat — toplu taşıma:** `POST /appointments/reschedule` ve önizlemesi `BulkReschedule:Appointment` ister; `salesperson` (Satış Temsilcisi) rolü bu izni otomatik almaz. Bkz. [Toplu randevu taşıma](/api/kaynaklar/toplu-randevu-tasima).
* `GET /appointments/summary` (bugünün toplam, bekleyen, onaylı ve tamamlanan randevu sayıları) ve `GET /appointments?sort_by=upcoming` eklendi.
* **Dikkat — sıralama:** `sort_by` kuralları tüm listelerde tek tipe getirildi. `sort_order` verilmezse metin sütunları Türkçe sıralamayla A'dan Z'ye, sayı ve tarih sütunları azalan sıralanır. `sort_by` verildiğinde arama alaka sırası uygulanmaz. Bkz. [Filtreleme ve sıralama](/api/istekler/filtreleme-ve-siralama).
* **Dikkat — OAuth:** `/oauth/*` ve `/announcements` uç noktaları `X-Tenant` başlığı ister (yoksa `400 TENANT_HEADER_REQUIRED`). `GET /announcements` ayrıca `View:Announcement` izni ister. İçe aktarma kimlik bilgisi düzenleme `Update:ImportSource` ister. Bkz. [X-Tenant](/api/klinikler-ve-x-tenant).
* Kanal izinleri ayrıştı: bağlantı durumu için `QueryStatus:Channel` (veya `Update:Channel`), gömme kodu için `CopyLink:Channel`, token yenileme için `GenerateLink:Channel`. Engeli kaldırmak `Unblock:ChannelBlacklist` ister.
* Yeni izinler: `Cancel:Appointment`, `RevertCancel:Appointment`, `Create:Conversation`, `Archive:Conversation`, `QueryStatus:Channel`, `GenerateLink:Channel`, `CopyLink:Channel`. Toplam izin sayısı 392 oldu. Mevcut kliniklerde bu izinler ilgili mevcut izinlere sahip rollere otomatik verildi; sonradan kurulan kliniklerde `Create:Conversation` varsayılan olarak yalnızca `super_admin` rolündedir. Bkz. [İzin kataloğu](/panel/sistem/izin-katalogu).
* İçe aktarma kaynağı olarak **Dr.DENTES** eklendi (hekim, hasta ve randevu aktarımı; `Base URL` ve `API Key` gerekir). API erişimi için Dr.DENTES ile iletişime geçmeniz ve Flextell sunucusunun IP adresini Dr.DENTES API izin listesine eklemelerini istemeniz gerekir. İçe aktarılan tedavilere varsayılan seans planı, randevulara seansları eklenir. Bkz. [İçe aktarma](/panel/baglantilar/ice-aktarma).
* Düzeltme: `GET /authentication-logs?sort_order=` boş gönderildiğinde artık `500` yerine varsayılan sıralamayı kullanır.

<Warning>
  **v1.8.0 panelinde bilinen durumlar**

  * **Uygulamalar** ekranında **İzinler** ve **Yetkileri Güncelle** için scope listesi yüklenmez (`GET /oauth/scopes` `X-Tenant` olmadan gider, `400` döner).
  * `ViewAllConversations:Conversation` iznine sahip olmayan kullanıcılar (varsayılan satış temsilcisi) sohbet listesinde canlı güncelleme almaz; liste sayfa yenilenince veya sayfa değişince güncellenir.
  * Panelden kanal silme `422` döndürür; kanal silme artık `current_password` ister (v1.6.0).
  * Randevu oluşturma formu `İptal Edildi` durumunu sunar; kaydetmek `422` döndürür. Önce randevuyu oluşturup sonra iptal edin.

  Bu dört durum v1.9.0 ile giderildi.
</Warning>

### v1.7.0 — 12 Ekim 2026

**Panel**

* WhatsApp eşleştirme penceresi yenilendi: dönen QR kod, eşleştirme kodu ve numara uyuşmazlığı uyarısı (**Numara Uyuşmuyor**). Bkz. [WhatsApp](/panel/baglantilar/whatsapp).
* WhatsApp geçmişini içe aktarma, birden çok hat için kişi başına tek sohbet ve gönderim hattı seçici eklendi.
* Hasta ve lead başlıkları birleşti; kayıt sayfalarında **Sohbeti Aç** ile sohbet çekmecesi açılır.
* **Yeni Sohbet** penceresinde mevcut hasta veya lead'i seçebilir ya da yeni kişiyi Hasta veya Lead olarak oluşturabilirsiniz. Bkz. [Yeni sohbet](/panel/sohbetler/yeni-sohbet).
* Tablo satırları yeni sekmede açılabilir (orta tık veya Cmd/Ctrl + tık). AI yanıt takvimi klinik saat diliminde gösterilir.

**API**

* **Dikkat — zorunlu kurulum:** Kurulum adımları tamamlanana kadar klinik API rotaları `428 SETUP_REQUIRED` döndürür. Mevcut klinikler tamamlanmış sayıldı. Bkz. [Erişim kilitleri](/api/istekler/erisim-kilitleri).
* WhatsApp'ta kanal adresinden farklı numarayla eşleştirme reddedilir (`number_mismatch`). Çok hatlı WhatsApp geçmiş aktarımı eklendi.
* Dosyalar bearer token ile indirilebilir (tek dosya ve ZIP); tedavi ve tedavi grubu görsel galerileri dosya API'siyle yönetilir.
* Finans: bakiye toplamları (`meta.totals`), banka işlemi düzenleme ve toplu silme, `/account-transaction-types`.
* `POST /conversations` isteğinde `contact_type=lead|customer` ile yeni kişi lead olarak oluşturulabilir.
* Lead sınırı denetimi yalnızca mevcut klinik için yapılır; `GET /leads?active=true|false` ve satış temsilcilerinde `active_lead_count` eklendi. Doktor–tedavi bağlama, satış temsilcisi metrikleri ve uygunluk bilgisi eklendi.
* e-Fatura entegratör hesapları için oluşturma, güncelleme ve silme (`/invoices/accounts`) ve `*:InvoiceAccount` izinleri eklendi.

### v1.6.0 — 12 Ekim 2026

* `POST /appointments/{id}/complete` ile randevu tamamlama, toplu taşıma işlem grubu ayrıntısı ve hasta bakiyesi (`customer_balance`) alanı eklendi.
* **Dikkat:** Sekiz kaynak için silme etkisi önizlemesi (`deletion-relations`) eklendi. Lead silmek artık lead'in notlarını, görevlerini ve dosyalarını da siler. `DELETE /channels/{id}` isteği `current_password` ister. Bkz. [Silme yaşam döngüsü](/api/istekler/silme-yasam-dongusu).
* Herkese açık hasta formu API'si (`/public/forms/{token}`) ve `POST /form-templates/{id}/links` eklendi. Bkz. [Herkese açık hasta formları](/api/webhooklar/herkese-acik-hasta-formlari).
* Telegram kanalı bot token'ıyla API'den bağlanır; `GET /channels/{id}/telegram` eklendi. Bkz. [Telegram](/api/entegrasyonlar/telegram).
* AI yanıt pencereleri gece yarısını aşabilir (bitiş saati başlangıçtan önce olabilir).
* Bildirim, push ve e-postalardaki bağlantılar yeni panele açılır.
* Kullanıcı başına tek kendi kendine klinik oluşturulabilir (`TENANT_CREATION_MEMBERSHIP_EXISTS`).

### v1.5.0 — 12 Ekim 2026

* Ön ödemeli abonelik, ödeme akışı, kota denetimi (AI, mesajlaşma, depolama) ve demo, ek süre ve süresi dolmuş yaşam döngüsü eklendi. Bkz. [Abonelik ve faturalama](/api/kaynaklar/abonelik-ve-faturalama).
* **Dikkat — lead kilidi:** `ViewAllLeads:Lead` iznine sahip olmayan satış temsilcileri başka temsilcilerin lead'lerinde yazamaz; kişisel bilgiler maskelenir. Randevu ve teklif formları için seçenek uç noktaları eklendi.
* **Dikkat:** Platform yöneticisi etkinlikleri klinik aktivite log API'sinde ve lead zaman çizelgesinde gizlenir.
* Klinik daveti, onboarding ve kurulum ilerlemesi API'leri; `POST /conversations/{id}/open`; AI öneri yayınları sohbet başına; stok ve tutar sınırları ile IBAN/SWIFT doğrulaması eklendi.
* Randevu saati elle değiştirilince bekleyen yeniden planlama iptal edilir. Faturalanmış satış ve kilitli teklif silme korumaları (`SALE_INVOICED`, `OFFER_LOCKED`) eklendi.
* Doktor ve asistan oluştururken `set_password`, parola değişikliğinde `revoke_other_tokens` alanları eklendi.
* AI asistan akışları (randevu, kayıt, bilgi, destek) sağlamlaştırıldı; mevcut kliniklerde Türkçe istemler güncellendi.

### v1.4.0–v1.4.2 — 8–10 Ekim 2026

* Tahsilatın hesabı ve ödeme yöntemi sonradan düzeltilebilir (`PUT /sales/{id}/transactions/{transactionId}`). Bkz. [Tahsilat](/panel/finans/tahsilat).
* Lead listesinde **Ara**, **Sohbete Git** ve **Numarayı Kopyala** eylemleri; listelerde filtre, arama, sıralama ve geçerli sayfa klinik ve sayfa başına, tarayıcı sekmesi açık kaldığı sürece hatırlanır; tablo başlığı araç çubuğunun altında sabit kalır.
* Hasta formundaki meslek seçicisinde **Meslek Oluştur**; **Meslekler** sayfasında oluşturma, düzenleme ve silme (sistem meslekleri salt okunur). Bkz. [Meslekler](/panel/hastalar/meslekler).
* Düzeltme: **Satışlar** listesinde **Hasta** sütunu sabitlenmez; uzun hesap adları **Hesaplara Göre Tahsilat** kartında kısaltılır.

### v1.3.0–v1.3.2 — 6–7 Ekim 2026

* Entegrasyon bağlantıları ve Zapier ile gelen lead alımı: gelen webhook, alan eşleme, **Birleştirilen kayıtların aşaması** ve birleşen lead'in kaynağını güncelleme anahtarı. Lead'lerde **Kaynak ve Reklam Bilgileri** bölümü eklendi. Bkz. [Gelen lead webhook'u](/panel/baglantilar/gelen-lead-webhooku) ve [API](/api/webhooklar/gelen-lead-webhooku).
* İçe aktarılmış kayıtlarda **İçe Aktarılmış Kayıt** bildirimi gösterilir.
* Panel her istekte `Accept-Language: tr` gönderir. Ayarlar menüsü ortak yapıya taşındı ve etiketler kısaldı (örneğin **Genel Ayarlar** yerine **Genel**).

### v1.2.0 ve v1.2.1 — 5–6 Ekim 2026

* **Dikkat (v1.2.1):** Başka bir satış temsilcisinin lead'ine erişim `404` yerine `403 LEAD_NOT_ASSIGNED` döndürür; lead aşamasındaki hastalar maskelenir. Detay yanıtlarına `import_source` eklendi.
* **Randevu Ayarları** sayfasına **Önerilen saat adımı (dakika)** eklendi. Bkz. [Randevu ayarları](/panel/sistem/ayarlar/randevu).
* API (v1.2.0): `POST /channels/{id}/whatsapp/connect`, `GET /channels/{id}/whatsapp/connection-state` ve `GET|PUT /channels/{id}/whatsapp/webhook` eklendi. Bkz. [WhatsApp](/api/entegrasyonlar/whatsapp).

### v1.1.1 — 5 Ekim 2026

* **Dikkat:** Personel randevularında slot çakışması, kapalı gün, tatil ve ızgara dışı dakika artık engel değil uyarıdır. `GET /appointments/available-slots` için `user_id` ve `duration_minutes` zorunludur; `busy_slots` alanı ve `OUTSIDE_BUSINESS_HOURS` hatası kaldırıldı. Bkz. [Randevu uygunluğu](/api/kaynaklar/randevu-uygunlugu-ve-takvim).
* Düzeltme: Uygun saat yanıtındaki `end_at` değeri `24:00` olabilir.

### v1.1.0 — 5 Ekim 2026

**Panel**

* Randevu ekranları yenilendi: form kartları, hatırlatma zaman çizelgesi, gün müsaitliği ve randevu çalışma alanı (`/appointments/{id}`). **Tatiller** sayfası, yenilenen ödeme pencereleri ve hesap bazında tahsilat kırılımı eklendi. Bkz. [Tatiller](/panel/randevular/tatiller).
* Silinen son mesaj sohbet listesinde **Bu mesaj silindi.** olarak görünür.
* Lead ve Destek Talebi panoları aşağı kaydırınca otomatik yüklenir. AI rapor pencereleri sadeleşti. İstenen scope değişince oturum otomatik yeniden yetkilendirilir.
* İlk klinik otomatik seçilir; oturum açma hata ekranında **Oturumu Sıfırla** düğmesi vardır.

**API**

* **Dikkat:** `GET /stocks/overview` için `View:StockOverview`, ürün oluştururken ilk stok miktarı için `Create:StockMovement` izni gerekir.
* Agent istem sürümleri, kararlı sürüm, tip, model ve araç katalogları ile `language` ve `llm_model` alanları eklendi.
* Süresi geçmiş hatırlatmalar geç gönderilmek yerine `expired` olur; süresi dolmuş hatırlatmayı onaylamak veya reddetmek `422 REMINDER_EXPIRED` döndürür.
* `meta.collections_by_account`, `GET /appointments/{id}/sale-items`, tahsilatta `installment_number`, `channel_ids[]` sohbet filtresi ve `last_message_is_deleted` alanı eklendi. İmzalı dosya bağlantıları artık en fazla yaklaşık 65 dakika geçerlidir (önceden 5 dakikaydı).

## Eylül 2026 (v1.0.24–v1.0.45)

### v1.0.40–v1.0.45 — 29 Eylül – 1 Ekim 2026

**Panel**

* Hasta ve lead kartlarında **İletişim Kanalları** sekmesi. Kayıttan sohbet açıldığında ilk mesaj gönderilene kadar boş sohbet oluşmaz.
* Sohbet ve sistem bildirimleri tek bildirim zilinde birleşti. Hatırlatma onayları randevu ekranında görünür.
* Kanal yönetimi ve NES/Nilvera hesap tarayıcısı eklendi.
* Kişi kartı (vCard) mesajları kart olarak görünür. Seçili klinik sekmeler arasında ve oturum kesintisinde korunur. Takvimde bugünün hücresi **Bugün** etiketi taşır; kişi hâlâ lead ise randevuya bağlı satış engellenir.

**API**

* **Dikkat — silinmiş hasta kayıtları:** Veri imhası yapılmış hastaya ait kayıtlar salt okunurdur; yazma isteği `409 CUSTOMER_ERASED` döndürür. Yanıtlarda `record_state` alanı bulunur.
* Birleşik bildirim akışı `/api/v1/notifications` ve `GET /conversations/{id}` eklendi.
* Randevu hatırlatmaları randevu onaylanınca otomatik onaylanır. Düzeltme: Hatırlatmalar 3 saat erken gidiyordu. WhatsApp kanalları yeniden adlandırılabilir.
* Düzeltme: Aynı telefonu paylaşan silinmiş ve aktif hasta WhatsApp webhook'unda `500` üretiyordu; **Ödeme Ekle** bazı durumlarda kayıt yazmadan hata veriyordu.

### v1.0.38–v1.0.39 — 28 Eylül 2026

**Panel**

* Klinik izinleri gezinmede, sayfalarda, isteklerde ve eylemlerde uygulanır.
* Sohbet yan panelinde hasta ve lead kayıtları, görsel albüm baloncukları, **Kaynak** ve **Temsilci** filtreleri, sadeleşmiş yazı alanı.
* Hasta kartında **Görevler** sekmesi; sohbette görev kartları. Randevu listelerinde lead ve hasta ayrı gösterilir. Satış listesinde tahsilat sütunları ve toplamlar.

**API**

* **Dikkat:** Teklifi satışa dönüştürmek `Convert:Offer`, pipeline işlemleri `Create/Update/Delete/Activate:Pipeline`, satışta tahsilat `Pay:Sale`, satıştan belge oluşturma `CreateDocument:Sale` izni ister. `GET /sales/form-metadata` eklendi.
* **Dikkat:** Hızlı yanıtlar birden çok dosya taşır (`files`; `file` kullanımdan kalkmıştır). `GET /customer-forms` tüm klinik formlarını listeler; hasta bazlı form uç noktaları kayıt sahipliğine göre kapsanır.
* Hasta ve lead kaydından sohbet başlatma, hasta görevleri, hasta iletişim kanalları (`/customers/{id}/identities`) ve `message_format: plain|markdown` eklendi. Hasta sayıları dönüşmemiş lead'leri saymaz.

### 23 Eylül 2026 (v1.0.26–v1.0.37)

* **Dikkat — oran sınırı:** Varsayılan sınır dakikada 300 istektir; kota kullanıcı ve OAuth istemcisi başına tutulur. Bkz. [Oran sınırları](/api/istekler/oran-sinirlari).
* **Dikkat — silme:** Tek tek listelerdeki "silinenleri göster" (`trashed`) filtreleri, geri yükleme ve kalıcı silme rotaları kaldırıldı. **Geri Dönüşüm Kutusu**, **Veri İmha Talepleri** ve ilgili API'ler geldi. Bkz. [Geri Dönüşüm Kutusu](/panel/sistem/geri-donusum-kutusu) ve [Veri İmha Talepleri](/panel/sistem/veri-imha-talepleri).
* Abonelik faturalaması: kullanıma göre planlar, kotalar, proforma faturalar, online ödeme, indirim kodları ve **Faturalarım** çalışma alanı. Bkz. [Faturalarım](/panel/sistem/faturalarim/genel-bakis).
* Web sitesi sohbet widget'ı: herkese açık `/widget/{token}/*` uç noktaları, kanal yönetimi API'si, zengin mesajlar (medya, belge, konum). Bkz. [Web sitesi widget'ı](/panel/baglantilar/web-sitesi-widgeti).
* **Tatiller** (tam gün, kısmi, bilgilendirme ve kliniğe özel) ve yönetim API'si. Bkz. [Tatiller](/api/kaynaklar/tatiller).
* Randevu bildirim kanalı seçilebilir; hasta o kanaldan ulaşılamıyorsa yedek kanala geçilir. Bağlantısı kopuk kanal seçilmez.
* Manuel randevular kapalı günlerde ve ızgara dışı dakikalarda oluşturulabilir.
* **Dikkat:** API mesajları `Accept-Language` başlığına (`en` / `tr`) göre yerelleştirilir; varsayılan `tr`. `GET /mobile/statistics` kaldırıldı.
* Markalı işlem e-postaları; **Engellenen Kullanıcılar** sayfası onarıldı; WhatsApp okundu bilgisi AI yanıt moduna uyar.
* Randevu yanıtlarında `treatments[].group`, sohbetlerde `customer.lead_id` ve `customer.lead_stage`, `GET /leads/pipeline-summary` eklendi.
* Düzeltme: Giden sohbet medyası yinelenen dosya kaydı oluşturmaz; sohbet dosyaları arşivde **Sohbet** olarak görünür.

### v1.0.24–v1.0.25 — 1 ve 11 Eylül 2026

* WhatsApp çıkartma ve GIF mesajları gösterilir. WhatsApp ve Telegram'da mesaj tepkileri (`POST /conversations/{id}/messages/{messageId}/reactions`) ve düzenleme/silme senkronu eklendi.
* **Satış Tarihi** (`sale_date`) tüm satış ve ciro ekranlarında iş tarihidir. Randevudan satış oluştururken **Satış Tarihi** otomatik dolar (v1.0.25).
* Mesajlarda `search` ve `message_type[]` filtreleri; destek talebi, aktivite logu ve dosya listelerinde arama alanları eklendi.
* Düzeltme: Bağlantısı kopan WhatsApp kanalları artık etkin görünmez; durum saatlik kontrol edilir.

## Ağustos 2026 (v1.0.12–v1.0.23)

### v1.0.19–v1.0.23 — 26–31 Ağustos 2026

* **Panel:** Hasta birleştirme çalışma alanı, **AI Raporları** ve **Rapor Planları**, izin ağacıyla **Roller** (gezinme kullanıcının izinlerine göre süzülür), **Bakiyeler** için Excel/PDF dışa aktarma ve ödeme penceresi, **Uygulamalar** ve **İçe Aktar**, hasta üzerine gelince açılan özet kart. Bkz. [Hasta birleştirme](/panel/hastalar/birlestirme).
* **API:** İçe aktarma API'si (`/api/v1/import/*`) ve OAuth uygulamaları API'si (`/api/v1/oauth/*`); `POST /roles` ve `DELETE /roles/{id}`; satış listesinde ödeme yöntemi sütunları ve para birimi bazında toplamlar (`meta.totals`).
* Satışlar listesi bugünün tarih aralığıyla açılır. Düzeltme: **İndir** dosyayı tarayıcıda göstermek yerine indirir; **Toplam Açık Bakiye** kuru uygular; AI rapor tarih seçicileri klinik kuruluş tarihiyle sınırlanmaz.

### v1.0.18 — 26 Ağustos 2026

* **Panel (kalite turu):** **Randevu Hatırlatmaları**, **Seans Onayları**, **İptal Takibi Hatırlatmaları**, **Kaydırma Geçmişi**, toplu taşıma, randevu kopyalama, etiketler, meslekler, **Sorun Bildirimlerim**, stok sayımı, doktor/asistan/tedavi detay sayfaları.
* **API — kaynaklar:** AI raporları ve rapor planları API'si; hasta birleştirme API'si (adaylar, önizleme, geçmiş); `PUT /roles/{id}` ve `GET /permissions`; fatura yanıtlarında `ettn`; depolama kullanım istatistikleri (`GET /credit-usages/statistics`).
* **API — listeler:** Hasta, dosya, not, tedavi, asistan, ürün, kredi, fatura, oda ve hatırlatma listelerine birçok tarih aralığı, arama ve sıralama filtresi eklendi. Hasta ve lead aramaları aksan duyarsız ve kelime ortasında da eşleşir.
* **Dikkat:** Avatar yalnızca `POST /account/avatar` ve `DELETE /account/avatar` ile yönetilir. `POST /users` isteğinde `password` isteğe bağlıdır (rastgele parola üretilir, sıfırlama e-postası gider). Kredi listesinde `created_from`, `created_until` ve `end_date_until` filtreleri `created_at_from/to` ve `end_date_to` oldu.
* **Dikkat — pano:** Gelir ve yeni hasta rakamları klinik saat dilimi, döviz kuru, tüm satış durumları ve yalnızca dönüşen hastalar esas alınarak yeniden hesaplandı.
* `GET /conversations` yanıtında `last_customer_message`, `POST /conversations/read-all`, iOS M4A sesli mesaj desteği eklendi.

### v1.0.13–v1.0.17 — 8–14 Ağustos 2026

* **Hasta Birleştirme** ve `POST /customers/{id}/merge` (`Merge:Customer` izni). Hasta sayfasında faturalar sekmesi; sekmeler **Belgeler** ve **Mali İşlemler** altında toplandı, **Satış** sekmesi **Satışlar** oldu.
* **Dikkat:** Lead aşamasındaki kişiler `/customers*` listelerinden çıkarıldı (kimlikle erişimde `404`). Genel arama dönüşmüş lead'i bir kez listeler ve kayıt görünürlüğünü uygular.
* **Dikkat — izinler (v1.0.14):** Merkezi izin kataloğu geldi; `ViewAny:*` izinleri kalktı, rol düzenleyici izin ağacına döndü. `salesperson` ve `sales_director` sistem rolleri oluşturuldu. Bkz. [Roller ve izinler](/panel/sistem/roller).
* **Nakit** ödeme yöntemi **Devir Kasa**'dan ayrıldı. Faturalar listesinde düzenleme tarihi filtresi (varsayılan bugün) ve istatistik kartları eklendi. AI klinik raporları yapılandırılmış ve yerelleştirilmiş hâle geldi.
* Rezervasyon asistanı doğrulanmış slotlarla çalışır; yeni hastalar kayıt olmadan önce randevu alabilir.
* v1.0.13: İlk panel sürüm etiketi. Oturum, yenileme belirteciyle yeniden kurulur.

### v1.0.12 — 4 Ağustos 2026

* **Dikkat:** Hasta **İşlemler** sekmesi satışa göre gruplanır; manuel işlem formu kalktı, ödemeler yalnızca **Ödeme Ekle** ile girilir.
* Tam lead REST API'si (aktiviteler, notlar, görevler, toplu işlemler). Klinikte tek aktif pipeline bulunur.
* Sohbet arşivleme ve etiketler, filtre paneli; `/` kısayoluyla çalışan ve medya taşıyan **Hızlı Yanıtlar**. Bkz. [Hızlı yanıtlar](/panel/sohbetler/hizli-yanitlar).

## Temmuz 2026 (v1.0.7–v1.0.11)

<Note>
  Panel sürüm etiketleri v1.0.13'te başladı. Temmuz'da panele eklenen modüller (Teklifler, lead Kanban ve pipeline, Satış Temsilcileri, Duyurular, Krediler, Form Şablonları, Agentlar, ürün kataloğu, profil) bu ilk panel etiketine dahildir.
</Note>

### v1.0.11 — 30 Temmuz 2026

* Satış oluştururken tahsilat alma: kısmi, tam, taksitli ve döviz cinsinden; satışla birlikte tek işlemde kaydedilir. Randevu **kopyalama**. Profilde bildirim tercihleri (`GET/PUT /account/notification-preferences`).
* `GET /customer-balances` (`View:CustomerBalances` izni) eklendi; **Bakiyeler** sayfası panelde v1.0.20 ile geldi. Bkz. [Bakiyeler](/panel/finans/bakiyeler).
* Satış API'sine `/sales/stats`, `/sales/export`, `GET /payment-methods`, yeni filtreler ve taksitler eklendi. Ürün kataloğu API'si (`GET /catalog-products`).
* **Dikkat:** `POST /sales/{id}/payments` için `payment_method` zorunludur. Hastanın serbest metin `job` alanı yerine `occupation_id` / `occupation_name` kullanılır. Pano, kullanım istatistikleri modülü üzerinde yeniden kuruldu; rol bazlı widget panosu kalktı.

### v1.0.8–v1.0.10 — 22–24 Temmuz 2026

* **Dikkat (v1.0.8):** Lead erişimi izin tabanlı sahiplikle sınırlandı; toplu atama, lead iletişim ve destek sekmeleri eklendi.
* **Dikkat (v1.0.8):** Tüm API hataları `{success, error_code, message, errors?, data?}` biçimindedir; `error` ve `data.message` alanları kalktı. Bkz. [Yanıt yapısı](/api/istekler/yanit-yapisi).
* Sohbet ayarına **Bildirim Alacak Roller** eklendi (varsayılan `assistant`; boş bırakılırsa kimse bildirim almaz).
* Düzeltme: Randevu ve seans saatleri 3 saat kayıyordu; yaklaşık 2–7 günlük zaman damgaları sohbet listesini bozuyordu; mobilden yüklenen hasta dosyaları API ve panelde görünmüyordu (v1.0.9).

### v1.0.7 — 14 Temmuz 2026

* Lead pipeline, Kanban ve satış temsilcisi altyapısı: aşamalar lead durumlarının yerini aldı; otomatik atama modları, lead sınırları, izole satış temsilcisi görünürlüğü, çoklu para biriminde beklenen değer.
* Renkli randevu etiketleri. **Kontrol randevusu mu?** seçeneği planı tek kontrol seansına indirir.
* Lead eylem API'leri (`POST /leads/{id}/assign|lost|won`, toplu aşama değiştirme), pipeline ve satış temsilcisi API'leri; randevu listesine `assistant_id`, `treatments`, `room_id`, `session_type`, `has_sale`, `created_at_from/to` ve `is_control_appointment` filtreleri.
* Rol ekranına `Assign:Lead`, `ViewAllLeads:Lead` ve `AutoAssignLeads:Lead` izinleri eklendi. AI modeli seçimi klinik ve rol bazında yapılır, maliyet izlenir.
* Düzeltme: KDV dahil toplamlar 1 kuruş yüksek çıkıyordu.

## Daha eski sürümler

| Sürüm | Tarih | Öne çıkanlar |
| - | - | - |
| v1.0.6 | 11 Temmuz 2026 | Seans randevusu yalnızca hasta açıkça onayladıktan sonra oluşur; satışlar için Excel ve PDF dışa aktarma |
| v1.0.2–v1.0.5 | 1–5 Temmuz 2026 | e-SMM KDV düzeltmesi, klinik varsayılan KDV oranı (0, 1, 10 veya 20), takvimde iptal edilen randevular, tedavi rozetleri, ürün oluştururken ilk stok |
| v1.0.1 | 24 Haziran 2026 | Mesaj bildirimleri API'si, özel seanslar, doktorun takvim meşgul saatleri yerine yerel randevuların kullanılması, Stok Sayımı, e-faturada döviz |
| v1.0.0 | 15 Haziran 2026 | İlk kararlı sürüm: OAuth güçlendirmesi, hatırlatma onayı, hesap silme, teklifler modülü, tarih ve saat dilimi standardı, ürün setleri |
| v0.1.0-alpha – v1.0.9-beta | Ekim 2025 – Mayıs 2026 | Medibot adıyla WhatsApp AI asistanı; Kasım 2025'te Flextell adı. Ardından kanallar, hatırlatmalar, ilk herkese açık API ve OAuth uygulamaları, finans ve fatura, stok, Telegram ve entegrasyon tabanlı kanallar |

## Kaldırılan özellikler

Aşağıdaki özellikleri eski kullanımınızdan hatırlıyor olabilirsiniz.

| Kaldırılan | Sürüm | Yerine |
| - | - | - |
| **Randevu Detayları** penceresi | v1.8.0 | Randevu detay sayfası (`/appointments/{id}`) |
| `View:ChatLogPage` ve `View:CalendarPage` izinleri | v1.6.0 | `View:Conversation` ve `View:Appointment` |
| Kanal listelerindeki **Özellikler** sütunu | v1.7.0 | — |
| `OUTSIDE_BUSINESS_HOURS` hatası ve `busy_slots` alanı | v1.1.1 | Uyarı olarak dönen çakışma, kapalı gün ve tatil bilgisi |
| `GET /mobile/statistics` | v1.0.35 | — |
| Listelerde "silinenleri göster" (`trashed`), geri yükleme ve kalıcı silme rotaları | v1.0.29 | **Geri Dönüşüm Kutusu** ve **Veri İmha Talepleri** |
| Rol bazlı widget panosu | v1.0.11 | Kullanım istatistiklerine dayalı pano |
| Hastanın serbest metin `job` alanı | v1.0.11 | Meslek (`occupation_id`, `occupation_name`) |
| Hasta **İşlemler** sekmesindeki manuel işlem formu | v1.0.12 | **Ödeme Ekle** |
| `ViewAny:*` izinleri | v1.0.14 | `View:*` izinleri ve merkezi izin kataloğu |
| **Lead Durumları** sayfası | v1.0.7 | [Pipeline'lar](/panel/pipelinelar) ve aşamalar |
| `GET /tenants`, `GET /exchange-rates`, `GET /general` | Şubat–Haziran 2026 | `/tenant` ve `/account/tenants`, `GET /general/exchange-rates`, `GET /general/global-search` |

Eski sürümlerden geçiş yapan entegrasyonlar için ayrıntılı eski ve yeni karşılaştırmaları [API değişiklikleri](/surum-notlari/api-degisiklikleri) sayfasındadır.


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