Zulip


Schemes	`zulip://`
Cargo feature	`service-zulip`
Service	https://zulipchat.com/
Body formats	`text` (first is the default)
Attachments	no
Title length	60 characters
Body length	10,000 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{botname}@{organization}/{token}
{schema}://{botname}@{organization}/{token}/{targets}

{schema} is one of zulip://.

URL tokens

Token	Meaning	Type	Required	Notes
`{botname}`	Bot Name	string	yes	must match `^[A-Z0-9_-]{1,32}$`
`{organization}`	Organization	string	yes	must match `^[A-Z0-9_-]{1,32}$`
`{target_stream}`	Target Stream	string	no
`{target_user}`	Target User	email	no
`{targets}`	Targets	list	no	any of `target_stream`, `target_user`; separated by `/`
`{token}`	Token	string	yes	secret; must match `^[A-Z0-9]{32}$`

Query parameters

Parameter	Meaning	Type	Default	Notes
`to`	Targets	list		sets `{targets}`
`token`	Token	string		sets `{token}`

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

zulip://bot-name-bot@mercurio/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
zulip://botname@mercurio/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/%23mystream
zulip://botname@mercurio/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/channel2/channel1
zulip://botname@mercurio/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/?to=channel1/channel2%23chan3
zulip://botname@mercurio/streamA?token=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
zulip://botname@mercurio/?token=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&to=channel1

Rejected URLs:

zulip://
zulip://:@/
zulip://mercurio
zulip://botname@mercurio

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'zulip://bot-name-bot@mercurio/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'

Notes

Zulip (zulip://): messages to Zulip streams and users through a bot.