Install and configure Algolia for Zendesk

​

Set up the Zendesk connector

1. Go to the Algolia dashboard and select your Algolia .
2. On the left sidebar, select Data sources.
3. On the Connectors page, find Zendesk Knowledge Base and click Connect.
4. Click Create a new source.
5. If you’ve already allowed Algolia to access your Zendesk account, select your existing authentication from the OAuth 2.0 list. Otherwise, connect your Zendesk account:
   1. Enter your Zendesk subdomain and click Connect to Zendesk.
   2. In Zendesk, allow Algolia to access your Zendesk Help Center.
   3. When Zendesk redirects you to the Algolia dashboard, select Create a new OAuth 2.0 authentication.
   4. In Zendesk authentication URL, enter the URL for your Zendesk subdomain.
   5. Optional: enter a name for the authentication.
   6. Click Create authentication.
   7. Refresh the connector setup page, then select the new authentication from the list.
6. Enter the following values:
   • Account name: your Zendesk subdomain. For example, if your Zendesk URL is https://my-zendesk-app.zendesk.com, your account name is my-zendesk-app.
   • Content to index: choose the Zendesk content type you want to index: articles or posts. The Zendesk connector supports both content types, but each source indexes one content type. To index both, create one source for articles and another for posts.
   • Max Content Size: the connector truncates the content to the specified size. The default value is 5,000 characters. Increase it only if you need to index longer content.
7. Click Create source.

​

Configure the Algolia index

1. Select the Algolia to use as the destination for your Zendesk content.
2. Create an indexing task and set how often to synchronize your Zendesk content.
3. Click Run task to start the first synchronization.

​

Update your Zendesk help center theme

<link
  rel="stylesheet"
  type="text/css"
  href="https://cdn.jsdelivr.net/npm/algoliasearch.zendesk-hc@3.0.0/dist/algoliasearch.zendesk-hc.min.css"
/>
<script
  type="text/javascript"
  src="https://cdn.jsdelivr.net/npm/algoliasearch.zendesk-hc@3.0.0/dist/algoliasearch.zendesk-hc.min.js"
></script>
<script type="text/javascript">
  algoliasearchZendeskHC({
    applicationId: "ALGOLIA_APPLICATION_ID",
    apiKey: "ALGOLIA_SEARCH_API_KEY",
    subdomain: "ZENDESK_SUBDOMAIN",
    indexName: "ALGOLIA_INDEX_NAME",
  });
</script>

​

Next steps