Conversation Embeds
DeskPress lets you embed a single Help Scout conversation thread on any WordPress page or post. This is useful for sharing resolved conversations publicly as knowledge base articles, or for internal reference.
How to Access
Use the [hsd_thread] shortcode in any page, post, or widget that supports shortcodes.
Configuration Walkthrough
Step 1: Find the Conversation ID
- In Help Scout, open the conversation you want to embed.
- Look at the URL in your browser. It will look something like:
https://secure.helpscout.net/conversation/123456/789/
- The number after
/conversation/is your conversation ID (in this example,123456).
Step 2: Add the Shortcode
- Edit the WordPress page or post where you want the conversation to appear.
- Add the shortcode with the conversation ID:
[hsd_thread id="123456"]- Publish or update the page.
Step 3 (Optional): Specify a Mailbox
If you have multiple mailboxes and need to target a specific one, include the mailbox ID:
[hsd_thread id="123456" mid="78910"]Settings Reference
| Attribute | Required | Default | Description |
|---|---|---|---|
| id | Yes | -- | The Help Scout conversation ID to embed. |
| mid | No | (none) | The mailbox ID. Only needed if you want to specify a particular mailbox. |
Tips and Common Questions
Q: What does the embedded conversation look like?
The full conversation thread is displayed, including all messages, attachments, and status information. It uses DeskPress's built-in styling to blend with your site.
Q: Can I embed multiple conversations on one page?
Yes. Add multiple [hsd_thread] shortcodes, each with a different conversation ID.
Q: Is the embedded conversation updated in real time?
The conversation content is fetched from Help Scout each time the page loads. So visitors will see the latest version, but there is no live auto-refresh.
Q: Can I use this for private/internal conversations?
You can, but keep in mind that anyone who can view the WordPress page will see the conversation. Make sure you are comfortable with the content being visible to your audience.
Q: Where do I find the mailbox ID?
In Help Scout, go to Manage > Mailboxes, select a mailbox, and check the URL. The number in the URL is the mailbox ID.
Related documentation: