---
title: "Sensibo Intelligens légkondicionáló vezérlés"
description: "Sensibo Cloud API integráció IR-alapú klímavezérlőkhöz. Tápellátás, üzemmód, ventilátor, lamellák, termosztát vezérlése és hőmérséklet-monitorozás."
url: "https://taphome.com/hu/compatibility/sensibo-air-conditioner-smart-control/"
language: hu
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","air-conditioning","cloud-api","thermostat","hvac-control","smart-home"]
  questions: ["Hogyan integrálható a Sensibo a TapHome-mal a Cloud API-n keresztül?","Milyen adatokat szolgáltat a Sensibo sablon a TapHome-ban?","Hogyan szerezhető be a Sensibo API kulcs a TapHome-hoz?","Vezérelhető-e a TapHome-on keresztül a ventilátorsebesség és a lamellapozíció a Sensibo-val?","Működik-e a Sensibo sablon bármely légkondicionálóval?","Hogyan állítható be a Sensibo POD ID a TapHome-ban?"]
---

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

Kommunikáció: Packet Parser → HTTP

- [Sensibo hivatalos weboldal](https://www.sensibo.com)

## 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

1. Nyissa meg a [home.sensibo.com/me/api](https://home.sensibo.com/me/api) oldalt a böngészőben
2. Jelentkezzen be a Sensibo fiók hitelesítő adataival
3. Kattintson a **Generate API Key** gombra, ha még nincs generált kulcsa
4. 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

1. Ellenőrizze, hogy a Sensibo készülék online-e — nézze meg a státusz LED-et és a Sensibo mobilalkalmazást
2. Győződjön meg róla, hogy az API kulcs helyes és nem lett újragenerálva
3. Bizonyosodjon meg arról, hogy a POD paraméter pontosan megegyezik a készülékazonosítóval (kis- és nagybetűérzékeny)
4. 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.

> [!WARNING]
> 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)   |

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

Páratartalom olvasása

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

Hőmérséklet olvasása

```taphome
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

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

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

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

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

```taphome
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

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

```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
```

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

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

```taphome
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

Olvasás

```taphome
IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0)
```

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

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

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

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

Hőmérséklet olvasása

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

Páratartalom olvasása

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

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

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

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

```taphome
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](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

## Kapcsolódó dokumentáció

- [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)