BulkSMS


Schemes	`bulksms://`
Cargo feature	`service-bulksms`
Service	https://bulksms.com/
Body formats	`text` (first is the default)
Attachments	no
Title length	no title (merged into the body)
Body length	160 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{token_id}:{token_secret}@{targets}

{schema} is one of bulksms://.

URL tokens

Token	Meaning	Type	Required	Notes
`{target_group}`	Target Group	string	no	prefix `@`; must match `^[A-Z0-9 _-]+$`
`{target_phone}`	Target Phone No	string	no	prefix `+`; must match `^[0-9\s)(+-]+$`
`{targets}`	Targets	list	yes	any of `target_group`, `target_phone`; separated by `/`
`{token_id}`	Token	string	yes
`{token_secret}`	Secret	string	yes	secret

Query parameters

Parameter	Meaning	Type	Default	Notes
`batch`	Batch Mode	bool	`no`
`from`	From Phone No	string		must match `^\+?[0-9\s)(+-]+$`
`route`	Route Group	choice	`STANDARD`	one of `ECONOMY`, `STANDARD`, `PREMIUM`
`to`	Targets	list		sets `{targets}`
`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):

bulksms://aaaaaaaaaa:bbbbbbbbbb@55555555555
bulksms://aaaaa:bbbbbbbbbb@123/33333333333/abcd/
bulksms://aaaaaaaaaa:bbbbbbbbbb@123456/44444444444
bulksms://bbbbb:cccccccccc@44444444444/55555555555/@grp?batch=y
bulksms://aaaaaaaaaa:bbbbbbbbbb@admin?route=premium
bulksms://aaaaaaaaaa:bbbbbbbbbb@55555555555?unicode=maybe
bulksms://bbbbb:cccccccccc@44444444444?batch=y&unicode=n
bulksms://_?user=aaaaaaaaaa&password=bbbbbbbbbb&from=55555555555

Rejected URLs:

bulksms://aaaaaaaaaa:bbbbbbbbbb@admin?route=invalid
bulksms://_?user=aaaaaaaaaa&password=bbbbbbbbbb&from=555

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'bulksms://aaaaaaaaaa:bbbbbbbbbb@55555555555'

Notes

BulkSMS (bulksms://): SMS through the BulkSMS API.