Telegram Messenger und die Bot API - Teil 2

Im ersten Teil - Telegram Messenger und die Bot API - bin ich auf einige Grundlagen eingegangen wie man einen Telegram-Bot einrichtet und diesen nutzt um sich Nachrichten, Informationen und sonstiges bequem auf sein Handy Handy zu schicken. Da sich dieses Werkzeug als äußerst praktisch erwiesen hat, habe ich mich dazu entschlossen den vorherigen Beitrag nochmal aufzugreifen und etwas aufzubohren sprich zu erweitern.

Es geht darum nicht mehr bloß irgendwelche Informationen zu einem vordefinierten Zeitpunkt zu erhalten, sondern vereinfacht gesagt in mehr oder weniger direktem Kontakt mit seinem Backend zu treten. Hier ein Beispiel wie man seinem Messenger-Bot beibringt auf eure Nachrichten zu reagieren. Um das Ganze relativ kurz und knackig zu halten werde ich hier nur die Einrichtung des Webhooks und das Verarbeiten eines Kommandos mit einem einfachen PHP-Script erklären. Bei allem weiteren was Programmierung angeht sind der eigenen Kreativität keine Grenzen mehr gesetzt. ;-)

Wie in Teil 1 schon erwähnt gibt es in der Dokumentation der Telegram Bot-API die Funktion setWebhook. Diese nutzt man um dem eigenen Telegram-Bot zunächst mitzuteilen wohin in Zukunft empfangene Nachrichten gesendet werden sollen. Hier übermittelt man einmalig u.a. eine URL zum Script auf eurem Server, welches die Nachrichten verarbeiten soll.

Der einmalige Aufruf (z.B. über den eigenen Browser) zur Einrichtung sieht dann wie folgt aus, wobei <HIER BOT-TOKEN> durch euren eigenen Auth-Token zu ersetzen ist. Gleiches gilt für den Parameter URL.

https://api.telegram.org/<HIER BOT-TOKEN>/setWebhook?url=https://www.meineseite.de/msg_receive_89572953227abdkjln438902.php&max_connections=5&allowed_updates=["message"]

Möchte man nicht nur Messages empfangen sondern auch jede andere Benachrichtigung (siehe Telegram Dokumentation) so lässt man den allowed_updates-Parameter einfach weg oder erweitert diesen um die jeweiligen Events.

Aus Sicherheitsgründen empfiehlt es sich das Script für die Verarbeitung in einen Unterordner zu packen, der einen "exotischen" Namen trägt, den man nicht erraten kann, oder gleich das Script so zu nennen. In meinem Beispiel heißt das PHP-Script:
msg_receive_8957295322$!p7abdkjln438902.php

Jetzt wo die Einrichtung des Webhooks klar ist, legen wir das besagte Script auf unserem Server an. Da Telegram die Status-Meldung per JSON-Object (JSON-serialized) an den Server schickt, müssen wir diese zunächst eingegen nehmen. Danach wandeln wir das JSON-Object in ein Array um.

$request = file_get_contents('php://input');
$request = json_decode($request, true);

if(!$request || !isset($request['message'])){
     //request ungültig
}else{
     //soweit sogut! hier nachricht auswerten
     //Hier Nachricht auswerten und dem User antworten.
}

Um sich einen Überblick zu verschaffen welche Informationen im Array liegen kann man dieses z.B. per $output = print_r($request, true); zurückgeben lassen und $output in eine Datei oder Datenbank auf dem Server schreiben.

In diesem Beispiel sind aber nur 3 Informationen interessant. Die Absender-ID, Benutzername und der Inhalt der Nachricht. Diese speichern wir in jeweils einer Variablen zwischen, für bessere Übersichtlichkeit:

$absender_id = $request['message']['chat']['id'];
$benutzername = $request['message']['chat']['username'];
$nachricht = strtolower(trim($request['message']['text']));

