Zum Hauptinhalt springen

OVHcloud SMS Smart-Home-Integration, kostenlos und Open Source

OVHcloud SMS-Integration für Gladys Assistant

Gladys-Benachrichtigungen per SMS über OVHcloud, an jeden Anbieter, mit Szenen und Widgets.

Auf GitHub ansehenAlle Integrationen

Überblick​

Diese Integration sendet die Benachrichtigungen von Gladys per SMS über die SMS-API von OVHcloud (Seite auf Englisch), an jede Mobilnummer und jeden Anbieter. Jeder Gladys-Benutzer gibt seine eigene Nummer ein; der Administrator gibt die Schlüssel der OVHcloud-API einmal für das Haus ein.

Außerdem bringt sie:

  • drei Szenenauslöser: SMS nicht gesendet, SMS empfangen, wenig Guthaben;
  • zwei Szenenaktionen: eine SMS an eine beliebige Nummer senden (auch an jemanden ohne Gladys-Konto), das SMS-Konto lesen;
  • zwei Dashboard-Widgets: das SMS-Konto und die empfangenen SMS.

Die zwei Widgets der Integration: das SMS-Konto mit seinem Guthaben und die zuletzt empfangenen SMS (generierte Illustration, kein Screenshot)

Transport: Cloud. Die Texte und die Rufnummern laufen über die OVHcloud-API (eu.api.ovh.com oder ca.api.ovh.com) und dann über die Mobilfunkanbieter.

Voraussetzungen​

  • Gladys Assistant 5.1.0 oder neuer.
  • Ein OVHcloud-Konto mit einem SMS-Konto (ein SMS-Paket, bestellt im Control Panel unter Telecom → SMS) und etwas Guthaben. Jede SMS verbraucht Guthaben, mehr bei einem langen Text oder einer ausländischen Nummer.
  • Optional: ein im Control Panel angelegter und freigegebener Absender (ein Name wie GLADYS oder eine virtuelle Nummer). Ohne ihn gehen die SMS von einer Kurznummer aus, auf die die Empfänger antworten können.
  • Optional, zum Empfangen von SMS: eine virtuelle Nummer oder Antworten an die Kurznummer.

Konfiguration​

  1. Öffnen Sie in Gladys Integrationen → OVHcloud SMS → Konfiguration.
  2. Wählen Sie die API-Region Ihres OVHcloud-Kontos (Europa oder Kanada).
  3. Klicken Sie auf Schlüssel erstellen für Ihre Region. Melden Sie sich bei OVHcloud an: Die Rechte, die die Integration braucht, sind bereits ausgefüllt (GET /sms, GET /sms/*, POST /sms/*/jobs). Geben Sie der Anwendung einen Namen und eine Beschreibung, wählen Sie die Gültigkeit Unlimited und erstellen Sie die Schlüssel.
  4. Übertragen Sie Application Key, Application Secret und Consumer Key in die Konfiguration und speichern Sie.
  5. Klicken Sie auf Verbindung testen: Es zeigt das SMS-Konto, sein Guthaben, seine Absender und den verwendeten. Test-SMS senden prüft die ganze Kette.
  6. Jeder Benutzer öffnet den Block Mein Konto desselben Bildschirms und gibt seine Mobilnummer ein.
FeldVerwendung
API-RegionEuropa (ovh.com, ovhcloud.com) oder Kanada (ovh.ca)
Application KeyVon der Seite zur Schlüsselerstellung
Application SecretVon der Seite zur Schlüsselerstellung, verschlüsselt gespeichert
Consumer KeyVon der Seite zur Schlüsselerstellung, verschlüsselt gespeichert
SMS-KontoOptional: sms-xx12345-1, nur wenn das OVHcloud-Konto mehrere hat
AbsenderOptional: ein aktiver Absender; leer = der erste aktive oder die Kurznummer
Standard-LändervorwahlWird Nummern ohne Vorwahl vorangestellt (33 als Standard: 06… wird zu +336…)
Warnung bei wenig GuthabenUnter dieser Guthabenzahl löst „Wenig Guthaben“ einmal aus (Standard 20)
Empfangene SMS lesenLiest die empfangenen SMS alle 30 Sekunden, für „SMS empfangen“ und das Widget

