With the Freshdesk help widget, you can embed solution articles and a contact form within your website or product. When your customers need help, they can open the widget to search through solution articles or to submit a ticket. You can watch this video to learn how to set up the help widget or read more about setting up the help widget here.
To set up your help widget in multiple languages, you should first add more than one language to your Freshdesk account. Click here to learn about adding multiple languages to your Freshdesk account. Once you've added multiple languages, you need to provide translations for the contact form, labels, and solution articles.
The help widget doesn’t support right-to-left languages, such as Hebrew and Arabic
Translating the contact form in supported languages
If you use the widget with the simple form, we will translate the simple form for you. On the other hand, if you use the ticket fields that you've set up in Admin > Workflows > Ticket fields, you can use this guide to translate them.
Translating solution articles in supported languages
You can provide translations for your solution articles only after you create them in your primary language. Once you have a set of solution articles in your primary language, you can provide translations for all the languages that you've added under the Languages tab.
Browser-based detection
If the language of your browser matches one of the supported languages in your Freshdesk account, then the contact form and solutions will load in that language.
For example, if German is a supported language in your Freshdesk account, and the end user's browser language is also German, then the widget will load the contact form in German. If you've enabled solution articles, the German version of all solution articles will load as well.
Forcing the help widget to load in a certain language
You can also force the widget to load in a certain language. For example, if one of your users is accessing your product in German, you can ask the widget to be loaded in German by passing their preference to the widget.
The widget can be forced to load in a certain language by setting the 'locale' property in the widget's embed code. The locale property overrides the end user's browser language. Here's a sample piece of code, using which you can load the widget in German:
To learn more about how you can use the locale property to have the widget load in a certain language, please read the API documentation.
Translating labels in supported languages
In Admin > Channels > Widgets, you can set the following labels in your primary language:
- Widget launcher text
- Widget banner message
- Contact form title
- Contact form submit button
- Contact form confirmation message
- Frustration tracking banner message
- Frustration tracking description
- Frustration tracking confirmation
To provide translations for these labels in any of your supported languages, you can use the setLabels API.
Let's say you support customers in German and French (in addition to English being the primary language in your account). To provide translations for the 'Contact form title' in French and Spanish, this is what you need to embed, along with the widget code:
FreshworksWidget("setLabels", {
'fr': {
contact_form: {
title:"Contactez nous"
}
},
'es': {
contact_form: {
title:"Contáctenos"
}
}
});
You can read the setLabels API documentation for more details.