Magyar

Hivatalos · TapHome Ellenőrzött HVAC integráció

Sensibo Intelligens légkondicionáló vezérlés

Sensibo Cloud API integráció IR-alapú okos klímavezérlőkhöz (Sensibo Sky, Air, Air Pro). Tápellátás, üzemmód, ventilátorsebesség, lamellák, termosztát vezérlése és hőmérséklet- és páratartalom-figyelés HTTPS-en keresztül — fizikai kábelezés nélkül.

SensiboPacket Parser → HTTP8 eszközRevízió 1.1 Utoljára frissítve: 2026. október 8.

Importálás a TapHome alkalmazásbaHardver › Packet Parser › Hozzáadás sablonból

Sablon letöltése

Ezen az oldalon

Sensibo hivatalos weboldal

Integrációs útmutató

A Sensibo Air Conditioner Smart Control sablon a TapHome-ot bármely IR-vezérelt légkondicionálóhoz csatlakoztatja egy Sensibo okos klímavezérlőn (Sky, Air vagy Air Pro) keresztül. A Sensibo készülék a klímaberendezés közelében helyezkedik el, megtanulja annak IR kódjait, és a Sensibo Cloud API v2-n keresztül teljes vezérlést biztosít. A TapHome HTTPS-en kommunikál a Sensibo szerverekkel, és JSON formátumban kapja a valós idejű állapotadatokat — a légkondicionálóhoz nem szükséges fizikai kábelezés.

A sablon 8 eszközt biztosít: be-/kikapcsolás, üzemmód választás, ventilátorsebesség, függőleges lamellapozíció, termosztát célhőmérséklet-beállítással, hőmérséklet- és páratartalom-figyelés, kijelzővezérlés és szűrőkarbantartási figyelmeztetések. Az egyetlen követelmény egy Sensibo fiók, egy Wi-Fi-hez csatlakoztatott Sensibo készülék és egy API kulcs.

Konfiguráció

Sensibo fiók és készülék beállítása

A Sensibo készüléket (Sky, Air vagy Air Pro) telepíteni kell, a Sensibo mobilalkalmazáson keresztül párosítani a légkondicionálóval, és csatlakoztatni a Wi-Fi hálózathoz. A készüléknek online státuszúnak kell lennie a Sensibo alkalmazásban, mielőtt folytatná a TapHome integrációt.

API kulcs beszerzése

Nyissa meg a home.sensibo.com/me/api oldalt a böngészőben
Jelentkezzen be a Sensibo fiók hitelesítő adataival
Kattintson a Generate API Key gombra, ha még nincs generált kulcsa
Másolja ki az API kulcsot — ez egy hosszú alfanumerikus karakterlánc

Az API kulcs hozzáférést biztosít a fiókjában lévő összes Sensibo készülékhez.

POD azonosító megkeresése

A POD az egyes Sensibo készülékek egyedi azonosítója. Hol található:

A Sensibo alkalmazásban — nyissa meg a készülék beállításait és keresse a Device ID-t
Az API-n keresztül — hívja meg a GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey} végpontot és jegyezze fel az egyes készülékek id mezőjét

Minden Sensibo készüléknek más a POD-ja. Ha több Sensibo készüléke van, a sablont mindegyikhez külön kell importálnia a saját POD-jával.

Importparaméterek

A sablon TapHome-ba importálásakor adja meg:

API Key — az API kulcs a Sensibo fejlesztői portálról
POD — az adott Sensibo egység egyedi azonosítója

Internetfüggőség

Ez egy kizárólag felhőalapú integráció. Minden adat a Sensibo szervereken (home.sensibo.com:443) halad keresztül. A sablon nem működik aktív internetkapcsolat nélkül sem a TapHome Core-on, sem a Sensibo készüléken.

Készülékképességek

Hőmérséklet- és páratartalom-figyelés

