Configuration
Description
WebChat and WebChatService share the configuration namespace '_genesys.widgets.webchat'. WebChat has UI options while WebChatService has connection options.
Example
window._genesys.widgets.webchat = {
apikey: 'n3eNkgLLgLKXREBMYjGm6lygOHHOK8VA',
dataURL: 'https://api.genesyscloud.com/gms-chat/2/chat',
userData: {},
emojis: true,
uploadsEnabled:false,
actionsMenu: true,
timeFormat:12,
autoInvite: {
enabled: false,
timeToInviteSeconds: 10,
inviteTimeoutSeconds: 30
},
chatButton: {
enabled: true,
template: '<div>CHAT NOW</div>',
effect: 'fade',
openDelay: 1000,
effectDuration: 300,
hideDuringInvite: true
}
};
Options
| Name | Type | Description | Default | Required |
|---|---|---|---|---|
| emojis | boolean | Enable/disable Emoji menu inside chat message input | true | |
| uploadsEnabled | boolean | Show/Hide the Send File button. The button will be shown if the value is set to true. For more information on how file transfer works, please see our article on File Transfer in Chat Solutions. |
false | |
| timeFormat | number/string | This sets the time format for the timestamps in this widget. It can be 12 or 24 | 12 | |
| actionsMenu | boolean | Enable/disable actions menu next to chat message input | true | |
| autoInvite.enabled | boolean | Enable/disable auto-invite feature. Automatically invites user to chat after user idles on page for preset time | false | |
| autoInvite.timeToInviteSeconds | number | Number of seconds of idle time before inviting customer to chat. | 5 | |
| autoInvite.inviteTimeoutSeconds | number | Number of seconds to wait, after showing invite, before closing chat invite. | 30 | |
| chatButton.enabled | boolean | Enable/disable chat button on screen. | false | |
| chatButton.template | string | Custom HTML string template for chat button. | <div class='cx-widget cx-webchat-chat-button' data-message='ChatButton' data-gcb-service-node='true'><span class='i18n' data-message='ChatButton'></span></div> |
|
| chatButton.effect | string | Type of animation effect when revealing chat button. 'slide' or 'fade'. | fade | |
| chatButton.openDelay | number | Number of milliseconds before displaying chat button on screen. | 1000 | |
| chatButton.effectDuration | number | Length of animation effect in milliseconds | 300 | |
| chatButton.hideDuringInvite | boolean | When auto-invite feature is activated, hide the chat button. When invite is dismissed, reveal the chat button again. | true |
Comments or questions about this documentation? Contact us for support!
