Dein eigener Bierlift Telegram Bot

Your own Beerlift Telegram Bot

Mit Hilfe des von vielen beliebten Telegram Messengers ist nun auch möglich den Bierlift zu steuern. Außerdem werdet ihr vom Bierlift Status-Benachrichtigungen bekommen, auch wenn der Bierlift während euer Abwesenheit benutzt wird.

Mit der folgenden Anleitung werdet ihr einen eigenen Telegram Bot für euren Bierlift erstellen. Bitte beachtet, das in diesem Tutorial nur die wichtigsten Bot-Einstellungen und Funktionen beschrieben werden. Für die erweiterten Einstellungen gibt es sehr viele Anleitungen im Internet.

Installiert und startet den Telegram-Messenger und tippt auf das Lupen-Symbol. In das Suchfeld gibt @BotFather ein.

 

Wählt diesen Bot aus und startet ihn dann. Mit dem Kommando /newbot wird der BotFather angewiesen, einen neuen Bot zu erstellen.

 

Anschließend werdet ihr aufgefordert, einen Anzeigenamen für Ihren Bot zu vergeben. Dieser Name kann bereits auf Telegram existieren und muss nicht eindeutig sein. Im Beispiel unten habe ich meinen Bot Bierlift genannt.

 

Danach müsst ihr einen User-Namen festlegen. Für den gelten strenge Regeln. Der Name muss auf bot enden und darf noch nicht vergeben sein. Die Suche nach einem freien Benutzernamen kann etwas langwierig sein, wie auf dem folgenden Bild zu sehen ist.

Anschließend legt Telegram euren Bot an. Die Willkommensnachricht enthält unter anderem einen Token, den ihr für die weiteren Bierlift  WebServer Einstellungen benötigt. Es empfiehlt sich, diesen Token nicht an andere weiterzugeben.

Kopiert den Token in die Zwischenablage, öffnet die Bierliftsteuerung und wechselt zu Telegram im Navigationsmenü. Fügt den Inhalt der Zwischenablage in das Feld Telegram Bot API Token ein.

Um die Benachrichtigungen von eurem Bierlift zu bekommen, müsst ihr die Option Benachrichtigung an Administrator aktivieren und euren Telegram ID in das Feld Admin ID eintippen. Euren ID könnt ihr vom IDBot erfahren. Tippt im Telegram Messenger auf das Lupensymbol und gibt @username_to_id_bot ein. Wählt diesen Bot und tippt /start ein.

Nun wählt im Chatbereich euren Bot aus und startet ihn mit dem Kommando /start.

Bierlift WebServer mit Blynk und Alexa steuern

Bierlift WebServer mit Blynk und Alexa steuern

Verbindung des Bierlift WebServers mit dem Blynk Server ist nur ab Version 2021.02.10a möglich. Falls ihr die Bierlift WebServer Version 2020.12.24b habt, bitte vorerst auf die neueste Version updaten.

Blynk

Im App Store/Google Play nach Blynk suchen und installieren

gleich starten und ein Account erstellen. Im Fenster für das neue Projekt das Symbol für das QR-Code antippen.

Kamera freigeben und das QR-Code scannen.

mit Temperaturchart

Falls ihr eine Meldung bekommt, dass ihr nicht genug Energie für dieses Projekt habt, könnt ihr mit diesem QR Kode ohne Temperaturchart versuchen.

ohne Temperaturchart

Auf eurem Smartphone soll nun das folgende Bild zu sehen sein. Tippt nun das Sechskantmutter Symbol an.

ohne Temperaturchart

tippt den Button E-Mail. Der Token wird an eure Mailadresse versendet, die ihr bei der Registrierung angegeben habt. Nun öffnet den Bierlift WebServer in eurem Browser. Aktiviert die Option Use Blynk und fügt den Blynk Token in das Feld Blynk API key ein. Wenn der Webserver sich mit dem Blynk Server verbunden hat, ist der Blynk status Connected.

ohne Temperaturchart

Wechselt zur Blynk App und tippt das Play-Symbol oben rechts.

ohne Temperaturchart

Alexa

wie ihr euren eigenen Alexa Skill erstellen könnt, wurde bereits in diesem Blog beschrieben. Bitte für das Einrichten die aktuellen Dateien Alexa.txt and Lambda.txt aus dem Bereich Downloads runterladen.

Alexa, ich habe Durst!

Alexa, ich habe Durst!

Hallo liebe Bierliftfreunde. Wie ich vor kurzem angekündigt habe, werde ich euch in diesem Blog die Alexa Steuerung für den Bierlift vorstellen und euch in einem Tutorial zeigen, wie ihr euren eigenen Alexa Skill erstellen könnt. Dieser Skill wird nur für euch persönlich zur Verfügung stehen und nicht im Skill Store für jedermann zu aktivieren sein! Wenn ihr bereits euren Bierlift gebaut und ESP32 programmiert habt, wird auch die Skill-Erstellung für euch unproblematisch sein.

 Alexa Steuerung macht deinen Bierlift noch cooler und wird zu einer Überraschung-Highlight deiner Party.

