TapHome

Sensibo Intelligente Klimaanlagensteuerung

Packet Parser → HTTP
Eingereicht von
Zuletzt aktualisiert: 06. 2026
Sensibo Intelligente Klimaanlagensteuerung

Die Vorlage Sensibo Air Conditioner Smart Control verbindet TapHome mit jeder IR-gesteuerten Klimaanlage über einen intelligenten Sensibo-Controller (Sky, Air oder Air Pro). Das Sensibo-Gerät wird in der Nähe der Klimaanlage platziert, erlernt deren IR-Codes und stellt die vollständige Steuerung über die Sensibo Cloud API v2 bereit. TapHome kommuniziert mit den Sensibo-Servern über HTTPS und empfängt Statusdaten im JSON-Format — eine physische Verkabelung zur Klimaanlage ist nicht erforderlich.

Die Vorlage bietet 8 Geräte für Ein-/Ausschalten, Betriebsmoduswahl, Lüftergeschwindigkeit, vertikale Lamellenposition, Thermostat mit Sollwertsteuerung, Temperatur- und Feuchtigkeitsüberwachung, Displaysteuerung und Filterwartungsmeldungen. Die einzigen Voraussetzungen sind ein Sensibo-Konto, ein mit dem WLAN verbundenes Sensibo-Gerät und ein API-Schlüssel.

Konfiguration

Sensibo-Konto und Geräteeinrichtung

Das Sensibo-Gerät (Sky, Air oder Air Pro) muss installiert, über die Sensibo-App mit der Klimaanlage gekoppelt und mit dem WLAN-Netzwerk verbunden sein. Das Gerät muss in der Sensibo-App als online angezeigt werden, bevor Sie mit der TapHome-Integration fortfahren.

API-Schlüssel erhalten
  1. Öffnen Sie home.sensibo.com/me/api im Webbrowser
  2. Melden Sie sich mit Ihren Sensibo-Kontodaten an
  3. Klicken Sie auf Generate API Key, falls Sie noch keinen Schlüssel generiert haben
  4. Kopieren Sie den API-Schlüssel — es handelt sich um eine lange alphanumerische Zeichenkette

Der API-Schlüssel gewährt Zugriff auf alle Sensibo-Geräte in Ihrem Konto.

POD-Identifikator ermitteln

Der POD ist eine eindeutige Kennung für jedes Sensibo-Gerät. So finden Sie ihn:

  • In der Sensibo-App — öffnen Sie die Geräteeinstellungen und suchen Sie die Device ID
  • Über die API — rufen Sie GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey} auf und notieren Sie das Feld id für jedes Gerät

Jedes Sensibo-Gerät hat einen eigenen POD. Wenn Sie mehrere Sensibo-Geräte besitzen, müssen Sie die Vorlage für jedes einzeln mit seinem eigenen POD importieren.

Importparameter

Beim Importieren der Vorlage in TapHome geben Sie ein:

  • API Key — der API-Schlüssel vom Sensibo-Entwicklerportal
  • POD — die eindeutige Kennung für das jeweilige Sensibo-Gerät
Internetabhängigkeit

Dies ist eine reine Cloud-Integration. Alle Daten laufen über Sensibo-Server (home.sensibo.com:443). Die Vorlage funktioniert nicht ohne aktive Internetverbindung sowohl am TapHome Core als auch am Sensibo-Gerät.

Gerätefähigkeiten

Temperatur- und Feuchtigkeitsüberwachung

Der Sensor Current Temperature & Humidity liest die eingebauten Temperatur- und Feuchtigkeitssensoren des Sensibo-Geräts. Die Temperatur wird in der am Sensibo-Gerät konfigurierten Einheit gemeldet (typisch Celsius). Die Luftfeuchtigkeit wird durch 100 geteilt für den TapHome-Analogeingangsbereich 0–1 (z. B. 60 % wird als 0,60 angezeigt).

Thermostatsteuerung

Der Thermostat bietet vollständige Klimasteuerung mit Temperatursollwert. Er liest die aktuelle Raumtemperatur, Luftfeuchtigkeit und Zieltemperatur aus dem Klimaanlagenstatus. Das Schreiben eines neuen Sollwerts sendet eine PATCH-Anfrage an die Sensibo API, die dann den entsprechenden IR-Befehl an die Klimaanlage sendet. Der verfügbare Temperaturbereich hängt vom gekoppelten Klimaanlagenmodell ab (typisch 16–32 °C).

