Africas Talking


Schemes	`atalk://`
Cargo feature	`service-africastalking`
Service	https://africastalking.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}://{appuser}@{apikey}/{targets}

{schema} is one of atalk://.

URL tokens

Token	Meaning	Type	Required	Notes
`{apikey}`	API Key	string	yes	secret; must match `^[A-Z0-9_-]+$`
`{appuser}`	App User Name	string	yes	must match `^[A-Z0-9_-]+$`
`{target_phone}`	Target Phone	string	no
`{targets}`	Targets	list	yes	any of `target_phone`; separated by `/`

Query parameters

Parameter	Meaning	Type	Default	Notes
`apikey`	API Key	string		sets `{apikey}`
`batch`	Batch Mode	bool	`no`
`from`	From	string	`AFRICASTKNG`
`mode`	SMS Mode	choice	`bulksms`	one of `bulksms`, `premium`, `sandbox`
`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):

atalk://user@apikey/11111111111/
atalk://user@apikey/+254711000111
atalk://user@apikey/123/33333333333/abcd/+44444444444
atalk://user@apikey/+44444444444?mode=s
atalk://user@apikey/+44444444444/55555555555?batch=y
atalk://11111111111?apikey=key&user=user&from=FROMUSER
atalk://_?user=user&to=11111111111,22222222222&key=bbbbbbbbbb&from=5555555555555

Rejected URLs:

atalk://
atalk://:@/
atalk://user@^/
atalk://user@apikey/+44444444444?mode=invalid

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'atalk://user@apikey/11111111111/'

Notes

Africa’s Talking (atalk://): SMS through the Africa’s Talking messaging API.