Discourse Integration

​

Data Collection

​

Members

• Full Name
• Username
• Email
• Job Title if provided
• Avatar
• Locale if provided
• Tags
• User Fields
• Joined Date

​

Community Activity

• Topics from all categories
• Replies to topics
• Reactions on posts
• Replies marked as solved
• Invitations

​

Activity Types

• Invitation
• Post marked as solved
• Write a topic
• Reply to topic
• Join Discourse community
• Add reaction
• Login

​

Real-Time Updates

• Members joining the workspace
• Members updates
• Members deleted
• Categories, created, updated and deleted
• Topics, edited, deleted and recovered
• Posts, edited, deleted and recovered
• Reactions added
• Badges granted and revoked
• Accept / unaccept post as solution

​

Setup Guide

1

Connect Your Community

1. Navigate to Settings > Integrations
2. Select Discourse
3. Click “Enable” to start the connection process

2

Configure API / Webhook

Complete the API / Webhook configuration process on Discourse.

You must be an admin of the Discourse community.

​

API

​

Api Key

You can create an API key by navigating to Admin > Advanced > API Keys > Add API Key. Add a description to avoid revoking it.

​

User Level

Select “All users”

​

Scope

Select “Read Only”

​

User Fields

If you have custom user fields, you can add them here. Add**“.json”** to the end of your community URL, eg:“https://your-discourse-community/admin/config/user-fields.json”.You will get a JSON response like this:

Add the ID and name from the JSON response into the form fields.

You can add multiple custom fields by clicking the “Add field” button and repeating this process.

​

Webhook

You can create a webhook by navigating to Admin > Advanced > Webhooks > Add Webhook

​

Payload URL

Add the following URL: https://app.useconquest.com/webhook/discourse

​

Content Type

Select “application/json”

​

Secret

Add a secret provided by Conquest. (It is used to verify the webhook)

This signature is essential for webhook authentication. Without it, we cannot create activities and sync your community in real-time.

​

Events

Select “Send me everything”

​

Active

Select “Active”

Then click on “Create”

3

Data Collection

Conquest will begin importing historical data.

We only collect data from the last 365 days.

4

Select Channels

Once authorized, you’ll be redirected to Conquest to select public channels for data collection.

1. Select the channels you want to collect data from

​

Missing channels?

Verify that the category has security group set on “everyone”

5

Configure Activity Types

Conquest will automatically generates activity types based on the data collected. You can add conditions on specific channels to fit your community’s scoring system.

​

FAQ

​

Need Help?