Stromsteuerung

Der Schalter Power schaltet die Klimaanlage ein und aus. Beim Ausschalten sendet Sensibo den Ausschalt-IR-Befehl. Beim Einschalten nimmt die Klimaanlage den letzten aktiven Modus wieder auf.

Betriebsmoduswahl

Der Umschalter AC Mode steuert den Betriebsmodus mit 6 Zuständen:

WertModus
0AUS
1Kühlen
2Heizen
3Lüfter
4Trocknen
5Auto

Das Setzen des Modus auf 0 (AUS) sendet einen Ausschaltbefehl anstelle einer Modusänderung. Verfügbare Modi hängen von der gekoppelten Klimaanlage ab — nicht alle Geräte unterstützen jeden Modus.

Lüftergeschwindigkeit

Der Umschalter Fan Level steuert die Lüftergeschwindigkeit mit 6 Stufen:

WertStufe
0Keine
1Niedrig
2Mittel
3Hoch
4Auto
5Stark

Verfügbare Lüfterstufen hängen vom Modell der gekoppelten Klimaanlage ab.

Vertikale Lamellensteuerung

Der Umschalter Vertical Swing steuert die vertikale Lamellenposition mit 10 Zuständen:

WertPosition
0Gestoppt
1Fest oben
2Fest Mitte-oben
3Fest Mitte
4Fest Mitte-unten
5Fest unten
6Bereich oben
7Bereich Mitte
8Bereich unten
9Bereich voll

Verfügbare Lamellenpositionen hängen von der gekoppelten Klimaanlage ab. Viele Geräte unterstützen nur eine Teilmenge dieser Positionen.

Displaysteuerung

Der Schalter Display Light steuert das LED-Display an der Klimaanlage. Nicht alle Klimaanlagenmodelle unterstützen die Displaysteuerung über IR — wenn das gekoppelte Gerät diese Funktion nicht unterstützt, hat der Befehl keine Wirkung.

Filterwartungsmeldung

Der Sensor Filter Clean Required (Reedkontakt) zeigt an, wann die Klimaanlagenfilter gereinigt werden müssen. Er liest das Flag shouldCleanFilters von der Sensibo API — der Wert ist 1, wenn die Filter gereinigt werden müssen, und 0, wenn sie sauber sind. Der Filterindikator kann über die Sensibo-App zurückgesetzt werden.

Weitere Funktionen

Die Sensibo API bietet auch horizontale Lamellensteuerung, Timer-Funktionen, Climate React (automatische Klimasteuerung basierend auf Schwellenwerten), historische Messungen und Luftqualitätssensoren (TVOC, CO2 beim Air Pro). Diese können in einem zukünftigen Vorlagen-Update hinzugefügt werden.

Fehlerbehebung

API liefert Fehler oder keine Daten
  1. Überprüfen Sie, ob das Sensibo-Gerät online ist — kontrollieren Sie die Status-LED und die Sensibo-App
  2. Bestätigen Sie, dass der API-Schlüssel korrekt ist und nicht neu generiert wurde
  3. Stellen Sie sicher, dass der POD-Parameter exakt mit der Gerätekennung übereinstimmt (Groß-/Kleinschreibung beachten)
  4. Prüfen Sie, ob sowohl der TapHome Core als auch das Sensibo-Gerät über eine aktive Internetverbindung verfügen
Fehler “API Key is empty” oder “Pod is empty”

Die Vorlage prüft vor dem Senden von API-Anfragen, ob beide Parameter gesetzt sind. Wenn dieser Fehler auftritt, öffnen Sie die Modulvariablen in TapHome und überprüfen Sie, ob die Felder API Key und POD die korrekten Werte enthalten.

Befehle haben keine Wirkung auf die Klimaanlage

Das Sensibo-Gerät steuert die Klimaanlage über IR-Signale (Infrarot). Stellen Sie sicher, dass das Sensibo-Gerät freie Sichtlinie zum IR-Empfänger der Klimaanlage hat. Wenn eine bestimmte Funktion (Display, Lamellenposition) nicht funktioniert, unterstützt die gekoppelte Klimaanlage diese Funktion möglicherweise nicht über ihr IR-Protokoll.