Die Integration fügt nie den „STOP“-Hinweis hinzu, den OVHcloud an Werbe-SMS anhängt: Die Benachrichtigungen eines Hauses sind keine Werbung.

Verwendung​

Benachrichtigungen​

Jede Gladys-Benachrichtigung an einen Benutzer, der eine Nummer eingegeben hat, geht per SMS raus: Alarme, Szenenaktionen „Nachricht senden“, Antworten von Gladys. Ein an eine Nachricht angehängtes Bild entfällt (eine SMS transportiert nur Text).

Szenenauslöser​

AuslöserWann er auslöstVariablen
SMS nicht gesendetBeim ersten Fehler einer Benachrichtigung, danach erst wieder nach einer erfolgreichen SMS (keine Schleife)Ursache, HTTP-Status, Fehler, maskierte Nummer
SMS empfangenBei jeder neuen SMS des Kontos, gefiltert nach Absender und erstem Wort („Empfangene SMS lesen“ muss aktiv sein)Absender, Text, erstes Wort, Datum
Wenig GuthabenDas Guthaben ist unter die Schwelle gefallen; erneut erst nach einer Aufladung darüberRestguthaben, Schwelle, SMS-Konto

Nutzen Sie „SMS empfangen“ nie, um eine Tür zu öffnen oder eine Alarmanlage zu entschärfen: Jeder kann eine SMS mit gefälschter Nummer senden.

Szenenaktionen​

  • SMS an eine Nummer senden: eine oder mehrere durch Kommas getrennte Nummern und ein Text (Szenenvariablen erlaubt). Gibt die gesendeten SMS, die abgelehnten Nummern, das verbrauchte und das restliche Guthaben zurück.
  • SMS-Konto lesen: gibt das Restguthaben, die in diesem Monat gesendeten und empfangenen SMS und das SMS-Konto zurück.

Szenenbeispiele​

  • Wenn der Alarm ausgelöst wird → eine SMS an den Nachbarn senden: „Alarm bei uns zu Hause, kannst du nachsehen?“.
  • Wenn das Guthaben knapp wird → dem Administrator eine Nachricht senden: „Nur noch {{triggerEvent.data.credits_left}} SMS-Guthaben“.
  • Wenn eine SMS mit STATUS von meiner Nummer empfangen wird → die Temperaturen lesen und mit „SMS an eine Nummer senden“ an {{triggerEvent.data.sender}} antworten.

Dashboard-Widgets​

  • OVHcloud-SMS: Restguthaben (orange nahe der Schwelle, rot darunter), Zustand der API, in diesem Monat gesendete und empfangene SMS, Absender, Schwelle und letzter Fehler.
  • Empfangene SMS: die zuletzt empfangenen SMS; tippen Sie auf eine, um sie ganz zu lesen.

Fehlerbehebung​

  • „OVHcloud lehnt die Schlüssel ab“: Prüfen Sie Region, Application Key und Secret und ob der Consumer Key bestätigt wurde (die Erstellungsseite muss mit einem Erfolg enden) und nicht abgelaufen oder widerrufen ist.
  • „Dem Consumer Key fehlen Rechte“: Erstellen Sie einen neuen Schlüssel über den Link der Konfiguration, der die drei Rechte ausfüllt.
  • „Kein nutzbares SMS-Konto“: Bestellen Sie ein SMS-Paket oder geben Sie den Dienstnamen ein, wenn Ihr OVHcloud-Konto mehrere SMS-Konten hat (von „Verbindung testen“ aufgelistet).
  • „Absender abgelehnt“: Der Absender der Konfiguration ist noch nicht aktiv (wartet auf Freigabe): Leeren Sie das Feld für die automatische Wahl.
  • Keine SMS empfangen: Der Empfang braucht eine virtuelle Nummer oder Antworten an die Kurznummer; prüfen Sie, ob „Empfangene SMS lesen“ aktiv ist.
  • Protokolle: Integrationen → OVHcloud SMS → Reiter Überwachung. Die Rufnummern sind maskiert; die Schlüssel erscheinen nie.

