Set up Zulip notifications using the discourse-chat-integration plugin


(David Taylor) #1

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

Install

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

Set up Zulip

  1. In your Zulip settings, go to the Bots tab

  2. Under the add a new bot view, enter the bot type, a name, an email, and optionally an avator for your bot.

  3. Select the “Incoming Webhook” type for the bot

  4. Click Create Bot

  5. Copy down the API Key and email address, you’ll need it later

Set up Discourse

  1. In your Discourse site settings, enter your Zulip server address in the chat_integration_zulip_server setting. Make sure to include the protocol. (e.g. https://chat.zulip.org)

  2. Paste the API Key you copied earlier into the chat_integration_zulip_bot_api_key site setting

  3. Paste the email address you copied earlier into the chat_integration_zulip_bot_email_address site setting

  4. Enable chat_integration_zulip_enabled

  5. Go to the Plugins tab, then Chat Integration

  6. Go to the Zulip tab, then Add Channel

  7. Enter a Stream that you want to send the notifications to, and a Subject to attach to the messages

  8. Save Channel

  9. Use the Test button on the channel you just created to check that everything’s working. You should see something like this:

  10. Set up some “Rules” for your channel, according to the discourse-chat-integration instructions.


Open external links in new tab not working when link is within a quote block