Configuration
Flex UI's configuration allows you to control the way the overall app loads, as well as the behavior of individual Flex Components. In the configuration object, you can define the default properties of your Flex Components. You can also configure properties that are not tied to specific Components.
Properties:
language?: stringlanguage code, not used
logLevel?: "silent" | "error" | "warning" | "info" | "debug" | "trace"level for logger
theme?: ThemeConfigPropstheme configuration
isLight?: boolean- Represents whether light or dark theme should be usedtokens?: DeepPartial.<Tokens>- Paste tokens. For more on each token information, please refer to Twilio PastecomponentThemeOverrides?: Theme- Object containing styles of the component which is to be overridden. See Theme Interface
sdkOptions?: SDKOptionsSDK options
worker?: WorkerOptions- options to pass to TaskRouter Worker SDK. See {@link https://twilio.github.io/twilio-taskrouter.js/Worker.html#Worker__anchor}chat?: ConversationsOptions- options to pass to Chat SDK. See {@link https://media.twiliocdn.com/sdk/js/chat/releases/3.4.0/docs/Client.html#.create__anchor}voice?: object- options to pass to Voice SDK. See {@link https://www.twilio.com/docs/voice/client/javascript/device#constructor}insights?: object- options to pass to Sync SDK. See {@link https://media.twiliocdn.com/sdk/js/sync/releases/0.11.1/docs/Client.html#Client__anchor}flex?: DeepPartial.<ClientOptions>- to pass to Flex SDK.
sso?: SSOConfigurationSSO configuration
accountSid?: string- account SIDidpUrl?: string- idpUrlloginPopup?: boolean- whether to launch IdP login in a new windowloginPopupFeatures?: string- standard window.open() features param to be applied to popup windowproducts?: Array.<string>- array of productsredirectUrl?: string- redirect url where to return back from identity provider to log in to FlextokenRefreshThresholdMs?: number- token refresh threshold in ms
pluginService?: PluginServicePluginService configuration
enabled?: boolean- Whether the plugin service is enabled or not
componentProps?: objectProps to be set for React components. Key of the object is component name. e.g. { AgentDesktopView: { showPanel2: false } }
router?: objectRouter configuration
type?: "browser" | "memory"- type of the routerhistory?: object- history object to use for routingisolate?: boolean- whether to isolate Flex routing from other routing. Makes Flex to use memory router.
disableBrowserVoice?: booleanwhether to disable Twilio Voice SDK instantiation
initialDeviceCheck?: booleanWhether to conduct an initial audio device check
rejectPendingReservations?: booleanwhether to reject all pending reservations if user goes to an offline activity
insights?: objectinsights configuration object
enableClientCalling?: booleanWhether to enable client calling
fileAttachment?: FileAttachmentConfigFile attachment configuration
enabled?: boolean- Represents if file attachments are supported.numberOfAttachments?: number- Maximum number of file attachments supported per message.maxFileSize?: number- Maximum file size that can be uploaded. Enter a value in bytes. Default is 10mbmaxFileSizeTotal?: number- Maximum total file attachments size that can be uploaded per message. Enter a value in bytes.acceptedExtensions?: Array.<string>- Allowed file extensions to be uploaded.readOnly?: boolean- Represents if file attachment is read only
holdMusicUrl?: stringurl for audio file to play when call is on hold
holdMusicMethod?: stringholdMusicMethod
locations?: Array.<LocationConfig>array of LocationConfig objects
name: string- region nameedge: Array.<string> | string- array of edge names or edge name
disableTelemetry?: booleanwhether to disable telemetry
enableReduxLogging?: booleanwhether to enable redux logging
markdown?: objectmarkdown configuration
notifications?: objectNotification configuration
outboundSettings?: OutboundConfigOutbound configuration
email: object- Configuration object for outbound emaildefaultAddress.address_metadata.from_name: string- The sender namedefaultAddress.coordinates.address: string- The senders email addressdefaultSettings.workflow_sid: string- Sid of the workflow to use for task assignmentdefaultAddress.queue_sid: string- Sid of the queue to use for task assignment
channelConfig?: Array.<ChannelConfig>array of channel configurations
addressType: string- Channel typecbmAttachments: object- Configuration object for cbm attachment settingsenabled: boolean- Whether attachments are enablednumberOfAttachments: number- Maximum number of attachments allowedmaxFileSize: number- Maximum allowed file size in bytesmaxTotalFileSize: number- Limit in bytes for the cumulative size of all attachmentsacceptedExtensions: Array.<string>- Array of allowed file extensions