Flock


Schemes	`flock://`
Cargo feature	`service-flock`
Service	https://flock.com/
Body formats	`text` (first is the default)
Attachments	no
Title length	250 characters
Body length	32,768 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	yes

URL formats

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

{schema} is one of flock://.

URL tokens

Token	Meaning	Type	Required	Notes
`{botname}`	Bot Name	string	no
`{targets}`	Targets	list	no	any of `to_channel`, `to_user`; separated by `/`
`{to_channel}`	To Channel ID	string	no	prefix `#`; must match `^[A-Z0-9_]+$`
`{to_user}`	To User ID	string	no	prefix `@`; must match `^[A-Z0-9_]+$`
`{token}`	Access Key	string	yes	secret; must match `^[a-z0-9-]+$`

Query parameters

Parameter	Meaning	Type	Default	Notes
`image`	Include Image	bool	`yes`
`to`	Targets	list		sets `{targets}`

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):

flock://tttttttttttttttttttttttt
flock://mybot@tttttttttttttttttttttttt
flock://iiiiiiiiiiiiiiiiiiiiiiii/g:/u:abc
https://api.flock.com/hooks/sendMessage/iiiiiiiiiiiiiiiiiiiiiiii/
flock://tttttttttttttttttttttttt?image=False
flock://iiiiiiiiiiiiiiiiiiiiiiii?format=text
flock://iiiiiiiiiiiiiiiiiiiiiiii/u:uuuuuuuuuuuu?format=html
flock://iiiiiiiiiiiiiiiiiiiiiiii/g:gggggggggggg/u:uuuuuuuuuuuu/%23chan/%40user?format=text

Rejected URLs:

flock://
flock://:@/
flock://bad_token!
flock://iiiiiiiiiiiiiiiiiiiiiiii/g:/u:?format=text

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'flock://tttttttttttttttttttttttt'

Notes

Flock (flock://): messages to Flock channels or users through a webhook or bot token.