--- title: "Sensibo Intelligente Klimaanlagensteuerung" description: "Sensibo Cloud API-Integration für IR-AC-Controller. Steuerung von Strom, Modus, Lüfter, Lamellen, Thermostat und Temperaturüberwachung." url: "https://taphome.com/de/compatibility/sensibo-air-conditioner-smart-control/" language: de lastmod: 2026-10-08 generator: hugo ai: topics: ["http","air-conditioning","cloud-api","thermostat","hvac-control","smart-home"] questions: ["Wie integriert man Sensibo mit TapHome über die Cloud API?","Welche Daten liefert die Sensibo-Vorlage in TapHome?","Wie erhält man den Sensibo API-Schlüssel für TapHome?","Kann man über TapHome mit Sensibo die Lüftergeschwindigkeit und Lamellenposition steuern?","Funktioniert die Sensibo-Vorlage mit jeder Klimaanlage?","Wie richtet man die Sensibo POD-ID in TapHome ein?"] --- # Sensibo Intelligente Klimaanlagensteuerung Kommunikation: Packet Parser → HTTP - [Offizielle Sensibo-Website](https://www.sensibo.com) ## Integrationsanleitung 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](https://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: | Wert | Modus | |------|-------| | 0 | AUS | | 1 | Kühlen | | 2 | Heizen | | 3 | Lüfter | | 4 | Trocknen | | 5 | Auto | 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: | Wert | Stufe | |------|-------| | 0 | Keine | | 1 | Niedrig | | 2 | Mittel | | 3 | Hoch | | 4 | Auto | | 5 | Stark | 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: | Wert | Position | |------|----------| | 0 | Gestoppt | | 1 | Fest oben | | 2 | Fest Mitte-oben | | 3 | Fest Mitte | | 4 | Fest Mitte-unten | | 5 | Fest unten | | 6 | Bereich oben | | 7 | Bereich Mitte | | 8 | Bereich unten | | 9 | Bereich voll | Verfügbare Lamellenpositionen hängen von der gekoppelten Klimaanlage ab. Viele Geräte unterstützen nur eine Teilmenge dieser Positionen. Die TapHome App zeigt die Wertnamen der Sensibo API an (zum Beispiel `fixedTop`, `rangeFull`, `low`). ### 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. > [!WARNING] > 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 8 Diese Geräte erscheinen nach dem Import in TapHome. 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) | Lesen (Modul) ```taphome 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, "", ""); 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() Luftfeuchtigkeit lesen ```taphome PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0; ``` Temperatur lesen ```taphome PARSEJSON(responseJson,"$.result.measurements.temperature"); ``` Lüfterstufe Mehrwertschalter Lesen und Schreiben 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 Schaltzustand lesen ```taphome VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel"); SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0); ``` Schaltzustand schreiben ```taphome 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 Lesen und Schreiben LED-Display der Klimaanlage ein-/ausschalten — nicht alle Modelle unterstützen diese Funktion string/boolean JSON parsejson() + IF comparison Werte / Zustände: ON · OFF Schaltzustand lesen ```taphome IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0) ``` Schaltzustand schreiben ```taphome SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/light?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}"); ``` Klimaanlagen-Modus Mehrwertschalter Lesen und Schreiben 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 Schaltzustand lesen ```taphome SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0); ``` Schaltzustand schreiben ```taphome 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 Lesen und Schreiben Klimaanlage ein-/ausschalten über IR-Befehl boolean JSON parsejson() + IF Werte / Zustände: ON · OFF Schaltzustand lesen ```taphome IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0) ``` Schaltzustand schreiben ```taphome 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 Lesen ```taphome IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0) ``` Vertikale Lamellen Mehrwertschalter Lesen und Schreiben 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 Schaltzustand lesen ```taphome 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 ```taphome 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 Lesen und Schreiben Temperatursollwertsteuerung mit aktuellen Temperatur- und Feuchtigkeitswerten numeric Einheit: °C JSON parsejson() Temperatur lesen ```taphome PARSEJSON(responseJson,"$.result.measurements.temperature"); ``` Luftfeuchtigkeit lesen ```taphome PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0; ``` Solltemperatur lesen ```taphome PARSEJSON(responseJson,"$.result.acState.targetTemperature"); ``` Solltemperatur schreiben ```taphome 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) ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |----------------------|----------------------| | API Key | Beim Import eingeben | | POD | Beim Import eingeben | ## Quellen - Sensibo API v2 Reference [support.sensibo.com](https://support.sensibo.com/api/) 2026-04-19 - Home Assistant Sensibo Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/sensibo/) 2026-04-19 ## Verwandte Dokumentation - [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/) - [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/) - [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)