Freshdesk: Create a Ticket Integration

Prev Next

The Freshdesk integration allows for easy connectivity between your forms and your Freshdesk system. Once configured, any form can be used to create tickets in your Freshdesk account.

Set Up the Integration

  1. Sign in to your site

  2. Navigate to the Workspace menu and click Settings
    Navigation menu showing 'My Workspace' and 'Settings' options.

  3. Select Integrations

  4. Click Setup Integration on the Freshdesk card Freshdesk integration setup instructions for CivicPlus form submissions and ticket mapping.

  5. Add your Freshdesk Base URL and Agent API keyFreshdesk integration setup showing fields for Base URL and API Key input.

    Note:

    If you are using a custom domain for your portal you will need to use the original URL (yourcompany.freshdesk.com). An Agent API key can be found by clicking the agent icon in the top right of your Freshdesk portal and selecting profile settings.

  6. Click Save The Save button on the Freshdesk integration card.


Set Up the Submission Event

  1. Sign in to your site

  2. Navigate to Forms and open the desired form The Forms tab in the left navigation menu with a form selected on the page.

  3. Click the Workflow tab The Workflow tab on the form builder screen.

  4. Select the Freshdesk: Create Ticket Submission Event Freshdesk event type selection for creating a ticket in the submission events section.

  5. Configure your ticket properties Freshdesk ticket creation interface showing field mapping options for submission events.

    Note:

    When mapping the properties on the submission event, you will be presented with a manual input depending on the type of property. For example, text properties will give you a free text input, date properties will give you a date picker, dropdown properties will display from the list of available options. Once these are set, the properties will be the same for every submission.Properties that are required when setting up the workflow if the property has a “Required when submitting the form” check turned on for either the agent or the customer. You can see this configuration in your Freshdesk Ticket Fields menu. If these are not set then that property does not need to be set in the submission event.Form settings for priority behavior and labels for agents and customers.

  6. Click Save

  7. Once the submission event is configured, any submission of the form will create a Freshdesk ticket in your account.

    Note:

    All form elements are included in the ticket description, ensuring that all the data from the form is available in the Freshdesk ticket. Attachments are included in the description as downloadable links, these will last for 7 days before they expire.


Set Up the Form

Instead of manually selecting or entering the value of the property on the submission event, you can populate them from the elements in your form. In the example below, the property is being set by the person completing the form. If you have a dropdown Freshdesk property, you can pull the list of options from your Freshdesk account. This can be done using the Freshdesk fields options as per the priority example below. Configuring the submission event this way allows the person filling in the form to set the Freshdesk ticket properties such as specifying the priority of the ticket.

FreshDesk support ticket interface showing priority and status options for user selection.