AgoAlert

From ago control wiki
(Difference between revisions)
Jump to: navigation, search
m
m (Add name for devices and controller)
 
(9 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
*a tweet on your Twitter account
 
*a tweet on your Twitter account
 
*a message on your email box
 
*a message on your email box
*a message on GTalk (only GTalk not hangout)
 
 
*a text message (SMS)
 
*a text message (SMS)
 
*a push notifications on your mobile devices
 
*a push notifications on your mobile devices
 +
 +
== Install package, enable and start daemon==
 +
sudo apt-get install agocontrol-alert
 +
 +
Then enable and start the daemon
 +
sudo systemctl enable agoalert.service
 +
sudo systemctl start agoalert.service
 +
  
 
== Configuration ==
 
== Configuration ==
 
Agoalert is configured on dedicated web page on agocontrol.
 
Agoalert is configured on dedicated web page on agocontrol.
Click on alertcontroller details icon on agocontrol->configuration->devices web page.
+
Click on Alert in the Applications list web page.
 
=== Twitter ===
 
=== Twitter ===
 
Follow instructions on Twitter tab to make agocontrol have access to your twitter account.
 
Follow instructions on Twitter tab to make agocontrol have access to your twitter account.
=== GTalk ===
 
Provide your google credentials if you want to receive message from agocontrol directly on GTalk.
 
Both basic and 2-step verification are supported.
 
 
=== SMS ===
 
=== SMS ===
 
Agocontrol uses SMS provider to send you text messages.
 
Agocontrol uses SMS provider to send you text messages.
Line 35: Line 39:
 
Configuration depends on chosen provider. Please follow instructions on push tab.
 
Configuration depends on chosen provider. Please follow instructions on push tab.
  
Push notifications are available for Windows 8 and Windows Phone 8 by using the [https://pushalot.com/ Pushalot app], setup email provider above and use your assigned @api.pushalot.com email address to push notifications to devices.  
+
Push notifications are available for Windows 8 and Windows Phone 8 by using the [https://pushalot.com/ Pushalot app], setup email provider above and use your assigned @api.pushalot.com email address to push notifications to devices.
  
 
== Send alert ==
 
== Send alert ==
Line 42: Line 46:
 
*type:twitter
 
*type:twitter
 
*param1: message to tweet
 
*param1: message to tweet
=== GTalk ===
 
*type:gtalk
 
*param1: gmail address (with @gmail.com)
 
*param2: message
 
 
=== SMS ===
 
=== SMS ===
 
*type:sms
 
*type:sms
Line 69: Line 69:
 
**param2: notification priority (see [http://www.notifymyandroid.com/api.jsp notifymyandroid api])
 
**param2: notification priority (see [http://www.notifymyandroid.com/api.jsp notifymyandroid api])
  
=== Add name for Device ===
+
=== Add name for devices and controller ===
When you are done, check your 127.0.0.1:8008/?deviceConfig that alertcontroller is there.<br>
+
When you are done, check your 127.0.0.1:8008/#config/Devices that alertcontroller is there.<br>
 
Device Name Room Name Device Type Handler IntID Action<br>
 
Device Name Room Name Device Type Handler IntID Action<br>
 
unset unset alertcontroller alert alertcontroller<br>
 
unset unset alertcontroller alert alertcontroller<br>
  
Add a name for the device, don't leave it 'unset' then it's not present when you want to create 'Event's Change name to maybe 'alertcontroller' as my below example.<br>
+
You have to set names for the alert controller and device(s) in order for them to be visible to the system.<br>
Device Name Room Name Device Type Handler IntID Action<br>
+
Change name to something as below example.<br>
alertcontroller unset alertcontroller alert alertcontroller<br>
+
Device Name   Room Name Device Type Handler IntID Action
 +
alertcontroller   unset alertcontroller alert alertcontroller
 +
pushgateway   unset         pushgateway alert <<UUDI not shown>>
 +
smtpgateway   unset smtpgateway alert <<UUDI not shown>>

Latest revision as of 20:53, 25 December 2016

Contents

[edit] AgoAlert

ago control can send some kind of alerts:

  • a tweet on your Twitter account
  • a message on your email box
  • a text message (SMS)
  • a push notifications on your mobile devices

[edit] Install package, enable and start daemon

sudo apt-get install agocontrol-alert

Then enable and start the daemon

sudo systemctl enable agoalert.service
sudo systemctl start agoalert.service


[edit] Configuration

Agoalert is configured on dedicated web page on agocontrol. Click on Alert in the Applications list web page.

[edit] Twitter

Follow instructions on Twitter tab to make agocontrol have access to your twitter account.

[edit] SMS

Agocontrol uses SMS provider to send you text messages.

Choosen provider is 12voip because it allows SMS sending anywhere. You have to create a 12voip account and buy credits to use this service. SMS rates are available here.

[edit] Mail

Agocontrol can send you email using your own email provider or existing one.

Gmail configuration example:
smtp: smtp.gmail.com:587
sender: a valid email address (an invalid mail address will probably be considered as spam)
login: your gmail address
password: your gmail password (don't forget to generate new token from your google account if you are using 2-step verification authorization)
tls: checked

[edit] Push

Agocontrol provides push notifications through different providers:

  • Pushover: compatible with android and ios. Application is not free but there are no other fees
  • Pushbullet: compatible with android, chrome and firefox browsers (using extension). Application is free.
  • Notifymyandroid: compatible with android and growl (mac). Mobile app is free.

Configuration depends on chosen provider. Please follow instructions on push tab.

Push notifications are available for Windows 8 and Windows Phone 8 by using the Pushalot app, setup email provider above and use your assigned @api.pushalot.com email address to push notifications to devices.

[edit] Send alert

Alerts need specific parameters according to alert type.

[edit] Twitter

  • type:twitter
  • param1: message to tweet

[edit] SMS

  • type:sms
  • param1: international phone number (must start with +)
  • param2:message content

[edit] Mail

  • type:mail
  • param1: list of recipients (separated by ;)
  • param2: email subject
  • param3: email content

[edit] Push

  • pushbullet
    • type:push
    • param1: notification message
    • param2: notification file. If empty note will be sent. If specified (full path, file accessible from agocontrol) a file notification will be sent.
  • pushover:
    • type:push
    • param1: notification message
    • param2: notification priority (see pushover api)
  • notifymyandroid:
    • type:push
    • param1: notification message
    • param2: notification priority (see notifymyandroid api)

[edit] Add name for devices and controller

When you are done, check your 127.0.0.1:8008/#config/Devices that alertcontroller is there.
Device Name Room Name Device Type Handler IntID Action
unset unset alertcontroller alert alertcontroller

You have to set names for the alert controller and device(s) in order for them to be visible to the system.
Change name to something as below example.

Device Name	  Room Name	Device Type	Handler	IntID	Action
alertcontroller   unset 	alertcontroller alert 	alertcontroller
pushgateway	  unset	        pushgateway	alert	<<UUDI not shown>>
smtpgateway	  unset 	smtpgateway	alert	<<UUDI not shown>>
Personal tools