Skip to content

Zulip Chat

URL Format

The shoutrrr service URL should look like this:

zulip://botmail:botkey@host/?stream=stream&topic=topic

URL Fields

  • BotMail - Bot e-mail address (Required)
    URL part: zulip://botmail:botkey@host:port/
  • BotKey - API Key (Required)
    URL part: zulip://botmail:botkey@host:port/
  • Host - API server hostname (Required)
    URL part: zulip://botmail:botkey@host:port/

Query/Param Props

Props can be either supplied using the params argument, or through the URL using
?key=value&key=value etc.

  • Stream
    Default: empty

  • Topic
    Default: empty
    Aliases: title

Note

Since botmail is a mail address you need to URL escape the @ in it to %40.

Examples

Stream and topic are both optional and can be given as parameters to the Send method:

  sender, _ := shoutrrr.CreateSender(url)

  params := make(types.Params)
  params["stream"] = "mystream"
  params["topic"] = "This is my topic"

  sender.Send(message, &params)

Example service URL

zulip://my-bot%40zulipchat.com:correcthorsebatterystable@example.zulipchat.com?stream=foo&topic=bar