MemberPress HelpScout / FreeScout Add-on Setup

The MemberPress HelpScout add-on will import your members' data directly into the tickets they open in your HelpScout or FreeScout.

This document will show you how to integrate HelpScout or FreeScout with MemberPress and explain how the integration works.

Set Up The Integration in MemberPress

Setting up the integration requires an active MemberPress HelpScout add-on on your site and a custom HelpScout or FreeScout app.

Install MemberPress HelpScout Add-on

To start, install and activate the add-on by following these steps:

1. Navigate to Dashboard > MemberPress > Settings > Add-ons.
2. Browse add-ons or search for HelpScout using the search tool.

3. Once you find the add-on, click the Install Add-on button. This will automatically install and activate the add-on.

Helpdesk Custom App Details in MemberPress

Now that you have activated the add-on on your site, you will need your integration details:

1. Navigate to Dashboard > MemberPress > Settings > General tab, and scroll down to the Helpdesk section.
2. Check the Enable Helpdesk App option.
3. Under the Helpdesk Provider, select HelpScout or FreeScout. This will show you the custom app details you need for the integration.

4. Here, you'll find your Callback URL, which will be automatically generated.
5. Also, you will need to set your Secret Key. You can type in any key you want.
6. Scroll down and click Update Options to save your HelpScout add-on settings.

You will need your Callback URL and the Secret Key to create a custom app in HelpScout.

Integrating MemberPress With HelpScout/FreeScout

You should add your MemberPress custom app details to enable communication between MemberPress and your helpdesk solution (HelpScout or FreeScout).

Below, you can find details on creating integration with HelpScout.

Note: To integrate MemberPress with FreeScout, you must install the Sidebar Webhook module.

Create A Custom App in HelpScout

To integrate MemberPress with HelpScout, you'll need to create a custom app in the HelpScout account.

1. Log in to your HelpScout account as an administrator (or the account owner).
2. Navigate to Manage > Apps, and click the Create button in the top-right corner.

3. Next, click Create App on the left side to start the app setup.

4. To create a custom app, fill in the details in the form:
   • App Name: give your custom app a name. You can choose any name here;
   • Callback URL: copy the HelpScout Callback URL from your MemberPress settings and paste the URL here.
   • Secret Key: copy the HelpScout Secret Key you added to MemberPress settings, and paste it here.

Note: The Secret Key saved in MemberPress settings, and the one used for the custom app must match.

5. Choose which MailBoxes you want MemberPress to connect to.
6. Click Save to create the app.

You completed the integration process by creating the HelpScout app.

Using The Integration

With the integration all set, your tickets will now contain the users' membership-related data.

Therefore, whenever any user submits a ticket, HelpScout will display MemberPress data for that user in the right-hand sidebar.

Note: The user's MemberPress data will be transferred to HelpScout based on the user's email. Accordingly, data is shown if the user submitted the ticket using the same email used to register on your website.

The user data transferred from your MemberPress site to HelpScout will include:

• User: the WordPress username related to the user;
• Email: the email related to the user in MemberPress;
• Joined: the date on which the user was created on your site;
• Membership: the name of the membership the user is subscribed to;
• Transaction: the transaction related to the user's membership;
• Subscription: the subscription related to the user's membership.

In addition, the integration will display three buttons:

• User Profile: direct link to the user's WordPress profile on your site;
• Transactions: direct link to the list of all user's transactions in MemberPress;
• Subscriptions: direct link to the list of all user's transactions in MemberPress.

Note: When you click on any of the buttons mentioned above, you will be redirected to your website's backend. Thus, accessing these pages will require you to log in as an administrator to your website.