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?: string
language code, not used
logLevel?: "silent" | "error" | "warning" | "info" | "debug" | "trace"
level for logger
theme?: ThemeConfigProps
theme 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?: SDKOptions
SDK 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?: SSOConfiguration
SSO 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?: PluginService
PluginService configuration
enabled?: boolean
- Whether the plugin service is enabled or not
componentProps?: object
Props to be set for React components. Key of the object is component name. e.g. { AgentDesktopView: { showPanel2: false } }
router?: object
Router 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?: boolean
whether to disable Twilio Voice SDK instantiation
initialDeviceCheck?: boolean
Whether to conduct an initial audio device check
rejectPendingReservations?: boolean
whether to reject all pending reservations if user goes to an offline activity
insights?: object
insights configuration object
enableClientCalling?: boolean
Whether to enable client calling
fileAttachment?: FileAttachmentConfig
File 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?: string
url for audio file to play when call is on hold
holdMusicMethod?: string
holdMusicMethod
locations?: Array.<LocationConfig>
array of LocationConfig objects
name: string
- region nameedge: Array.<string> | string
- array of edge names or edge name
disableTelemetry?: boolean
whether to disable telemetry
enableReduxLogging?: boolean
whether to enable redux logging
markdown?: object
markdown configuration
notifications?: object
Notification configuration
outboundSettings?: OutboundConfig
Outbound 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