Anatomy of App Settings Module

To preview and publish an app developed in Kuika, you need an App Settings configuration.

1. Namespace

  • You can change the name you gave your configuration and save it.

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

  • WORKFLOW: Contains Workflow Engine connection settings.
    • 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:

      WhatsApp Business Account and App Information:

  • Create a WhatsApp Business account.
  • Create an application (App) through Facebook Business.
  • 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.

3. Save & Cancel Field

  • CANCEL: Cancels the configuration settings.
  • SAVE: Saves configuration settings.