Edit

Share via

Zendesk Help Center Microsoft Graph connector (Preview)

  • Article

The Zendesk Help Center Graph connector allows your organization to index articles from Zendesk Help Center (also known as Zendesk Guide). After you configure the connector, end users can search for these articles from Zendesk in Microsoft Copilot and from any Microsoft Search client.

This article is for Microsoft 365 administrators or anyone who configures, runs, and monitors a Zendesk Help Center Graph connector.

Note

The Zendesk Help Center connector is in public preview. If you wish to get access to try it, you need to enable Targeted Release ring for your Admin account.

Capabilities

  • Index Help Center articles
  • Enable your end users to ask questions related to your support queries or product information in Copilot.
    • What is the return policy for apparels?
    • What are the product specifications for Surface laptop?
    • How can I upgrade my subscription?
  • Use Semantic search in Copilot to enable users to find relevant content based on keywords, personal preferences, and social connections.

Limitations

  • Doesn't support access restrictions to articles based on Zendesk user permissions. All users in your tenant have access to all indexed articles.
  • Doesn't index Zendesk Guide Community posts and topics.
  • Doesn't index attachments.

Prerequisites

  • You must be the search admin for your organization's Microsoft 365 tenant.
  • Zendesk Instance URL: To connect to your Zendesk Help Center data, you need your organization's Zendesk Help Center instance URL. Your organization's Zendesk Help Center instance URL typically looks like https://<your-organization-domain>.zendesk.com. If you don't have an instance already, refer the article to learn about creating a test instance.
  • Service Account: To connect to Zendesk Help Center and allow Microsoft Graph Connector to update knowledge articles regularly, you need a service account with read permissions granted to the service account.

Get Started

1. Display name

A display name is used to identify each citation in Copilot, helping users easily recognize the associated file or item. Display name also signifies trusted content. Display name is also used as a content source filter. A default value is present for this field, but you can customize it to a name that users in your organization recognize.

2. Zendesk URL

To connect to your Zendesk data, you need your organization's Zendesk instance URL. Your organization's Zendesk instance URL typically looks like https://<your-organization-domain>.zendesk.com.

3. Authentication Type

To authenticate and sync content from Zendesk, choose one of the two supported methods:

a. Basic authentication
Enter the username and password of Zendesk account to authenticate to your instance.

b. Zendesk OAuth (Recommended)

[Click to expand] To use the Zendesk OAuth for authentication, follow these steps.

A Zendesk admin needs to create an OAuth client in the Zendesk Admin Center. To learn more, see Managing access to the Zendesk API in the Zendesk documentation.

The following table provides guidance on how to fill out the OAuth client creation form:

Field Description Recommended Value
Client name Unique value that identifies the application that you require OAuth access for. Microsoft Search
Description (Optional) A short description of the OAuth client Use an appropriate description
Company The name of your company Use an appropriate value
Logo A file that contains the image for the application logo. Any appropriate logo or use default.
Client kind Choose between Confidential and Public Oauth client Confidential
Redirect URL A required callback URL that the authorization server redirects to. For M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback,
For M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback

Enter the client ID and Secret to connect to your instance. After connecting, use a Zendesk account credential to authenticate permission to crawl.

4. Roll out to limited audience

Deploy this connection to a limited user base if you want to validate it in Copilot and other Search surfaces before expanding the rollout to a broader audience. To know more about limited rollout, click here.

At this point, you're ready to create the connection for Zendesk Help Center. You can click on the "Create" button to publish your connection and index articles from your Zendesk account.

Troubleshooting

After publishing your connection, you can review the status under the Data Sources tab in the admin center. To learn how to make updates and deletions, see Manage your connector.

If you have issues or want to provide feedback, contact Microsoft Graph | Support.