Override configuration
By default, in the initialization of Webchat widget, only the integrationId
option is required. However, you can provide more options to override the default behavior of your web chat instance.
<script src="https://cdn.jsdelivr.net/npm/@moveo-ai/web-client@latest/dist/web-client.min.js"></script>
<script>
MoveoAI.init({
integrationId: 'YOUR_INTEGRATION_ID',
//You can insert the additional options here. Example :
welcome_message: 'Hello , how can i help you',
welcome_trigger_message: 'hello',
chatWindow: {
width: '380px',
height: '650px',
},
launcher: {
size: '60px',
show: true,
},
language: 'en',
bubble_image:
'https://media.dev.moveo.ai/media/accounts/b650cbbc-2f62-4ac7-a8fd-1e73fd09eba9/706ed26e-43ad-4f09-9787-e3029f30cfba.png',
// You can find all the available options listed below.
})
.then((instance) => {
console.log('connected');
})
.catch((error) => console.error(error));
</script>
Instances
Method | Description |
---|---|
welcome_message | Overrides the teaser message next to the minimized webchat. |
welcome_trigger_message | Overrides the auto-send message when the user opens the launcher. |
chatWindow | Changes the width and height of the opened chat. |
background_color | Overrides the default color of webchat. |
accent_color | Overrides the typography color. |
launcher |
|
bubble_image | Override custom image of launcher. |
avatar | Overrides the assistant avatar. |
header_title | Overrides the title on the chat header. |
language | Overrides the system language. Read more about the system language here. |
focus_trap | Prevents user browsing while the conversation is open. |
auto_open | The widget opens automatically without waiting for the user to click on it. |
virtual_agent_name | Name your VA so that the message "YOUR_NAME" joined the conversation instead of Virtual Assistant joined the conversation appears |
webchat_aria_label | Aria label text for the webchat button for screen readers |
Webchat default system language
The language of the webchat determines the language of the messages displayed, as highlighted in the image below. The language is selected in order of priority (highest first) as follows:
- If the language field from the visitor information form is selected, the system language updates depending on the user's choice.
- Next, if no language is chosen, the default language specified in the webchat integration configuration is used.
- When neither of the above is available, the language of the user's browser is used.
This ensures that the messages displayed are tailored to the user's preferred language, and provides a seamless experience across different devices and settings.
You can use the language override above to ensure that everyone sees the same language regardless of their browser settings. See the available languages here.