WeCom Bot


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

URL formats

{schema}://{key}

{schema} is one of wecombot://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{key}`	Bot Webhook Key	string	yes		secret; must match `^[a-z0-9_-]+$`

Query parameters

Parameter	Meaning	Type	Default	Notes
`key`	Bot Webhook Key	string		sets `{key}`

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

wecombot://botkey
wecombot://?key=botkey
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=BOTKEY
wecombot://other/?key=bot_key-2
https://qyapi.weixin.qq.com/cgi-bin/webhook/send/?key=BOTKEY&data=123
http://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=abc-123&format=markdown

Rejected URLs:

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?other=1
wecombot://
wecombot://:@/
wecombot://bot.key

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'wecombot://botkey'

Notes

WeCom Bot (wecombot://): messages through WeCom group bot webhooks.