---
title: "Integrate Zendesk Repository"
slug: "integrate-zendesk-repository"
tags: ["cagg"]
updated: 2025-05-06T09:53:24Z
published: 2025-05-06T09:53:24Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.whatfix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate Zendesk Repository

Whatfix enables you to integrate Zendesk with Whatfix to fetch articles from your Zendesk Repository and display them as contextual links in Self Help and Task List widgets. Fetch all content or only content from specific folders.

Use the following steps to integrate Zendesk Repository:
{{snippet.click_repositories}}

3. Click the **Zendesk** tile.
![RB_DB_CAggclickzendesktile](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/RB_DB_CAggclickzendesktile.png){height="" width="500"}

4. Enter the title and URL of your Repository.
![RB_DB_CAgg_entercredszendesk](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/RB_DB_CAgg_entercredszendesk.png){height="" width=""}

5. Specify whether your Repository is password protected or not.
![RB_DB_CAgg_entercredszendesk](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/RB_DB_CAgg_entercredszendesk.png){height="" width=""}

6. Click **Next**.
![RB_DB_CAgg_entercredszendesk](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/RB_DB_CAgg_entercredszendesk.png){height="" width=""}


:::(Info) (Info:)
If your Repository is password protected, enter your Zendesk username and API token. For more information on how to get your Zendesk API token, see [Generate Credentials for Zendesk Integration](/studio/docs/generate-credentials-for-zendesk-integration){target=`_blank`}.
![zendesk_credentials_input.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/zendesk_credentials_input.png){height="" width="500"}

After you enter your credentials, click **Next**.
:::


7. Choose whether you want to fetch content from the entire Repository or from a specific folder.
![RB_DB_CAggselectcontent](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/RB_DB_CAggselectcontent.png){height="" width=""}

<details>
<summary> Integrate all content in your Repository </summary>
    Select the <strong>All content</strong> option.
    <br>
    <img src="https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/RB_DB_CAggselectcontent.png">
    
</details>

<details>
<summary> Integrate specific content in your Repository </summary>

Select the <strong>Specific content</strong> option.
    <img src="https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/zendesk_select_content.png" width=500>

Specify what kind of URLs you want to crawl using the URL rules.
<img src="https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/repository_url_rules.png" width=500>
    
| URL rule | Explanation |
| --- | --- |
| Starts With | Crawls a URL if it starts with the specified text. |
| Ends With | Crawls a URL if it ends with the specified text. |
| Equals | Crawls a URL if it equals the specified text exactly. |
| Not Equals | Crawls a URL if it does not equal the specified text. |
| Contains | Crawls a URL if the specified text is part of the URL. |
| Not Contains | Crawls a URL is the specified text is not part of the URL. |

Combine multiple rules using AND and OR operators by clicking <strong>Add More</strong>.
![add_more_url_rules.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/add_more_url_rules.png){height="" width="500"}

</details>


8. After the crawler option is configured, click **Integrate**.

Once the Integration request is created, the Repository appears under the Integrated Repositories in the **Processing** state. 

:::(Info) (Info:)
* Once all the content is indexed, access it on the Whatfix dashboard.
![RB_DB_CRclickrepo](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/RB_DB_CRclickrepo.png){height="" width="500"}

* The Repository links fetched appear in Self Help and Task List in the same manner as Whatfix links.
* If you have Smart Context enabled, add the global-page tag for the content to reflect in the Self Help widget on your application. For more information, see [Add Repository Content to Self Help and Task List](/studio/docs/add-repository-content-to-self-help){target="_blank"}.
:::

:::(Warning) (Note:)
* The Repository links are available in the Ready stage only after a sync of all crawled content from your repository to Whatfix.
* You cannot move the links to the Draft stage or edit them. In the Ready stage, you can edit only tags and search keywords.
* Once you push the Repository links to the Production stage, you cannot move them back to the Ready or Draft stages like the other Whatfix content and widgets.
* Unlike other content and widgets that you can tag in the Draft stage, you can tag the Repository links only in the Ready stage.
:::

## Related

- [Generate Credentials for Zendesk Integration](/generate-credentials-for-zendesk-integration.md)
- [Content Aggregation](/content-repository.md)
- [View Content Repository links on the Dashboard](/view-content-repository-links-on-the-dashboard.md)