Discord
| Schemes | discord:// |
| Cargo feature | service-discord |
| Service | https://discord.com/ |
| Body formats | text, markdown (first is the default) |
| Attachments | yes |
| Title length | 250 characters |
| Body length | 1,750 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | yes |
URL formats
{schema}://{webhook_id}/{webhook_token}
{schema}://{botname}@{webhook_id}/{webhook_token}
{schema} is one of discord://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{botname} | Bot Name | string | no | ||
{webhook_id} | Webhook ID | string | yes | secret | |
{webhook_token} | Webhook Token | string | yes | secret |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
avatar | Avatar Image | bool | yes | |
avatar_url | Avatar URL | string | ||
batch | Batch Attachments | bool | yes | |
emojis | Interpret Emojis | bool | yes | no escapes every :name: so Discord shows it as text |
fields | Use Fields | bool | yes | |
flags | Discord Flags | int, min 0 | ||
footer | Display Footer | bool | no | |
footer_logo | Footer Logo | bool | yes | |
href | URL | string | also url | |
image | Include Image | bool | no | |
ping | Ping Users/Roles | list | separated by , or space | |
template | Template Path | string | secret | |
thread | Thread ID | string | ||
tts | Text To Speech | bool | no |
Prefixed parameters:
:name=value: Template Tokens
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):
https://discord.com/api/webhooks/0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
discord://iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt
discord://l2g@iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt
discord://iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt?flags=1
discord://iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt?batch=no
discord://iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt/?emojis=no
discord://iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt?format=markdown
discord://iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt?url=http://localhost
Rejected URLs:
discord://
discord://:@/
discord://iiiiiiiiiiiiiiiiiiiiiiii
discord://iiiiiiiiiiiiiiiiiiiiiiii/tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt?flags=-1
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'https://discord.com/api/webhooks/0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB'
Notes
Discord (discord://): messages to a Discord channel through a webhook.