Create a Discourse webhook

Common Room’s Discourse integration uses a webhook to receive new activity as it occurs. To configure the webhook, you'll first have to connect the Discourse API to Common Room.

Setup

To setup the webhook, you'll need to have both Common Room and Discourse open in separate windows.

• In Common Room, open the Discourse signal settings; you should be on step 3 (Create your Discourse webhook).
• In Discourse, open the Webhooks settings by navigating to Settings → Admin → API → Webhooks.

Follow the guide below after opening both Common Room and Discourse.

1. Copy the payload URL from Common Room and paste it into Discourse.
2. Copy the webhook secret from Common Room and paste it into Discourse.
3. Scroll down the page and check the options Send me everything, Check TLS certificate, and Active.
4. Test the webhook by clicking the Ping button. Note that you may need to log out and back into Discourse to successfully ping the webhook. When the ping works correctly, you'll see a Successful delivery status in the webhook settings.
5. Enable webhook retries by opening the Settings tab in Discourse, and enabling the option to "retry webhook events".