zulip/zerver/webhooks/slack/doc.md

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

See also the Slack-compatible webhook.

1. {!create-channel.md!}

2. {!create-an-incoming-webhook.md!}

3. {!generate-integration-url.md!}

   If you'd like to map Slack channels to different topics within the same channel, add &channels_map_to_topics=1 to the end of the URL. Note that this should be used instead of specifying a topic in the URL. If a topic is specified in the URL, then it will be prioritized over the channel to topic mapping.

   If you'd like to map Slack channels to different channels, add &channels_map_to_topics=0 to the end of the URL. Make sure you create channels for all your public Slack channels (see step 1), and that the name of each channel is the same as the name of the Slack channel it maps to. Note that in this case, the channel to channel mapping will be prioritized over the channel specified in the URL.

4. Go to https://my.slack.com/services/new/outgoing-webhook and click Add Outgoing WebHooks integration.

5. Scroll down and configure the Channel and/or Trigger Word(s) options as appropriate. Set URL(s) to the URL constructed above, and click Save Settings.

{!congrats.md!}