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

Ryver

Schemesryver://
Cargo featureservice-ryver
Servicehttps://ryver.com/
Body formatstext (first is the default)
Attachmentsno
Title length250 characters
Body length1,000 characters
Body linesunlimited
Request throttlenone
Vendor URLs acceptedyes

URL formats

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

{schema} is one of ryver://.

URL tokens

TokenMeaningTypeRequiredDefaultNotes
{botname}Bot Namestringno
{organization}Organizationstringyesmust match ^[A-Z0-9_-]{3,32}$
{token}Tokenstringyessecret; must match ^[A-Z0-9]{15}$

Query parameters

ParameterMeaningTypeDefaultNotes
imageInclude Imageboolyes
modeWebhook Modechoiceryverone of slack, ryver

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

ryver://mercurio/ckhrjW8w672m6HG
ryver://caronc@mercurio/ckhrjW8w672m6HG
https://mercurio.ryver.com/application/webhook/ckhrjW8w672m6HG
ryver://mercurio/ckhrjW8w672m6HG?image=no
ryver://mercurio/ckhrjW8w672m6HG?mode=slack
ryver://mercurio/ckhrjW8w672m6HG?webhook=slack
https://mercurio.ryver.com/application/webhook/ckhrjW8w672m6HG/?mode=slack&image=no

Rejected URLs:

ryver://
ryver://:@/
ryver://mercurio
ryver://mercurio/ckhrjW8w672m6HG?mode=invalid

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'ryver://mercurio/ckhrjW8w672m6HG'

Notes

Ryver (ryver://): messages to Ryver forums through webhooks.