---
title: "Sensibo Inteligentné ovládanie klimatizácie"
description: "Integrácia Sensibo Cloud API pre IR ovládače klimatizácie. Ovládanie napájania, režimu, ventilátora, lamiel, termostatu a monitorovanie teploty a vlhkosti."
url: "https://taphome.com/sk/compatibility/sensibo-air-conditioner-smart-control/"
language: sk
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","air-conditioning","cloud-api","thermostat","hvac-control","smart-home"]
  questions: ["Ako integrovať Sensibo s TapHome cez Cloud API?","Aké dáta poskytuje šablóna Sensibo v TapHome?","Ako získať API kľúč Sensibo pre TapHome?","Dá sa cez TapHome ovládať rýchlosť ventilátora a poloha lamiel so Sensibo?","Funguje šablóna Sensibo s akoukoľvek klimatizáciou?","Ako nastaviť Sensibo POD ID v TapHome?"]
---

# Sensibo Inteligentné ovládanie klimatizácie

Komunikácia: Packet Parser → HTTP

- [Oficiálna stránka Sensibo](https://www.sensibo.com)

## Návod na integráciu

Šablóna Sensibo Air Conditioner Smart Control pripája TapHome k akejkoľvek klimatizácii ovládanej infračerveným signálom prostredníctvom inteligentného ovládača Sensibo (Sky, Air alebo Air Pro). Zariadenie Sensibo sa umiestni v blízkosti klimatizácie, naučí sa jej IR kódy a sprístupní kompletné ovládanie cez Sensibo Cloud API v2. TapHome komunikuje so servermi Sensibo cez HTTPS a prijíma stavové dáta v JSON formáte — nie je potrebná žiadna fyzická kabeláž ku klimatizácii.

Šablóna poskytuje 8 zariadení pokrývajúcich zapnutie/vypnutie, výber prevádzkového režimu, rýchlosť ventilátora, polohu vertikálnych lamiel, termostat s nastavením cieľovej teploty, monitorovanie teploty a vlhkosti, ovládanie displeja a upozornenia na údržbu filtra. Jediné požiadavky sú účet Sensibo, zariadenie Sensibo pripojené k Wi-Fi a API kľúč.

## Konfigurácia

### Sensibo účet a nastavenie zariadenia

Zariadenie Sensibo (Sky, Air alebo Air Pro) musí byť nainštalované, spárované s klimatizáciou cez mobilnú aplikáciu Sensibo a pripojené k Wi-Fi sieti. Zariadenie musí byť zobrazené ako online v aplikácii Sensibo pred pokračovaním s integráciou TapHome.

### Získanie API kľúča

1. Otvorte [home.sensibo.com/me/api](https://home.sensibo.com/me/api) vo webovom prehliadači
2. Prihláste sa pomocou prihlasovacích údajov účtu Sensibo
3. Kliknite na **Generate API Key**, ak ešte nemáte vygenerovaný kľúč
4. Skopírujte API kľúč — je to dlhý alfanumerický reťazec

API kľúč poskytuje prístup ku všetkým zariadeniam Sensibo na vašom účte.

### Zistenie identifikátora POD

POD je unikátny identifikátor pre každé zariadenie Sensibo. Kde ho nájdete:

- **V aplikácii Sensibo** — otvorte nastavenia zariadenia a vyhľadajte Device ID
- **Cez API** — zavolajte `GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey}` a poznačte si pole `id` pre každé zariadenie

Každé zariadenie Sensibo má iný POD. Ak máte viacero zariadení Sensibo, musíte šablónu importovať samostatne pre každé s jeho vlastným POD.

### Parametre importu

Pri importovaní šablóny v TapHome zadajte:

- **API Key** — API kľúč z vývojárskeho portálu Sensibo
- **POD** — unikátny identifikátor pre konkrétnu jednotku Sensibo

### Závislosť na internete

Toto je čisto cloudová integrácia. Všetky dáta prechádzajú cez servery Sensibo (`home.sensibo.com:443`). Šablóna nebude fungovať bez aktívneho internetového pripojenia na TapHome Core aj na zariadení Sensibo.

## Schopnosti zariadení

### Monitorovanie teploty a vlhkosti

Senzor **Current Temperature & Humidity** číta zabudované snímače teploty a vlhkosti na zariadení Sensibo. Teplota je hlásená v jednotke nakonfigurovanej na zariadení Sensibo (typicky Celsius). Vlhkosť je delená 100 pre rozsah analógového vstupu TapHome 0–1 (napr. 60 % sa zobrazí ako 0,60).

### Ovládanie termostatu

**Thermostat** poskytuje kompletné ovládanie klímy s nastavením cieľovej teploty. Číta aktuálnu izbovú teplotu, vlhkosť a cieľovú teplotu zo stavu klimatizácie. Zápis nového setpointu odošle PATCH požiadavku na Sensibo API, ktoré následne vyšle zodpovedajúci IR príkaz klimatizácii. Dostupný teplotný rozsah závisí od spárovaného modelu klimatizácie (typicky 16–32 °C).

### Ovládanie napájania

Spínač **Power** zapína a vypína klimatizáciu. Po vypnutí Sensibo odošle IR príkaz na vypnutie. Po zapnutí klimatizácia obnoví posledný aktívny režim.

### Výber režimu klimatizácie

Prepínač **AC Mode** ovláda prevádzkový režim so 6 stavmi:

| Hodnota | Režim |
|---------|-------|
| 0 | VYP |
| 1 | Chladenie |
| 2 | Kúrenie |
| 3 | Ventilátor |
| 4 | Sušenie |
| 5 | Auto |

Nastavenie režimu na 0 (VYP) odošle príkaz na vypnutie namiesto zmeny režimu. Dostupné režimy závisia od spárovanej klimatizácie — nie všetky jednotky podporujú každý režim.

### Ovládanie rýchlosti ventilátora

Prepínač **Fan Level** ovláda rýchlosť ventilátora so 6 úrovňami:

| Hodnota | Úroveň |
|---------|--------|
| 0 | Žiadna |
| 1 | Nízka |
| 2 | Stredná |
| 3 | Vysoká |
| 4 | Auto |
| 5 | Silná |

Dostupné úrovne ventilátora závisia od modelu spárovanej klimatizácie.

### Ovládanie vertikálnych lamiel

Prepínač **Vertical Swing** ovláda polohu vertikálnych lamiel s 10 stavmi:

| Hodnota | Poloha |
|---------|--------|
| 0 | Zastavené |
| 1 | Fixná hore |
| 2 | Fixná stred-hore |
| 3 | Fixná stred |
| 4 | Fixná stred-dole |
| 5 | Fixná dole |
| 6 | Rozsah hore |
| 7 | Rozsah stred |
| 8 | Rozsah dole |
| 9 | Rozsah plný |

Dostupné polohy lamiel závisia od spárovanej klimatizácie. Mnohé jednotky podporujú len podmnožinu týchto polôh. Aplikácia TapHome zobrazuje názvy hodnôt zo Sensibo API (napríklad `fixedTop`, `rangeFull`, `low`).

### Ovládanie displeja

Spínač **Display Light** ovláda LED displej na klimatizácii. Nie všetky modely klimatizácií podporujú ovládanie displeja cez IR — ak spárovaná jednotka túto funkciu nepodporuje, príkaz nebude mať žiadny efekt.

### Upozornenie na údržbu filtra

Senzor **Filter Clean Required** (jazýčkový kontakt) indikuje, kedy filtre klimatizácie potrebujú vyčistenie. Číta príznak `shouldCleanFilters` zo Sensibo API — hodnota je 1, keď filtre potrebujú čistenie, a 0, keď sú čisté. Indikátor filtra je možné resetovať cez mobilnú aplikáciu Sensibo.

### Ďalšie schopnosti

Sensibo API tiež sprístupňuje ovládanie horizontálnych lamiel, časovače, Climate React (automatické ovládanie klímy na základe prahových hodnôt), historické merania a senzory kvality vzduchu (TVOC, CO2 na Air Pro). Tieto funkcie môžu byť pridané v budúcej aktualizácii šablóny.

## Riešenie problémov

### API vracia chybu alebo žiadne dáta

1. Overte, že zariadenie Sensibo je online — skontrolujte stavovú LED a mobilnú aplikáciu Sensibo
2. Potvrďte, že API kľúč je správny a nebol preg enerovaný
3. Uistite sa, že parameter POD presne zodpovedá identifikátoru zariadenia (rozlišuje veľké a malé písmená)
4. Skontrolujte, že TapHome Core aj zariadenie Sensibo majú aktívne internetové pripojenie

### Chyba "API Key is empty" alebo "Pod is empty"

Šablóna overuje, či sú oba parametre nastavené pred odoslaním API požiadaviek. Ak vidíte túto chybu, otvorte premenné modulu v TapHome a overte, že polia API Key a POD obsahujú správne hodnoty.

### Príkazy nemajú žiadny efekt na klimatizáciu

Zariadenie Sensibo ovláda klimatizáciu cez IR (infračervené) signály. Uistite sa, že zariadenie Sensibo má priamy výhľad na IR prijímač klimatizácie. Ak konkrétna funkcia (displej, poloha lamiel) nefunguje, spárovaná klimatizácia nemusí túto funkciu podporovať cez svoj IR protokol.

> [!WARNING]
> Sensibo Cloud API vyžaduje aktívne internetové pripojenie a závisí od dostupnosti serverov Sensibo. Počas výpadkov cloudu alebo prerušenia internetu šablóna nebude prijímať aktualizované dáta ani odosielať príkazy. Neexistuje lokálna záloha — všetka komunikácia prechádza cez servery Sensibo.

## Dostupné zariadenia 8

Tieto zariadenia sa po importe zobrazia v TapHome.

Sensibo Inteligentné ovládanie klimatizácie Modul

Vlastné premenné

|                   |                                                                                  |
|-------------------|----------------------------------------------------------------------------------|
| `apiKey` (string) | Kľúč Sensibo Cloud API (získajte na https://home.sensibo.com/me/api)             |
| `pod` (string)    | Identifikátor zariadenia Sensibo (POD ID, unikátny pre každé zariadenie Sensibo) |

Čítanie (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álna teplota a vlhkosť Teplotný senzor Len na čítanie

Zabudované snímače teploty a vlhkosti — vlhkosť delená 100 pre rozsah TapHome 0–1

numeric Jednotka: °C / % JSON parsejson()

Čítanie vlhkosti

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

Čítanie teploty

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

Rýchlosť ventilátora Viacstavový prepínač Čítanie aj zápis

Ovládanie rýchlosti ventilátora klimatizácie — nízka, stredná, vysoká, auto, silná (dostupné úrovne závisia od spárovaného modelu)

string → numeric JSON parsejson() + SWITCH mapping

Hodnoty / Stavy: low · medium · high · auto · strong

Čítanie stavu prepínača

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

Zápis stavu prepínača

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

Displej Prepínač Čítanie aj zápis

Ovládanie LED displeja klimatizácie — nie všetky modely túto funkciu podporujú

string/boolean JSON parsejson() + IF comparison

Hodnoty / Stavy: ON · OFF

Čítanie stavu prepínača

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

Zápis stavu prepínača

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

Režim klimatizácie Viacstavový prepínač Čítanie aj zápis

Prevádzkový režim klimatizácie — VYP, Chladenie, Kúrenie, Ventilátor, Sušenie, Auto (dostupné režimy závisia od spárovaného modelu)

string → numeric Custom variable + SWITCH mapping

Hodnoty / Stavy: OFF · Cool · Heat · Fan · Dry · Auto

Čítanie stavu prepínača

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

Zápis stavu prepínača

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

Napájanie Prepínač Čítanie aj zápis

Ovládanie zapnutia/vypnutia klimatizácie cez IR príkaz

boolean JSON parsejson() + IF

Hodnoty / Stavy: ON · OFF

Čítanie stavu prepínača

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

Zápis stavu prepínača

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

Čistenie filtra vyžadované Jazýčkový kontakt Len na čítanie

Upozornenie na údržbu filtra — indikuje, kedy filtre klimatizácie potrebujú vyčistenie

boolean JSON parsejson() + IF

Čítanie

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

Vertikálne lamely Viacstavový prepínač Čítanie aj zápis

Ovládanie polohy vertikálnych lamiel — 10 polôh od fixných po rozsahové (dostupné polohy závisia od spárovaného modelu)

string → numeric JSON parsejson() + SWITCH mapping

Hodnoty / Stavy: stopped · fixedTop · fixedMiddleTop · fixedMiddle · fixedMiddleBottom · fixedBottom · rangeTop · rangeMiddle · rangeBottom · rangeFull

Čítanie stavu prepínača

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

Zápis stavu prepínača

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

Termostat Termostat Čítanie aj zápis

Nastavenie cieľovej teploty s aktuálnymi hodnotami teploty a vlhkosti

numeric Jednotka: °C JSON parsejson()

Čítanie teploty

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

Čítanie vlhkosti

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

Čítanie požadovanej teploty

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

Zápis požadovanej teploty

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

**Pripojenie:** Packet Parser → HTTP

Možné vylepšenia (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)

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii | Predvolené         |
|---------------------|--------------------|
| API Key             | Zadáte pri importe |
| POD                 | Zadáte pri importe |

## Zdroje

- 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

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)