This article provides an overview of how to use a configuration file to set up and customize the Corti application for your organization. The configuration file allows administrators to set parameters and initial settings for all designated workstations, including API options, window preferences, login behavior, and integration-specific settings.
Why Use a Configuration File?
A configuration file simplifies the process of preconfiguring Corti settings across multiple devices, ensuring consistency and efficiency. The file can be customized to fit your organization’s needs and includes the following capabilities:
Configure API endpoints and server settings.
Customize window behavior (e.g., size, location, resizability).
Adjust login settings for user convenience and security.
Enable integration-specific features.
Configuration File Specification
Below is a sample configuration file specification. Use this as a reference for creating your organization's customized configuration.
Full Specification
{
"apiHost": "https://api.YOUR-ENVIRONMENT-NAME.motocorti.io", // Specify API host "callSubscriber:configFileLocation": "C:/ProgramData/Corti/extension.json", "windowOptions:movable": true, "windowOptions:resizable": true, "windowOptions:defaultX": 120, "windowOptions:defaultY": 30, "login:enableRememberMe": true // Allow Corti to remember logged-in users
}File Location and Naming
The configuration file can be placed in one of the following locations:
AppData Roaming Directory (default):
C:/Users/{user}/AppData/Roaming/CortiCorti Installation Directory:
Examples:C:/Users/{user}/AppData/Local/Programs/CortiC:/Program Files/Corti
Configuration File Details
API Options
apiHost: The API endpoint for server communication. (Default:
'beta'or on-premise-specific URL.)
Login Options
enableRememberMe:
A boolean property (trueorfalse) to enable or disable the "Keep me logged in" feature.If set to
true, Corti remembers the last user logged in and keeps them logged in unless they log out explicitly or their system session ends.Example:
login:enableRememberMe": true
If set to
false, users are logged out upon exiting the application.
preferredAuthProvider: Specifies the preferred authentication method:
'native'or'ad'.
Window Options
Corti offers configurable options for different window types:
Primary Window (
windowOptions)
Controls the main application window.Child Windows (
childWindowOptions)
For pop-up windows (e.g., document viewers).Alert Widget Windows (
alertWidgetWindowOptions)
For displaying AI alerts.
Common Settings:
defaultX/Y: Set the default position of the window on the screen.
defaultWidth/Height: Specify the default size of the window in pixels.
defaultZoomLevel: Adjust the zoom level. Example: A value of
-1reduces size by 20%.alwaysOnTop: If
true, keeps the window on top of other applications.resizable: Allows users to resize the window if set to
true.movable: Enables moving the window if set to
true.
CallSubscriber Config
For setups where phone extensions are tied to workstations rather than individual users, use a secondary configuration file.
Steps:
Store the file in a shared system directory, such as:
C:/ProgramData/Corti/extension.jsonReference this file in the main configuration:
"callSubscriber:configFileLocation": "C:/ProgramData/Corti/extension.json"
Example content of { "phoneExtension": "2101" }
{
"webappUrl": "https://YOUR-ENVIRONMENT-NAME.corti.app", "apiHost": "https://api.YOUR-ENVIRONMENT-NAME.motocorti.io", "callSubscriber:configFileLocation": "C:/ProgramData/Corti/extension.json", "windowOptions:movable": false, "windowOptions:resizable": false, "windowOptions:defaultX": 100, "windowOptions:defaultY": 50, "windowOptions:defaultZoomLevel": 0, "login:enableRememberMe": false, "childWindowOptions:defaultWidth": 800, "childWindowOptions:defaultHeight": 600
}
Each workstation should have a unique extension.json file corresponding to its specific phone extension.
Example Configuration
Here’s a full example configuration file combining the key settings:
jsonCopy code{ "webappUrl": "https://{{environment_id}}.corti.app", "apiHost": "http://localhost:5173", "callSubscriber:configFileLocation": "C:/ProgramData/Corti/extension.json", "windowOptions:movable": false, "windowOptions:resizable": false, "windowOptions:defaultX": 100, "windowOptions:defaultY": 50, "windowOptions:defaultZoomLevel": 0, "login:enableRememberMe": false, "childWindowOptions:defaultWidth": 800, "childWindowOptions:defaultHeight": 600 }Need Help?
If you have questions or require assistance with configuring Corti for your organization, please contact support through the chatbot.