This article details how to install the Swifteq Translate Conversations app from the Zendesk Marketplace page.
In this Article
Installing your Free 7-day Trial or your Free Version of the App
Setting the Title and Access Restrictions
Entering your Swifteq API Key
Swifteq API Key if you do not already have a Swifteq Account
Swifteq API Key if you already have a Swifteq Account
Adding the Swifteq API Key to the Translate Conversations App Configuration in Zendesk
Completing the Installation
Changing the Settings or Uninstalling
Installing your Free 7-day Trial or your Free Version of the App
You can install a free 7-day Trial of the app which gives you unlimited translations. Or, you can install a Free version of the Translate Conversations app which allows you to translate up to 100 translations per month.
- Go to the relevant page for the app in the Zendesk Marketplace page.
You can search for the app or click the following link to take you directly to the page:
https://www.zendesk.com/marketplace/apps/support/989146/translate-conversations/
- Click Select Plan.
-
Select to Installing a Free 7-day Trial or the Free Version
Either, click the Free trial button to install a free 7-day trial of the app in your Zendesk account.
Or, click the Install button to install the app for free but with a limit of up to 100 translations per month in your Zendesk account.
- Select the Zendesk Account to install the app for and click Install.
- If not already signed in to Zendesk, you are prompted to sign in with your Zendesk login.
Note: This is your Zendesk login. A Swifteq account is different from a Zendesk account. Once you have installed the app in the Zendesk account, you will then need to create a Swifteq account from the app and connect it to your Zendesk.
The settings for the Installation of the app display automatically in your Zendesk > Admin Center > Apps and Integrations > Apps for Zendesk Support Apps.
If you have selected to install the Free 7-Day Trial, you are prompted for your billing details.
Enter your details and click Proceed to payment and enter your credit card details.
If you are installing the free version, limited to 100 translations per month, you are not prompted to enter any credit card details and the following displays.
Setting the Title and Access Restrictions
- The Title defaults to the name of the app and you can change this if required.
- You can Enable Role Restrictions. When Role Restrictions are enabled, only users that have the selected Role(s) in Zendesk have access to the app.
Checkmark Enable role restrictions and the drop-down list displays all the Roles you have set up in your Zendesk Account. Select any Role(s) that you want to have access to the app.
The selected Role(s) display.
- You can Enable group restrictions. When Group Restrictions are enabled, only users in the selected Groups in Zendesk have access to the app.
Checkmark Enable group restrictions and the drop-down list displays all the Groups you have set up in your Zendesk Account. Select any Group(s) that you want to have access to the app.
Entering your Swifteq API Key
You need to enter your Swifteq API Key.
Swifteq API Key if you do not already have a Swifteq Account
Click the following link to create a new account
agenthelper.swifteq.com/auth/translate
Enter your details and click Sign up.
Swifteq API Key if you already have a Swifteq Account
If you already have a Swifteq account you need to copy the Swifteq API Key.
- Login to your account.
- From the Switch between Swifteq Zendesk Apps button in the top right menu, select the Translate Conversations app.
The following screen displays.
- From the Configure the app using this API Key, click the Copy to Clipboard icon.
Adding the Swifteq API Key to the Translate Conversations App Configuration in Zendesk
Paste your Swifteq API Key into the Zendesk configuration.
Completing the Installation
To complete the installation, click Install.
The My Apps page displays and Translate Conversations shows in the Currently Installed apps.
Once Translate Conversations is installed, the app is enabled and displays in the Ticket Sidebar in an opened ticket. Refer to Using Translate Conversations.
Changing the Settings or Uninstalling
After installing, you can change the installation settings for the Title, Enable Role Restrictions or Enable Group Restrictions at any time. You do this by opening the app from your Zendesk Admin Center.
If you need to uninstall the app, you do this from the Zendesk Admin Center My Apps.