The appConfig.js object

You can control the behavior and appearance of your self-hosted Flex UI instance by specifying configuration properties in a Javascript object housed within a file named appConfig.js.

This file must be made accessible on your Flex UI server at the location:

public/assets/appConfig.js

The Flex UI application attempts to load the appConfig.js file from your server at startup. Flex UI then fetches your account's current Configuration resource via the Flex Configuration REST API, and merges any properties found in the ui_attributes field with the properties defined in appConfig.js to determine the app's effective configuration. Values defined in your server's appConfig.js take precedence over corresponding values defined in ui_attributes via the REST API.

See the REST API configuration guide to learn more about the Flex Configuration REST API.

Configuration properties

To see a complete list of fields you can specify in the configuration object, check out the Flex UI reference docs for the major version of Flex UI that you are using:

• Flex UI 1.x
• Flex UI 2.x

Sample content

This is example content for a valid Flex UI 2.x appConfig.js file.

var appConfig = {
  serviceBaseUrl: "https://dancing-owl-1234.twil.io/",
  sso: {
    accountSid: "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  },
  sdkOptions: {
      chat: {},
      insights: {},
      voice: {},
      worker: {}
  },
  logLevel: "debug",
  theme: {
    isLight: false
  },
  componentProps: {
    CRMContainer: {
      uriCallback: (task) => task
        ? `https://www.bing.com/search?q=${task.attributes.name}`
        : "http://bing.com"
    }
  },
  router: {
    type: "memory",
    history: {
      initialEntries: [ "/agent-desktop" ]
    }
  }
};