SMPP


Schemes	`smpp://`, `smpps://`
Cargo feature	`service-smpp`
Service	https://smpp.org/
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}://{user}:{password}@{host}/{from_phone}/{targets}
{schema}://{user}:{password}@{host}:{port}/{from_phone}/{targets}

{schema} is one of smpp://, smpps://.

URL tokens

Token	Meaning	Type	Required	Notes
`{from_phone}`	From Phone No	string	yes	must match `^[0-9\s)(+-]+$`
`{host}`	Host	string	yes
`{password}`	Password	string	yes	secret
`{port}`	Port	int, 1 to 65535	no
`{target_phone}`	Target Phone No	string	no	prefix `+`; must match `^[0-9\s)(+-]+$`
`{targets}`	Targets	list	yes	any of `target_phone`; separated by `/`
`{user}`	Username	string	yes

Query parameters

Parameter	Meaning	Type	Default	Notes
`from`	From Phone No	string		sets `{from_phone}`
`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):

smpp://user:pass@host/1111111111/2222222222
smpps://user:pass@host/1111111111/2222222222
smpp://user:pass@host/1111111111/2222222222/+3333333333
smpp://user:pass@host/2222222222?from=1111111111
smpps://_?&from=1111111111&to=2222222222,3333333333&user=user&password=pw

Rejected URLs:

smpp://
smpp:///
smpp://@/
smpp://user@/

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'smpp://user:pass@host/1111111111/2222222222'

Notes

SMPP (smpp://, smpps://): SMS through an SMPP server, with a built-in SMPP v3.4 client: bind_transmitter, one submit_sm per segment and target, unbind.

PDUs: sequence numbers start at 2, registered_delivery=1, GSM 7-bit unpacked or UCS-2 with concatenation UDH above 160 / 140 octets, string fields truncated to the SMPP maxima.

Divergences: an explicit :port is honoured (otherwise 2775 / 3550); smpps:// uses TLS; submit_sm_resp statuses are checked.

Differences with Apprise

An explicit :port is honoured (Apprise always uses 2775 / 3550).
smpps:// uses TLS (Apprise opens a plain socket).
submit_sm_resp statuses are checked (Apprise never reads them).

Keyboard shortcuts