Einrichtungshinweise für die Verbindung von HConnect zu IFTTT, Pushover oder SMS
Die Homematic-Zentrale ist in der Lage Benachrichtigungen zu versenden wenn sich z.B. der Schaltzustand eines Aktors verändert oder ein Bewegungsmelder eine Bewegung registriert etc. Von nahezu allen Datenpunkten der Homematic-Geräte können diese Zustandsänderungen empfangen werden. In der @Events-Konfiguration von HConnect kann festgelegt werden, welche weiteren Aktionen bei einem Empfang einer Nachricht der Homematic-Zentrale ausgeführt werden sollen. So können z.B. die Plattformen IFTTT oder Pushover angebunden werden um weitere Automatisierungen einzurichten. Für die Verarbeitung von Homematic-Benachrichtigungen von HConnect wird eine Premium Lizenz oder eine Basis-Lizenz mit Events-Lizenz benötigt
Um auf Zustandsänderungen der Homematic-Zentrale reagieren zu können, müssen Sie diese Events auf der HConnect-Plattform registrieren. Hierzu bietet HConnect die Event-Registrierung an. Sie aktivieren die Registrierung von Events und lösen innerhalb der nächsten 2 Minuten einen Vorgang in der Homematic-Zentrale aus (z.B. Einschalten eines Aktors, oder lösen einen Bewegungsmelder aus). HConnect empfängt innerhalb dieser 2 Minuten die Events der Homematic-Zentrale und bietet Ihnen diese Events zur weiteren Konfiguration an. Diese Homematic-Events benötigen Sie im weiteren Verlauf der Konfiguration um einzustellen, welche Aktionen HConnect durchführen soll, wenn Events dieser Art empfangen werden. Im folgenden wird beschrieben wie Sie die gewünschten Events registrieren können.
Diese Vorgehensweise eignet sich immer dann, wenn Sie bereits genau wissen von welchem Gerät/Kanal ein Event empfangen wird, auf welches Sie reagieren möchten. Es werden Ihnen in den 2 Minuten der Event-Registrierung dann nur Events eines ausgewählten Gerätes/Kanals angezeigt.
Diese Vorgehensweise eignet sich dann, wenn Sie nicht genau wissen von welchem Gerät/Kanal das Event kommt, welches Sie überwachen möchten. Es werden Ihnen in den 2 Minuten der Event-Registrierung dann alle Events angezeigt, welche von der Homematic-Zentrale gesendet werden.
In der Liste der Event-Registrierung werden alle empfangenen Events der Homematic-Zentrale angezeigt. Diese Events werden aber damit noch nicht permanent überwacht. Die Event-Registrierung soll lediglich dazu dienen die richtigen Events auszuwählen, welche dann später permanent überwacht werden sollen.
In der List der Event-Registrierung haben Sie noch die Möglichkeit, bevor Sie das gewünschte Event der permanenten Überwachung hinzufügen, den Wert des Events zu verändern auf welchen reagiert werden soll. Möchten Sie z.B. darauf reagieren, wenn ein Heizungsthermostat auf 23 Grad gestellt wird, so können Sie in der Spalte Wert den Wert 23 explizit eintragen, auch wenn ein anderer Wert während der Überwachung empfangen wurde. Ist alles korrekt eingestellt, so fügen Sie das gewünschte Event mit dem blauen + Button der permanenten Überwachung hinzu. Damit können Sie später konfigurieren, welche Aktionen HConnect bei Empfang genau dieses Events ausführen soll.
Weitere Hinweise zur Event-Registrierung erhalten Sie in der Hilfe auf der entsprechenden Konfigurationsseite.
Homematic-Events, welche über die Event-Registrierung der permanenten Überwachung hinzugefügt wurden, können anschließend weiter bearbeitet werden. Dies ist z.B. dann sinnvoll, wenn Sie zwar auf ein bereits registriertes Event reagieren möchten, der Wert des Events sich jedoch verändert hat, bzw. Sie möchten auf einen anderen Wert reagieren. Zusätzlich kann der Name des Events bearbeitet werden und eingestellt werden, ob HConnect nur bei Änderung des angegebenen Wertes reagieren soll, oder jedes Mal. Im folgenden wird beschrieben wie Sie die bereits registrierten Events bearbeiten können.
Weitere Hinweise zur Event-Bearbeitung erhalten Sie in der Hilfe auf der entsprechenden Konfigurationsseite.
Wurde ein Homematic-Event ausgelöst, so kann eine Aktion über die IFTTT Plattform darüber ausgelöst werden. HConnect unterstützt aktuell den Aufruf eines Webhooks von IFTTT, mit welchem dann weitere beliebige Aktionen der Plattform ausgeführt werden können. So können Sie sich z.B. per Email benachrichtigen lassen. Im folgenden wird beschrieben, wie Sie das System dazu konfigurieren müssen.
Falls Sie noch keinen Account auf der IFTTT Plattform haben, so legen Sie sich zunächst einen kostenlosen Account dort an. Geben Sie auf der Homepage unter IFTTT einfach Ihre Email-Adresse an und klicken Sie auf "Get started"
Wenn Sie sich nicht mit Ihrer Email-Adresse anmelden möchten, so bietet IFTTT ebenfalls ein Login mit Facebook oder Google an. Wählen Sie in diesem Fall die entsprechenden Buttons unter der Email-Eingabezeile.
HConnect spricht die IFTTT Plattform über den Webhooks Service von IFTTT an. Ein Webhook ist ein Service von IFTTT welcher über eine URL angesprochen werden kann. Dem Webhook wird bei dem Aufruf zusätzlich ein Eventname übergeben. Über diese Eventnamen können Sie dann steuern, welche Aktion IFTTT ausführen soll. Damit Webhooks genutzt werden können, muss dieser Service auf der IFTTT Plattform zunächst aktiviert werden. Dies muss nur einmal erledigt werden. Sind Webhooks einmal aktiviert, so können Sie diesen Service in unterschiedlichen Events immer wieder verwenden und müssen Ihn nicht erneut zu aktivieren. Suchen Sie also im Suchbereich oben nach dem Service "Webhooks". Wird das Suchergebnis angezeigt, so klicken Sie auf den Bereich "Services" und es erscheint der Service Webhooks im unteren Bereich, welcher dann durch einen Klick verbunden werden kann.
Wird der Webhook Service das Erste mal verwendet, so muss dieser noch mit dem eigenen Benutzeraccount verbunden werden. Es erscheint dann eine Beschreibung des Webhook Services und man hat die Möglichkeit den Service zu verbinden. Klicken Sie dazu auf den Button CONNECT. Damit HConnect in der Lage ist Daten an diesen Webhook zu senden benötigt HConnect den persönlichen API-Key des Webhooks. Jeder Benutzer der IFTTT Plattform erhält für den Service Webhooks einen eigenen persönlichen API-Key. Nur wenn der Webhook Service mit diesem Key angesprochen wird, wird später die eingestellte Aktion ausgeführt. Um den API-Key anzeigen zu lassen klicken Sie auf den Button "Settings" des Webhook Services. Daraufhin wird auf der Einstellungsseite eine URL angezeigt. Der letzte Teil der URL ist der persönliche API-Key, welchen wir gleich in den HConnect-Einstellungen eintragen müssen.
Der persönliche API-Key des Webhooks Services muss nun in den Einstellungen von HConnect hinterlegt werden, damit HConnect diesen Service aufrufen kann.
Der Webhook Service ist nun konfiguriert und in HConnect hinterlegt. HConnect ist nun in der Lage diesen Service aufzurufen. Der nächste Schritt ist auf der IFTTT Plattform ein Applet anzulegen, um zu bestimmen, welche Aktion ausgeführt werden soll wenn dieser Service aufgerufen wird.
Im letzten Schritt muss nun ein registriertes Homematic-Event mit dem IFTTT-Applet verbunden werden. Tritt dann das konfigurierte Homematic-Event auf, wird der Webhooks-Service der IFTTT-Plattform mit dem eigenen API-Key aufgerufen und der eingestellte Event-Name übertragen. Stimmt der Event-Name mit dem eingestellten Event-Namen des konfigurierten Applets überein, so wird die konfigurierte Aktion (in diesem Fall das Senden einer Email) ausgeführt.
Für IFTTT existiert eine App für das Handy (Android/IOS). Über diese App kann man zusätzlich benachrichtigt werden, wenn ein Applet ausgeführt wurde. Weiterhin können verschiedene Einstellungen gemacht werden und der Verlauf der Events angesehen werden. Die App ist in den Stores des jeweiligen Plattform verfügbar.
Weitere Hinweise zur IFTTT-Konfiguration erhalten Sie in der Hilfe auf der entsprechenden Konfigurationsseite.
Wurde ein Homematic-Event ausgelöst, so kann eine Benachrichtigung über die Pushover Plattform gesendet werden. Pushover bietet dazu Clients für die gängigen Plattformen IOS, Android und Desktop an. Für die private Nutzung kann eine 7-tägige kostenlose Testphase genutzt werden. Möchte man im Anschluß den Service weiterhin nutzen, so fallen pro genutzter Plattform einmalige Kosten an (zur Zeit z.B. 4,99 $ einmalig pro genutzter Plattform (z.B. Android)). Weitere Hinweise dazu finden sich auf der Homepage: Pushover Homepage Im folgenden wird beschrieben, wie Sie das System dazu konfigurieren müssen.
Falls Sie noch keinen Account auf der Pushover Plattform haben, so legen Sie sich zunächst einen kostenlosen Account dort an. Dies ist entweder auf der Homepage unter Pushover Homepage oder in der Handy-App möglich. Um Später Benachrichtigungen an diesen Account zu senden muss der persönliche User Key des Pushover Accounts in der HConnect-Plattform hinterlegt werden.
Nachrichten können von HConnect direkt zu einem Pushover Benutzer gesendet werden. Pushover bietet aber auch die Möglichkeit an per Applikation diese Nachrichten zu senden. Werden Nachrichten per Applikation übertragen, so hat man den Vorteil, dass diese Nachrichten gruppiert in der Handy-App angezeigt werden. Weiterhin kann man für die verschiedenen Applikationen auch eine kleine Grafik hinterlegen. Um eine Applikation in Pushover anzulegen gehen Sie wie folgt vor:
Nachdem die Applikation erstellt wurde erscheint eine Übersicht dieser Applikation. Im oberen Bereich ist ein API Token angegeben. Dieses API Token muss gleich in der HConnect Plattform hinterlegt werden, damit HConnect Benachrichtigungen versenden kann.
Das persönliche API-Token der Pushover Applikation muss nun in den Einstellungen von HConnect hinterlegt werden, damit HConnect Nachrichten senden kann kann. Zusätzlich muss der persönliche User Key hinterlegt werden.
Im letzten Schritt muss nun ein registriertes Homematic-Event so eingestellt werden, dass es Nachrichten an Pushover sendet. Tritt dann das konfigurierte Homematic-Event auf, wird eine Nachricht für die eingestellte Applikation an den eingestellten Benutzer gesendet. Diese Nachricht wird dann in der Pushover Applikation empfangen.
Für Pushover existiert eine App für das Handy (Android/IOS). Über diese App wird man benachrichtigt sobald neue Nachrichten eintreffen. Die App ist in den Stores des jeweiligen Plattform verfügbar.
Weitere Hinweise zur Pushover-Konfiguration erhalten Sie in der Hilfe auf der entsprechenden Konfigurationsseite.
HConnect kann auf Wunsch bei auftretenden Homematic-Events SMS an beliebige Empfänger versenden. Sie müssen dazu lediglich die Rufnummer des Empfängers und einen Nachrichtentext hinterlegen. Für das Senden von SMS benötigen Sie für jede SMS einen Credit. Credits können in Paketen zu jeweils 25, 50 oder 100 SMS im Lizenz-Store erworben werden. Sind keine Credits in Ihrem Account mehr vorhanden, werden keine weiteren SMS versendet. Sind nur noch wenige Credits in Ihrem Account vorhanden, so erhalten Sie dazu eine Benachrichtigung per Email. Im folgenden wird beschrieben, wie Sie eine SMS versenden lassen wenn ein Homematic-Event erkannt wird.
Die aktuell verfügbaren SMS Credits können im Benutzerkonto unter SMS CREDITS eingesehen werden. Dort werden alle Details angezeigt.