1.5 KiB
Slack
!!! attention "New URL format"
The URL format for Slack has been changed to allow for API- as well as webhook tokens.
Using the old format (slack://xxxx/yyyy/zzzz) will still work as before and will automatically be upgraded to
the new format when used.
The Slack notification service uses either Slack Webhooks or the Bot API to send messages.
See the guides for information on how to get your token and channel.
URL Format
!!! note ""
Note that the token uses a prefix to determine the type, usually either hook (for webhooks) or xoxb (for bot API).
--8<-- "docs/services/slack/config.md"
!!! info "Color format"
The format for the Color prop follows the slack docs
but # needs to be escaped as %23 when passed in a URL.
So #ff8000 would be %23ff8000 etc.
Examples
!!! example "Bot API"
uri slack://xoxb:123456789012-1234567890123-4mt0t4l1YL3g1T5L4cK70k3N@C001CH4NN3L?color=good&title=Great+News&icon=man-scientist&botname=Shoutrrrbot
!!! example "Webhook"
uri slack://hook:WNA3PBYV6-F20DUQND3RQ-Webc4MAvoacrpPakR8phF0zi@webhook?color=good&title=Great+News&icon=man-scientist&botname=Shoutrrrbot