A Current Temperature & Humidity szenzor a Sensibo készülék beépített hőmérséklet- és páratartalom-érzékelőit olvassa. A hőmérséklet a Sensibo készüléken beállított mértékegységben jelenik meg (jellemzően Celsius). A páratartalom 100-zal osztva jelenik meg a TapHome 0–1 analóg bemeneti tartományához (pl. 60% = 0,60).

Termosztát vezérlés

A Thermostat teljes klímavezérlést biztosít célhőmérséklet-beállítással. Kiolvassa az aktuális szobahőmérsékletet, páratartalmat és a célhőmérsékletet a klíma állapotából. Új célérték írásakor PATCH kérést küld a Sensibo API-nak, amely a megfelelő IR parancsot továbbítja a légkondicionálónak. Az elérhető hőmérsékleti tartomány a párosított klímamodelltől függ (jellemzően 16–32 °C).

Tápellátás vezérlés

A Power kapcsoló be- és kikapcsolja a légkondicionálót. Kikapcsoláskor a Sensibo kikapcsoló IR parancsot küld. Bekapcsoláskor a klíma az utolsó aktív üzemmódban folytatja a működést.

Klíma üzemmód választás

Az AC Mode többértékű kapcsoló 6 állapottal vezérli az üzemmódot:

Érték	Üzemmód
0	KI
1	Hűtés
2	Fűtés
3	Ventilátor
4	Szárítás
5	Auto

A 0 (KI) üzemmód beállítása kikapcsoló parancsot küld az üzemmódváltás helyett. Az elérhető üzemmódok a párosított légkondicionálótól függenek — nem minden egység támogat minden üzemmódot.

Ventilátorsebesség vezérlés

A Fan Level többértékű kapcsoló 6 fokozattal vezérli a ventilátorsebességet:

Érték	Fokozat
0	Nincs
1	Alacsony
2	Közepes
3	Magas
4	Auto
5	Erős

Az elérhető ventilátor fokozatok a párosított klímamodelltől függenek.

Függőleges lamella vezérlés

A Vertical Swing többértékű kapcsoló 10 állapottal vezérli a függőleges lamellapozíciót:

Érték	Pozíció
0	Megállítva
1	Fix felső
2	Fix közép-felső
3	Fix közép
4	Fix közép-alsó
5	Fix alsó
6	Tartomány felső
7	Tartomány közép
8	Tartomány alsó
9	Tartomány teljes

Az elérhető lamellapozíciók a párosított légkondicionálótól függenek. Sok egység csak ezek egy részhalmazát támogatja. A TapHome alkalmazás a Sensibo API értékneveit jeleníti meg (például fixedTop, rangeFull, low).

Kijelzővezérlés

A Display Light kapcsoló a légkondicionáló LED kijelzőpaneljét vezérli. Nem minden klímamodell támogatja a kijelzővezérlést IR-en keresztül — ha a párosított egység nem támogatja ezt a funkciót, a parancsnak nincs hatása.

Szűrőkarbantartási figyelmeztetés

A Filter Clean Required szenzor (reed kontaktus) jelzi, amikor a klíma szűrői tisztítást igényelnek. A Sensibo API shouldCleanFilters jelzőjét olvassa — az érték 1, ha a szűrők tisztítást igényelnek, és 0, ha tiszták. A szűrőjelző a Sensibo mobilalkalmazáson keresztül állítható vissza.

További képességek

A Sensibo API emellett biztosít vízszintes lamella vezérlést, időzítő funkciókat, Climate React-ot (automatikus klímavezérlés küszöbértékek alapján), előzményméréseket és levegőminőség-érzékelőket (TVOC, CO2 az Air Pro modellen). Ezek egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az API hibát vagy üres adatot ad vissza

Ellenőrizze, hogy a Sensibo készülék online-e — nézze meg a státusz LED-et és a Sensibo mobilalkalmazást
Győződjön meg róla, hogy az API kulcs helyes és nem lett újragenerálva
Bizonyosodjon meg arról, hogy a POD paraméter pontosan megegyezik a készülékazonosítóval (kis- és nagybetűérzékeny)
Ellenőrizze, hogy a TapHome Core és a Sensibo készülék is rendelkezik aktív internetkapcsolattal

