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şur:
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.
A. Sol Panel
Ana sayfaya veya farklı projelere erişebilirsiniz.
Yeni konfigürasyonlar ekleyebilir ve mevcut projelerinizin konfigürasyonlarını yönetebilirsiniz.
Configuration +: Yeni bir konfigürasyon ekleme alanıdır.
Project / Global:
Project: Açık olan uygulamaya özel hazırlanmış konfigürasyonları listeler.
Global: Apps ekranındaki Configuration Manager ile eklenmiş ve workspace genelinde kullanılabilir olan konfigürasyonları listeler.
B. Konfigürasyon Yönetim Alanı
Yeni konfigürasyonlar oluşturabilir ve test edebilirsiniz.
Name: Konfigürasyonunuza isim verebileceğiniz alandır.
CREATE: Yeni bir konfigürasyon oluşturur.
Download: Oluşturduğunuz konfigürasyonu indirmenizi sağlar.
RUN: Konfigürasyonunuzu test etmenize 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ş yapın.
Apps ekranından çalışacağınız projeyi açın.
Configuration Manager modülüne tıklayın.
Açılan ekrandan konfigürasyona bir isim verin ve CREATE butonuna tıklayın.
Böylece uygulamanıza yeni bir konfigürasyon eklemiş olursunuz.
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.
A. İsim Alanı
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ğlayacağınızı gösterir.
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: Workflow Engine bağlantı ayarlarını içerir.
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ılır.
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 ayarlarını içerir.
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 ve diğer uyarıların yönetimini sağlar.
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 ve yönetme hizmetleri 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.
GOOGLE RECAPTCHA: Spam ve kötüye kullanım gibi etkinlikleri önlemek için kullanılır.
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.
WHATSAPP BUSINESS: WhatsApp API entegrasyon bilgilerini içerir.
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.
FILE UPLOAD PATH: Dosya yükleme işlemi sırasında saklanacak dizini 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.
C. Kaydetme & İptal Etme Alanı
CANCEL: Yapılandırma ayarlarını iptal eder.
SAVE: Yapılandırma ayarlarını kaydeder.
D. Description Alanı
Yapılandırma ayarlarına dair ek açıklamalar ve notlar ekleyebileceğiniz bölümdür.
Uygulamanızı App Settings Aracılığıyla Yapılandırın
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
Configuration Manager modülünü kullanarak konfigürasyon oluşturun.
App Settings modalından Web sekmesine tıklayın.
Host Settings, Sessions ve Google Maps gibi alanları yapılandırın.
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.
SAVE butonuna tıklayarak ayarlarınızı kaydedin.
iOS Uygulamalarınızı Yapılandırın
Configuration Manager modülünü kullanarak konfigürasyon oluşturun.
App Settings modalından iOS sekmesine tıklayın.
Mobile App Settings, Apple Sign In, App Store Settings gibi ayarları yapılandırın.
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.
Mobile App Settings, Play Store Settings, Maps, Geolocation gibi ayarları yapılandırın.
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.
Bu eğitimle Configuration Manager modülünü kullanarak Kuika platformunda uygulamalarınızın konfigürasyonlarını yapılandırabilir, test edebilir ve yayınlayabilirsiniz.