Plivo
| Schemes | plivo:// |
| Cargo feature | service-plivo |
| Service | https://plivo.com |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | no title (merged into the body) |
| Body length | 140 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{auth_id}@{token}/{source}
{schema}://{auth_id}@{token}/{source}/{targets}
{schema} is one of plivo://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{auth_id} | Auth ID | string | yes | must match ^[a-z0-9]{20,30}$ | |
{source} | Source Phone No | string | yes | prefix +; must match ^[0-9\s)(+-]+$ | |
{target_phone} | Target Phone No | string | no | prefix +; must match ^[0-9\s)(+-]+$ | |
{targets} | Targets | list | no | any of target_phone; separated by / | |
{token} | Auth Token | string | yes | must match ^[a-z0-9]{30,50}$ |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
batch | Batch Mode | bool | no | |
from | Source Phone No | string | sets {source} | |
id | Auth ID | string | sets {auth_id} | |
to | Targets | list | sets {targets} | |
token | Auth Token | string | sets {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):
plivo://aaaaaaaaaaaaaaaaaaaaaaaaa@bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb/15551231234
plivo://aaaaaaaaaaaaaaaaaaaaaaaaa@aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/15551230000/15551231111/15551232222
plivo://aaaaaaaaaaaaaaaaaaaaaaaaa@aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/15551230000/15551231111/15551232222?batch=yes
plivo://aaaaaaaaaaaaaaaaaaaaaaaaa@aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/?from=15551233000&to=15551232000&batch=yes
plivo://?id=aaaaaaaaaaaaaaaaaaaaaaaaa&token=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&from=15551233000&to=15551232000
Rejected URLs:
plivo://
plivo://aaaaaaaaaa@aaaaaaaaaaaaaaaaaaaaaaaaa/15551232000
plivo://aaaaaaaaaaaaaaaaaaaaaaaaa@aaaaaaaaaa/15551232000
plivo://aaaaaaaaaaaaaaaaaaaaaaaaa@aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/123
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'plivo://aaaaaaaaaaaaaaaaaaaaaaaaa@bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb/15551231234'
Notes
Plivo SMS (plivo://): SMS through the Plivo API.
Differences with Apprise
- Apprise posts to a literal
{auth_id}URL, while mercurio fills it in.