Die Sensibo Cloud API erfordert eine aktive Internetverbindung und ist von der Verfügbarkeit der Sensibo-Server abhängig. Bei Cloud-Ausfällen oder Internetunterbrechungen empfängt die Vorlage keine aktualisierten Daten und sendet keine Befehle. Es gibt keinen lokalen Fallback — die gesamte Kommunikation läuft über die Sensibo-Server.

Verfügbare Geräte

Sensibo Intelligente Klimaanlagensteuerung Modul
Benutzerdefinierte Variablen
apiKey (string)Sensibo Cloud API-Schlüssel (erhalten unter https://home.sensibo.com/me/api)
pod (string)Sensibo-Gerätekennung (POD-ID, eindeutig pro Sensibo-Gerät)

Sensibo Air Conditioner Smart Control

Lesen (Modul)
responseJson := "error";
IF LENGTH(apiKey) = 0
    ADDERROR("API Key is empty. Fill API Key in module variables");
	RETURN(0);
END

IF LENGTH(pod) = 0
    ADDERROR("Pod is empty. Fill pod in module variables");
	RETURN(0);
END

VAR response := SENDHTTPREQUEST("/api/v2/pods/"+pod+"/?fields=*&apiKey="+apiKey, "GET", "");

IF(response.IsSuccess)
    responseJson := response.Content;
    mode := PARSEJSON(responseJson,"$.result.acState.mode");
ELSE
    VAR contentJson := response.Content;
    VAR errCode := response.StatusCode;
    VAR message := PARSEJSON(contentJson, "message", 1);
	IF ISNULL(message)
		message := PARSETEXT(response.Content, "<title>", "</title>");
	END
    ADDERROR("Failed to read data - (" + errCode + ") " + message);
END
Aktuelle Temperatur und Luftfeuchtigkeit Temperatursensor Nur lesen

Eingebaute Temperatur- und Feuchtigkeitssensoren — Feuchtigkeit geteilt durch 100 für TapHome 0–1 Bereich

numeric Einheit: °C / % JSON parsejson()

Aktuelle Temperatur und Luftfeuchtigkeit

Luftfeuchtigkeit lesen
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Temperatur lesen
PARSEJSON(responseJson,"$.result.measurements.temperature");
Lüfterstufe Mehrwertschalter

Lüftergeschwindigkeit der Klimaanlage — niedrig, mittel, hoch, auto, stark (verfügbare Stufen abhängig vom gekoppelten Modell)

string → numeric JSON parsejson() + SWITCH mapping
Werte / Zustände: low · medium · high · auto · strong

Lüfterstufe

Schaltzustand lesen
VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel");
SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0);
Schaltzustand schreiben
VAR localfan := SWITCH(Mu, 1, "low", 2, "medium", 3, "high", 4, "auto", 5, "strong", "");

SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/fanLevel?apiKey="+apiKey, "PATCH", "{\"newValue\": \""+localfan+"\"}");
Displaybeleuchtung Schalter

LED-Display der Klimaanlage ein-/ausschalten — nicht alle Modelle unterstützen diese Funktion

string/boolean JSON parsejson() + IF comparison
Werte / Zustände: ON · OFF

Displaybeleuchtung

Schaltzustand lesen
IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)
Schaltzustand schreiben
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/light?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Klimaanlagen-Modus Mehrwertschalter

Betriebsmodus der Klimaanlage — AUS, Kühlen, Heizen, Lüfter, Trocknen, Auto (verfügbare Modi abhängig vom gekoppelten Modell)

string → numeric Custom variable + SWITCH mapping
Werte / Zustände: OFF · Cool · Heat · Fan · Dry · Auto

Klimaanlagen-Modus

Schaltzustand lesen
SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);
Schaltzustand schreiben
VAR localmode := SWITCH(Mu, 1, "cool", 2, "heat", 3, "fan", 4, "dry", 5, "auto", "");

IF (Mu > 0)
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/mode?apiKey="+apiKey, "PATCH", "{\"newValue\": \""+localmode+"\"}");

ELSE

SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": false}");

END
Strom Schalter

Klimaanlage ein-/ausschalten über IR-Befehl

boolean JSON parsejson() + IF
Werte / Zustände: ON · OFF

