### Pushover
```
"accessories": [
{
"accessory": "HomebridgeMessenger",
"name": "Messenger",
"services": {
"pushover": {
"user": "your_user",
"token": "your_token"
}
},
"messages": [
{
"type": "pushover",
"name": "Pushover message",
"text": "This is a test",
"sound": "pushover",
"device" : "iphone",
"priority": 0
},
{
"type": "pushover",
"name": "Critical message",
"text": "This is important",
"sound": "magic",
"priority": 2
}
]
}
]
```
* Service properties :
* user *(required)*: The user/group key of your user (or you).
* token *(required)*: Your application's API token.
* Message properties :
* type *(required)*: Must be `pushover`.
* name *(required)*: Name of the switch and title of your message.
* text *(required)*: Body of the message.
* sound *(facultative)*: Name of the sound that will notify the user. If no valid value is provided, the default `pushover` sound will be used. For no sound, use `silent`. The [Pushover API](https://pushover.net/api#sounds) contains the list of all available sounds.
* device *(facultative)*: The device name to send the message to. If not specified, the message will be send to all your devices. You can send to multiple devices by using a coma.
* priority *(required)*: Priority of the message. Accepted values are `-2`, `-1`, `0`, `1` or `2`. You may refer to the [Pushover API](https://pushover.net/api#priority) for more details. Critical messages (`2`), are sent with the following parameters :
* Retry : 60 seconds
* Expires: 3600 seconds
### IFTTT (Webhooks service)
```
"accessories": [
{
"accessory": "HomebridgeMessenger",
"name": "Messenger",
"services": {
"ifttt": {
"key": "your_key"
},
},
"messages": [
{
"type": "ifttt",
"name": "Test IFTTT",
"event": "my_webhook",
"value1": "hello world",
"value2": "foo bar",
"value3": "chewbacca"
}
]
}
]
```
* Service properties :
* key *(required)*: Your key. To obtain your key, log into your IFTTT account and click on the Documentation link in the [Webhooks service](https://ifttt.com/maker_webhooks).
* Message properties :
* type *(required)*: Must be `ifttt`.
* name *(required)*: Name of the switch. This will be **not** passed to IFTTT.
* event *(required)*: Name of your event configured in IFTTT (Webhooks service).
* value1 *(facultative)*: Value 1 to be passed to IFTTT.
* value2 *(facultative)*: Value 2 to be passed to IFTTT.
* value3 *(facultative)*: Value 3 to be passed to IFTTT.
### Email
```
"accessories": [
{
"accessory": "HomebridgeMessenger",
"name": "Messenger",
"services": {
"email": {
"recipient": "you_email@domain.com",
"smtpServer": "smtp.domain.com",
"smtpPort": 465,
"smtpSecure": true,
"smtpUsername": "your_username",
"smtpPassword": "your_password"
}
},
"messages": [
{
"type": "email",
"name": "Test email",
"text": "This is a test",
"recipients": "your_friend@domain.com, other_email@domain.com"
}
]
}
]
```
* Service properties :
* recipient *(required)*: Default email address of the recipient.
* smtpServer *(required)*: Address of the SMTP host.
* smtpPort *(facultative)*: Port to connect to. (Default value is `25`).
* smtpSecure *(facultative)*: Set to `true` if SMTP supports TLS. (Default value is `false`).
* smtpUsername *(facultative)*: Username for the SMTP server, if required.
* smtpPassword *(facultative)*: Password for the SMTP server, if required.
* Message properties :
* type *(required)*: Must be `email`.
* name *(required)*: Name of the switch and subject of your email.
* text *(required)*: Body of the email.
* recipients *(facultative)*: Address of the recipients for this email. Multiple emails can be used, divided by a comma. If empty, the default email address at the service level will be used.
### Advanced configuration
An example featuring **all technologies** is available [here](configuration-examples/advanced.example.json).
## Coming next
* Support for [Pushcut](https://www.pushcut.io/) ([#5](https://github.com/potrudeau/homebridge-messenger/issues/5))
* Support for [Pushbullet](https://www.pushbullet.com)
## Change Log
Available [here](CHANGELOG.md)
## Credits
* [qbit/node-pushover](https://github.com/qbit/node-pushover) - library to send Pushover messages
* [jeroentvb/IFTTT-webhooks-channel](https://github.com/jeroentvb/IFTTT-webhooks-channel) - library to send IFTTT messages
* [nodemailer](https://github.com/nodemailer/nodemailer) - library to send SMTP emails
## License
The [homebridge-messenger](https://github.com/potrudeau/homebridge-messenger) plugin is released under the [MIT license](LICENSE).