Title: Help Scout integration for Easy Digital Downloads
Author: flowdee
Published: <strong>December 14, 2014</strong>
Last modified: April 17, 2025

---

Search plugins

![](https://ps.w.org/edd-helpscout/assets/banner-772x250.png?rev=2553149)

![](https://ps.w.org/edd-helpscout/assets/icon-256x256.png?rev=2553148)

# Help Scout integration for Easy Digital Downloads

 By [flowdee](https://profiles.wordpress.org/flowdee/)

[Download](https://downloads.wordpress.org/plugin/edd-helpscout.2.4.0.zip)

 * [Details](https://ewe.wordpress.org/plugins/edd-helpscout/#description)
 * [Reviews](https://ewe.wordpress.org/plugins/edd-helpscout/#reviews)
 *  [Installation](https://ewe.wordpress.org/plugins/edd-helpscout/#installation)
 * [Development](https://ewe.wordpress.org/plugins/edd-helpscout/#developers)

 [Support](https://wordpress.org/support/plugin/edd-helpscout/)

## Description

Help Scout integration for Easy Digital Downloads is a WordPress plugin that will
show customer information right from your Help Scout dashboard.

Activating the plugin and configuring the integration will add the following information
to your Help Scout dashboard:

 * The name of the customer and link to the profile page in EDD
 * All purchased “downloads”
 * Orders with status and link to payment providers

If using the Software Licensing add-on, the following information is shown as well:

 * License keys. Links to the site manager in Easy Digital Downloads.
 * Active sites, with a link to deactivate the license for the given site.
 * Links to purchase an upgrade directly

When using Easy Digital Downloads with Recurring Payments:

 * Subscriptions and their status

**How to install and configure**

Have a look at the [installation instructions](https://wordpress.org/plugins/edd-helpscout/installation/).

Please note that Help Scout changed their App interface. This plugin uses custom
legacy apps, which you can learn more about [here](https://secure.helpscout.net/apps/custom).

**More information**

 * Developers; follow or contribute to the [plugin on GitHub](https://github.com/webzunft/edd-helpscout)
 * Other [WordPress plugins](https://profiles.wordpress.org/webzunft/#content-plugins)
   by Thomas Maier

## Screenshots

 * [[
 * Customer overview with Licenses area opened by default
 * [[
 * Orders with status, links to the store and payment provider
 * [[
 * Subscriptions with status and links to the store

## Installation

To get this up and running, you’ll need to configure a few things in WordPress and
Help Scout.

#### WordPress

 1. Upload the contents of **edd-helpscout.zip** to your plugins directory, which usually
    is `/wp-content/plugins/`.
 2. Activate the **Help Scout integration for Easy Digital Downloads** plugin
 3. Set the **HELPSCOUT_SECRET_KEY** constant in your `/wp-config.php` file. This should
    be a random string of 40 characters.

_Example_

Replace `your-random-string` with your own random string.

    ```
    define( 'HELPSCOUT_SECRET_KEY', 'your-random-string' );
    ```

#### Help Scout

 1. Go to the [Help Scout custom app interface](https://secure.helpscout.net/apps/custom/).
 2. Enter the following settings with adjustments according to your site’s URL and 
    the secret key.

**App Name:** Easy Digital Downloads
 **Content Type:** Dynamic Content **Callback
URL:** https://YOUR-SITE.COM/edd-helpscout-api/customer_info _(I recommend using
HTTPS)_  **Secret Key:** The value of your **HELPSCOUT_SECRET_KEY** constant.

#### Testing the plugin locally

You can set the plugin in some test mode.
 Set `HELPSCOUT_DUMMY_DATA` to `true` 
and `HELPSCOUT_DUMMY_DATA_EMAIL` to an email address in `wp-config.php` to let the
plugin use dummy data. You can then call https://your-site.com/edd-helpscout-api/
customer_info directly and get a reply based on the value of `HELPSCOUT_DUMMY_DATA_EMAIL`.

## FAQ

### Help Scout just shows “Invalid Signature”

Make sure the “Secret Key” setting for your Help Scout application matches the value
of your `HELPSCOUT_SECRET_KEY` constant. This key is used to authorize requests 
coming from HelpScout.

## Reviews

![](https://secure.gravatar.com/avatar/128a524c3d061dc4a055ec94e2cfed81d97281b4e8938ed75fdbe97914b2c6aa?
s=60&d=retro&r=g)

### 󠀁[Must have!](https://wordpress.org/support/topic/must-have-729/)󠁿

 [flowdee](https://profiles.wordpress.org/flowdee/) March 25, 2025 1 reply

There’s no way around to this widget, when you use EDD and offer support via HelpScout!

![](https://secure.gravatar.com/avatar/d4ccb9e35f3cf827d1d1280f6b8dd20e5a0afd4f4022ba830938400b37646044?
s=60&d=retro&r=g)

### 󠀁[Thank you](https://wordpress.org/support/topic/thank-you-3396/)󠁿

 [Soflyy](https://profiles.wordpress.org/soflyy/) July 13, 2023 1 reply

This plugin saves us time and allows us to provide better and faster service.

![](https://secure.gravatar.com/avatar/c156686326fa06fe69fa69b70a3a9309eac2bf333f582acd16872648cab13a8e?
s=60&d=retro&r=g)

### 󠀁[Hugely helpful](https://wordpress.org/support/topic/hugely-helpful-4/)󠁿

 [Steve Burge](https://profiles.wordpress.org/stevejburge/) August 22, 2022 1 reply

Thanks so much for developing this plugin. It’s really enormously helpful for anyone
using EDD.

![](https://secure.gravatar.com/avatar/ab1a784a75453d85d42e7e0c4b4fffcf183506b255b21bed38cf97100453e0dd?
s=60&d=retro&r=g)

### 󠀁[Brilliant plugin](https://wordpress.org/support/topic/brilliant-plugin-473/)󠁿

 [Edith Allison](https://profiles.wordpress.org/terragirl/) March 24, 2022 2 replies

Thank you for taking the time to build this plugin! Works perfectly, super easy 
to set up. I chose Easy Digital Downloads and Helpscout indepdently not knowing 
this plugin existed, so happy I came across it by pure chance in the plugin directory.
No idea why neither EDD nor Helpscout list this plugin on their site, should be 
top recommended!

![](https://secure.gravatar.com/avatar/691592e104a2092a042efecda057c8fe7f1e0d3e97b946c282e8a351f1ba122b?
s=60&d=retro&r=g)

### 󠀁[Excellent Work!](https://wordpress.org/support/topic/excellent-work-293/)󠁿

 [Adnan](https://profiles.wordpress.org/hiddenpearls/) January 8, 2022 1 reply

I am using this plugin on both of my EDD stores for LoginPress and Analytify. Helps
in support management a lot.

![](https://secure.gravatar.com/avatar/cc672217b1e53ff6449684a15b54eed0b2c6cbf3e0e88fb46a05fc6075900cda?
s=60&d=retro&r=g)

### 󠀁[This is going to be a huge timesaver](https://wordpress.org/support/topic/this-is-going-to-be-a-huge-timesaver/)󠁿

 [Daan van den Bergh](https://profiles.wordpress.org/daanvandenbergh/) October 22,
2021 1 reply

Before doing my support rounds on Help Scout I decided to installed this. I’ve just
installed it and got it up and running in less than 5 minutes. After that I dove
into my support tickets and I could immediately tell this is going to be a huge 
timesaver. Thanks a lot for creating this!

 [ Read all 28 reviews ](https://wordpress.org/support/plugin/edd-helpscout/reviews/)

## Contributors & Developers

“Help Scout integration for Easy Digital Downloads” is open source software. The
following people have contributed to this plugin.

Contributors

 *   [ flowdee ](https://profiles.wordpress.org/flowdee/)
 *   [ Thomas Maier ](https://profiles.wordpress.org/webzunft/)
 *   [ Danny van Kooten ](https://profiles.wordpress.org/dvankooten/)
 *   [ ibericode ](https://profiles.wordpress.org/ibericode/)

“Help Scout integration for Easy Digital Downloads” has been translated into 1 locale.
Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/edd-helpscout/contributors)
for their contributions.

[Translate “Help Scout integration for Easy Digital Downloads” into your language.](https://translate.wordpress.org/projects/wp-plugins/edd-helpscout)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/edd-helpscout/), check
out the [SVN repository](https://plugins.svn.wordpress.org/edd-helpscout/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/edd-helpscout/) 
by [RSS](https://plugins.trac.wordpress.org/log/edd-helpscout/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.4.0

 * Increased required PHP version to 7.4
 * Increased required WordPress version to 6.0
 * Fix: PHP 8.2 deprecation notice, props @slaFFik

#### 2.3.0

 * Improvement: added the `edd_helpscout_after_licenses_active_site_list_item` filter
   to extend output of activated sites
 * Improvement: added the subscription id to endpoint data
 * Fix: status badge of completed orders is now also green

#### 2.2.1

 * Improvement: added the `edd_helpscout_after_subscription_list_item` action hook
   to allow adding elements to the Subscriptions view
 * Improvement: increased required PHP version to 7.2
 * Fix: typo in the installation instructions

#### 2.2.0

 * Feature: the toggle state for Licenses, Orders, and Subscriptons sections is 
   now persistent, props @nosilver4u on github
 * Feature: display the number of items found for each section in the heading, props
   @nosilver4u on github
 * Improvement: show “Lifetime” label for lifetime licenses, props @nosilver4u on
   github
 * Improvement: override section templates by hosting your own version of them under`
   wp-content/themes/{THEME}/edd-helpscout/`, props @Spreeuw on github
 * Improvement: added the `edd_helpscout_endpoint_html_sections` and `edd_helpscout_endpoint_html`
   filters to customize existing section templates, props @Spreeuw on github
 * Improvement: added the `edd_helpscout_order_list_item_download_details_start`
   and `edd_helpscout_order_list_item_download_details_end` actions to order template,
   props @Spreeuw on github
 * Improvement: added the `edd_helpscout_default_section_toggle` and `edd_helpscout_persist_section_toggle`
   filters to force a specific toggle state for sections, props @Spreeuw on github
 * Improvement: increased required PHP version to 5.6 to sync with WordPress core

#### 2.1.1

 * Improvement: check if emails field is empty and handle fallback to email field

#### 2.1

 * complete template refactoring, e.g., to show Customer, Licenses, Orders and Subscriptions
   separately, props @Spreeuw
 * refactor data collection, props @Spreeuw
 * support EDD 3.0 and newer add-on versions, props @ashleyfae, @Spreeuw
 * edd_helpscout_customer_licenses to filter license query response, props @Spreeuw
 * changed “HelpScout” to “Help Scout” where technically reasonable

#### 2.0

The original developer Danny van Kooten stopped working on EDD Help Scout since 
he no longer uses it.
 The development of the plugin was taken over by Thomas Maier
from https://wpadvancedads.com, who continues using the plugin. Danny left in the
middle of developing a better version 2.0. I decided to build in top of that because
the changes show a lot potential and fixed some issues. Please test carefully and
let me know in case something is missing or not working as expected.

**Additions**

 * callback URL changed from https://your-site.com/edd-helpscout/api to https://
   your-site.com/edd-helpscout-api/customer_info, though both are working for now
 * added name of the customer and link to the profile page in EDD since Help Scout
   doesn‘t show it for everyone
 * set `HELPSCOUT_DUMMY_DATA` and `HELPSCOUT_DUMMY_DATA_EMAIL` constants in `wp-
   config.php` to let the plugin use dummy data

**Improvements**

 * fetch all payments when user has multiple emails in Help Scout or in his EDD 
   profile

**Fixes**

 * Compatibility with latest EDD plugin versions.

#### 1.1.1 – January 28, 2016

**Fixes**

 * Certain characters at start of URL were being stripped off in HelpScout.

#### 1.1 – September 6, 2015

**Fixes**

 * The plugin is now listening at a later hook in the WP request lifecycle, which
   prevents issues with bbPress and EDD Wishlists.

**Improvements**

 * Code refactoring for better separation of concerns and better overall code readability
 * Better naming consistency

**Additions**

 * Support for lifetime licenses in Easy Digital Downloads
 * Various action hooks to output your own HTML

#### 1.0.3 – February 19, 2015

**Fixes**

 * Added protocol for links to active sites
 * Querying payments by multiple emails was not working

**Additions**

 * When using EDD Software Licensing, show if a license is expired.
 * Added `helpscout_edd_customer_emails` hook to filter customer emails

#### 1.0.2

**Improvements**

 * The plugin used to “listen” to all requests to the site. It will now (after confirmation)
   only listen to requests to `/edd-hs-api/customer-data.json`.

#### 1.0.1

**Fixed**

 * Issue with nonces not working properly for the admin actions. Now using the HelpScout
   signature to validate requests.

**Improvements**

 * Minor code & inline documentation improvements

**Additions**

 * Added “renewal” label to renewals

## Meta

 *  Version **2.4.0**
 *  Last updated **1 year ago**
 *  Active installations **200+**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **6.8.5**
 *  PHP version ** 7.4 or higher **
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/edd-helpscout/) and [English (US)](https://wordpress.org/plugins/edd-helpscout/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/edd-helpscout)
 * Tags
 * [easy digital downloads](https://ewe.wordpress.org/plugins/tags/easy-digital-downloads/)
   [edd](https://ewe.wordpress.org/plugins/tags/edd/)[help scout](https://ewe.wordpress.org/plugins/tags/help-scout/)
   [helpscout](https://ewe.wordpress.org/plugins/tags/helpscout/)[support](https://ewe.wordpress.org/plugins/tags/support/)
 *  [Advanced View](https://ewe.wordpress.org/plugins/edd-helpscout/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  28 5-star reviews     ](https://wordpress.org/support/plugin/edd-helpscout/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/edd-helpscout/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/edd-helpscout/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/edd-helpscout/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/edd-helpscout/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/edd-helpscout/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/edd-helpscout/reviews/)

## Contributors

 *   [ flowdee ](https://profiles.wordpress.org/flowdee/)
 *   [ Thomas Maier ](https://profiles.wordpress.org/webzunft/)
 *   [ Danny van Kooten ](https://profiles.wordpress.org/dvankooten/)
 *   [ ibericode ](https://profiles.wordpress.org/ibericode/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/edd-helpscout/)