Integration Types

Coveo for Zendesk can be integrated in two types of services: Zendesk Support, which is the agent interface, or Zendesk Guide, which is a customizable self-service knowledge base. By adding a Zendesk source to your Coveo organization, your content is added to the index, and then appears in query results for agents and end users.

Integration for Zendesk Support

Zendesk Support uses the Agent Dashboard, which appears when you log in. The dashboard is a ticketing system designed to help agents track customer interactions. Coveo for Zendesk instantiates different sections of the dashboard in order to provide you with personalized recommendations.

The Coveo integration for Zendesk Support relies on the Coveo search page service, which includes the JavaScript files along with the search page template. When a query is made, the integration first parses a JWT search token generated by Zendesk to ensure user authentication. Then, depending on the query, either the Top Toolbar component or the Ticket Sidebar component is instantiated and the search page service returns the correct page configuration based on the query context.

Zendesk Agent Interface

Ticket Sidebar

The Ticket Sidebar component on the Agent Dashboard contains data pertaining to the ticket context. This is where the Insight panel is embedded, allowing the ticket context to be leveraged and allowing the user to retrieve relevant items. The CoveoJsSearch library renders the Insight panel search interface. The ticket data is retrieved with the Zendesk Client API after which the context is flattened and modified for readability by the Coveo Platform.

Top Toolbar

The Top Toolbar component is visible at the top of the Agent Dashboard. The toolbar consists of icons which allow you to access different functionalities such as creating a new ticket or opening a search box. This component doesn’t have access to the ticket; instead, it takes care of the initialization and communicates with the Insight panel to retrieve the context of the ticket and updates accordingly.

Integration for Zendesk Guide

Zendesk Guide is a knowledge base designed for end users which uses the self-service Help Center that can be customized according to the customer’s needs. The self-service integration is set up by implementing a Coveo search box in the Help Center and also by replacing the home page with a built-in Coveo search page that allows end users to search for relevant content.

The search box and search page are implemented by importing Coveo JavaScript Framework files to the header of the Help Center. Depending on the theme used in the initial setup, the search box may be added to either the home page or the page header while the search page must be added to the Help Center. The integration is finalized once Coveo within Guide is initialized, after which the Help Center will be ready for use.

What’s Next

Get started on the deployment setup, and then follow the applicable installation guide: Zendesk Support or Zendesk Guide.

Recommended Articles