Nextcloud Talk
| Schemes | nctalk://, nctalks:// |
| Cargo feature | service-nextcloudtalk |
| Service | https://nextcloud.com/talk |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | 255 characters |
| Body length | 31,745 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{user}:{password}@{host}/{targets}
{schema}://{user}:{password}@{host}:{port}/{targets}
{schema}://{host}/{targets}?secret={secret}
{schema}://{host}:{port}/{targets}?secret={secret}
{schema} is one of nctalk://, nctalks://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{host} | Hostname | string | yes | ||
{password} | Password | string | yes | secret | |
{port} | Port | int, 1 to 65535 | no | ||
{secret} | Secret | string | yes | secret | |
{target_room_id} | Room ID | string | no | ||
{targets} | Targets | list | yes | any of target_room_id; separated by / | |
{user} | Username | string | yes |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
secret | Secret | string | sets {secret} | |
silent | Silent Notification | bool | no | |
url_prefix | URL Prefix | string |
Prefixed parameters:
+name=value: HTTP Header
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):
nctalks://user:pass@localhost/roomid
nctalk://user:pass@localhost:8080/roomid
nctalk://user:pass@localhost/roomid2/roomid1
nctalk://user:pass@localhost/roomid?silent=yes
nctalks://localhost/room1/room2?secret=abcd
nctalk://user:pass@localhost:8080/roomid?url_prefix=/prefix
nctalks://user:pass@localhost/room?secret=abc&silent=yes
nctalk://user:pass@localhost/admin/?url_prefix=a/longer/path/abcd/
Rejected URLs:
nctalk://
nctalk://localhost/roomid
nctalk://user@localhost/roomid
nctalk://localhost/roomid?secret=
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'nctalks://user:pass@localhost/roomid'
Notes
Nextcloud Talk (nctalk://, nctalks://): messages to Nextcloud Talk rooms.
Either user/password (chat API) or ?secret= (bot API, HMAC-SHA256 signed).