# Multilanguage chat box
Choose a language to fit your business.
⛔ Legacy API
You are browsing legacy API. Current version you can find here.
# Chat box language
In this case we setup English using code en
in our script.
<script>
smartsupp('language','en');
</script>
Supported language codes:
ar
= Arabic (U.A.E.)az
= Azeri (Latin) (Azerbaijan)bg
= Bulgarian (Bulgaria)br
= Portuguese (Brazil)ca
= Catalan (Spain)cn
= Chinese Simplified (China)cs
= Czech (Czech Republic)da
= Danish (Denmark)de
= German (Germany)el
= Greek (Greece)en
= English (United States)es
= Spanish (Spain)fa
= Persian = Farsi (Iran)fi
= Finnish (Finland)fr
= French (France)he
= Hebrew (Israel)hi
= Hindi (India)hr
= Croatian (Croatia)hu
= Hungarian (Hungary)is
= Icelandic (Iceland)it
= Italian (Italy)ja
= Japanese (Japan)ka
= Georgian (Georgia)lt
= Lithuanian (Lithuania)lv
= Latvian (Latvia)mk
= Macedonian (FYROM)nl
= Dutch (Netherlands)no
= Norwegian (Norway)pl
= Polish (Poland)pt
= Portuguese (Portugal)ro
= Romanian (Romania)ru
= Russian (Russia)sk
= Slovak (Slovakia)sl
= Slovenian (Slovenia)sr
= Serbian (Latin) (Bosnia and Herzegovina)sv
= Swedish (Sweden)th
= Thai (Thailand)tr
= Turkish (Turkey)tw
= Chinese Traditional (Taiwan)uk
= Ukrainian (Ukraine)
# Modify multiple languages
If you have multilanguage website you can modify more languages in the same .js
file. Expand code below using conditions
and check your site URL for language code. Based on language you can choose translations you need. In this example you would look for /de/
or /cs/
or /en/
in your URL.
http://example.com/de/
http://example.com/cs/
http://example.com/en/
<script>
if (window.location.href.indexOf("http://example.com/de/") > -1) { //choose URL
smartsupp('language', 'de'); //set DE language
} else if (window.location.href.indexOf("http://example.com/cs/") > -1) { //choose URL
smartsupp('language', 'cs'); // set CS language
} else {
smartsupp('language', 'en'); // set EN language
}
</script>
# Custom Privacy notice
In Dashboard Settings > Chat box > Options (opens new window) you can select Show notice about personal data processing (visible when offline). In case you do not want default text you can change it.
<script>
smartsupp('translate', {
privacyNotice: {
title: 'Your Privacy notice title',
text: 'Custom text'
}
});
</script>
# Create new texts
Maybe your language is not on of those we provide. Maybe you do not need everything translated and need just some parts. You can create your own texts and define language code for your own language. Any other words will be added from our default English texts.
<script>
smartsupp('translate', {
widget: {
online: 'Text for language XY.'
}
}, 'xy'); // set your own langauge code
// define the language code
smartsupp('language','xy');
</script>
# Custom texts
If you want to modify existing texts you can write your own texts in any language. All you need to do is to define the language at the end of the script. In this example we change default text Online => We are online.
<script>
smartsupp('translate', {
widget: {
online: 'We are online'
}
}, 'en');
</script>
# All customizable texts
Below are all texts currently available for customization of your chat box.
You can customize:
- online window
- offline window
- pre-chat form
- chat banners
- chat box
- mobile widget
<script>
smartsupp('translate', {
online: { // online window
title: 'Support',
infoTitle: 'Live chat',
infoDesc: 'Ask us anything',
maximize: 'Maximize',
minimize: 'Minimize',
hideTitle: 'Hide chat',
closeTitle: 'Close chat',
settingsTitle: 'Settings',
disableSounds: 'Disable sounds',
enableSounds: 'Enable sounds',
visitor: 'Me',
send: 'Send',
textareaPlaceholder: 'Write here, press to send',
typingMsg: '{name} is typing...',
transcriptSendingTitle: 'Sending email...',
transcriptSendingDesc: '',
transcriptSendedTitle: 'Email was successfully sent',
transcriptSendedDesc: ''
},
offline: { // offline window
title: 'Send us a message',
notice: 'We are not available now but leave us a message. We will respond as soon.',
hideTitle: 'Hide chat',
required: '',
name: 'Name',
email: 'Email',
number: 'Phone',
message: 'Your message',
submit: 'Send message',
messageRequiredAlert: 'You have not entered a message.',
emailRequiredAlert: 'You have not entered an email address.',
emailInvalidAlert: 'Invalid email address',
sendInfo: 'Sending email...',
successTitle: 'Thank you for your message',
successDesc: 'Your message was sent successfully. We will contact you soon.',
failureTitle: 'Error',
failureDesc: 'We are sorry but your message wasn\'t sent.'
},
login: { // pre-chat form
title: 'Chat login',
notice: '',
messageLabel: 'Your question',
submit: 'Start chat'
},
banner: { // chat banners
bubble: {
text: 'We are ready for your questions!'
},
arrow: {
title: 'Any questions?',
desc: 'We are ready to answer.'
}
},
widget: { // chat box
online: 'Ask us anything',
away: 'Ask us anything',
offline: 'Leave us a message',
},
button : { // mobile widget
title: 'Chat'
},
dialogClose: {
title: 'Would you like to end the conversation?',
yes: 'Yes',
no: 'No',
send: 'Yes, and send chat to email'
},
dialogSend: {
title: 'Send conversation to email',
email: 'Email',
yes: 'Send',
no: 'Cancel'
},
dialogRating: {
title: 'How would you rate the chat?',
cancel: 'I don\'t want to rate',
submit: 'Send',
commentTitle: 'Your comment'
}
}, 'en');
</script>