Update Webchat configuration

You can update your Webchat’s configuration dynamically using JavaScript. This is useful if you want to update Webchat’s style or settings after it’s already loaded on your website.

You will need:

A website with an embedded bot
Familiarity with JavaScript

Update configuration

To update Webchat’s configuration, you can call the window.botpress.config method after Webchat has been initialized:

window.botpress.config({
  configuration: {},
})

Include any configuration object you’d like to apply the new configuration.

You don’t need to provide the entire configuration object every time—just the values that you want to update. Any fields you don’t include will default to the most recent configuration.

Switch to dark theme

Here’s an example that updates Webchat’s theme to dark mode as soon as Webchat loads:

const webchatConfig = {
  themeMode: 'dark',
}

window.botpress.on('webchat:initialized', () => {
  window.botpress.config({ configuration: webchatConfig })
})

The above snippet:

Waits until Webchat is initialized
Updates the themeMode configuration to dark