You can use Kuika's Configuration Manager module to configure the definitions to be used during the creation of the application you are developing, preview, test and publish the application. In this training content you will learn how to configure the definitions to be used during the creation of the application through the Configuration Manager module.
This training content consists of the following topics:
Anatomy of the Configuration Manager module
Adding configurations to your application
Anatomy of the App Settings modal
Configure your app via App Settings
Anatomy of the Configuration Manager Module
When you switch to the Configuration Manager module on the Kuika platform, you will see the configuration creation screen.
A. Left Panel
You can access the home page or different projects.
You can add new configurations and manage the configurations of your existing projects.
Configuration +: This is the field to add a new configuration.
Project / Global:
Project: Lists the configurations prepared specifically for the open application.
Global: Lists the configurations added with Configuration Manager on the Apps screen and available across the workspace.
B. Configuration Management Area
You can create and test new configurations.
Name: This is the field where you can name your configuration.
CREATE: Creates a new configuration.
Download: Allows you to download the configuration you created.
RUN: It allows you to test your configuration.
C. Right Panel
Through the documentation panel, you can access content on how to configure your configurations in web and mobile apps.
Add Configuration to Your App
To create a new configuration:
Log in to the Kuika platform.
Open the project you will work with from the Apps screen.
Click on the Configuration Manager module.
From the screen that opens, give a name to the configuration and click the CREATE button.
This adds a new configuration to your app.
Anatomy of App Settings Module
To preview and publish an app developed in Kuika, you need an App Settings configuration.
A. Namespace
You can change the name you gave your configuration and save it.
B. App Settings Configuration Area
CONNECTION SETTINGS: Shows you how to connect your application's database to the API or another service.
DB connection string: A string containing the information needed to connect to your application's database. It usually contains the server address, database name, username and password.
Backend URL : The URL used to access the backend services of your application.
Backend URL settings accept “IP” and “Port” information.
Engine Base URL: The main URL used to access your application's API.
Mail Provider: Used for sending or receiving e-mails from within the application.
Workflow Engine Connection String: This is the field where you will enter the connection string to integrate your application with Workflow Engine.
SEARCH SERVICE: Used for data search and management operations in your applications.
Name: The name specified for the created configuration.
Base URL: This is the base URL that allows connection to the search service. It allows the application to send search queries through the Search Service API and get results.
Vector Database Service Port: The port number used by the vector-based database service. It is used to perform similarity-based searches (e.g. text-based searches, etc.) on large and complex datasets.
Python Service Port: The port number used by the python service that enables the search service to communicate with the vector database. It allows operations such as adding resources and searching to be performed.
Storage Path: Specifies the directory where the data of the search service is stored. It is where the indexes and results related to the search are stored.
AUTHENTICATION & AUTHORIZATION: Includes authentication and authorization settings.
Password Policy: Allows you to set the length, complexity and frequency of changing your password.
Google: Allows you to sign in to third-party apps using your Google accounts.
Facebook: Allows you to log in to your app with your Facebook accounts.
MSAL: Allows you to authenticate with Microsoft accounts.
OTP: It is a one-time password and is used in two-factor authentication processes.
2F Auth: When you activate the switch, the authentication process becomes two-factor. The first step is usually a password and the second step is the OTP security code.
2 Auth Duration: The validity period of the OTP or security code, which is the second step in the two-factor authentication process. It authenticates via SMS every 15 days.
Expire Old Sessions Upon New Login: A security feature that ensures that when a user opens a new session with the same account, old sessions belonging to that account are automatically terminated.
NOTIFY ACTIONS: Manages email notifications and other alerts in your app.
Name: The name given for the notification. For example, the title or type of notification shown to the user can be specified here.
Default Duration: By default, this determines how long notifications are displayed on the screen.
Success Duration: Specifies the length of time that notifications remain on the screen after successfully completed transactions. For example, if the user performed an action and it was successful, the notification will appear on the screen for this duration.
Info Duration: Duration of notifications shown for informational purposes. It is used to inform about developments in the system or important information.
Warning Duration: Determines how long warning messages will be displayed.
Error Duration: Specifies the duration of error messages.
MAIL / PROVIDER: Provides services for sending, receiving and managing e-mail.
PAYMENT METHOD: Includes payment methods (Stripe, Iyzico, Param).
Stripe: Payment processing platform that you can use to process online payment transactions.
Iyzico: A payment processing platform based in Turkey that makes it easy for you to manage online payments.
Param: Offers various payment methods for e-commerce sites, mobile apps and other digital platforms.
GOOGLE RECAPTCHA: Used to prevent activities such as spam and abuse.
Name: The name set for the ReCaptcha configuration.
Site Key: The public key that allows ReCaptcha to run in your application.
Secret Key: It is the private key used on the server side in ReCaptcha verification processes.
WHATSAPP BUSINESS: Contains WhatsApp API integration information.
WhatsApp Business API is a service that enables businesses to communicate more efficiently with their customers. The following configuration information is required to correctly integrate the API and manage messaging flows through WhatsApp. You can visit the Facebook for Developers platform to access the necessary information:
Then enter the following information in the WhatsApp Business field in the App Settings area:
Name: The name given to the WhatsApp Business account.
Account ID: The unique ID number that identifies your WhatsApp Business account. It must be the same for all WhatsApp configurations.
App ID: The unique ID of the app created through Facebook Business and used to access the API.
App Secret: A secret key used to secure your Facebook app.
Access Token: The verification key used to access the WhatsApp API. It can be purchased for a period of time or indefinitely. If it is received for a period of time, when it expires, messages cannot be sent through the application created with Kuika.
Phone Number ID: The unique identification number of the phone number linked to your WhatsApp Business account.
Version Number: The number indicating which version of the WhatsApp Business API is being used. It is important for compatibility with the current version.
Message Sending and Template Usage:
A message template is created on WhatsApp Dashboard and WhatsApp approval is obtained.
Template example:
Title: “About Offer Status”
Message: "Congratulations! Your process has been concluded positively. Please select one of the buttons below to indicate whether you accept or reject our offer."
Buttons: “Accept”, “Decline”
Approved templates are sent with the Send WhatsApp Business Message action on Kuika. For detailed information, you can review our related content.
Template Types: The parameters of the templates used for WhatsApp messages are selected when they are created on Facebook. These parameters come to Kuika automatically and can be set here and the message can be sent.
Buttoned Templates: Only available for steps with external assignment.
Templates without buttons: Can be used in every step of the process.
Kuika currently only supports Quick Reply buttons. Other button types are not available.
Quick Reply Usage:
Buttons used to advance the process must be of Quick Reply (custom) type.
Each button must be mapped to a mail interaction.
FILE UPLOAD PATH: Specifies the directory to be stored during the file upload process.
Name: This is the field where the name identifying the files to be uploaded should be entered.
File Upload Path: Specifies the directory where the uploaded files will be stored on the server. For example, a path like /upload/user_documents/ can be specified for uploaded documents.
C. Save & Cancel Field
CANCEL: Cancels the configuration settings.
SAVE: Saves configuration settings.
D. Description Field
Is the section where you can add annotations and notes on configuration settings.
Configure Your App through App Settings
The App Settings modal view differs for web and mobile applications. The App Settings modal has App Settings and Web tabs for your web apps, and App Settings, iOS, Android and Web tabs for your mobile apps.
Configure Your Web Apps
Create a configuration using the Configuration Manager module.
From the App Settings modal, click the Web tab.
Configure fields such as Host Settings, Sessions and Google Maps.
HOST SETTINGS: Determines how a service or app will run and interact with other devices.
SESSIONS: Allows you to set the session timeout period of the web app for the end users of your app.
GOOGLE MAPS: If a web application you have developed uses maps, you can create map settings and enter the necessary information for the map.
Save your settings by clicking the SAVE button.
Configure Your iOS Applications
Create a configuration using the Configuration Manager module.
From the App Settings modal, click the iOS tab.
Configure settings such as Mobile App Settings, Apple Sign In, App Store Settings.
MOBILE APP SETTINGS: This is the area where you will enter the application name, Bundle ID and application version information that you will use in the Apple App Store.
APPLE SIGN IN SETTINGS: You can sign in with your Apple accounts by making configuration settings in the applications you develop.
APP STORE SETTINGS: You can make App Store settings to connect the application you developed with AppMachine.
FIREBASE SETTINGS: You can integrate the services and features offered by the Firebase platform into your application.
GEOLOCATION: You can define the location information permission you will use in your app.
CAMERA: You can define the camera usage permission text to be shown to end users.
BLUETOOTH: You can define the Bluetooth permission text to be shown to end users.
PUSH NOTIFICATIONS: You can define the permission text to be shown to end users to send push notifications.
GPS TRACKER: You can set the GPS tracking function you use in your application.
Save your settings by clicking the SAVE button.
Configure your Android Apps
Create a configuration using the Configuration Manager module.
From the App Settings modal, click on the Android tab.
Configure settings such as Mobile App Settings, Play Store Settings, Maps, Geolocation.
MOBILE APP SETTINGS: This is the area where you will enter the application name, Bundle ID, application version information and minimum Android version that you will use in the Play Store.
PLAY STORE SETTINGS: You can configure the application you developed to connect it to the Play Store.
MAPS: If the Android application you developed uses maps, you can create map settings and enter the necessary information.
GEOLOCATION: You can define the location information permission you will use in your application.
CAMERA: You can define the camera usage permission text to be shown to end users.
BLUETOOTH: You can define the Bluetooth permission text to be shown to end users.
PUSH NOTIFICATIONS: You can define the permission text to be shown to end users to send push notifications.
GPS TRACKER: You can set the GPS tracking function you use in your application.
Save your settings by clicking the SAVE button.
With this training, you can configure, test and publish the configurations of your applications on the Kuika platform using the Configuration Manager module.