API is only available in EXPERT and ULTIMATE packages. (Legacy: PRO and Ultimate)
If you run Smartsupp on a multilingual website (or on several websites in different languages), you can set up the chat box to match each language version automatically using our API.
Below is a step-by-step guide that walks you through the setup. The whole process takes about 10 minutes per language.
Important: Setting up the API requires basic technical skills (editing your website’s HTML code). If you’re not comfortable with this, send this article to your developer.
Step 1 — Change the chat box language
Go to Settings → Chat box → Options and change the language to the one you want to add. Then click Save.
Example: Your website is in English and you also want a French chat box. Change the language from English to French and save.
Step 2 — Customize the chat box texts
While the language is set to the new one, go to Advanced settings → Customize chat box texts. Here you can edit all the texts that visitors will see in the chat box for this language. Make your changes and click Save.
Step 3 — Add the API language script to your website
Add the API script that tells Smartsupp which language to display on each page. Detailed documentation is available on our API page.
Example: Add the API call for the English chat box to the English version of your website, and the API call for the French chat box to the French version of your website.
Step 4 — Switch the default language back
Go back to Settings → Chat box → Options, select your original (primary) language and click Save.
Example: If your website was originally in English, change the language back to English and save the changes.
Note: You need to translate the chat box texts for each additional language yourself (Step 2). The API only switches between language versions — it does not translate automatically.
Need more than two languages?
Simply repeat Steps 1–3 for each additional language you want to add.
Dynamic language selection for multilingual websites
If you have one multilingual website (not separate domains), you can use the dynamic language selection endpoint to switch the chat box language automatically based on the page language:
This handles language selection only, not translation of custom texts. You still need to translate your chat box texts manually (see Step 2 above).

