1. Documentation /
  2. WooCommerce Freshdesk

WooCommerce Freshdesk

WooCommerce Freshdesk connects your Freshdesk account to your WooCommerce-powered store, allowing customers to create tickets within your Freshdesk Help Desk, and allowing you to connect a customer in Freshdesk with their information.

NOTE: As of version 1.1.24, SSO (Single Sign On) is no longer supported. Existing Freshdesk accounts with SSO implementations will continue to work however.


↑ Back to top
  • WooCommerce 3.5+
  • PHP 5.4+
  • A Freshdesk account with a paid plan. More info at: freshdesk.com


↑ Back to top
  1. Download the .zip file from your WooCommerce account.
  2. Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
  3. Install Now and Activate the extension.

More information at Install and Activate Plugins/Extensions.

Setup and Configuration

↑ Back to top
  1. Go to WooCommerce > Settings > Integration > Freshdesk.
  2. Configure your settings:
    • URL from your Freshdesk account
    • Plan from the dropdown
    • API Key from your Freshdesk account. See Find your API Key (below)
  3. Testing
    • Enable logging when troubleshooting. Otherwise, leave it disabled.
  4. Save changes.

Find your API Key

↑ Back to top
The link to your Profile, within Freshdesk.

To locate your API key, log in to your Freshdesk account and select User Profile in the top-right corner. Visit Profile Settings and view your API key.

Why do you need to know what Freshdesk plan I’m using?

WooCommerce Freshdesk comes bundled with quite a few features which are only available to upgraded plans. To keep the user experience and interface as clean as possible, we only show features available for the Freshdesk plan you’re using.

When you upgrade your Freshdesk plan, change the setting here and enjoy a whole host of new features.

Connecting a product to Freshdesk

↑ Back to top
Synchronise a product with a solution category and a forum category (Blossom and higher) in Freshdesk.
Synchronize a product with a solution category and a forum category (Blossom and higher) in Freshdesk.

To make it easier for customers to request your assistance, WooCommerce Freshdesk makes it possible to connect a product in your store with a Solutions category and a Forum category in your Freshdesk helpdesk.

Note: Forum category synchronization is only available to Blossom plans and higher. This screenshot is for illustrative purposes only.

To start, select Create for the Solution category and/or Forum category. Update the product to connect this product to your helpdesk.

At a later stage, if you change the product name or description, you could select Synchronize to update your Solution and/or Forum category information on your helpdesk.

A product, connected to a Solution category in Freshdesk.
A product connected to a Solution category in Freshdesk.

Once a product is connected, should you wish to remove the relationship, click the Remove Relationship? Checkbox and click Update on the product.

Create Freshdesk tickets in WooCommerce

↑ Back to top

WooCommerce Freshdesk makes it easier for you and your customer to converse about a particular order or blog post comment by providing a one-click solution to create a new ticket within Freshdesk. The various implementations of this are described below.

Customer – Create a ticket for an order

↑ Back to top

When viewing their orders, your customer may have a query or issue they would like to address, pertaining to the specific order.

A new Get Help button is displayed when viewing the My Account or My Orders screens within your WooCommerce store.

Help is available, at the click of a button.
Help is available, at the click of a button.

When this button is clicked, the customer is directed to the View Order screen for the order in question. This screen now contains a short form for receiving help via your helpdesk.

Easily create a new helpdesk ticket, by providing a subject line and description.
Easily create a new helpdesk ticket by providing a subject line and description.

Provide a Subject and Description, and click Send. You’ve now sent a ticket to the helpdesk, to help get your query attended to.

Customer – View existing helpdesk tickets

↑ Back to top

Most commonly, ticket interactions are best dealt with via email. When you (the merchant) have responded to the customer’s ticket, they will get an email with the reply. From there they can just respond accordingly via email.

Keeping track of several tickets, and their statuses, isn’t easy… until now. WooCommerce Freshdesk provides a neat way to keep track of all of your helpdesk tickets via your WooCommerce My Account screen.

A list of all of your helpdesk tickets, along with their statuses and some useful information.
A list of all your helpdesk tickets, along with statuses and useful information.

Select Reply next to a ticket to go to Freshdesk and interact with the ticket.

It’s possible to hide this table using the following code:

add_filter( 'woocommerce_freshdesk_hide_my_support_tickets', '__return_true' );

Store Owner – Create a ticket for an order

↑ Back to top

In some instances, when viewing an order within WooCommerce, the store owner may wish to quickly reach out to the customer (perhaps based on an irregularity in their order, or a special order note/request). They may also wish to track this discussion within their helpdesk.

A new meta box is now made available for each order, titled Report an Issue.

Quickly create a new ticket, relating to a specific order.
Quickly create a new ticket relating to a specific order.

To use this form, fill in the Subject and Description and click the Open Ticket button. A new ticket will be created in Freshdesk without reloading the screen. You will be notified of the ticket URL once the ticket has been created.

A link to the ticket is provided for you, once the ticket has been created.
A link to the ticket is provided for you once the ticket has been created.

Store Owner – Create a ticket from a blog post comment

↑ Back to top

Sometimes, a customer may have an issue or query and may not know how to contact your helpdesk. This may result in the customer commenting about their issue on a related (or unrelated) blog post.

Convert this discussion into a helpdesk ticket to help speed up the resolution time.

Visit the Comments section of your WordPress admin. Locate the comment and click the Convert to Ticket button alongside it.

NOTE: The commenter must have provided an Email Address for this to work correctly. Without an email address, this feature will not work.
Easily convert a blog post comment into a ticket. Delivering happiness on all fronts.
Easily convert a blog post comment into a ticket. Delivering happiness on all fronts.

Feedback widget shortcode

↑ Back to top

You can add the Freshdesk feedback widget on any page with the wc_freshdesk_form shortcode.


↑ Back to top
[wc_freshdesk_form title="Custom title" submit_message="Custom message" attach_file="yes" search_area="yes"]

Shortcode parameters

↑ Back to top
  • height – form height (default: 500px)
  • title – custom form heading (defaul: Help & Support)
  • submit_message – custom message to be displayed after a user submits the ticket form (default: Thank you for submitting feedback)
  • attach_file – display the “Attach a file” field (accepted values: yes/no, default: no)
  • search_area – display the “Search Articles” area (accepted values: yes/no, default: no)
Illustration of what each parameter represents.

Questions and Feedback

↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with a Happiness Engineer via the Help Desk.