šĀ NOTE: This article pertains to integrating your Higher Logic Vanilla (Vanilla) community with your Zendesk help center.
āļø TIP: For information on Vanilla's Zendesk Guide Search Connector, see:
Integration highlights
If you're using a Zendesk help center, you can integrate it with Vanilla in order to:
- Link your Zendesk account to your Vanilla user profile.
- Submit usersā discussions and comments as tickets to your Zendesk help center's ticketing system.
šĀ NOTE: You must have a Zendesk account to use this integration. If you donāt have a Zendesk account, visitĀ Zendesk.
Set up the integration
You have to enable API Access in your Zendesk account for this plugin to work.
- Login to your Zendesk site.
- Go to the Admin Setting.
- Under Channels, select API.
- Select the OAuth Clients.
- Add a client.
- Complete the form.
- Copy the Unique Identifier and Secret and enter it below.
- Set the Redirect URLs by appendingĀ
/profile/zendeskconnect
Ā and /plugin/zendesk/connect
Ā to your forumās URL, as shown below.
Redirect URL examples
If your forum URL is:
- https://forum.example.com/
...your Redirect URLs will be:
- https://forum.example.com/profile/zendeskconnect
- https://forum.example.com/plugin/zendesk/connect
If your forum URL is:
- https://forum.example.com/en/
...your Redirect URLs will be:
- https://forum.example.com/en/profile/zendeskconnect
- https://forum.example.com/en/plugin/zendesk/connect
Link your Vanilla & Zendesk accounts
- Log in to your Vanilla profile page.
- Edit your profile.
- Click the Connections option to access the Connections page (/profile/connections).
- Click the Connect button for Zendesk.
- Follow the instructions to link your Vanilla and Zendesk accounts.
Troubleshooting
Issue: When I try to link my account I get the error:
Invalid Authorization Request. bad_request
Check: Make sure that the URL you are on when you are in theĀ SocialĀ section of your profile matches the Redirect URLs that you set in the configuration.
āļø EXAMPLE: When you are in your profile's SocialĀ section, if the URL is
https://forum.example.com/somedirectory/profile/connections
...then, in your configuration, you should have
https://forum.example.com/somedirectory/
profile/zendeskconnect
...and
https://forum.example.com/somedirectory/
plugin/zendesk/connect
Addon settings
If the URLs above are correct but the issue persists, check the URL in the Your Zendesk URL field of the Zendesk addon settings page (in Settings > Addons > Addons > Zendesk).
- Make sure that the URL uses the https (secure) protocol.
šĀ NOTE: If the protocol is (the less secure) http, Zendesk will reject the connection request.