This guide helps your team get more value from TurboHelp's Integrations tools. Use it to understand the feature, configure it correctly, and know what to check before relying on it in your daily support workflow.
At a Glance
Use integrations to connect TurboHelp with the services your team already depends on.
Create credentials with the minimum access required and store them securely.
Test each integration with a real support scenario before announcing it to customers.
In order for social login buttons to work properly, you will need to register for an application on their respective sites and enter the credentials you receive into admin area > settings > authentication page.
When entering your site callback URL on google, facebook and twitter sites, it is very important that URL you enter matches the one displayed in "Admin > Settings > general" page exactly, including protocol (https or http), www or no www and all slashes.
Register for regular facebook account, if you don't already have one.
Open this URL, click my apps in the top navigation bar, then Add a New App.
Enter any display name, your email address and click Create App ID
Click + Product in left sidebar, then Facebook Login, select Web, enter your site URL. You can ignore the rest of the panels on this page (quickstart).
Click Facebook Login > Settings and enter http://your-site-URL.com/secure/auth/social/facebook/callback into Valid OAuth redirect URIs field.
Click Status toggle in the navbar to make your application public.
Click Settings > Basic in left sidebar and copy/paste APP ID and APP SECRET into settings page.
Facebook login will only work with secure sites (https).
Register for regular google account, if you don't already have one.
Open this URL, create a new project, click Credentials in left sidebar, click Create Credentials select Oauth Client ID > Web Application.
Enter http://your-site-URL/secure/auth/social/google/callback into Authorized Redirect URIs field and click Create.
Click on Library in left sidebar, find Google+ API and enable it.
Copy/paste Client ID and Client Secret into settings page.
Register for regular twitter account, if you don't already have one.
Open this URL, click Create an App, enter anything into name and description fields, enter your site URL into Website field.
Open twitter project URL, click app settings icon, click set up next to user authentication settings.
Select "Read", "Request emails from users", "Web App, Automated App or Bot".
In "App info" > "Callback Uri" field enter https://your-site.com/secure/auth/social/twitter/callback and click save.
Click on Keys and Tokens and copy API Key and Secret from Consumer Keys section into your site settings page.
Best Practices
Rotate keys when a teammate leaves or an integration is rebuilt.
Keep a record of which external account owns each credential.
Disable integrations you no longer use to reduce security and maintenance overhead.