Bu API tamamen salt okunur (read-only) bir servistir. Yeni kanal ekleme, mevcut kanalları düzenleme veya silme işlemleri API üzerinden yapılamaz; bu işlemler yalnızca Admin Paneli (Filament) üzerinden yönetilebilir.
Tüm isteklerde X-Tenant header’ı zorunludur ve sadece ilgili tenant’a ait kanallar listelenir.
Endpoint özeti
| Metot | Endpoint | Açıklama |
|---|
GET | /api/v1/channels | Tenant’a ait tüm iletişim kanallarını listeler |
Tüm parametreler, alanlar ve örnek istek/yanıtlar için API Referansı sekmesine bakın. İletişim kanalı (channel) kavramı
İletişim kanalları, kliniğin (tenant’ın) hastalarla iletişim kurduğu entegrasyon noktalarını temsil eder. Örneğin: “Klinik WhatsApp Hattı 1”, “Instagram Hesabı” vb.
Sohbetler (Conversations) API’sini kullanarak yeni bir konuşma başlatmak istediğinizde, sistemi hangi kanal üzerinden mesaj göndereceği konusunda yönlendirmek için bu listedeki aktif kanallardan birinin ID’sini (channel_id) kullanmanız gerekir.
Entegrasyon için pratik not: Kullanıcı arayüzünüzde (UI) mesaj göndermek için bir kanal seçimi yaptıracaksanız; yalnızca is_active değeri true ve status değeri open olan kanalları listelemeniz önerilir. Aksi takdirde mesaj gönderim işlemleri arka planda hata alabilir.
Yetkilendirme
Uygulama izinleri (permissions)
| İşlem | Permission |
|---|
| Listeleme | ViewAny:Channel |
Token scope’ları (Passport)
| İşlem | Scope |
|---|
Okuma (index) | channels:read |
