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

# Freshdesk Tool

## Learn how to integrate Freshdesk with Insighto.ai to automatically create support tickets from form submissions.

## Setup Freshdesk Tool

1. Go to Tools & Integration

From the left-hand sidebar of your Insighto dashboard, click on **Tools & Integration**.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT1.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=416dab14b111b98212f16036aa4c2efd" alt="Go to Tools & Integration" width="1526" height="962" data-path="images/fd/FDT1.png" />

***

2. Locate the Freshdesk Tool and Click Set Up

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT2.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=de86e2fa0d7af3a00b8b41c92e676d6c" alt="Locate Freshdesk Tool" width="1526" height="962" data-path="images/fd/FDT2.png" />

***

3. Click on Start New

After clicking **Set Up**, a popup window will appear. Click the **Start New** button to begin creating a new configuration.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT3.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=f287d3baaa2390ea5b6d499d8b69de3c" alt="Click on Start New" width="1526" height="962" data-path="images/fd/FDT3.png" />

***

4. Configure Freshdesk Tool Settings

To set up the Freshdesk tool, enter:

* A name for the integration
* Your **Freshdesk API Key**
* Your **Freshdesk domain**

#### How to retrieve these details:

1. Log in to your Freshdesk account.
2. Go to **Profile Settings** from the top-right profile menu.
3. Copy your API Key from the **Your API Key** section.
4. Identify your domain from your Freshdesk URL (e.g., `https://yourdomain.freshdesk.com` → `yourdomain`).

🔗 [Help article](https://support.freshdesk.com/en/support/solutions/articles/237264-how-do-i-find-my-freshdesk-account-url-using-my-email-address)

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT4.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=eba970159e9a623c1dd7aba87aa27f5b" alt="Configure Settings" width="1526" height="962" data-path="images/fd/FDT4.png" />

***

5. Enable Create Ticket Function

Enable the **Create Ticket** function and click **Save** to complete the setup.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT5.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=b938dddec3fcaf54695a68ce5833a8ae" alt="Enable Create Ticket" width="1526" height="962" data-path="images/fd/FDT5.png" />

***

## Connect With Forms to Use on Assistant

6. Navigate to Forms Section

Go to the **Library** section in the left panel and click on **Forms** to manage or create the form.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT6.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=bd92131d05420bdb36ae99926d2b535d" alt="Navigate to Forms" width="1526" height="962" data-path="images/fd/FDT6.png" />

***

7. Connect Freshdesk Tool to Form

Find or create a form that includes the required fields (**Email**, **Subject**, **Description**), then click **Assign Tool**.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT7.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=8071a0557730fdb880af9ec79c68b5f4" alt="Assign Tool to Form" width="1526" height="962" data-path="images/fd/FDT7.png" />

***

8. Select Tool Type and Configuration

In the popup, select **Freshdesk** from the tool type dropdown, then choose the configuration you set up.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT8.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=448ecb5ee6c199395b00516a6b1a71ad" alt="Select Tool Type and Configuration" width="1526" height="962" data-path="images/fd/FDT8.png" />

***

9. Map Form Fields and Finalize Connection

Select the **Create Ticket** function, map the form fields, and click **Save**.

<img src="https://mintcdn.com/insightoai-bc61fe99/jm8-ODpzfaYvg9G-/images/fd/FDT9.png?fit=max&auto=format&n=jm8-ODpzfaYvg9G-&q=85&s=f59424930c86fd63b75ae34d78b0c96b" alt="Map Fields" width="1526" height="962" data-path="images/fd/FDT9.png" />

***

10. Connect Form to Assistant and Trigger

Attach the form to your assistant using the **Instructions block**. When a user submits it, a Freshdesk ticket will be created.
