Yowsup

2015-06-18T21:32:43Z

Phel: /* Anwendungsbeispiele */

{{SEITENTITEL:yowsup}}
{{Infobox Modul
|ModPurpose=Schnittstelle, um WhatsApp-Nachrichten empfangen und senden zu können.
|ModType=d
|ModCmdRef=yowsup
|ModFTopic=27543
|ModForumArea=Unterstuetzende Dienste
|ModTechName=32_yowsup.pm
|ModOwner=André / justme1968 ({{Link2FU|430|Forum}} / [[Benutzer Diskussion:justme|Wiki]])
}}

Das Modul [[yowsup]] dient dazu, WhatsApp-Nachrichten zu empfangen und zu senden.

== Voraussetzungen ==
* Die Funktionalität ist vermutlich auf Linux/Unix Systeme beschränkt.
* Nach der Erstinstallation/-einrichtung '''muss''' zwingend das ''cmd'' Attribut korrekt gesetzt werden.

== Anwendung ==
=== Define ===
* Fhem Device anlegen: <code> define <name> yowsup </code>
* 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, dass Fhem online ist
* zum Senden aus Fhem kann man das Kommando <code>set WhatsApp send <nummer> <text></code> verwenden

=== Attribute ===
* cmd komplettes Kommando, um den yowsup Client zu starten. z.B.: <code>attr WhatsApp cmd /opt/local/bin/yowsup-cli demos -c /root/config.yowsup --yowsup</code>
* 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-Befehl interpretiert. alles andere -> Wenn die Nachricht mit diesem Prefix startet, wird alles weitere als Befehle interpretiert.
{{Randnotiz|RNTyp=Warn|RNText='''allowedCommands''' should work as intended, but no guarantee can be given, that there is no way to circumvent it.}}
* allowedCommands 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 ===
Beim 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 einen Kontakt angelegt ist, lässt sich auch direkt dieses Device zum Senden verwenden:
:<code>set <device> send <text></code>,
d.h., man spart sich die Angabe der Nummer.
=== Gruppen ===
Gruppennachrichten werden von yowsup mit Sonderzeichen im Absender empfangen:
: 49yyyyyyyyyyyy/49xxxxxxxxxxx-1234567890
: absender/gründer-timestamp
Aufgrund der Sonderzeichen schlägt das automatische Anlegen einer yowsup Instanz fehl. Es kann aber zum versenden direkt die JID der Gruppe genutzt werden, oder manuell die yowsup Instanz ohne Sonderzeichen gemacht werden.
: erst kommt die Nummer des Gruppen erstellers, dann die Uhrzeit im Unix Zeitformat.
: 49xxxxxxxxxxx-1234567890
: gründer-timestamp
:<code>define whatsapp.gruppe yowsup 49xxxxxxxxxxx-1234567890</code>
==== JID der Gruppe ermitteln ====
Am einfachsten ist es, eine Nachricht an die Gruppe zu senden und aus der Fehlermeldung von fhem die JID herauszusuchen.
Etwas gezielter geht es mit der Auflistungsfunktion von yowsup direkt.
:<code>set WhatsApp raw /groups list</code>

Um die Ergebnisse eines raw Befehls im Log zu sehen, muss noch verbose 4 gesetzt werden:
:<code>attr WhatsApp verbose 4</code>
Dieses Attribut sollte wenn nicht mehr benötigt wieder gelöscht werden um unnötige Logeinträge zu vermeiden.

FHEMWiki - Benutzerbeiträge [de]

Yowsup