integration-docs: Update Discourse for new doc format.

Part of zulip#29592.
This commit is contained in:
Niloth P
2024-11-14 17:31:38 +05:30
committed by Tim Abbott
parent fde3e01236
commit f57768f4c4
2 changed files with 33 additions and 11 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 123 KiB

View File

@@ -1,16 +1,38 @@
# Zulip Discourse integration
Forward new Discourse posts to Zulip!
{start_tabs}
1. {!create-an-incoming-webhook.md!}
The API keys for "Incoming webhook" bots are limited to only
sending messages via webhooks. Thus, this bot type lessens
the security risks associated with exposing the bot's API
key to third-party services.
1. Install the Discourse [Chat Integration][chat-integration].
1. Copy the `USERNAME` and `API KEY` - you'll need it later.
1. In your **Discourse site settings**, toggle
`chat_integration_zulip_enabled`, and fill in the following information:
1. Head over to the
[discourse-chat-integration setup instructions](https://meta.discourse.org/t/68501)
and complete them.
* `chat_integration_zulip_server`: {{ zulip_url }}
* `chat_integration_zulip_bot_api_key`: your bot's API key
* `chat_integration_zulip_bot_email_address`: your bot's email
{!congrats.md!}
1. Go to the **Plugins** tab, click on **Chat Integration**. Select
**Zulip**, and click **Add Channel**.
![Discourse chat integration](/static/images/integrations/discourse/001.png)
1. Set **Stream** to the [channel](/help/create-a-channel) name that you'd
like to receive notifications in, set **Subject** to the topic name, and
click **Save Channel**.
1. To filter the posts you'd like to forward to Zulip,
[configure the rules][configuring-rules] in your Discourse forum's
**Chat Integrations** panel.
{end_tabs}
### Related documentation
- [Discourse Chat Integration][chat-integration]
- [Discourse's documentation on the Zulip integration][setup-instructions]
[setup-instructions]: https://meta.discourse.org/t/68501
[chat-integration]: https://meta.discourse.org/t/discourse-chat-integration/66522
[configuring-rules]: https://meta.discourse.org/t/discourse-chat-integration/66522#configuring-rules-4