Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

DingTalk

Schemesdingtalk://
Cargo featureservice-dingtalk
Servicehttps://www.dingtalk.com/
Body formatstext, markdown (first is the default)
Attachmentsno
Title length250 characters
Body length32,768 characters
Body linesunlimited
Request throttlenone
Vendor URLs acceptedno

URL formats

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

{schema} is one of dingtalk://.

URL tokens

TokenMeaningTypeRequiredDefaultNotes
{secret}Secretstringnosecret; must match ^[a-z0-9]+$
{target_phone_no}Target Phone Nostringno
{targets}Targetslistnoany of target_phone_no; separated by /
{token}Tokenstringyessecret; must match ^[a-z0-9]+$

Query parameters

ParameterMeaningTypeDefaultNotes
secretSecretstringsets {secret}
toTargetslistsets {targets}
tokenTokenstringsets {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):

dingtalk://12345678
dingtalk://aaaaaaaa/11111111111111
dingtalk://aaaaaaaa/111/invalid/+1 (555) 123-45678
dingtalk://aaaaaaaa?format=markdown
dingtalk://secret@aaaaaaaa/?to=11111111111111
dingtalk://aaaaaaaa/?to=11111111111111,22222222222
dingtalk://?token=bbbbbbbb&to=11111111111111&secret=abc123

Rejected URLs:

dingtalk://aaaaaaaa/?to=11111111111111&secret=_
dingtalk://a_b@aaaaaaaa
dingtalk://
dingtalk://a_bd_/

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'dingtalk://12345678'

Notes

DingTalk (dingtalk://): messages to a DingTalk group robot webhook.