Exotel
| Schemes | exotel:// |
| Cargo feature | service-exotel |
| Service | https://exotel.com/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | no title (merged into the body) |
| Body length | 2,000 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{sid}:{token}@{from_phone}
{schema}://{sid}:{token}@{from_phone}/{targets}
{schema} is one of exotel://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{from_phone} | From Phone No / Sender ID | string | yes | must match ^(?:(?=.{3,16}$)(?=.*[A-Z.-])[A-Z0-9][A-Z0-9.-]*|[0-9]{6}|\+?[0-9\s)(+-]{9,})$ | |
{sid} | Account SID | string | yes | secret | |
{target_phone} | Target Phone No | string | no | prefix +; must match ^[0-9\s)(+-]+$ | |
{targets} | Targets | list | no | any of target_phone; separated by / | |
{token} | Token | string | yes | secret |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
apikey | API Key | string | also key; secret | |
batch | Batch Mode | bool | no | |
from | From Phone No / Sender ID | string | sets {from_phone} | |
priority | Priority | choice | normal | one of normal, high |
region | Region Name | choice | us | one of us, in |
sid | Account SID | string | sets {sid} | |
to | Targets | list | sets {targets} | |
token | Token | string | sets {token} | |
unicode | Unicode Characters | bool | yes |
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):
exotel://sid:token@15551232000
exotel://sid:token@MYBRAND/919876543210
exotel://sid:token@15551232000/919876543210/+91 98765 43211
exotel://sid:token@15551232000?region=IN
exotel://sid:token@15551232000/919876543210/919876543211/919876543212?batch=yes
exotel://sid:token@15551232000?priority=h
exotel://sid:token@15551232000?unicode=no
exotel://sid:token@15551232000?key=K2&source=ALT.ID
Rejected URLs:
exotel://
exotel://sid@15551232000
exotel://:token@15551232000
exotel://sid:token@12345/919876543210
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'exotel://sid:token@15551232000'
Notes
Exotel (exotel://): SMS through the Exotel API.