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

# FreshDesk

With Zuper’s first-class integration with Freshdesk, it seamlessly helps push Freshdesk tickets to Zuper, delivering an exceptional customer experience. You can create a Job from a Freshdesk ticket with a bi-directional sync.

The three major sections we are going to discuss here are:

A. How to connect Zuper with Freshdesk?

B. How to connect Freshdesk with Zuper?

C. How does Zuper –Freshdesk Integration work?

D. How to uninstall Freshdesk from Zuper?

**A. How to connect your Zuper with Freshdesk?**

1. Open a new tab in your browser once you are logged in to your Freshdesk, and select the Freshdesk **App Store**.

a. **Zuper Region** (Mandatory) – Enter the region of Zuper for which Freshdesk integration is applicable.

b. **Zuper API Key** (Mandatory) - To create the Zuper API key, Click [**here**](https://docs.zuper.co/Settings/Developer_Hub/API_Keys#api-keys) to know how to create and use API keys

c. **Freshdesk Domain** (Mandatory) - Enter Freshdesk’s URL.

d. **Freshdesk API Key** (Mandatory) – Copy-paste the Freshdesk API key from your Freshdesk account (How to find your API key).

e. **Sync Notes Automatically** – You can choose either “**Yes**” or “**No**” to sync or unsync Zuper Job Notes with Freshdesk.

f. Choose Notes to Sync – You can choose the type of notes for which the sync should happen from Freshdesk to Zuper. Options available are **Private Note**, **Public Note**, and **Reply**.

g. Enable Full Page to Support Agent – You can choose either “**Yes**” or “**No**” to set permissions for the Support Agents to the Full Page app access within Freshdesk.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk1.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=00c94bff22820f06defd7cd700f4c807" alt="Fdesk1 Pn" width="1920" height="942" data-path="images/Fdesk1.png" />

## B. How to connect your Freshdesk with Zuper?

1. Open a new tab in your browser once you are logged in to your Zuper Account. Click on your Profile Picture in the top right corner of the screen and select the “**App Store**.”

<img src="https://mintcdn.com/zuperinc/M4JqQ68bNxvkxTES/images/Zcrm1.png?fit=max&auto=format&n=M4JqQ68bNxvkxTES&q=85&s=5b5d74b7c119dfd939b2c0c99ec4289b" alt="Zcrm1 Pn" width="1903" height="872" data-path="images/Zcrm1.png" />

2. Under the “**Browse by Category**,” select the “**CRM**” option and choose “**Freshdesk**.”

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk3.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=cb5639df9b79facf8b1f0a21a9038041" alt="Fdesk3 Pn" width="1920" height="881" data-path="images/Fdesk3.png" />

3. Click on the “**Install Freshdesk**” button.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk4.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=cb293b1adec06e3cdf5f84be4f0c1c42" alt="Fdesk4 Pn" width="1918" height="878" data-path="images/Fdesk4.png" />

4. Update Zuper Settings by configuring the following fields:

a. Zuper API Key (Mandatory) – To create the Zuper API key, Click [**here**](https://docs.zuper.co/Settings/Developer_Hub/API_Keys#api-keys) to know how to create and use API keys.

b. Freshdesk API Key (Mandatory) – Copy paste the Freshdesk API key from Freshdesk account ([How to find your API key](https://support.freshdesk.com/en/support/solutions/articles/215517-how-to-find-your-api-key)).

c. Freshdesk Subdomain (Mandatory) - Enter the Freshdesk Subdomain details here.

d. Sync Zuper Status Updates - You can choose either “**Yes**” or “**No**” to sync or unsync Zuper Status updates with Freshdesk.

e. Sync Zuper Custom Fields - You can choose either “**Yes**” or “**No**” to sync or unsync Zuper Custom Fields with Freshdesk.

f. Sync Zuper Job Notes - You can choose either “**Yes**” or “**No**” to sync or unsync Zuper Job Notes with Freshdesk.

g. Freshdesk Status Field Name - You need to enter the Freshdesk Field Name for which Zuper gets synced.

h. Freshdesk Assignees Field Name - You need to enter the Freshdesk Assignees Field Name for which Zuper gets synced.

i. Freshdesk Start Date Field Name - You need to enter the Freshdesk Start Date Field Name for which Zuper gets synced.

j. Freshdesk End Date Field Name - You need to enter the Freshdesk End Date Field Name for which Zuper gets synced.

k. Freshdesk Customer Signature Field Name - You need to enter the Customer Signature for which Zuper gets synced.

l. Freshdesk Ticket Close Statuses - You need to enter the list of Freshdesk Ticket Close Statuses for which Zuper status get synced (Use a comma separator to add multiple statuses).

m. Mark Freshdesk ticket as? - You need to choose the status of the Freshdesk ticket from the dropdown list - **None**, **Closed**, or **Resolved**.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk5.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=ed372a19e052421f0ce0e8cdf5036239" alt="Fdesk5 Pn" width="1917" height="1867" data-path="images/Fdesk5.png" />

Select the “**Update**” button to connect Freshdesk with Zuper.

## C. How does Zuper – Freshdesk work?

**Create a Job from Zuper**:

1. Log in to your Freshdesk account, and in the right sidebar widget, you can view the ticket for which a Job has not been created in Zuper.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk6.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=5e4c5e0fd4985b17f17538bb9f0ac616" alt="Fdesk6 Pn" width="1920" height="905" data-path="images/Fdesk6.png" />

Click the "**Create Job**" button to create a new job for the pending Freshdesk ticket.

2. The Job Title, Job Category, and Job Priority are automatically picked. The agent has added the Job description and chosen the time slot.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk7.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=87525bd6490a56168a93554874ddc8cf" alt="Fdesk7 Pn" width="1905" height="905" data-path="images/Fdesk7.png" />

3. Use the "**Assisted Scheduling**" feature to choose the slots and click the "**Confirm**" button.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk8.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=5404a0cc576dd7e4a5647a1cd02f1832" alt="Fdesk8 Pn" width="1920" height="905" data-path="images/Fdesk8.png" />

4.The Freshdesk ticket contact will be created as a Customer in Zuper.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk9.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=f6c909403c02b0402dcc00bd7b140385" alt="Fdesk9 Pn" width="1920" height="905" data-path="images/Fdesk9.png" />

5. Use the "**Pick From Map**" option to capture the exact customer address with proper geo-coordinates.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk10.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=b1c01fd40b7d043d642f80d490548772" alt="Fdesk10 Pn" width="1920" height="905" data-path="images/Fdesk10.png" />

6. The new job is successfully created from the Freshdesk sidebar.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk11.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=91e2ffd423b3e3a220b548e6c525cd96" alt="Fdesk11 Pn" width="1920" height="905" data-path="images/Fdesk11.png" />

7. You can view the list of Jobs created using Zuper-Freshdesk integration, and you can also view all jobs in the associated Zuper account.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk12.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=d35152620a454b85ea68335ea02f791a" alt="Fdesk12 Pn" width="1913" height="894" data-path="images/Fdesk12.png" />

8. Click any one of the line items to view the Job details.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk13.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=d3e421546655adeadf2d66690f8b520e" alt="Fdesk13 Pn" width="1913" height="826" data-path="images/Fdesk13.png" />

### Custom fields

If custom field values you saved in Zuper are not appearing in Freshdesk, check the following:

1. Confirm **Sync Zuper Custom Fields** is set to **Yes** in your Freshdesk integration settings.
2. Check whether the Freshdesk ticket was already closed before you saved the custom fields in Zuper. If so, reopen the ticket in Freshdesk, then re-save the custom fields in Zuper to trigger the sync.
3. Confirm the field names match exactly in both systems. Only fields with identical names sync automatically.

If the issue continues, contact [Support](mailto:support@zuper.co).

### Workflow execution history

Check workflow execution history for errors

If a workflow linked to this integration is not running as expected, you can check its execution history to find where it failed.

1. Go to the **Jobs** module and open the relevant job.
2. In the right panel, locate **Workflow Activity** and select **View History**.
3. Review the **Status** column. Select any failed run to see the error message and the node where the failure occurred.
4. To retry a failed run, select the **Retry** icon next to the execution.
5. If you have resolved the issue manually, select **Acknowledge** to mark the run as reviewed.

### Zuper inside Freshdesk App:

You can use the major Zuper capabilities in the Freshdesk App.

1. The Assets Picker helps you to add the Assets needed for the Job. Choose the Asset and click the "**Confirm**" button.

<Note>
  **Note**: You can include the required unassociated assets to Job based on your need and click the "Confirm" button.
</Note>

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk14.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=86d50824e6f22726247bb5259f6f74d3" alt="Fdesk14 Pn" width="745" height="877" data-path="images/Fdesk14.png" />

2. The Contract Picker helps you add the contracts needed for the job. Choose the Contract and click the "**Confirm**" button.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk15.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=c0ab84343224e5bddc12889d433005cc" alt="Fdesk15 Pn" width="747" height="871" data-path="images/Fdesk15.png" />

3. The Part Picker helps you add the parts needed for the job.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk16.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=e4e9ba7e87cb64af035982af8facd2bc" alt="Fdesk16 Pn" width="743" height="875" data-path="images/Fdesk16.png" />

Choose the parts and click the "**Confirm**" button.

4. The Custom fields are auto-populated only if they match the custom fields that are available in the Freshdesk ticket. Also, the user can fill in manually.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk17.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=2480cd291b73ea27e9b4a705c7288d44" alt="Fdesk17 Pn" width="697" height="728" data-path="images/Fdesk17.png" />

5. You can track the technician by viewing the live location of the User.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk18.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=57817ab97c8d08a05481f50e202d3694" alt="Fdesk18 Pn" width="748" height="880" data-path="images/Fdesk18.png" />

## D. How to Uninstall Freshdesk from Zuper?

1. Open a new tab in your browser once you are logged in to your Zuper Account. Click on your Profile Picture in the top right corner of the screen and select the “**App Store**.”

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk19.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=bb574c06b6b2ddbb7b7ff9557b494bea" alt="Fdesk19 Pn" width="1903" height="872" data-path="images/Fdesk19.png" />

2. Under the “**Browse by Category**,” select the “**CRM**” option and choose “**Freshdesk**.”

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk20.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=908b8c356349e7685cfd863b1303a883" alt="Fdesk20 Pn" width="1920" height="881" data-path="images/Fdesk20.png" />

3. Click on the “**Uninstall App**” button.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk21.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=717901ca1ed02f9425971c0bcf9bfb7e" alt="Fdesk21 Pn" width="1917" height="1867" data-path="images/Fdesk21.png" />

4. The Freshdesk app is uninstalled successfully.

<img src="https://mintcdn.com/zuperinc/oz3deuyqs2bjRahT/images/Fdesk22.png?fit=max&auto=format&n=oz3deuyqs2bjRahT&q=85&s=c6cc25d501a68805dee98c724d99cf6b" alt="Fdesk22 Pn" width="1915" height="880" data-path="images/Fdesk22.png" />

Using Zuper integration with Freshdesk, you can easily create & dispatch field visit jobs, pick the right slot & technician using Assisted Scheduling directly, and access Zuper Job-status updates within Freshdesk with the Freshdesk tickets.
