# Freshdesk Integration ## Introduction Freshdesk is a cloud-based CRM software that assists businesses in managing customer support. By integrating the **Freshdesk Extension** into the Fynd Platform, businesses can smoothly manage customer service for a specific sales channel. The setup process for the Freshdesk extension is easy and efficient, allowing businesses to manage customer support tickets effectively. The extension streamlines customer support for sellers and users, making it a valuable tool for businesses. ## Steps to use Freshdesk Integration Extension 1. Go to **Extensions** in Fynd Platform. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_1.png) Figure 1: Extension Section - Fynd Commerce 2. Search for the **Freshdesk Integration** extension in the search box, and open it. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_2.png) Figure 2: Freshdesk Extension 3. Select the sales channel you want to configure the extension with. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_3.png) Figure 3: Selecting Sales Channel ## Configure You can configure the Freshdesk Integration extension by fulfilling the following paths: ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_4.png) center em Figure 4: Configuring Freshdesk br ### Integration 1. Create an account on [Freshdesk](https://www.freshworks.com/freshdesk/). 2. Copy Freshdesk domain URL from Freshdesk. Check the image below. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/5.png) Figure 5: Freshdesk Homepage 3. Come to the extension page and paste the link under the Base URL section. before that, you need to enable the toggle button to activate the extension on your sales channel. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/freshdesk_6.png) Figure 6: Pasting Base URL 4. Go to the Freshdesk Profile section. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_7.png) Figure 7: Freshdesk Profile Section 5. Click **View API Key** and copy the API Key from there. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_8.png) Figure 8: Copying API Key 6. Now paste the API Key on the extension page under the API Key section, and click **Test**. This will verify your API key. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/fig_9.png) Figure 9: Pasting API Key 7. Once the API verification is successful, click **Integrate**. The data is now stored in the internal database. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/fig_10.png) Figure 10: Integrating Extension ### Ticket Fields A new ticket gets created once you click **Test** to verify your API key. It justifies the validity of your credentials. iframe center em Ticket Creation br The ticket fields are fetched from your Freshdesk account. When you open **Tickets Fields**, you can find the mandatory sections are highlighted with an asterisk mark. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_11.png) center em Figure 11: Mandatory Ticket Fields on Platform Extension Page br You can view/manage specific tickets fields by going to **Freshdesk** > **Admin** > **Ticket Fields**. Here, you can add/delete an old ticket field or can customise any other tickets. 1. Go to Freshdesk **Tickets Fields**. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/ticket_field.png) Figure 12a: Ticket Creation - Freshdesk Ticket Fields 2. Choose any of the ticket field types (refer fig. 12b) to create a ticket field in the ticket creation. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/create_a_ticket.png) center em Figure 12b: Ticket Creation - Choose a Ticket Field br 1. Once a new ticket gets added/deleted, come to the **Ticket Fields** in the extension. Click **Sync Now**. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/sync.png) Figure 12c: Ticket Creation - Syncing a New Ticket 2. If there are any changes in the ticket fields you will be getting a tooltip at the ticket settings with the message **'Please download your API collection’**. The latest ticket fields get updated and you need to download api collection with changed ticket fields. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/create_a_ticket_1.png) Figure 12d: Ticket Creation - Updating Ticket Information 3. You can see your new ticket at the end of the page. You can delete any ticket there itself. Here, you can easily create, manage or delete any particular ticket of your own. iframe center em Managing & Deleting Ticket Fields on Freshdesk br ### Webhook We have integrated Webhook to automate the workflows. To receive notifications about ticket updates or changes, you'll need to set up the webhook in the Freshdesk portal. If you're a seller and wish to receive the same notifications, you'll need to have your own server to receive the events alert. Once you set up your server, integrate it with an API key to receive the same updates that are sent to our server. 1. Go to the **Admin** section of **Freshdesk** site. 2. Click **Automation** from the **Recommended Fetures** section. 3. Click **New Rule** under **Ticket Update**. - **Rule Name:** In this section create a webhook name (e.g., webhook_fynd). - **Involves any of these events:** Choose events (e.g., Priority is changed). - **Perform these actions:** Choose Trigger webhook from the dropdown list. - **Request type:** Choose **PUT** from the dropdown. - **URL:** Go to the Extension page, copy the **Webhook URL** from there and paste it here in this section. - Enable **Requires authentication** button. - **API Key:** Copy the **API key** from the Extension page and paste it here. - **Encoding:** Select **JSON**. - **Content:** Select **Simple**. There in the box, select any ticket properties of your choice, e.g., Ticket ID, Subject, etc. - Click **Preview and Save**. It is updated now; you can find it under the Ticket Update section. iframe center em Configuring webhook br #### Get Update Webhook If a seller has a custom webhook, he can add that here to integrate the seller webhook with the extension. This webhook will get the updates when there are any changes in ticket updates. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/fig___13.png) center em Figure 13: Get Update Webhook br ### Ticket Setting Download the **API collection** from the download section. You can upload the particular curl to Postman or any other API platform to create, get, filter, and update any tickets. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/14a.png) center em Figure 14a: Downloading API Collection br When a new ticket gets created, an (i) icon appears up beside the ticket setting (fig. 14b). You need to go to **Ticket Setting** > download the **API collection**, and reupload the particular curl on the API platform like Postman. You have to follow the same in case you delete any particular ticket from the Freshdesk site. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_13b.png) center em Figure 14b: Appearing (i) icon br ## Reset API key You can rest your API Key at any time: 1. Go to **Freshdesk Integration** extension and click **Reconfigure**. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/fig_15.png) Figure 15: Reconfigure API Key 2. Click **Profile settings** of Freshdesk site. ![QG1](https://cdn.pixelbin.io/v2/lingering-waterfall-e480b7/original/Freshdesk_extension/fig_15.png) Figure 16: Freshdesk Profile 3. Go to **View API key** > **Reset API Key** > Copy the API key from there. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/fig_17.png) Figure 17: Reset API Key 4. Paste the API Key on the extension page under the **API Key** section, and click **Test**. This will verify your API key. Once verified, click **Reconfigure**. ![QG1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/fig_18.png) Figure 18: Reconfiguring API Key ## Final Output Your sales channel is now connected with the Freshdesk Integration extension which will act as a proxy service of the tool Freshdesk. Once all the steps are integrated, the screen will ask you to reconfigure. You can reconfigure only if you need to. The page will look like the below format. ![GQ1](https://cdn.pixelbin.io/v2/doc/original/Freshdesk_extension/Freshdesk_-_new_folder/fig_19.png) center em Figure 19: Freshdesk Extension Integrated Successfully br