Im nächsten und letzten Schritt wird der Switch durchlaufen und wenn das Kommando bzw. die Nachricht bekannt ist (z.B. "Hello World") dann wird eine passende Antwort generiert und dem Benutzer per Telegram geschickt. Schickt man dem Bot also über Telegram "Hello World", antwortet dieser mit "hello <username>! how are u? ;)". Der Code dazu sieht dann so aus:

$answer = "";
switch ($msg)
{
     case "hello world":
          $answer = "hello ".$username."! how are u? ;)"; break;
}

if (strlen($answer)>0)
{
     //Antwort an User schicken; siehe Part 1
     $request = TELEGRAM_URL;

     $request = str_replace("<ID>", $chat_id, $request);
     $request = str_replace("<TEXT>", urlencode($answer), $request);

     $response = @file_get_contents($request);
     $positive_answer = "{\"ok\":true";
     $telegram_sent = (substr($response, 0, strlen($positive_answer)) == $positive_answer);
}

Die Switch-Anweisung kann nun um beliebige cases und Funktionen erweitert werden.

Der Code an sich ist sicherlich nicht perfekt, aber ich hoffe leicht verständlich und es hilft als kleinen Einstieg in die Materie.

Viel Spaß beim proggen! :)

Zuletzt bearbeitet: 7. Juni, 2018
Tags: , , , , , , , , ,

Verwandte Beiträge

Nebenkosten App

Wie im Bürgerlichen Gesetzbuch festgelegt müssen Vermieter ihren Mietern jährlich eine Abrechnung der Betriebskosten übermitteln, doch das erstellten einer Abrechnung kostet Zeit. Mit dieser App lassen sich auf einfache Weise Nebenkostenabrechnungen erstellen. Nach Eingabe der Daten und einer Vorschau zum zur Überprüfung der Eingaben erhalten sie eine professionelle Abrechnung im PDF Format, welche gedruckt und [...] Weiterlesen »


ESP8266-WiFi-Modul flashen

Da ich mich seit kurzem wieder intensiver mit den Themen Smart Home und "Home automation" beschäftige habe ich beschlossen einige meiner Baustellen, Stolpersteine und Lösungen hier zu veröffentlichen. Wie im Beitrag zu meinem Smart-Home-Project V1 bereits erwähnt setze ich auf das WLAN-Modul ESP8266-ESP01 , da dieses unter anderem klein, zuverlässig und günstig ist. In diesem [...] Weiterlesen »


Apps und Spiele für Apple Watch

Die experimentelle Suchmaschine von Saschas-Bastelstube.de für iOS- und Android-Apps wurde um eine weitere Kategorie und Funktionalität erweitert. Ab sofort findet man hier neben aktuell reduzierten Apps und Spielen auch Software speziell für die Apple Watch (WatchOS). Eine Sortierfunktion nach Kundenbewertungen, um sich schnell die Top-Apps und Top-Spiele  anzeigen zulassen, gibt es jetzt auch. Genau wie ein [...] Weiterlesen »


Safari Abenteuer: Wir entdecken Afrika - Brettspiel für Kinder

Safari Abenteuer: Wir entdecken Afrika - Brettspiel für Kinder, Schüler, Familie - von Kindermatica Ltd. Bring Familie und Freunde mit dem Safari-Rätselspiel zusammen! In diesem kinderfreundlichen Brettspiel für mehrere Spieler wirst du die Bewohner der heißen Savanne kennen lernen und erstaunliche Abenteuer in Afrika erleben! Du könntest einen Löwen treffen, dich Regenschauern schützen, eine Brücke [...] Weiterlesen »


tedokai.de - Karate-App

Die tedokai.de–Karate–App beinhaltet einige schöne Funktionen wie eine Verwaltung der eigenen Trainerlizenzen. Desweiteren ist es möglich einen individuellen Trainingsplan mit Hilfe des Kihon-Generators zu erstellen und auszudrucken. Der Funktionsumfang im Überblick: • Verwaltung für Trainer-Lizenzen. • Kihon-Generator / Eigenes Kihon-Programm erstellen. • Kihon-Programm als PDF-Datei exportieren, drucken oder per E-Mail senden. • Kihon-Programm als Import-URL [...] Weiterlesen »