Introducing the New CivicPlus Status Page!  

Check real-time updates on maintenance, incidents, and system performance all in one place. You can now subscribe to get automatic notifications for all products or only the ones you use. Visit the Status Page.

Freshdesk: Add Note to Ticket Integration

Prev Next

The Freshdesk Add Note to Ticket integration allows for easy connectivity between your forms and your Freshdesk system. Once configured, any form can be used to add a note to an existing ticket 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 key Freshdesk 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. The Agent API Key used for this integration will appear as the one adding notes to tickets. The suggestion is to add an Agent to your Freshdesk account with a generic name. This way when new notes are added to tickets you know they are created from the Process Automation and Digital Services form instead of appearing as though they were added by an agent.

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


Set Up the Workflow 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. Select the Workflow tab The Workflow tab on the form builder screen.

  4. Add the Freshdesk: Add Note to Ticket event to the form Event type selection for adding notes to Freshdesk tickets in submission events.

    • Run Conditionally: Choose to only run the event when a specific rule is met

  5. Click Save


Set Up Freshdesk

To ensure that the forms submitted are updating the correct Freshdesk tickets, you will need to configure your Freshdesk Account.

  1. Click the more info button on your Freshdesk: Add Note To Ticket event. Select the app you are going to use for the form (if you only have one app this selection is hidden), and copy the Freshdesk Canned Response TemplateFreshdesk interface showing a canned response template for ticket management.

  2. Open your Freshdesk Account and navigate to Admin and select Canned ResponsesAdmin panel showing options for agent productivity, including canned responses and ticket templates.

  3. Click Create NewCreate New button highlighted in the Canned Responses section of an application interface.

  4. Add a Response Title and paste in the Canned Response Template from Step 1 Form for adding a new canned response with placeholders for dynamic content.

    Note:

    It is important that the canned response includes the full link to the form. This includes the external ID that connects the form submission to the Freshdesk ticket.

  5. Click SaveThe Save button on the canned responses page.

  6. Now when a new ticket is created, your agents will be able to select this canned response. This can be done by clicking Reply, selecting Canned Response, and clicking Insert canned response. Click Send to send the canned response and form link to the requester. Email interface showing ticket details and a link for response submission.

  7. The Requester will receive an email with the link to the form Email correspondence regarding Blake's Example Ticket with a response link included.

  8. Once the form is completed and submitted the content from the form will be added as a public note to the ticket Email correspondence regarding a ticket response with contact details and deadlines.