Clickatell
| Schemes | clickatell:// |
| Cargo feature | service-clickatell |
| Service | https://www.clickatell.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 | no |
URL formats
{schema}://{apikey}/{targets}
{schema}://{source}@{apikey}/{targets}
{schema} is one of clickatell://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{apikey} | API Token | string | yes | secret | |
{source} | From Phone No | string | no | must match ^[0-9\s)(+-]+$ | |
{target_phone} | Target Phone No | string | no | prefix +; must match ^[0-9\s)(+-]+$ | |
{targets} | Targets | list | yes | any of target_phone; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
from | From Phone No | string | sets {source} | |
to | Targets | list | sets {targets} |
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):
clickatell://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/1111111111
clickatell://1111111111@aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/1111111111
clickatell://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/+1%20555%20123%204567/tel:15551234568
clickatell://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?from=1111111111&to=1111111111,2222222222
Rejected URLs:
clickatell://
clickatell:///
clickatell://@/
clickatell://1111111111@/
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'clickatell://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/1111111111'
Notes
Clickatell (clickatell://): SMS through the Clickatell API.