# Freshdesk

{% hint style="info" %}
**Note:** You cannot index your Knowledge Source if you are on Freshdesk's **Free plan.** This is because making API calls to Freshdesk is unsupported in this plan.
{% endhint %}

<details>

<summary>Prerequisite - <strong>Integrating with Freshdesk</strong></summary>

To index your Knowledge Source, you must integrate your Freshdesk account with ClearFeed.

1. Navigate to `Settings` from the nav-bar, and proceed to the [Integrations](https://web.clearfeed.app/settings/integrations) tab.
2. Within the list of available integrations, locate and select **Freshdesk.**
3. Press the `Connect` button. You will be asked to enter the Freshdesk sub-domain, as well as the API Key of your Freshdesk Account which once done, you should click on the connect button.
4. This will direct you to the Freshdesk sign-in page. Fill in the credentials and sign in. This step isn't required if you are already signed in to your Freshdesk account.
5. Once you sign in, you will be redirected to ClearFeed, and your integration will be completed.

</details>

### **Indexing a Freshdesk Knowledge Source**

With the integration complete, you can now index your Knowledge Source:

<figure><img src="https://3455705434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE2O2wTaNovd6fXpEuLKz%2Fuploads%2Fgit-blob-c8bed955c09ef1939569f78e89a030487a1e52c5%2FFreshdesk%20Knowledge%20Source.gif?alt=media" alt=""><figcaption><p>Indexing a Freshdesk Knowledge Source</p></figcaption></figure>

**Step 1**: **Add your first Knowledge Source**

* From the left navigation bar on the ClearFeed WebApp, go to **AI >** [**Knowledge Sources**](https://web.clearfeed.app/knowledge-sources)**.**
* Hover over the "Add Knowledge Source" dropdown at the top right corner to select `Freshdesk`.
* A side drawer will appear, prompting you to provide specific details:
  * **Name**: Designate a title for this Knowledge Source, which will be displayed on ClearFeed.
  * **Tags**: These are identifiers linked with every Knowledge Source, aiding in categorization and structuring. Customize tags based on your needs. **Note**: *Freshdesk* will be a default tag.
  * **Auto Reindex Regularly:** When enabled, the particular knowledge source will reindex once every 24 hours.
* After saving your addition, the Knowledge Source will either start indexing immediately (reflected by an **In Progress** status) or will be picked soon (reflected with an **Initiated** status). Get more details on Managing Knowledge Sources [here](https://docs.clearfeed.ai/clearfeed-help-center/clearfeed-ai/knowledge-sources/managing-knowledge-sources).
* **Reindexing Freshdesk Docs -** To reindex Freshdesk documents, manually reindex the knowledge source by clicking the "Reindex" button next to it.\\

  <figure><img src="https://3455705434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE2O2wTaNovd6fXpEuLKz%2Fuploads%2Fgit-blob-da57bd93a3d9583e77671859324a173ec71632c3%2FScreenshot%202024-06-07%20at%201.41.03%20AM.png?alt=media" alt=""><figcaption><p><strong>Reindexing Freshdesk Docs</strong></p></figcaption></figure>

### Using AI Agents

Once you've configured the knowledge sources, learn how to build and use AI Agents

{% content-ref url="../../ai-agents/build-ai-agents" %}
[build-ai-agents](https://docs.clearfeed.ai/clearfeed-help-center/clearfeed-ai/ai-agents/build-ai-agents)
{% endcontent-ref %}

{% content-ref url="../../ai-agents/use-ai-agents" %}
[use-ai-agents](https://docs.clearfeed.ai/clearfeed-help-center/clearfeed-ai/ai-agents/use-ai-agents)
{% endcontent-ref %}

### **Manage Knowledge Sources**

Once the status of the knowledge source has been indexed, learn more on how to manage the knowledge source below.

{% content-ref url="../managing-knowledge-sources" %}
[managing-knowledge-sources](https://docs.clearfeed.ai/clearfeed-help-center/clearfeed-ai/knowledge-sources/managing-knowledge-sources)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clearfeed.ai/clearfeed-help-center/clearfeed-ai/knowledge-sources/indexing-knowledge-sources/freshdesk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.