Konfigurationseinstellungen​

Diese Einstellungen fragt OVHcloud SMS in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Schlüssel der OVHcloud-APIsectionNeinSie benötigen ein SMS-Konto bei OVHcloud (ein SMS-Paket, bestellt im Control Panel unter Telecom → SMS). Öffnen Sie unten die Seite zur Schlüsselerstellung Ihrer Region und melden Sie sich an: Die Rechte, die die Integration braucht, sind bereits ausgefüllt (GET /sms, GET /sms/, POST /sms//jobs). Geben Sie der Anwendung einen Namen und eine Beschreibung, wählen Sie die Gültigkeit „Unlimited“ und übertragen Sie dann Application Key, Application Secret und Consumer Key hierher.
API-RegionselectJaWo Ihr OVHcloud-Konto angelegt wurde: Europa (ovh.com, ovhcloud.com) oder Kanada (ovh.ca).
Application KeystringJa„Application key“ auf der Seite zur Schlüsselerstellung.
Application SecretsecretJa„Application secret“. Wird verschlüsselt gespeichert und nie wieder angezeigt.
Consumer KeysecretJa„Consumer key“. Wird verschlüsselt gespeichert und nie wieder angezeigt.
SMS-Konto und AbsendersectionNeinLassen Sie beide Felder leer, um das einzige SMS-Konto Ihres OVHcloud-Kontos und seinen ersten aktiven Absender zu verwenden. Ohne aktiven Absender gehen die SMS von einer Kurznummer aus, auf die die Empfänger antworten können. Ein Namensabsender (zum Beispiel GLADYS) muss zuerst im Control Panel angelegt und freigegeben werden. Die Schaltfläche „Verbindung testen“ unten listet die gefundenen Konten und Absender auf.
SMS-KontostringNeinOptional. Sein Dienstname, sms-xx12345-1, nur nötig, wenn Ihr OVHcloud-Konto mehrere hat.
AbsenderstringNeinOptional. Ein aktiver Absender des SMS-Kontos: ein Name (GLADYS) oder eine virtuelle Nummer (+33…).
Standard-LändervorwahlstringNeinWird Nummern ohne Vorwahl vorangestellt (06 12 34 56 78 wird zu +33 6 12 34 56 78). Nur Ziffern: 49 Deutschland, 43 Österreich, 41 Schweiz, 33 Frankreich.
Guthaben und EmpfangsectionNeinDas Guthaben wird alle 15 Minuten und nach jeder SMS gelesen. Der Empfang liest alle 30 Sekunden die auf dem Konto empfangenen SMS, für den Szenenauslöser „SMS empfangen“ und das Dashboard: Dafür braucht es eine virtuelle Nummer oder SMS, die mit der Kurznummer für Antworten gesendet wurden.
Warnung bei wenig GuthabennumberNeinUnter dieser Guthabenzahl löst der Szenenauslöser „Wenig Guthaben“ einmal aus.
Empfangene SMS lesenbooleanNeinLöst „SMS empfangen“ für jede neue SMS des Kontos aus. Jeder kann eine SMS mit gefälschter Nummer senden: Nutzen Sie es nie, um eine Tür zu öffnen oder eine Alarmanlage zu entschärfen.

So installierst du OVHcloud SMS in Gladys​

  1. Öffne in Gladys Integrationen: OVHcloud SMS erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/william-de71/gladys-ovhcloud-sms:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-ovhcloud-sms.

OVHcloud SMS benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

OVHcloud SMS ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am