Threema Gateway
| Schemes | threema:// |
| Cargo feature | service-threema |
| Service | https://gateway.threema.ch/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | no title (merged into the body) |
| Body length | 3,500 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{gateway_id}@{secret}/{targets}
{schema} is one of threema://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{gateway_id} | Gateway ID | string | yes | secret | |
{secret} | API Secret | string | yes | secret | |
{target_email} | Target Email | no | |||
{target_phone} | Target Phone No | string | no | prefix +; must match ^[0-9\s)(+-]+$ | |
{target_threema_id} | Target Threema ID | string | no | ||
{targets} | Targets | list | yes | any of target_email, target_phone, target_threema_id; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
from | Gateway ID | string | sets {gateway_id} | |
gwid | Gateway ID | string | sets {gateway_id} | |
secret | API Secret | string | sets {secret} | |
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):
threema://*THEGWID@secret/ECHOECHO/
threema://*THEGWID@secret/user@example.com
threema://*THEGWID@secret/16134442222/16134443333/
threema://*THEGWID@secret/ECHOECHO/user@example.com/+1 613 444 2222/bad
threema:///?secret=secret&gwid=*THEGWID&to=16134442222
threema:///?secret=secret&from=*THEGWID&to=16134442222,ECHOECHO
Rejected URLs:
threema://
threema://@:
threema://user@secret
threema:///?gwid=*THEGWID&to=ECHOECHO
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'threema://*THEGWID@secret/ECHOECHO/'
Notes
Threema Gateway (threema://): messages through the Threema Gateway API.