mirror of https://github.com/caronc/apprise
Updated Notify_signal (markdown)
parent
83126c8449
commit
86cf027749
|
@ -30,12 +30,12 @@ The **{FromPhoneNo}** must be the number associated with your account.
|
||||||
Valid syntax is as follows:
|
Valid syntax is as follows:
|
||||||
* `signal://{user}:{password}@{hostname}/{from_phone}`
|
* `signal://{user}:{password}@{hostname}/{from_phone}`
|
||||||
* `signal://{user}:{password}@{hostname}:{port}/{from_phone}`
|
* `signal://{user}:{password}@{hostname}:{port}/{from_phone}`
|
||||||
* `signal://{user}:{password}@{hostname}/{from_phone}/{to_phone}`
|
* `signal://{user}:{password}@{hostname}/{from_phone}/{target}`
|
||||||
* `signal://{user}:{password}@{hostname}:{port}/{from_phone}/{from_phone}`
|
* `signal://{user}:{password}@{hostname}:{port}/{from_phone}/{target}`
|
||||||
|
|
||||||
You can post in multiple chats by simply chaining them at the end of the URL.
|
You can post in multiple chats by simply chaining them at the end of the URL.
|
||||||
* `signal://{user}:{password}@{hostname}:{port}/{from_phone}/{to_phone1}/{to_phone2}/{to_phone3}`
|
* `signal://{user}:{password}@{hostname}:{port}/{from_phone}/{target1}/{target2}/{target3}`
|
||||||
* `signals://{user}:{password}@{hostname}:{port}/{from_phone}/{to_phone1}/{to_phone2}/{to_phone3}`
|
* `signals://{user}:{password}@{hostname}:{port}/{from_phone}/{target1}/{target2}/{target3}`
|
||||||
|
|
||||||
### Parameter Breakdown
|
### Parameter Breakdown
|
||||||
| Variable | Required | Description
|
| Variable | Required | Description
|
||||||
|
@ -45,11 +45,43 @@ You can post in multiple chats by simply chaining them at the end of the URL.
|
||||||
| user | No | If you're system is set up to use HTTP-AUTH, you can provide _username_ for authentication to it.
|
| user | No | If you're system is set up to use HTTP-AUTH, you can provide _username_ for authentication to it.
|
||||||
| password | No | If you're system is set up to use HTTP-AUTH, you can provide _password_ for authentication to it.
|
| password | No | If you're system is set up to use HTTP-AUTH, you can provide _password_ for authentication to it.
|
||||||
| from | Yes | This must be a _From Phone Number_ you've added to the API service.
|
| from | Yes | This must be a _From Phone Number_ you've added to the API service.
|
||||||
| to | **\*No** | A phone number you wish to send your notification to. If one isn't specified, then the `from` is used instead.
|
| to | **\*No** |A phone number or group id you wish to send your notification to. If one isn't specified, then the `from` is used instead.
|
||||||
| batch | No | Send multiple specified notifications in a single batch (1 upstream post to the end server). By default this is set to `no`.
|
| batch | No | Send multiple specified notifications in a single batch (1 upstream post to the end server). By default this is set to `no`.
|
||||||
| status | No | Optionally include a small little ASCII string representing the notification status being sent (inline with it) by default this is set to `no`.
|
| status | No | Optionally include a small little ASCII string representing the notification status being sent (inline with it) by default this is set to `no`.
|
||||||
|
|
||||||
#### Example
|
### Acquiring A Group ID
|
||||||
|
Groups can be created in the app, or via the [Signal Rest API Service](https://github.com/bbernhard/signal-cli-rest-api).
|
||||||
|
To get a list of available groups and their ids run:
|
||||||
|
```bash
|
||||||
|
curl -X GET -H "Content-Type: application/json" localhost:9922/v1/groups/+15555551234 | jq
|
||||||
|
```
|
||||||
|
|
||||||
|
Example output is as follows:
|
||||||
|
```
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"name": "Test Group",
|
||||||
|
"id": "group.abcdefghijklmnop=",
|
||||||
|
"internal_id": "aabbccdd/eeffgghh=",
|
||||||
|
"members": [
|
||||||
|
"+1555555551234
|
||||||
|
"+16666661234"
|
||||||
|
],
|
||||||
|
"blocked": false,
|
||||||
|
"pending_invites": [],
|
||||||
|
"pending_requests": [],
|
||||||
|
"invite_link": "",
|
||||||
|
"admins": [
|
||||||
|
"+1555555551234"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
|
||||||
|
The takeaway from the above is the group
|
||||||
|
```
|
||||||
|
Example sending a notification to a group: `group.aabbccdd/eeffgghh=` identified by the `id`.
|
||||||
|
|
||||||
|
### Example
|
||||||
Send a Signal Notification (via Signal API):
|
Send a Signal Notification (via Signal API):
|
||||||
```bash
|
```bash
|
||||||
# Assuming our {Hostname} is localhost (hosting the bbernhard/signal-cli-rest-api)
|
# Assuming our {Hostname} is localhost (hosting the bbernhard/signal-cli-rest-api)
|
||||||
|
@ -57,12 +89,12 @@ Send a Signal Notification (via Signal API):
|
||||||
# Assuming our {PhoneNo} - is in the US somewhere making our country code +1
|
# Assuming our {PhoneNo} - is in the US somewhere making our country code +1
|
||||||
# - identifies as 800-555-1223
|
# - identifies as 800-555-1223
|
||||||
apprise -vv -t "Test Message Title" -b "Test Message Body" \
|
apprise -vv -t "Test Message Title" -b "Test Message Body" \
|
||||||
signal://localhost/19005559999/18005551223
|
"signal://localhost/19005559999/18005551223"
|
||||||
|
|
||||||
# the following would also have worked (spaces, brackets,
|
# the following would also have worked (spaces, brackets,
|
||||||
# dashes are accepted in a phone no field):
|
# dashes are accepted in a phone no field):
|
||||||
apprise -vv -t "Test Message Title" -b "Test Message Body" \
|
apprise -vv -t "Test Message Title" -b "Test Message Body" \
|
||||||
signal://localhost/1-(900) 555-9999/1-(800) 555-1223
|
"signal://localhost/1-(900) 555-9999/1-(800) 555-1223"
|
||||||
```
|
```
|
||||||
|
|
||||||
Based on my personal experiences, I was able to send a notification to myself by simply doing the following:
|
Based on my personal experiences, I was able to send a notification to myself by simply doing the following:
|
||||||
|
@ -71,9 +103,20 @@ Based on my personal experiences, I was able to send a notification to myself by
|
||||||
# Assuming our {Port} is 9922
|
# Assuming our {Port} is 9922
|
||||||
# Assuming our {FromPhoneNo} is +1 555 555 1234
|
# Assuming our {FromPhoneNo} is +1 555 555 1234
|
||||||
apprise -vv -t "Test Message Title" -b "Test Message Body" \
|
apprise -vv -t "Test Message Title" -b "Test Message Body" \
|
||||||
signal://localhost:9922/15555551234
|
"signal://localhost:9922/15555551234"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
If you know the Group ID you want to notify, you can idenify it as well on the command line:
|
||||||
|
```bash
|
||||||
|
# Assuming our {Hostname} is localhost (hosting the bbernhard/signal-cli-rest-api)
|
||||||
|
# Assuming our {Port} is 9922
|
||||||
|
# Assuming our {FromPhoneNo} is +1 555 555 1234
|
||||||
|
# Assuming our {Group} is group.abcdefghijklmnop=
|
||||||
|
apprise -vv -t "Group Message:" -b "Hello group members" \
|
||||||
|
"signal://localhost:9922/+1555555551234/group.abcdefghijklmnop="
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
I could even send an attachment without a problem:
|
I could even send an attachment without a problem:
|
||||||
```bash
|
```bash
|
||||||
apprise -vv -t -b "test" \
|
apprise -vv -t -b "test" \
|
||||||
|
|
Loading…
Reference in New Issue