zulip/zerver/webhooks/slack/doc.md

1.8 KiB

Get notifications from Slack for messages on your team's public channels!

There are two ways in which you may want to receive a notification:

  • Slack Channel to a single Zulip stream with different topics
  • Multiple Zulip streams for multiple Slack channels

Single stream with different topics

{!create-stream.md!}

{!create-bot-construct-url.md!}

If you'd like to receive notifications to a single stream with different topics for different Slack channels, append &channels_map_to_topics=1 to the above URL.

Multiple Zulip streams for multiple Slack channels

First, create streams for all of your Slack channels. Make sure that the name of a given stream is the same as the name of the Slack channel it maps to.

{!create-bot-construct-url.md!}

If you'd like your Slack channels to be mapped to multiple Zulip streams, append &channels_map_to_topics=0 to the above URL.

Configuring the webhook

Go to the following URL: https://api.slack.com

Next, under the category of App features click on Legacy custom integrations.

Now, click on Outgoing Webhooks under Custom Integrations.

Then click the hyperlink outgoing webhook integration which can be found in the page.

Next, click the Add Outgoing Webhook integration button.

Now, under Integration Settings, fill in the channel you'd like to get your notifications from.

Then fill in the URL created above as your URL. Finally, save your settings.

{!congrats.md!}

This integration is not created by, affiliated with, or supported by Slack Technologies, Inc.