The Pushbullet action allows you to notify iOS, Android & Windows 10 Phone & Desktop devices of a message using the Pushbullet API web service.
You may define default values for parameters to action calls in the file
To override the default values, specify configuration parameters in the action call (using
|accesstoken||Yes||-||Pushbullet API token to send to devices|
|devicename||DEFAULT||No||botname||The name of the openHAB bot|
|defaultreceiver||No||receiver||The name of the Recipient|
|bots||No||-||Comma-separated list of multiple bots, each with its own settings below.|
| ||Yes, if using multiple bots||botname||Device name for a single bot|
| ||Yes, if using multiple bots||-||API token for a single bot|
Extended setup with 2 bots, each with its own access token (optional):
bots=bot1,bot2 bot1.devicename=openHAB-foobar bot1.accesstoken=1234abc bot2.devicename=openHAB-tralala bot2.accesstoken=4711qwert
The following is a valid action call that can be made when the plugin is loaded. For specific information on each item, see the Pushbullet API. The recipient can either be an email address or a channel tag. If it is not specified or invalid, the note will be broadcast to all of the user account's devices.
sendPushbulletNote(String title, String message)
sendPushbulletNote(String receiver, String title, String message)
sendPushbulletNote(String botname, String receiver, String title, String message)
sendPushbulletNote("mybot", "email@example.com", "this is the title", "And this is the body of the message")
Creating an account for your bot(s)
The pushbullet accounts are bound to either Google or Facebook accounts.
- Go to "https://www.pushbullet.com/"
- Chose to either "Sign up with Google" or "Sign up with Facebook".
- Complete the signup process as guided by the pushbullet web site.
- Continue with "Obtaining an API key".
Obtaining an API key
The API keys are bound to the pushbullet account.
- Go to the pushbullet site.
- Log in with either your personal account or the one you created for your bot.
- Go to "https://www.pushbullet.com/#settings/account"
- Click on "Create Access Token".
- Copy the token created on the site.
You must at least provide an API token (Private or Alias Key from Pushbullet.com) and a message in some manner before a message can be pushed. All other parameters are optional. If you use an alias key, the parameters (device, icon, sound, vibration) are overwritten by the alias setting on pushbullet.
As of June 2017, free accounts have a limit of 500 pushes per month. This action does not evaluate the rate limiting headers though.
This action has been written without using libraries as jpushbullet or jpushbullet2. Both of those libraries use various libraries themselves which makes integrating them into openHAB a challenge.