yowsup

Aus FHEMWiki
Version vom 16. Juni 2015, 22:25 Uhr von Bambi (Diskussion | Beiträge) (Auf Basis des Forums erstellt.)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)


Yowsup
Zweck / Funktion
Schnittstelle um WhatsApp-Nachrichten empfangen und senden zu können.
Allgemein
Typ Inoffiziell
Details
Dokumentation Thema
Support (Forum) Sonstiges
Modulname 32_yowsup.pm
Ersteller André / justme1968 (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


Das Modul yowsup dient dem empfangen und senden von WhatsApp-Nachrichten.

Voraussetzungen

Die Funktionalität kann auf Linux/Unix Systemen eingeschränkt sein.

Anwendung

Define

  • in zeile 148 muss der pfad für den aufruf und das config file angepasst werden. eventuell mit sudo und HOME setzen. Das wird noch konfigurierbar gemacht.
  • fhem device anlegen: define <name> yowsup
  • wenn alles gut geht gibt es danach im device ein internal PID und das reading state.
  • im whatsapp client auf dem handy sollte man sehen das fhem online ist.
  • zum senden aus fhem kann man das kommando set WhatsApp send <nummer> <text> verwenden.

Attribute

  • cmd -> komplettes Kommando um den yowsup cli client zu starten. z.B.: attr WhatsApp cmd /opt/local/bin/yowsup-cli demos -c /root/config.yowsup --yowsup
  • accept_from -> Kommagetrennte Liste von Kontakten (Nummern) von denen Nachrichten akzeptiert werden. Ist das Attribut nicht gesetzt, so werden die Nachrichten von jedem akzeptiert.
  • commandPrefix
    nicht gesetzt -> es werden keine Befehle akzeptiert.
    0 -> es werden keine Befehle akzeptiert.
    1 -> erlaubt Befehle, jede Nachricht wird als fhem-Befehle interprätiert.
    alles andere -> Wenn die Nachricht mit diesem Prefix startet, dann wird alles weitere als Befehle interprätiert.
  • allowedCommands
    Info green.pngallowedCommands should work as intended, but no guarantee can be given that there is no way to circumvent it.


Eine Komma-getrennte Liste von zulässigen Befehlen für diesen Kontakt. Wenn die Liste leer ist (z.B. nur ein Komma) dann werden keine Befehle akzeptiert.

Befehle

  • image -> Über diesen Befehl können Bilder gesendet werden.

Anwendungsbeispiele

Beispielnachricht

Bei dem Empfang einer Nachricht wird automatisch ein FHEM Device für diesen Kontakt angelegt. In diesem Device gibt es das Reading message für die empfangene Nachricht und ab der ersten Nachricht auch das Reading chatstate in dem zu sehen ist ob gerade getippt wird. Nachdem ein Device für ein Kontakt angelegt ist, lässt sich auch direkt dieses Device zum senden verwenden: set <device> send <text>. D.h. man spart sich die Angabe der Nummer.