Files
zulip/zerver/webhooks/slack/doc.md
Lauryn Menard 1618060a3e integrations-docs: Update both Slack integration articles.
Updates the Slack integration page to not describe adding a stream
or topic parameter to the URL query since that's not supported by
the current integration implementation.

Updates the Slack-compatible webhook integration page to have the
extra notes about the integration at the top of the page. Also,
removes the reference to a screenshot of the webhook since there
isn't one.
2023-11-07 12:59:24 -08:00

1.2 KiB

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

See also the Slack-compatible webhook.

  1. {!create-stream.md!}

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

    Construct the URL for the {{ integration_display_name }} bot using the bot's API key:

    {{ api_url }}{{ integration_url }}?api_key=abcdefgh

    If you'd like to map Slack channels to different topics within the same stream, add &channels_map_to_topics=1 to the end of the URL. This is the default behavior of the integration.

    If you'd like to map Slack channels to different streams, add &channels_map_to_topics=0 to the end of the URL. Make sure you create streams for all your public Slack channels, and that the name of each stream is the same as the name of the Slack channel it maps to.

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

  4. 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!}