“API Key is empty” vagy “Pod is empty” hiba

A sablon ellenőrzi, hogy mindkét paraméter be van-e állítva az API kérések elküldése előtt. Ha ezt a hibát látja, nyissa meg a modulváltozókat a TapHome-ban, és ellenőrizze, hogy az API Key és POD mezők tartalmazzák-e a helyes értékeket.

A parancsok nem hatnak a légkondicionálóra

A Sensibo készülék IR (infravörös) jelekkel vezérli a légkondicionálót. Győződjön meg arról, hogy a Sensibo készüléknek szabad rálátása van a klíma IR vevőjére. Ha egy adott funkció (kijelző, lamellapozíció) nem működik, előfordulhat, hogy a párosított légkondicionáló nem támogatja azt az IR protokollon keresztül.

A Sensibo Cloud API aktív internetkapcsolatot igényel és a Sensibo szerverek elérhetőségétől függ. Felhőkimaradás vagy internetszünet esetén a sablon nem kap frissített adatokat és nem küld parancsokat. Nincs helyi tartalék — minden kommunikáció a Sensibo szervereken keresztül történik.

Elérhető eszközök 8

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Sensibo Intelligens légkondicionáló vezérlés Modul

Egyéni változók

`apiKey` (string)	Sensibo Cloud API kulcs (beszerezhető: https://home.sensibo.com/me/api)
`pod` (string)	Sensibo készülékazonosító (POD ID, egyedi minden Sensibo készülékhez)

Sensibo Air Conditioner Smart Control

Olvasás (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

Aktuális hőmérséklet és páratartalom Hőmérséklet-érzékelő Csak olvasható

Beépített hőmérséklet- és páratartalom-érzékelők — páratartalom osztva 100-zal a TapHome 0–1 tartományhoz

numeric Egység: °C / % JSON parsejson()

Aktuális hőmérséklet és páratartalom

Páratartalom olvasása

PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;

Hőmérséklet olvasása

PARSEJSON(responseJson,"$.result.measurements.temperature");

Ventilátor fokozat Többértékű kapcsoló Olvasás és írás

Klíma ventilátorsebesség vezérlés — alacsony, közepes, magas, auto, erős (elérhető fokozatok a párosított modelltől függenek)

string → numeric JSON parsejson() + SWITCH mapping

Értékek / Állapotok: low · medium · high · auto · strong

Ventilátor fokozat

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

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+"\"}");

Kijelző Kapcsoló Olvasás és írás

Klíma LED kijelző be-/kikapcsolása — nem minden modell támogatja ezt a funkciót

string/boolean JSON parsejson() + IF comparison

Értékek / Állapotok: ON · OFF

Kijelző

Kapcsoló állapot olvasása

IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)

Kapcsoló állapot írása

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

Klíma üzemmód Többértékű kapcsoló Olvasás és írás

Klíma üzemmód — KI, Hűtés, Fűtés, Ventilátor, Szárítás, Auto (elérhető üzemmódok a párosított modelltől függenek)

string → numeric Custom variable + SWITCH mapping

Értékek / Állapotok: OFF · Cool · Heat · Fan · Dry · Auto

Klíma üzemmód

Kapcsoló állapot olvasása

SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);

Kapcsoló állapot írása

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

Tápellátás Kapcsoló Olvasás és írás

Klíma be-/kikapcsolás IR paranccsal

boolean JSON parsejson() + IF

Értékek / Állapotok: ON · OFF

Tápellátás

Kapcsoló állapot olvasása

IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)

Kapcsoló állapot írása

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

Szűrőtisztítás szükséges Reed kontaktus Csak olvasható

Szűrőkarbantartási figyelmeztetés — jelzi, amikor a klíma szűrői tisztítást igényelnek

boolean JSON parsejson() + IF