Schaut selber…

Im folgenden Video sind auch andere Sprachanweisungen vorgestellt. Ihr könnt auch erkennen, dass Alexa zusammen mit Blynk App synchron arbeitet. Das heißt, der Bierlift kann sowohl mit Alexa als auch mit dem Smartphone gesteuert werden.

Natürlich könnt ihr sowohl Antworten von Alexa als auch die Sprachanweisungen nach eurem Geschmack anpassen, indem ihr den Skill modifiziert. Ich empfehle jedoch, falls ihr noch keine Erfahrung in der Skill-Erstellung habt, exakt den Anweisungen im Tutorial zu folgen. Erst wenn der Skill funktioniert, könnt ihr versuchen, schrittweise den Programmcode anzupassen.

Funktionen

Bierlift Skill aktivieren

Äußerung beginnen mit

  • Alexa, starte Bier Lift“
  • „Alexa, Bier Lift“

Antwort „Bierlift Skill gestartet“

Bierlift-Temperatur abfragen

 Äußerung beginnen mit

  • „Temperatur“
  • „Wie kalt ist mein Bier?“
  • „Wie warm ist mein Bier?“

Antwort „Temperatur im Bierlift beträgt xx Grad“

Außentemperatur abfragen

 Äußerung beginnen mit

  • „Außentemperatur“

Antwort „Außentemperatur beträgt xx Grad“

Bierlift hochfahren

Äußerung beginnen mit

  • „fahre den Bierlift hoch“
  • „ich habe Durst!“
  • „hoch“
  • „nach oben fahren“

Antwort „Bierlift fährt hoch“

Bierlift runterfahren

Äußerung beginnen mit

  • „fahre den Bierlift runter“
  • „verstecke das Bier!“
  • „runter“
  • „nach unten fahren“

Antwort „Bierlift fährt runter“

Wenn Alexa dich nicht verstanden hat

 Antwort „Unklare Anweisung. Kein Bier“ 

Voraussetzungen für die Erstellung eines eigenen Alexa Skills für den Bierlift

Bei der Anmeldung bei AWS wird eine Kreditkarte benötigt. Keine Sorge, bei der Registrierung des AWS-Konto entstehen euch keine Kosten. Bei AWS Lambda umfasst das kostenlose Kontingent derzeit 1. Mio. Anforderungen pro Monat. Ich bin der festen Überzeugung, dass ihr dieses Limit nicht mit eurem Bierlift Skill sprengen werdet.

Solltet ihr einen der oben genannten Punkte nicht erfüllen können, ist diese Anleitung eher nichts für euch. Danke, dass ihr trotzdem bis hierher gelesen habt!  🙂

Tutorial

Meldet euch bei Amazon Developer an. Wenn ihr noch keinen Amazon-Developer-Account besitzt, erstellt ein kostenloses Entwicklerkonto. Für die Anmeldung verwendet euren bestehenden Amazon Account, damit eure  Skills sofort auf allen Echos verfügbar sind, die mit eurem Account verbunden sind.

Klickt im Drop-down-Menü unter Produkte auf „Alexa Skills Kit“ und anschließend auf „Skill entwickeln“, um die Alexa-Developer-Konsole zu öffnen.

Nach dem Login werdet ihr auf die Service-Übersicht gelangen. Wählt hier „Amazon Alexa“ aus.

Klickt im Drop-down-Menü unter Produkte auf „Alexa Skills Kit“ und anschließend auf „Skill entwickeln“, um die Alexa-Developer-Konsole zu öffnen.

Auf der Startseite der Alexa-Developer-Konsole werden euch zukünftig alle selbst erstellten Alexa-Skills angezeigt. Meldet ihr euch zum ersten Mal an, ist die Liste leer.

Klickt auf „Create Skill“, um einen neuen Alexa-Skill zu erstellen.

Tragt als „Skill Name“ die Bezeichnung „KE Bierlift“ , Default language –> German (DE)  und wählt als Model Typ „Custom“ aus. Klickt anschließend auf „Create skill“, um den Entwicklungsprozess zu starten. Ihr werdet automatisch in die Bearbeitungsansicht der Alexa-Developer-Konsole weitergeleitet.

Klickt auf JSON Editor. Überschreibt den Inhalt im Editorbereich mit dem Inhalt aus der Datei Alexa.txt, speichert das Model und klickt auf „Build Model“

Die Amazon-Developer-Konsole spielt eine Push-Nachricht aus, in der ihr darüber informiert werdet, dass der Build-Prozess gestartet wurde.

