Discourse Topic Audit

Number of APIs: 2

Discourse

Qodex's community has transitioned to Discourse!

Although we can't get to every topic posted, we wanted to flag topics that hadn't received attention, and surface them internally (Slack) so that someone on our team could respond.

We decided to leverage our Monitoring service to run our audit periodically.

Criteria

We prioritized topics posted in Just Getting Started and Help. We all know how it feels to be new to a tool or framework, or spend hours scouring the ‘interweb’ for answers to your questions.

Topics that hadn't been responded to within twelve (12) hours of being posted/bumped seemed like a good place to start. We also didn't want to surface topics that may have already been answered by other forum-goers, so that's the last criteria.

Getting Started

Before you can successfully run the monitor, you'll need to update a few of the Environment Variables in the environment template provided.

Environment Variable Name	Description
`discourseForumUrl`	The URL to the Discourse forum you'd like to monitor. Ours is [https://community.getQodex.com](https://community.getQodex.com)
`apiKey`	This value will need to be generated by a forum Administrator. [See Discourse API documentation for more information]((http://docs.discourse.org/#tag/Admin%2Fpaths%2F~1admin~1users~1%7Bid%7D~1generate_api_key%2Fpost).
`webhook`	[A Slack webhook URL](https://api.slack.com/incoming-webhooks)

Setting up a Monitor

Once you have all of the necessary environment variables, you'll want to set up a monitor so that the collection runs periodically.

Get The Latest Posts GET {{base_url}}/latest.json
Post Flagged Topics to Slack POST {{webhook}}