Függőleges lamellák Többértékű kapcsoló Olvasás és írás

Függőleges lamellapozíció vezérlés — 10 pozíció fix-től tartomány-ig (elérhető pozíciók a párosított modelltől függenek)

string → numeric JSON parsejson() + SWITCH mapping

Értékek / Állapotok: stopped · fixedTop · fixedMiddleTop · fixedMiddle · fixedMiddleBottom · fixedBottom · rangeTop · rangeMiddle · rangeBottom · rangeFull

Függőleges lamellák

Kapcsoló állapot olvasása

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);

Kapcsoló állapot írása

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+"\"}");

Termosztát Termosztát Olvasás és írás

Célhőmérséklet-beállítás aktuális hőmérséklet- és páratartalom-adatokkal

numeric Egység: °C JSON parsejson()

Termosztát

Hőmérséklet olvasása

PARSEJSON(responseJson,"$.result.measurements.temperature");

Páratartalom olvasása

PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;

Kívánt hőmérséklet olvasása

PARSEJSON(responseJson,"$.result.acState.targetTemperature");

Kívánt hőmérséklet írása

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

Kapcsolat: Packet Parser → HTTP

Lehetséges fejlesztések (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)

Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

Az alkalmazás kéri	Alapérték
API Key	Importáláskor adja meg
POD	Importáláskor adja meg

Források

Sensibo API v2 Reference
support.sensibo.com 2026-04-19
Home Assistant Sensibo Integration
www.home-assistant.io 2026-04-19

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

Sablon · TapHome portál Sensibo Intelligens légkondicionáló vezérlés Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba. Packet Parser → HTTP Megnyitás a TapHome portálon

Sensibo Intelligens légkondicionáló vezérlés

Integrációs útmutató

Konfiguráció

Sensibo fiók és készülék beállítása

API kulcs beszerzése

POD azonosító megkeresése

Importparaméterek

Internetfüggőség

Készülékképességek

Hőmérséklet- és páratartalom-figyelés

Termosztát vezérlés

Tápellátás vezérlés

Klíma üzemmód választás

Ventilátorsebesség vezérlés

Függőleges lamella vezérlés

Kijelzővezérlés

Szűrőkarbantartási figyelmeztetés

További képességek

Hibaelhárítás

Az API hibát vagy üres adatot ad vissza

“API Key is empty” vagy “Pod is empty” hiba

A parancsok nem hatnak a légkondicionálóra

Elérhető eszközök 8

Importálási paraméterek

Források

Talált problémát ezzel az eszközsablonnal?

Hagyd meg az elérhetőségedet — elküldjük a választ

Folytatás WhatsAppon

Az üzenet megérkezett

A kód lejárt

A kérés a támogatásnál van

Az új verzió tesztelőit keressük

Köszönjük, hamarosan jelentkezünk

Integrációs útmutató

Konfiguráció#

Sensibo fiók és készülék beállítása

API kulcs beszerzése

POD azonosító megkeresése

Importparaméterek

Internetfüggőség

Készülékképességek#

Hőmérséklet- és páratartalom-figyelés

Termosztát vezérlés

Tápellátás vezérlés

Klíma üzemmód választás

Ventilátorsebesség vezérlés

Függőleges lamella vezérlés

Kijelzővezérlés

Szűrőkarbantartási figyelmeztetés

További képességek

Hibaelhárítás#

Az API hibát vagy üres adatot ad vissza

“API Key is empty” vagy “Pod is empty” hiba

A parancsok nem hatnak a légkondicionálóra

Elérhető eszközök 8

Sensibo Air Conditioner Smart Control

Aktuális hőmérséklet és páratartalom

Ventilátor fokozat

Kijelző

Klíma üzemmód

Tápellátás

Szűrőtisztítás szükséges

Függőleges lamellák

Termosztát

Importálási paraméterek

Források

Kapcsolódó dokumentáció

Talált problémát ezzel az eszközsablonnal?

Konfiguráció

Készülékképességek

Hibaelhárítás