You can customize phrases used in the Bitrix24 Website Widget.
Use JavaScript code to do that:
<script>window.addEventListener('onBitrixLiveChat', function(event) { var widget = event.detail.widget; widget.subscribe({ type: BX.LiveChatWidget.SubscriptionType.configLoaded, callback: function() { widget.addLocalize({VARIABLE: 'New Text'}); } }); });</script>
For example, you can customize these variable phrases:
BX_LIVECHAT_LOADING
– "Please wait"BX_LIVECHAT_ERROR_TITLE
– "Unfortunately we could not load live chat :("BX_LIVECHAT_ERROR_DESC
– "Please use some other communication tool or try again later."BX_LIVECHAT_VOTE_BUTTON
– "Rate our service"BX_MESSENGER_TEXTAREA_PLACEHOLDER
– "Enter message..."console.table(BXLiveChat.__privateMethods__.localize);
You can add new phrases to the code as a string or as an array:
<script>window.addEventListener('onBitrixLiveChat', function(event) { var widget = event.detail.widget; widget.subscribe({type: BX.LiveChatWidget.SubscriptionType.configLoaded, callback: function(){widget.addLocalize({BX_LIVECHAT_LOADING: 'Wait, Live Chat is loading'}); widget.addLocalize({BX_LIVECHAT_ERROR_TITLE: 'Oops, something went wrong'}); widget.addLocalize({BX_LIVECHAT_VOTE_BUTTON: 'Give us a score!', BX_LIVECHAT_OFFLINE: 'Sorry, our agents are sleeping', BX_LIVECHAT_ONLINE_LINE_1: 'Our team', BX_LIVECHAT_ONLINE_LINE_2: 'is ready to help you', BX_LIVECHAT_ERROR_DESC: 'Chat is down for repairs', BX_MESSENGER_TEXTAREA_PLACEHOLDER: 'Type your question', }) } }); });</script>
How to insert a code
In the Sites section, select a website. Then you need to add a new block.
Scroll down > click Other > HTML code.
Click Edit.
Paste the code > click Save > Publish.
Done! Phrases used in the website widget have been successfully customized!
You cannot customize the following phrases using JavaScript anymore:
BX_LIVECHAT_ONLINE_LINE_1
– "We are online"-
BX_LIVECHAT_ONLINE_LINE_2
– "and ready to help!" BX_LIVECHAT_OFFLINE
– "One of our representatives will get back to you shortly!"
You can customize these phrases in the Live Chat settings > custom messages section:
- Welcome text (upper).
- Welcome text (lower).
- Agent unavailable text.