search mobile facets autocomplete spellcheck crawler rankings weights synonyms analytics engage api customize documentation install setup technology content domains user history info home business cart chart contact email activate analyticsalt analytics autocomplete cart contact content crawling custom documentation domains email engage faceted history info install mobile person querybuilder search setup spellcheck synonyms weights engage_search_term engage_related_content engage_next_results engage_personalized_results engage_recent_results success add arrow-down arrow-left arrow-right arrow-up caret-down caret-left caret-right caret-up check close content conversions-small conversions details edit grid help small-info error live magento minus move photo pin plus preview refresh search settings small-home stat subtract text trash unpin wordpress x alert case_deflection advanced-permissions keyword-detection predictive-ai sso

Zendesk Connector Guide

Ingest all of your Zendesk data into Enterprise Search.

The Zendesk Connector requires that you create an OAuth App within Zendesk.

Configuration

Login to your Zendesk subdomain as an administrator: https://www.zendesk.com/login/

Click into Admin -- it's the gear in the sidebar.

Select API under Channels:

Zendesk - Clicking API in the settings menu.
Your classic dashboard of the time. A thin menu on the left has a set of options. It's dark in tone. There is a gear among some other things. Clicking the gear exposes a sub-menu, vertical, wherein there are many options. API has a purple box.

Agree to the terms of service -- if you'd like. Make sure you read it!

Click over to the OAuth Clients tab.

... And then click the + on the right side:

Zendesk - Creating an OAuth connector.

You'll need to fill out some information.

  • Client Name: You'll use this to identify the OAuth application.
  • Description: Also used for identification. You can write whatever you'd like.
  • Company: Elastic makes Enterprise Search. You can use that, or your own -- whatever works.
  • Logo: See below!
  • Unique Identifier: elastic_enterprise_search -- this is required and must be as is.
  • Redirect URLs: http://HOSTNAME:PORT/ent/sources/zendesk/create also required. Sub with your own HOSTNAME/PORT.

As for the logo, here's the Elastic Enterprise Search logo, if you'd like to use that one.

Right click and save-as:

It's all colourful, sleek, and sophisticated. A partial, sunlike circle with a convex-like bubble coming out of the right side connects to what looks like a convex green eye. It's pretty radical.

Add the logo.

Now press Save:

Zendesk - Filling out the details. The Unique Identifier and Redirect URLs must match the above pattern. The rest is up to you.
A simple form with nothing note worthy. The above text describes the fields.

Saving will generate a secret token. Keep it safe!

Copy it and then head over to Enterprise Search.

Within the administrative dashboard, click Settings on the sidebar.

Navigate to Content Source Connectors:

Zendesk - Click Settings within the sidebar, then Content Source Connectors.
A picture of the sidebar within the administrative dashboard. The item

Look for Zendesk, then click Connect.

Use your...

  1. Unique Identifier as the Client ID: elastic_enterprise_search
  2. Secret token as the Client Secret.

Now, click Sources within the sidebar.

Zendesk - Click Sources within the sidebar.
A picture of the sidebar within the administrative dashboard. The item

Locate Zendesk and click Add.

Use the same subdomain for which you configured the OAuth application, then click Continue.

Zendesk - Add your subdomain. If you use a different subdomain than the one that's expected, you'll need to login.
An input bar contained in the

After that, click I understand.

Why the hurdle? We want to make it clear that you're adding a public source.

All of its contents will be accessible by those with the right permissions.

As the final step, you'll need to click Allow for the Zendesk OAuth prompt.

Congratulations! It's time to search.

You can now make the source available to various groups and scale its relevance priority.


Enjoying the beta? Something broken? Lost? Please send us your feedback or visit the Enterprise Search community.