Connect your Help Scout account to your WooCommerce-powered store.
This extension helps your customers to easily start informative conversations and send them to your Help Scout, as well as for you to connect a customer in Help Scout with their information in your WooCommerce-powered store.
- A HelpScout account – sign up or log in at HelpScout.net
- Download the .zip file from your WooCommerce account.
- Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
- Install Now and Activate the extension.
More information at: Install and Activate Plugins/Extensions.
Setup and Configuration
To set up WooCommerce Help Scout:
- Go to WooCommerce > Settings > Integration.
- Configure your settings:
- Enter the API Key from your HelpScout account
- Enter the Mailbox ID from your HelpScout account
- Enter the Profile ID from your HelpScout account in Assigned To (optional)
- Enter customer email addresses in Conversation CC and Conversation BCC (both optional)
- Enable Debug Log when troubleshooting. Otherwise, leave disabled.
- Save changes.
Find your API key
To generate your API key, you need to create an OAuth2 application:
- Log in to your Help Scout account and select Your Profile from the top right menu.
- Navigate to “My Apps” on the left-hand sidebar and click “Create My App”.
- Name the app something that is easy to remember. As for the redirection URL, this can be obtained from the plugin’s settings page within WordPress. Paste the URL into this field and click “Create”.
- After an app is created, you will be able to access the App ID and App Secret Key. Use “APP ID” as “App Key” and “App Secret” as App Secret inside your plugin settings.
Find your Mailbox ID
To locate your Mailbox ID:
- Go to: Mailbox > Mailbox Settings > Edit Mailbox.
- Look at the URL in your Web browser to find the Mailbox ID.
- For “Assigned To” option, Enter the user ID responsible for conversations. Find this in the “Your Profile” page URL, example: https://secure.helpscout.net/users/profile/USER-ID-HERE/.
Where 123456 is the mailbox ID.
Find your Profile ID (optional)
To locate your Profile ID:
- Go to Your Profile in the top right menu.
- Look at the URL in your Web browser to find the Profile ID.
Where 123456 is the profile ID.
This step is optional. If you do not add an ID, the conversation will be created as Unassigned.
After filling out all of the required fields in the Help Scout settings page, a green “Allow Access” button will appear. Upon clicking this button, you can authenticate the connection and allow Help Scout to work with WooCommerce.
Starting Help Scout conversations
WooCommerce Help Scout 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 start a new conversation within Help Scout. The various implementations of this are described below.
Customer – Create a conversation for an order
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.
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 Help Scout conversation, by providing a subject line and description.
Provide a Subject and Description and click Send. You’ve now sent a conversation to Help Scout, to help get your query attended to.
Store Owner – Start a conversation for an order
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 start a new conversation, relating to a specific order.
To use this form, fill in the Subject and Description and click the Start Conversation button. A new ticket will be created in Help Scout, without reloading the screen. You will be notified of the conversation URL once the conversation has been created.
A link to the conversation is provided for you, once the conversation has been created.
Store Owner – Start conversation from a blog comment
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 Help Scout conversation to help speed up the resolution time.
Visit the Comments section of your WordPress admin. Locate the comment and click the Create a Conversation button alongside it.
Easily convert a blog post comment into a conversation. Delivering happiness on all fronts.
Connecting Help Scout
Help Scout provides a sidebar block, directly when viewing a conversation within Help Scout, to display WooCommerce data for the customer taking part in the conversation.
Part of setting this up is to enable the WooCommerce REST API.
For information on how to enable the REST API within WooCommerce, please see our documentation.
Use the follow shortcode to create a conversation form for customers and guests:
Logged in customer
Guest users – non-logged in users
Questions and Feedback
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.