Strom

Schaltzustand lesen
IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)
Schaltzustand schreiben
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Filterreinigung erforderlich Reed-Kontakt Nur lesen

Filterwartungsmeldung — zeigt an, wann die Klimaanlagenfilter gereinigt werden müssen

boolean JSON parsejson() + IF

Filterreinigung erforderlich

Lesen
IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0)
Vertikale Lamellen Mehrwertschalter

Vertikale Lamellenpositionssteuerung — 10 Positionen von fest bis Bereichsschwenk (verfügbare Positionen abhängig vom gekoppelten Modell)

string → numeric JSON parsejson() + SWITCH mapping
Werte / Zustände: stopped · fixedTop · fixedMiddleTop · fixedMiddle · fixedMiddleBottom · fixedBottom · rangeTop · rangeMiddle · rangeBottom · rangeFull

Vertikale Lamellen

Schaltzustand lesen
VAR swing := PARSEJSON(responseJson,"$.result.acState.swing");
SWITCH(swing, 
"stopped", 0, 
"fixedTop", 1, 
"fixedMiddleTop", 2, 
"fixedMiddle", 3, 
"fixedMiddleBottom", 4, 
"fixedBottom", 5, 
"rangeTop", 6, 
"rangeMiddle", 7, 
"rangeBottom", 8, 
"rangeFull", 9, 
0);
Schaltzustand schreiben
VAR localswing := SWITCH(Mu, 

0, "stopped", 
1, "fixedTop", 
2, "fixedMiddleTop", 
3, "fixedMiddle", 
4, "fixedMiddleBottom", 
5, "fixedBottom", 
6, "rangeTop", 
7, "rangeMiddle", 
8, "rangeBottom", 
9, "rangeFull"

, "");

SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/swing?apiKey="+apiKey, "PATCH", "{\"newValue\": \""+localswing+"\"}");
Thermostat Thermostat

Temperatursollwertsteuerung mit aktuellen Temperatur- und Feuchtigkeitswerten

numeric Einheit: °C JSON parsejson()

Thermostat

Temperatur lesen
PARSEJSON(responseJson,"$.result.measurements.temperature");
Luftfeuchtigkeit lesen
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Solltemperatur lesen
PARSEJSON(responseJson,"$.result.acState.targetTemperature");
Solltemperatur schreiben
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/targetTemperature?apiKey="+apiKey, "PATCH", "{\"newValue\": "+Se+"}");
Verbindung: Packet Parser → HTTP
Mögliche Verbesserungen (10)
  • Horizontal Swing — Horizontal swing/louver position control. Available values vary by AC model. Present in acState but not implemented in TapHome template
  • Timer — GET/PUT/DELETE /pods/{pod}/timer — set countdown timer for AC on/off. Available in HA as 10-minute timer toggle
  • Schedules — GET/POST/PUT/DELETE /pods/{pod}/schedules — create and manage recurring AC schedules
  • Climate React — GET/PUT/POST /pods/{pod}/smartMode — automatic climate control based on temperature/humidity thresholds. Configurable high/low triggers with independent AC states
  • Historical Measurements — GET /pods/{pod}/historicalMeasurements — temperature and humidity history over time
  • TVOC Sensor — Total Volatile Organic Compounds sensor. Available on Sensibo Air Pro only
  • CO2 Sensor — Carbon dioxide level sensor. Available on Sensibo Air Pro only
  • Feels-Like Temperature — Computed feels-like temperature based on temperature and humidity. Available on Sky, Air, Air Pro
  • Filter Last Reset — Timestamp of last filter cleaning indicator reset
  • Filter Reset — Button to reset filter cleaning indicator (currently template only reads shouldCleanFilters, cannot reset)

Quellen

Haben Sie ein Problem mit dieser Gerätevorlage gefunden?

Sagen Sie uns, was nicht funktioniert, was fehlt oder wie sich die Vorlage verhalten sollte. Ihr Feedback hilft uns, den Katalog genau zu halten.

Von TapHome verifiziert

Möchtest du das in deinem TapHome Core verwenden?

Öffne diese Vorlage im Kundenportal, um sie auf eine deiner Wohnungen anzuwenden, oder entwirf eine Anpassung und reiche sie an den Katalog ein.

Im Portal öffnen