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ı

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

  1. 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.  
  1. 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.
  1. 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.
  1. 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. 
  1. MAIL / PROVIDER: E-posta gönderme, alma, depolama ve yönetme için altyapı sağlar. 
  2. 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. 
  1. INVERS CLOUDBOXX: Bulut tabanlı yönetim ve otomasyon platformudur.  Invers Cloudboxx için konfigürasyon tanımlaması yapabilirsiniz. 
  2. 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:

WhatsApp Business Hesabı ve App Bilgileri:

  • Bir WhatsApp Business hesabı oluşturun.
  • Facebook Business üzerinden bir uygulama (App) oluşturun.
  • 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.