Set up Rocket Chat notifications using the discourse-chat-integration plugin


(David Taylor) #1

This #howto describes how to setup the Rocket.Chat provider included in discourse-chat-integration.

Install

If you haven’t already, install the discourse-chat-integration plugin

Notifications

Set up Rocket Chat

Your Rocket Chat server needs to be accessible from your Discourse server in order to connect them. It is recommended that you use HTTPS, but HTTP should also work.

  1. Log in to your Rocket Chat server, click your name in the top left, then click Administration

  2. Under Integrations, click New Integration

  3. Choose Incoming Webhook

  4. Fill out the form to define how you want your bot to look inside Rocket Chat. Under “Post to Channel”, you can enter any channel name (e.g. #general). This will be overridden by Discourse, so it doesn’t matter which.

  5. Set “Enabled” to “True”

  6. Save Changes

  7. Copy the “Webhook URL”, you’ll need it later

Setup Discourse

  1. Paste the URL you copied into the chat_integration_rocketchat_webhook_url site setting

  2. Enable chat_integration_rocketchat_enabled

  3. Setup some “Rules” for your channels, according to the discourse-chat-integration instructions. Channel identifiers look like #general or @davidtaylor.

  4. Click Test on one of the channels to check everything’s working. You should receive a message like this:

  5. :rocket: