Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/zerver/webhooks/slack/doc.md

35 lines
1.3 KiB
Markdown
Raw Normal View History

webhooks/slack: Update docs to conform to style guide.
2018-05-17 15:52:24 +02:00
Get Zulip notifications from Slack for messages on your team's
public channels!
webhooks/slack: Migrate docs to markdown.
2017-06-07 22:05:55 +02:00
docs: Advertise Slack-compatible webhook a bit. This should make it discoverable enough that users will try it out and send us feedback.
2020-05-09 20:22:11 +02:00
See also the [Slack-compatible webhook](/integrations/doc/slack_incoming).
webhooks/slack: Update docs to conform to style guide.
2018-05-17 15:52:24 +02:00
1. {!create-stream.md!}
webhooks/slack: Migrate docs to markdown.
2017-06-07 22:05:55 +02:00
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 16:06:16 +01:00
1. {!create-an-incoming-webhook.md!}
webhooks/slack: Migrate docs to markdown.
2017-06-07 22:05:55 +02:00
integrations: Update Slack webhook to use check_send_webhook_message. Due to the channel_map_to_topics URL parameter in the Slack webhook, it was not migrated to use the check_send_webhook_message. By using check_send_webhook_message, any topic parameter in the webhook URL will be prioritized over mapping Slack channels to topics, e.g. when channel_map_to_topics is true. This is because the default behaviour for incoming webhooks is to send a default topic as a parameter to check_send_webhook_message in case there is no topic specified in the URL. In contrast, we can override the stream passed in the URL when channel_map_to_topics is false by passing the Slack channel name to check_send_webhook_message. The default behaviour for incoming webhooks is to send a direct message if there is no specified stream in the URL, so a default stream is not generally passed to check_send_webhook_message. Fixes #27601.
2024-02-15 12:25:57 +01:00
1. {!generate-integration-url.md!}
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 16:06:16 +01:00
integrations: Update Slack webhook to use check_send_webhook_message. Due to the channel_map_to_topics URL parameter in the Slack webhook, it was not migrated to use the check_send_webhook_message. By using check_send_webhook_message, any topic parameter in the webhook URL will be prioritized over mapping Slack channels to topics, e.g. when channel_map_to_topics is true. This is because the default behaviour for incoming webhooks is to send a default topic as a parameter to check_send_webhook_message in case there is no topic specified in the URL. In contrast, we can override the stream passed in the URL when channel_map_to_topics is false by passing the Slack channel name to check_send_webhook_message. The default behaviour for incoming webhooks is to send a direct message if there is no specified stream in the URL, so a default stream is not generally passed to check_send_webhook_message. Fixes #27601.
2024-02-15 12:25:57 +01:00
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. 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.
webhooks/slack: Restructure docs to use create-stream.md macro.
2017-06-20 02:52:48 +02:00
webhooks/slack: Update docs to conform to style guide.
2018-05-17 15:52:24 +02:00
If you'd like to map Slack channels to different streams, add
integrations: Update Slack webhook to use check_send_webhook_message. Due to the channel_map_to_topics URL parameter in the Slack webhook, it was not migrated to use the check_send_webhook_message. By using check_send_webhook_message, any topic parameter in the webhook URL will be prioritized over mapping Slack channels to topics, e.g. when channel_map_to_topics is true. This is because the default behaviour for incoming webhooks is to send a default topic as a parameter to check_send_webhook_message in case there is no topic specified in the URL. In contrast, we can override the stream passed in the URL when channel_map_to_topics is false by passing the Slack channel name to check_send_webhook_message. The default behaviour for incoming webhooks is to send a direct message if there is no specified stream in the URL, so a default stream is not generally passed to check_send_webhook_message. Fixes #27601.
2024-02-15 12:25:57 +01:00
`&channels_map_to_topics=0` to the end of the URL. Make sure you create
streams for all your public Slack channels *(see step 1)*, and that the
name of each stream is the same as the name of the Slack channel it maps
to. Note that in this case, the channel to stream mapping will be
prioritized over the stream specified in the URL.
webhooks/slack: Restructure docs to use create-stream.md macro.
2017-06-20 02:52:48 +02:00
webhooks/slack: Update docs to conform to style guide.
2018-05-17 15:52:24 +02:00
1. Go to <https://my.slack.com/services/new/outgoing-webhook>
and click **Add Outgoing WebHooks integration**.
webhooks/slack: Restructure docs to use create-stream.md macro.
2017-06-20 02:52:48 +02:00
webhooks/slack: Update docs to conform to style guide.
2018-05-17 15:52:24 +02:00
1. 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**.
webhooks/slack: Migrate docs to markdown.
2017-06-07 22:05:55 +02:00
{!congrats.md!}
webhooks/slack: Update docs to conform to style guide.
2018-05-17 15:52:24 +02:00
![](/static/images/integrations/slack/001.png)