Slack

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 that the token uses a prefix to determine the type, usually either hook (for webhooks) or xoxb (for bot API).

URL Fields

• Token - API Bot token (Required)
  URL part: slack://token:token@channel/

• Channel - Channel to send messages to in Cxxxxxxxxxx format (Required)
  URL part: slack://token:token@channel/

Query/Param Props

Props can be supplied through URL query params: ?key=value&key=value etc.

• BotName - Bot name
  Default: empty Aliases: username

• Color - Message left-hand border color
  Default: empty

• Icon - Use emoji or URL as icon (based on presence of http(s):// prefix)
  Default: empty
  Aliases: icon_emoji, icon_url

• ThreadTS - ts value of the parent message (to send message as reply in thread)
  Default: empty

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 #BADA55 would be %23BADA55 etc.

Examples

Bot API

slack://xoxb:123456789012-1234567890123-4mt0t4l1YL3g1T5L4cK70k3N@C001CH4NN3L?color=good&title=Great+News&icon=man-scientist&botname=Shoutrrrbot

Webhook

slack://hook:WNA3PBYV6-F20DUQND3RQ-Webc4MAvoacrpPakR8phF0zi@webhook?color=good&title=Great+News&icon=man-scientist&botname=Shoutrrrbot `