Kuika’nın Configuration Manager modülünü, geliştirdiğiniz uygulamanın oluşturulması sırasında kullanılacak tanımları yapılandırmak, uygulamayı ön izlemek, test etmek ve yayınlamak için kullanabilirsiniz. Bu eğitim içeriğinde Configuration Manager modülü aracılığıyla uygulamanın oluşturulması sırasında kullanılacak tanımları nasıl yapılandırabileceğinizi öğreneceksiniz.
Bu eğitim içeriği aşağıdaki başlıklardan oluşmaktadır:
Configuration Manager modülünün anatomisi,
Uygulamanıza konfigürasyon ekleme,
App Settings modalı anatomisi,
Uygulamanızı App Settings aracılığıyla yapılandırma.
Configuration Manager Modülünün Anatomisi
Kuika platformunda “Configuration Manager” modülüne geçiş yaptığınızda konfigürasyon oluşturma ekranı karşınıza çıkar.
Sol panelden ana sayfaya veya farklı projelere erişebilir, yeni konfigürasyonlar ekleyebilir veya mevcut projelerinizin konfigürasyonlarını yönetebilirsiniz.
Configuration +: Yeni bir konfigürasyon ekleyebileceğiniz alandır.
Project / Global:"Project" sekmesi, açık olan uygulamaya özel hazırlanmış konfigürasyonları listeler. "Global" sekmesi ise, Apps ekranındaki Configuration Manager ile eklenmiş ve workspace genelinde kullanılabilir olan konfigürasyonları listeler. Global konfigürasyon içeriğimizde linkten ulaşabilirsiniz.
B. Konfigürasyon Yönetim Alanı
Konfigürasyon yönetim alanı aracılığıyla yeni konfigürasyonlar oluşturabilir ve test edebilirsiniz.
Name: Konfigürasyonunuza isim verebileceğiniz alandır.
CREATE: Yeni bir konfigürasyon oluşturmanızı sağlar.
Download: Oluşturduğunuz konfigürasyonu indirmenizi sağlar.
RUN: Konfigürasyonunuzu test edebilmenize olanak tanır.
C. Sağ Panel
Dökümantasyon paneli aracılığıyla konfigürasyonlarınızı web ve mobil uygulamalarda nasıl yapılandıracağınıza dair içeriklere ulaşabilirsiniz.
Uygulamanıza Konfigürasyon Ekleyin
Yeni bir konfigürasyon oluşturmak için:
Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız Mobile projeyi açın.
Ardından “Configuration Manager” modülüne tıklayın.
Açılan ekrandan konfigürasyona bir isim (1) verin ve “CREATE” (2) butonuna tıklayın.
App Settings Modalı Anatomisi
Kuika’da geliştirilen bir uygulamayı ön izlemek ve yayınlamak için bir App Settings yapılandırmasına ihtiyacınız vardır.
Yapılandırma işlemleriniz için App Settings modalının bölümleri inceleyelim.
A.İsim Alanı
Bu bölümden konfigürasyonunuza verdiğiniz ismi değiştirebilir ve kaydedebilirsiniz.
B. App Settings Yapılandırma Alanı
CONNECTION SETTINGS: Uygulamanızın veritabanını API’ye veya başka bir hizmete nasıl bağlanabileceğinizi gösteren yapılandırma bilgisidir.
DB connection string: Uygulamanızın veritabanına bağlanmak için gereken bilgileri içeren dizidir. Genellikle sunucu adresi, veritabanı adı, kullanıcı adı ve şifre bilgilerini içerir.
Backend URL : Uygulamanızın backend hizmetlerine erişmek için kullanılan URL’dir.
Backend URL ayarları, “IP” ve “Port” bilgilerini kabul etmektedir.
WORKFLOW: Cihazınızda bir uygulama içinde WF özelliğini kullanırsanız, Workflow Engine ayrı bir servis olarak devreye girecektir.
Engine Base URL: Uygulamanızın API’yına erişmek için kullanılan ana URL’dir.
Mail Provider: Uygulama içerisinden e-posta gönderme veya alma işlevleri için kullanılır.
Workflow Engine Connection String: Uygulamanızın Workflow Engine ile entegrasyonunu sağlamak için bağlantı dizesi gireceğiniz alandır.
SEARCH SERVICE: Uygulamalarınızda veri arama ve yönetim işlemleri için kullanılan bir servistir.
Name: Yaratılan konfigürasyon için belirlenen isimdir.
Base Url: Arama servisiyle bağlantı kurulmasını sağlayan temel URL'dir. Uygulamanın Search Service API’si üzerinden arama sorguları gönderip sonuç almasını sağlar.
Vector Database Service Port: Vektör tabanlı veritabanı hizmetinin kullandığı port numarasıdır. Büyük ve karmaşık veri kümelerinde benzerlik tabanlı arama (ör. metin tabanlı aramalar vb.) yapmak için kullanılır.
Python Service Port: Arama servisinin, vektör veritabanı ile iletişimini sağlayan python servisinin kullandığı port numarasıdır. Kaynak ekleme, arama gibi işlemlerin yerine getirilmesini sağlar.
Storage Path: Arama hizmetine ait verilerin depolandığı dizini belirtir. Arama ile ilgili indekslerin ve sonuçların depolandığı yerdir.
AUTHENTICATION & AUTHORIZATION: Kimlik doğrulama ve yetkilendirme alanı, kullanıcı adı ve şifre girerek kimlik doğrulama işlemini gerçekleştirdikten sonra belirli kaynaklara veya işlemlere izniniz olup olmadığını belirler.
Password Policy: Şifrenizin uzunluğunu, karmaşıklığını ve değiştirilme sıklığınızı belirlemenizi sağlar.
Google: Google hesaplarınızı kullanarak üçüncü taraf uygulamalarda oturum açabilmenizi sağlar.
Facebook: Facebook hesaplarınızla uygulamanıza giriş yapmanızı sağlar.
MSAL: Microsoft hesapları ile kimlik doğrulama işlemlerini yapmanızı sağlar.
OTP: Tek kullanımlık bir şifredir ve iki faktörlü doğrulama süreçlerinde kullanılır.
2F Auth: Switch’i aktif hale getirdiğinizde kimlik doğrulama süreci iki aşamalı hale gelir. İlk aşama genellikle bir şifre, ikinci aşama ise OTP güvenlik kodudur.
2 Auth Duration: İki faktörlü kimlik doğrulama sürecinde ikinci aşama olan OTP veya güvenlik kodunun geçerlilik süresidir. Her 15 günde bir SMS ile kimlik doğrulaması yapar.
Expire Old Sessions Upon New Login: Bir kullanıcının aynı hesabıyla yeni bir oturum açtığında, o hesaba ait eski oturumların otomatik olarak sonlandırılmasını sağlayan bir güvenlik özelliğidir.
NOTIFY ACTIONS: Uygulamanızdaki e-posta bildirimleri veya diğer uyarı türlerinin belirli sürelerle yönetilmesini sağlar. Her bir bildirim türünün gösterilme süresini ve yapılandırmasını içerir.
Name: Bildirim için verilen adıdır. Örneğin, kullanıcıya gösterilen bildirim başlığı ya da türü burada belirtilebilir.
Default Duration: Varsayılan olarak, bildirimlerin ekranda ne kadar süreyle görüntüleneceğini belirler.
Success Duration: Başarıyla tamamlanan işlemler sonrası gösterilen bildirimlerin ekranda kalma süresini belirtir. Örneğin, kullanıcı bir işlem yaptı ve başarılı olduysa, ekranda gösterilecek bildirim bu süre boyunca görünür.
Info Duration: Bilgilendirme amaçlı gösterilen bildirimlerin süresi. Sistemdeki gelişmeler veya önemli bilgiler hakkında bilgi vermek için kullanılır.
Warning Duration: Uyarı mesajlarının ne kadar süreyle görüneceğini belirler.
Error Duration: Hata mesajlarının gösterileceği süreyi belirtir.
MAIL / PROVIDER: E-posta gönderme, alma, depolama ve yönetme için altyapı sağlar.
PAYMENT METHOD: Uygulamanız içerisinde bir ürün veya hizmet için ödeme yaparken kullanılabilecek yöntemi belirlemenizi sağlar.
Stripe: Çevrimiçi ödeme işlemlerini işlemek için kullanabileceğiniz ödeme işlemi platformudur.
Iyzico: Türkiye merkezli bir ödeme işleme platformudur ve çevrimiçi ödemeleri yönetmenizi kolaylaştırır.
Param: E-ticaret siteleri, mobil uygulamalar ve diğer dijital platformlar için çeşitli ödeme yöntemleri sunar.
INVERS CLOUDBOXX: Bulut tabanlı yönetim ve otomasyon platformudur. Invers Cloudboxx için konfigürasyon tanımlaması yapabilirsiniz.
FILE UPLOAD PATH: Bir dosya yükleme işlemi sırasında yüklenen dosyaların saklanacağı dizini veya yolu belirtir.
Name: Yüklenecek dosyaları tanımlayan ismin girilmesi gereken alandır.
File Upload Path: Yüklenen dosyaların sunucuya hangi dizinde saklanacağını belirtir. Örneğin, yüklenen belgeler için /upload/user_documents/ gibi bir yol belirlenebilir.
10. GOOGLE RECAPTCHA: Uygulamanızda spam ve kötüye kullanım gibi istenmeyen etkinlikleri önlemek için kullanılan bir güvenlik hizmetidir. Gerekli bilgilere ulaşmak için Google Cloud’u ziyaret edebilirsiniz:
Name: ReCaptcha konfigürasyonu için belirlenen isimdir.
Site Key: ReCaptcha’nın uygulamanızda çalışmasını sağlayan açık anahtardır.
Secret Key: ReCaptcha doğrulama işlemlerinde sunucu tarafında kullanılan özel anahtardır.
11. WHATSAPP BUSINESS: WhatsApp Business API, işletmelerin müşterileriyle daha verimli iletişim kurmalarını sağlayan bir hizmettir. Aşağıda belirtilen konfigürasyon bilgileri, API'yi doğru şekilde entegre etmek ve WhatsApp üzerinden mesajlaşma akışlarını yönetmek için gereklidir. Gerekli bilgilere ulaşmak için Facebook for Developers platformunu ziyaret edebilirsiniz:
Ardından App Settings alanındaki Whatsapp Business alanına aşağıdaki bilgiler girilir:
Name: WhatsApp Business hesabına verilen isimdir.
Account ID: WhatsApp Business hesabınızı tanımlayan benzersiz kimlik numarasıdır. Tüm WhatsApp konfigürasyonlarında aynı olmalıdır.
App ID: Facebook Business üzerinden oluşturulan uygulamanın benzersiz kimliğidir ve API'ye erişimde kullanılır.
App Secret: Facebook uygulamanızın güvenliğini sağlamak için kullanılan gizli bir anahtardır.
Access Token: WhatsApp API'ye erişim sağlamak için kullanılan doğrulama anahtarıdır. Süreli ya da süresiz olarak alınabilir. Süreli olarak alınırsa, süresi dolduğunda Kuika ile oluşturulmuş uygulama üzerinden mesaj gönderilemez.
Phone Number ID: WhatsApp Business hesabınıza bağlanmış telefon numarasının benzersiz kimlik numarasıdır.
Version Number: WhatsApp Business API'nin hangi sürümünün kullanıldığını belirten numaradır. Güncel sürümle uyumluluk için önemlidir.
Mesaj Gönderim ve Template Kullanımı:
WhatsApp Dashboard üzerinden bir mesaj şablonu oluşturulur ve WhatsApp onayı alınır.
Şablon örneği:
Başlık: "Teklif Durumu Hakkında"
Mesaj: "Tebrikler! Süreciniz olumlu sonuçlanmıştır. Teklifimizi kabul edip etmediğinizi belirtmek için aşağıdaki butonlardan birini seçiniz."
Butonlar: "Kabul Ediyorum", "Reddetmek İstiyorum"
Onaylı şablonlar, Kuika üzerindeki Send WhatsApp Business Message aksiyonu ile gönderilir. Detaylı bilgi için ilgili içeriğimizi inceleyebilirsiniz.
Template Türleri: WhatsApp mesajları için kullanılan şablonlarda parametreler, Facebook'ta oluşturulurken seçilir. Bu parametreler, Kuika'ya otomatik olarak gelir ve burada ayarlanıp mesaj gönderilebilir.
Butonlu Template’ler: Sadece dış atamaya sahip adımlarda kullanılabilir.
Butonsuz Template’ler: Sürecin her aşamasında kullanılabilir.
Kuika şu anda yalnızca Quick Reply (hızlı yanıt) butonlarını desteklemektedir. Diğer buton türleri kullanılamaz.
Quick Reply Kullanımı:
Süreç ilerletmek için kullanılan butonlar Quick Reply (custom) tipinde olmalıdır.
Her buton bir mail interaction ile eşleştirilmelidir.
C. Kaydetme & İptal Etme Alanı
Bu alandan yapılandırma ayarlarınızı “CANCEL” butonu ile iptal edebilir veya “SAVE” butonu ile kaydedebilirsiniz.
D. Not Alanı
Konfigürasyon ayarlarınız için not alabildiğiniz alandır.
Uygulamanızı App Settings Aracılığıyla Yapılandırın
Kuika’da geliştirilen bir uygulamayı ön izlemek ve yayınlamak için bir App Settings yapılandırmasına ihtiyaç vardır.
Web ve mobil uygulamalar için App Settings modal görünümü farklılık göstermektedir. App Settings modalında web uygulamalarınız için App Settings ve Web sekmeleri bulunurken, mobile uygulamalarınız için App Settings, iOS, Android ve Web sekmeleri bulunmaktadır.
Web Uygulamalarınızı Yapılandırın
Geliştirdiğiniz Web uygulama için Configuration Manager modülünü kullanarak ihtiyacınız olan ayarları yapılandırabilirsiniz.
Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız Web projenizi açın.
“Configuration Manager” modülüne tıklayın ve bir konfigürasyon oluşturun.
Açılan App Settings modalından “Web” sekmesine tıklayın.
Web modalından aşağıdaki alanları yapılandırabilirsiniz:
HOST SETTINGS: Bir hizmetin veya uygulamanın nasıl çalışacağını ve diğer cihazlarla nasıl etkileşime geçeceğini belirler.
SESSIONS: Uygulamanızın son kullanıcıları için web uygulamasının oturum zaman aşımı süresini belirlemenizi sağlar.
GOOGLE MAPS: Geliştirdiğiniz bir web uygulamasında harita kullanımı mevcutsa harita ayarlarını oluşturabilir ve harita için gerekli bilgileri girebilirsiniz.
Son olarak uygulamanızın konfigürasyon ayarlarını kaydetmek için “SAVE” butonuna tıklayın.
Configuration Manager modülü aracılığıyla Web sekmesinde gerekli ayarlamaları yaparak geliştirdiğiniz web uygulamayı test edebilir ve yayına alabilirsiniz.
iOS Uygulamalarınızı Yapılandırın
Geliştirdiğiniz iOS uygulama için Configuration Manager modülünü kullanarak ihtiyacınız olan ayarları yapılandırabilirsiniz.
Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız Mobile projenizi açın.
“Configuration Manager” modülüne tıklayın ve bir konfigürasyon oluşturun.
Açılan App Settings modalından “iOS” sekmesine tıklayın.
iOS modalından aşağıdaki alanları yapılandırabilirsiniz:
MOBILE APP SETTINGS: Apple App Store’da kullanacağınız uygulama ismi, Bundle ID ve uygulama sürüm bilgilerini gireceğiniz alandır.
APPLE SIGN IN SETTINGS: Geliştirdiğiniz uygulamalarda yapılandırma ayarları yaparak Apple hesaplarınızla giriş yapabilirsiniz.
APP STORE SETTINGS: Geliştirdiğiniz uygulamayı AppMachine ile bağlamak için App Store ayarlarını yapabilirsiniz.
FIREBASE SETTINGS: Firebase platformunun sunduğu hizmetleri ve özellikleri uygulamanıza entegre edebilirsiniz.
GEOLOCATION: Uygulamanızda kullanacağınız konum bilgileri iznini tanımlayabilirsiniz.
CAMERA: Son kullanıcılara gösterilecek kamera kullanım izin metnini tanımlayabilirsiniz.
BLUETOOTH: Son kullanıcılara gösterilecek Bluetooth kullanım izin metnini tanımlayabilirsiniz.
PUSH NOTIFICATIONS: Push bildirimleri göndermek için son kullanıcılara gösterilecek izin metnini tanımlayabilirsiniz.
Son olarak uygulamanızın konfigürasyon ayarlarını kaydetmek için “SAVE” butonuna tıklayın.
Configuration Manager modülü aracılığıyla iOS sekmesinde gerekli ayarlamaları yaparak geliştirdiğiniz mobil uygulamayı test edebilir ve yayına alabilirsiniz.
Android Uygulamalarınızı Yapılandırın
Geliştirdiğiniz Android uygulama için Configuration Manager modülünü kullanarak ihtiyacınız olan ayarları yapılandırabilirsiniz.
Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız Mobile projenizi açın.
“Configuration Manager” modülüne tıklayın ve bir konfigürasyon oluşturun.
Açılan App Settings modalından “Android” sekmesine tıklayın.
Android modalından aşağıdaki alanları yapılandırabilirsiniz:
MOBILE APP SETTINGS: Play Store’da kullanacağınız uygulama ismi, Bundle ID, uygulama sürüm bilgileri ve minimum Android versiyonunu gireceğiniz alandır.
PLAY STORE SETTINGS: Geliştirdiğiniz uygulamayı Play Store’a bağlamak için yapılandırabilirsiniz.
MAPS: Geliştirdiğiniz Android uygulamasında harita kullanımı mevcutsa harita ayarları oluşturabilir ve gerekli bilgileri girebilirsiniz.
GEOLOCATION: Uygulamanızda kullanacağınız konum bilgileri iznini tanımlayabilirsiniz.
CAMERA: Son kullanıcılara gösterilecek kamera kullanım izin metnini tanımlayabilirsiniz.
BLUETOOTH: Son kullanıcılara gösterilecek Bluetooth kullanım izin metnini tanımlayabilirsiniz.
PUSH NOTIFICATIONS: Push bildirimleri göndermek için son kullanıcılara gösterilecek izin metnini tanımlayabilirsiniz.
Son olarak uygulamanızın konfigürasyon ayarlarını kaydetmek için “SAVE” butonuna tıklayın.
Configuration Manager modülü aracılığıyla Android sekmesinde gerekli ayarlamaları yaparak geliştirdiğiniz mobil uygulamayı test edebilir ve yayına alabilirsiniz.
