Zendesk Integration Guide - Vanilla Success
<main> <article class="userContent"> <p>šĀ <strong>NOTE</strong>: This article pertains to integrating your <strong>Higher Logic Vanilla</strong> (<strong>Vanilla</strong>) community with your <em>Zendesk help center</em>.</p><p>āļø <strong>TIP</strong>: For information on Vanilla's <em>Zendesk Guide</em> <strong>Search Connector</strong>, see:</p><div class="js-embed embedResponsive" data-embedjson="{"body":"Federated Search is an addon that enhances your Higher Logic Vanilla (Vanilla) community search by automatically including content from external platforms, such as Zendesk Guide. This broader search provides a real benefit to your users: they get more results, from multiple sources, returned to them in a central locationā¦","photoUrl":"https:\/\/us.v-cdn.net\/6030677\/uploads\/VWGAXAF5OFCO\/microsoftteams-image.png","url":"https:\/\/success.vanillaforums.com\/kb\/articles\/523","embedType":"link","name":"Federated Search - Vanilla Success"}"> <a href="https://success.vanillaforums.com/kb/articles/523" rel="nofollow noreferrer ugc"> https://success.vanillaforums.com/kb/articles/523 </a> </div><h2 data-id="integration-highlights">Integration Highlights</h2><p>If you're using a Zendesk help center, you can integrate it with Vanilla in order to:</p><ul><li>Link your Zendesk account to your Vanilla user profile.</li><li>Submit usersā discussions and comments as tickets to your Zendesk help center's ticketing system.</li></ul><p>šĀ <strong>NOTE</strong>: You must have a Zendesk account to use this integration. If you donāt have a Zendesk account, visitĀ <a href="http://www.zendesk.com/" rel="nofollow noreferrer ugc">Zendesk</a>.</p><h2 data-id="set-up-the-integration">Set Up the Integration</h2><p>You have to enable API Access in your Zendesk account for this plugin to work.</p><ol><li>Login to your Zendesk site.</li><li>Go to the Admin Setting.</li><li>Under Channels, select API.</li><li>Select the OAuth Clients.</li><li>Add a client.</li><li>Complete the form.</li><li>Copy the Unique Identifier and Secret and enter it below.</li><li>Set the Redirect URLs by appendingĀ <code class="code codeInline" spellcheck="false" tabindex="0">/profile/zendeskconnect</code>Ā and <code class="code codeInline" spellcheck="false" tabindex="0">/plugin/zendesk/connect</code>Ā to your forumās URL, as shown below.</li></ol><h3 data-id="redirect-url-examples">Redirect URL examples</h3><p>If your forum URL is:</p><ul><li>https://forum.example.com/</li></ul><p>...your Redirect URLs will be:</p><ul><li>https://forum.example.com/<strong>profile/zendeskconnect</strong></li><li>https://forum.example.com/<strong>plugin/zendesk/connect</strong></li></ul><p>If your forum URL is:</p><ul><li>https://forum.example.com/en/</li></ul><p>...your Redirect URLs will be:</p><ul><li>https://forum.example.com/en/<strong>profile/zendeskconnect</strong></li><li>https://forum.example.com/en/<strong>plugin/zendesk/connect</strong></li></ul><h2 data-id="link-your-vanilla-zendesk-accounts">Link your Vanilla & Zendesk Accounts</h2><ol><li>Log in to your Vanilla profile page.</li><li>Edit your profile.</li><li>Click the <strong>Connections</strong> option to access the Connections page (<strong>/profile/connections</strong>).</li><li>Click the <strong>Connect</strong> button for Zendesk.</li><li>Follow the instructions to link your Vanilla and Zendesk accounts.</li></ol><h2 data-id="troubleshooting">Troubleshooting</h2><p><strong>I get an error sayingĀ </strong><strong><code class="code codeInline" spellcheck="false" tabindex="0">Invalid Authorization Request. bad_request</code></strong><strong>Ā when I try to link my account.</strong></p><p>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.</p><p>āļø <strong>EXAMPLE</strong>: If the URL when you are on in your profileās social section isĀ <a href="https://forum.example.com/somedirectory/profile/connections" rel="nofollow noreferrer ugc"><code class="code codeInline" spellcheck="false" tabindex="0">https://forum.example.com/somedirectory/profile/connections</code></a>, you should haveĀ <a href="https://forum.example.com/somedirectory/profile/zendeskconnect" rel="nofollow noreferrer ugc"><code class="code codeInline" spellcheck="false" tabindex="0">https://forum.example.com/somedirectory/profile/zendeskconnect</code></a>Ā andĀ <a href="https://forum.example.com/somedirectory/plugin/zendesk/connect" rel="nofollow noreferrer ugc"><code class="code codeInline" spellcheck="false" tabindex="0">https://forum.example.com/somedirectory/plugin/zendesk/connect</code></a>Ā in your configuration.</p> </article> </main>