Created de:Plugins:yowsup (markdown)

de:Plugins:yowsup.md

@@ -0,0 +1,68 @@
+# Yowsup - WhatsApp Nachrichten verschicken
+
+Plugin um Meldungen über WhatsApp zu versenden.
+
+## 1. Allgemeines:
+Yowsup ist eine Linux Libary mit dessen man WhatsApp Nachrichten versendet werden können. 
+[Hier](https://www.johannespetz.de/yowsup-cli-linux-whatsapp-nachrichten-verschicken/) gibt es nochmal eine ausführliche Erklärung für die Installation und sonstige Nutzung,
+
+## 2. Installation:
+
+Das yowsup git Repository wird mit dem Befehl
+
+`git clone https://github.com/tgalal/yowsup/` auf die Linuxmaschine geklont. 
+Wer git noch nicht installiert hat, kann dieses mit `aptitude install git `tun.
+Danach kann mit `cd` in das Verzeichnis gewechselt werden.
+
+In diesem befindet sich wiederum eine „setup.py“ Datei. Diese wird darauf ausgeführt mit:
+`python setup.py install`
+
+## 3. Yowsup konfigurieren
+Die Konfigurationsdatei kann z.B. im Homeverzeichnis des Benutzers erstellt werden. Der Name der Datei kann beliebig gewählt werden. `nano /home/<user>/config.yowsup`
+
+Der Inhalt der Datei sollte folgend aussehen:
+
+`cc=49                         # Länderkennung`
+
+`phone=49xxxxxxxxxxx           # Handynummer`
+
+`id=                           # frei lassen`
+
+`password=                     # zunächst noch frei lassen`
+
+## 4. Yowsup registrieren
+
+WhatsApp muss die Handynummer erst registrieren. Dies funktioniert über einen SMS Code, der von WhatsApp an die angegebene Handynummer in der Konfigurationsdatei geschickt wird.
+
+`yowsup-cli registration -c config.yowsup --requestcode sms`
+
+Nach kurzer Zeit sollte eine SMS mit dem benötigten Code auf dem Handy ankommen. Dieser Code muss über die Kommandozeile eingetragen werden:
+
+`yowsup-cli registration --register 000-000 -c config.yowsup`
+
+Die „000-000“ steht hierbei für den Code. Das Password, welches ausgegeben wird, muss vermerkt werden. Es sollte zudem in der config.yowsup mit der Handynummer eingetragen werden.
+
+## 5. Gruppen - ChatID herausfinden
+Um die ChatID herauszufinden muss als erstes yowsup gestartet werden. `yowsup-cli demos -c config.yowsup -y`
+Darauf folgt ein login mit `/L`. Die WhatsApp-Nummer muss vorher zu einer WhatsApp-Gruppe hinzugefügt werden. Zuletzt werden alle Gruppen mit Hilfe von `/groups list` aufgelistet. 
+
+## 6. Config bearbeiten
+
+Im Abschnitt `[yowsup]` der config.ini befindet sich die Konfiguration für das yowsup-Plugin.
+
+Das Password und die Handynummer aus Kapitel `4. Yowsup registrieren` müssen in die Config-Datei eingetragen werden. Der Empfänger kann sowohl eine Einzelperson (Handynummer) als auch eine WhatsApp-Gruppe sein. Dafür muss entweder die Nummer bzw. die ChatID eingetragen werden. Siehe Kapitel `5. Gruppen - ChatID herausfinden`.
+
+```php
+# number or chat-number who whants to become the news
+empfaenger = 
+# WhatsApp-number of that the news comes
+sender = 
+# password from this number
+password= 
+
+fms_message = %DATE% %TIME%: %FMS%
+
+zvei_message = %DATE% %TIME%: %ZVEI%
+
+poc_message = %MSG%
+```