Wartet, bis die Konsole euch meldet, dass das Interaktionsmodell erfolgreich erstellt wurde.

Klickt auf „Endpoint“ und aktiviert die Checkbox bei „AWS Lambda ARN“. Den erstellten Skill ID werden wir später bei der Programmierung der Lambda Funktion brauchen.

Meldet euch bei eurem AWS-Konto an und wählt unter „Mein Konto“ die „AWS Management Console“ aus.

Stellt zunächst sicher, dass eure Konsole auf die Region „EU (Ireland)“ eingestellt ist,  sofern euer Skill euch in Deutschland zur Verfügung stellen soll.

Gibt das Stichwort „Lambda“ in die Suchmaske ein und bestätigt mit Enter.

Klickt auf „Funktion erstellen“, um den Konfigurationsprozess für eine neue Lambda-Funktion zu starten.

Wählt die Option „Ohne Vorgabe erstellen“ und einen Namen für die Funkion aus. In unserem Beispiel soll die Funktion „MyBierLiftFunction“ heißen. Anschließend klickt auf Funktion erstellen.

Nachdem eure Lambda-Funktion erstellt wurde, werdet ihr automatisch in die Konfigurationsübersicht der Lambda-Funktion weitergeleitet, in der ihr alle weiteren Einstellungen vornimmt.

Im oberen Bereich der Konfigurationsübersicht findet ihr den Funktionsdesigner und einen Editor, mit dem ihr manuell in den Funktionscode eingreifen könnt.

Damit unser Alexa-Skill von Anwendern über einen Smart Speaker angesprochen werden kann, ist eine beidseitige Verknüpfung erforderlich. Im Bereich Designer klickt auf „+ Auslöser hinzufügen“.

Im folgenden Fenster wählt als Auslöser „Alexa Skills Kit“ aus. Aktiviert die Qualifikations-ID-Verifizierung, kopiert die Skill ID von der Alexa Developer Console (siehe oben das Bild mit dem Endpoint) in die Zwischenablage und tragt diese anschließend als Qualifikations-ID eurer Lambda-Funktion ein. Anschließend klickt auf Hinzufügen.

Um den Web-Service-Endpunkt für euren Skill zu definieren, scrollt in der Konfigurationsübersicht eurer Lambda-Funktion ganz nach oben. Kopiert den ARN in der rechten oberen Ecke eures Browserfensters in die Zwischenablage und wechselt in die Alexa-Developer-Konsole.

Wählt im Navigationsmenü der Alexa-Developer-Konsole erneut den Punkt „Endpoint“ aus (sofern dieser nicht bereits ausgewählt ist) und fügt den kopierten ARN in das Feld „Default Region“ ein. Klick anschließend auf „Save Endpoints“.

Kopiert den Inhalt der Textdatei Lambda.txt (für alte Steuerung Bierlift-Shield Lambda.txt) in die Zwischenablage und ruft die Konfigurationsübersicht eurer Lambda-Funktion in der AWS-Managementkonsole auf. Fügt nun das Template als Funktionscode für eure Lambda-Funktion ein. In der 2. Zeile muss gleich die Variable const token geändert werden. Fügt zwischen den Anführungszeichen euren Blynk Token ein. Optional könnt ihr gleich im Bereich Optionen die Alexa Antworten nach eurem Geschmack anpassen. Hierzu müssen lediglich die Texteingaben zwischen den Anführungszeichen geändert werden. Klickt auf „Speichern“, um die Änderung zu übernehmen

Testen

Um euren neuen Alexa-Skill zu nutzen, braucht ihr keine besonderen Kommandos. Ihr verwendet den selbst erstellten Bierlift Skill genauso wie diejenigen, die ihr schon von Drittanbietern verwendet habt.

 Zum Starten sagt einfach „Alexa, starte Bier Lift“

 Wenn Alexa „Bier Lift Skill gestartet“ antwortet, Glückwünsche! Ihr habt es geschafft. Euer Skill ist fertig und sofort einsatzbereit. Mit den Anweisungen, die ich oben beschrieben habe, könnt ihr nun euren Bierlift steuern.

Fazit

Ich habe Alexa Echo Dot erst seit ca. einem Monat bei mir Zuhause (Stand 21.03.2020). Der Bierlift Skill ist auch mein erster selbst entwickelter Skill. Und ich bin kein Programmierer 🙂 Bitte habt Verständnis dafür, dass ich hier nicht jedem dabei helfen kann, eventuelle Probleme zu lösen. 

 Wenn euch diese Anleitung geholfen hat, euren eigenen Bierlift Skill zu erstellen, dann würde ich mich über einen Kommentar natürlich freuen. Natürlich freue ich mich auch über Anregungen, Lob oder Kritik.

en_GB