Versende Push-Benachrichtigungen mit pushsafer.com zu iOS, Android und Windows Geräten aus FHEM - Perl Server für Haus Automation heraus

Aktuelle Plugin Beschreibung

die aktuellste Plugin Beschreibung mit allen verfügbaren Parametern gibt es unter http://fhem.de/commandref_DE.html#Pushsafer

Download

http://fhem.de/fhem.html#Download

Define

define <Name> Pushsafer <Schlüssel>

Der Parameter <Schlüssel> muss eine alphanumerische Zeichenkette sein. Hierbei kann es sich um einen regulären privaten Schlüssel (20 Zeichen lang) handeln oder um einen Email-Alias-Schlüssel (15 Zeichen lang), welcher in einem Account entsprechend eingerichtet sein muss.

Beispiel:
define PushsaferAccount Pushsafer A1b2c3D4E5F6g7h8i9J0

Set

set <Name> message <Nachricht> [<Option1>=<Wert> <Option2>=<Wert> ...]

Aktuell wird nur das "message"-Kommando unterstützt um Nachrichten zu versenden.

Der einfachste Anwendungsfall ist das Versenden einer einfachen Textnachricht wie im folgenden Beispiel:

set PushsaferAccount message "Meine erste Pushsafer Nachricht."

Um eine mehrzeilige Nachricht zu schicken, kann man den Platzhalter "\n" für einen Zeilenumbruch verwenden:

set PushsaferAccount message "Meine zweite Pushsafer Nachricht.\nDiesmal mit zwei Zeilen."

Optionale Zusatzparameter

Es ist möglich die zu versendende Nachricht durch zusätzliche Optionen an die eigenen Wünsche anzupassen. Diese Optionen können hinter dem Nachrichtentext beliebig kombiniert werden um die Nachricht zu individualisieren. Die möglichen Optionen sind:

title     - Kurzform: t  - Typ: Text - Eine Überschrift, die über der Nachricht hervorgehoben angezeigt werden soll.
device    - Kurzform: d  - Typ: Text - Die Geräte-ID als Ganzzahl an welche die Nachricht gezielt geschickt werden soll. Um eine Gruppen-ID direkt zu addressieren muss der ID das Präfix "gs" vorangestellt werden (Bsp. "gs23" für die Gruppen-ID 23). Standardmäßig wird eine Nachricht immer an alle Geräte geschickt, die mit dem Account verknüpft sind.
sound     - Kurzform: s  - Typ: Ganzzahl - Die Nummer eines Tons, welcher beim Empfang der Nachricht auf dem Zielgerät ertönen soll (siehe pushsafer.com für eine Liste möglicher Werte).
icon      - Kurzform: i  - Typ: Ganzzahl - Die Nummer eines Icons, welches zusammen mit der Nachricht auf dem Zielgerät angezeigt werden soll (siehe Pushsafer.com für eine Liste möglicher Werte).
vibration - Kurzform: v  - Typ: Ganzzahl - Die Anzahl, wie oft das Zielgerät vibrieren soll beim Empfang der Nachricht (maximal 3 mal; nur für iOS-/Android-Geräte nutzbar). Falls nicht benutzt, wird die geräteinterne Einstellung verwendet.
url       - Kurzform: u  - Typ: Text - Eine URL, welche der Nachricht angehangen werden soll. Dies kann eine normale http:// bzw. https:// URL sein, es sind jedoch auch weitere spezielle Schemas möglich. Eine Liste aller möglichen URL-Schemas gibt es unter pushsafer.com .
urlText   - Kurzform: ut - Typ: Text - Der Text, welcher zum Anzeigen der URL benutzt werden soll anstatt der Zieladresse.
key       - Kurzform: k  - Typ: Text - Übersteuert den zu nutzenden Schlüssel zur Identifikation aus dem define-Kommando. Es kann hierbei auch ein Email-Alias-Schlüssel benutzt werden.
ttl       - Kurzform: l  - Typ: Ganzzahl - Die Lebensdauer der Nachricht in Minuten. Sobald die Lebensdauer erreicht ist, wird die Nachricht selbstständig auf allen Geräten gelöscht. Der mögliche Wertebereich liegt zwischen 1 - 43200 Minuten (entspricht 30 Tagen).
picture   - Kurzform: p  - Typ: Text - Anhängen eines Bildes zur Nachricht. Dies kann ein Dateipfad zu einer Bilddatei sein (z.B. picture=/home/user/Bild.jpg) oder der Name einer IPCAM-Instanz (im Format: picture=IPCAM:<Name>) um die letzte Aufnahme zu senden (Bsp. picture=IPCAM:IpKamera_Einganstuer). Es werden die Dateiformate JPG, PNG und GIF unterstüzt.
picture2  - Kurzform: p2 - Typ: Text - Gleiche Syntax wie die Option "picture".
picture3  - Kurzform: p3 - Typ: Text - Gleiche Syntax wie die Option "picture".

Beispiele:


set PushsaferAccount message "Dies ist eine Nachricht mit Überschrift." title="Sehr Wichtig!!"
set PushsaferAccount message "Komm runter\nwir warten" title="Mittag ist fertig" device=100
set PushsaferAccount message "Server ist nicht erreichbar" sound=25 icon=5 vibration=3
set PushsaferAccount message "Hier sind die Urlaubsfotos" url="http://www.foo.de/fotos" urlText="Sommerurlaub"

It is also possible to use the short-term versions of options:

set PushsaferAccount message "Dies ist eine Nachricht mit Überschrift." t="Sehr Wichtig!!"
set PushsaferAccount message "Komm runter\nwir warten" t="Mittag ist fertig" d=100
set PushsaferAccount message "Server ist nicht erreichbar" s=25 i5 v=3
set PushsaferAccount message "Hier sind die Urlaubsfotos" u="http://www.foo.de/fotos" ut="Sommerurlaub"

Get

N/A

Attribute

• do_not_notify
• disabled
• disabledForIntervals
• readingFnAttributes

Generierte Readings/Events:

• lastSuccess - Die letzte erfolgreiche Statusmeldung vom Pushsafer Server
• lastError - Die letzte Fehlermeldung vom Pushsafer Server
• availableMessages-<Geräte-ID>-<Geräte-Name> - Die verbleibende Anzahl an Nachrichten die zu diesem Gerät noch gesendet werden können

Weitere Informationen zum Ersetzten von Werten (Titel, Nachricht, Sound, Icon, Vibration) in deiner Push-Benachrichtigung, findest du in unserer API Beschreibung!