Conversations & Community Help Center

Introduction

With Conversations, crowd.dev automatically detects discussions that are going on in your community. On the one hand, this will help you to keep a better overview of discussed topics. What's even more exciting is that you can use Conversations to auto-generate Community Help Center. Thereby, you can:

  • Auto-generate support content
  • Make your community discoverable by Google
  • Reduce duplicate questions and support effort

Take a look at this example, which is created based on our Discord community.

How to set-up

General set-up

To set up your community help center, simply navigate to the Conversations page.

🚧

Refresh settings

If you have used the Community Help Center before August 5, 2022, you have to refresh the Settings by saving them once. After this, you should be able to see the new Community Help Center settings (including auto-publishing).

Click Settings and fill out the following details.

General

  • Community Name: Display name of your community
  • Community Slug: Unique identifier for your community (will be later used to create your public URL: open.crowd.dev/{communitySlug} - can’t be changed later!

Community links

  • Website: URL of your community/company (the link behind Home)
  • Discord URL: Permanent Discord invite link (will be used to let visitors join your Discord) - learn here how to create one
  • Slack URL: Permanent Slack invite link (will be used to let visitors join your Slack)
  • GitHub URL: Link to your GitHub organization page or repo

Auto-publishing
For auto-publishing conversations to your community help center, you have three options:

  • None: No conversation is going to be published automatically.
  • Specific channels: Conversations from selected channels will automatically be published.
  • All channels: All conversations will automatically be published.

Once you choose an option and save it, it will affect all past conversations in that channel!

Theming

  • Logo URL: The logo that will be displayed in the upper right corner. (Recommended size: 240x60 pixels)
  • Favicon URL: The icon that will be displayed in the browser tab. (Recommended size: 32x32 pixels)
  • Colors: The different colors of your community help center. We recommend playing around with it to see how it affects the appearance.

That's it. Click *save* and your community help center will automatically be created/changed.

Custom domain set-up (Premium only)

To set up a custom domain to your help center, simply navigate here.

Click on the Settings button and add your custom domain (ex: help.crowd.dev) into the following input:

Next, add your a CNAME record to your DNS pointing to open.crowd.dev like the following example:

12231223

Review and edit existing Conversations

You should see conversations in a list view:

27122712
You can click on each conversation and view it in detail: 27262726
You can also edit the title of the conversation by clicking on the ✏️ icon. Please note: A changed title will affect your titleSlug before you publish a conversation for the first time: *open.crowd.dev/{tenantSlug}/{titleSlug}*

Filter & Sort Conversations

Active communities often have 100s and 1000s of conversations. To stay on top of it, the conversations module has a variety of filter and sorting options:

  • Title: Filter or sort by keywords in the conversation title (usually the first message of conversation)
  • Status: Filter by the publishing status of the conversation (published/unpublished)
  • Number of Activities: Sort by the number of activities/replies a conversation received
  • Last active: Sort by the timestamp of the latest activity/reply that got added to the conversation
  • Platform: Filter by platform (Discord, Slack, Github, etc.)
  • Channel: Filter by channel (e.g. #support on your Discord)

To sort conversations, simply click on the table header to sort the referring column either ascending or descending.

To filter conversation, either use the quick filters on top (for Status and Platforms) or click on Filters, select your desired options, and confirm with Apply Filters.

27282728 27102710

Auto-publish Conversations

To auto-publish conversations to your community help center, simply go to the settings and choose an auto-publishing option. You can choose between:

  • None: No conversation is going to be published automatically.
  • Specific channels: Conversations from selected channels will automatically be published.
  • All channels: All conversations will automatically be published.

Once you picked an option and saved it, it will affect all past conversations in that channel!

Publish selected Conversations

To publish selected conversations to your community help center, you have two options:


Option 1: Bulk publish conversations in the conversations list view

This option also works well with filters and helps you to publish several conversations at once. (Tip: To maximize the number of selected conversations, you can set the pagination to 100/page at the bottom of the table.)

27102710

Option 2: Publish a conversation in the conversations list view

27262726

After publishing, your conversation will be shown on open.crowd.dev/{tenantSlug}.

You can simply use Unpublish Conversations to remove them from the public page again.

What’s next

Please note that this feature is currently in alpha. For the next releases we plan to:

  • Add more filters and pre-selection support to identify Conversations worth publishing

What else are you missing? Feel free to add it to our public roadmap.