---
title: "Sensibo Air Conditioner Smart Control"
description: "Sensibo Cloud API za pametne IR upravljače klima-uređaja: uključivanje, način rada, brzina ventilatora, njihanje, termostat, temperatura i vlažnost."
url: "https://taphome.com/hr/compatibility/sensibo-air-conditioner-smart-control/"
language: hr
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","air-conditioning","cloud-api","thermostat","hvac-control","smart-home"]
  questions: ["Kako integrirati Sensibo sa sustavom TapHome preko Cloud API-ja?","Koje podatke daje predložak TapHome za Sensibo?","Kako dobiti API ključ Sensibo za TapHome?","Mogu li preko sustava TapHome i uređaja Sensibo upravljati brzinom ventilatora i položajem njihanja?","Radi li predložak Sensibo sa svakim klima-uređajem?","Kako u sustavu TapHome postaviti Sensibo POD ID?"]
---

# Sensibo Air Conditioner Smart Control

Komunikacija: Packet Parser → HTTP

- [Službena stranica Sensibo](https://www.sensibo.com)

## Upute za integraciju

Predložak Sensibo Air Conditioner Smart Control povezuje TapHome sa svakim klima-uređajem kojim se upravlja infracrvenim (IR) daljinskim upravljačem, preko pametnog upravljača klima-uređaja Sensibo (Sky, Air ili Air Pro). Uređaj Sensibo postavlja se blizu klima-uređaja, uči IR kodove njegova daljinskog upravljača i daje potpuno upravljanje klima-uređajem preko Sensibo Cloud API v2. TapHome šalje upite poslužiteljima Sensibo preko HTTPS-a i prima podatke o stanju u stvarnom vremenu u formatu JSON, pa fizičko ožičenje do klima-uređaja nije potrebno.

Predložak daje 8 uređaja: uključivanje i isključivanje, odabir načina rada, brzinu ventilatora, položaj okomitog njihanja, termostat sa zadanom temperaturom, praćenje temperature i vlažnosti, upravljanje svjetlom zaslona i upozorenja za održavanje filtra. Potrebni su samo Sensibo račun, uređaj Sensibo spojen na Wi-Fi i API ključ.

## Konfiguracija

### Postavljanje Sensibo računa i uređaja

Uređaj Sensibo (Sky, Air ili Air Pro) mora biti ugrađen, uparen s vašim klima-uređajem u mobilnoj aplikaciji Sensibo i spojen na vašu Wi-Fi mrežu. Prije integracije sa sustavom TapHome uređaj se u aplikaciji Sensibo mora prikazivati kao povezan s mrežom.

### Dobivanje API ključa

1. U web-pregledniku otvorite [home.sensibo.com/me/api](https://home.sensibo.com/me/api)
2. Prijavite se podacima svojeg Sensibo računa
3. Kliknite **Generate API Key** ako ključ još nemate
4. Kopirajte API ključ: to je dugi alfanumerički niz

API ključ daje pristup svim uređajima Sensibo na vašem računu.

### Pronalaženje identifikatora POD

POD je jedinstveni identifikator svakog uređaja Sensibo. Gdje ga pronaći:

- **U aplikaciji Sensibo** — otvorite postavke uređaja i potražite Device ID
- **Preko API-ja** — pozovite `GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey}` i zapišite polje `id` za svaki uređaj

Svaki uređaj Sensibo ima drugačiji POD. Ako imate više uređaja Sensibo, predložak treba uvesti zasebno za svaki od njih, s njegovim POD-om.

### Parametri uvoza

Pri uvozu predloška u TapHome unesite:

- **API Key** — API ključ s portala Sensibo za razvojne programere
- **POD** — jedinstveni identifikator određenog uređaja Sensibo

### Ovisnost o internetu

Ovo je integracija isključivo preko oblaka. Svi podaci idu preko poslužitelja Sensibo (`home.sensibo.com:443`). Predložak ne radi bez aktivne internetske veze i na centralnoj jedinici TapHome Core i na uređaju Sensibo.

## Mogućnosti uređaja

### Praćenje temperature i vlažnosti

Senzor **Trenutačna temperatura i vlažnost** čita ugrađene senzore temperature i vlažnosti uređaja Sensibo. Temperatura se iskazuje u jedinici postavljenoj na uređaju Sensibo (obično u Celzijevim stupnjevima). Vlažnost se dijeli sa 100 za raspon analognog ulaza TapHome 0–1 (npr. 60 % postaje 0,60).

### Upravljanje termostatom

**Termostat** omogućuje potpuno upravljanje klimom sa zadanom temperaturom. Čita trenutačnu sobnu temperaturu, vlažnost i ciljnu temperaturu iz stanja klima-uređaja. Upis nove zadane temperature šalje zahtjev PATCH na Sensibo API, koji zatim klima-uređaju šalje odgovarajuću IR naredbu. Dostupni raspon temperature ovisi o uparenom modelu klima-uređaja (obično 16–32 °C).

### Uključivanje i isključivanje

Sklopka **Uključivanje** uključuje ili isključuje klima-uređaj. Pri isključivanju Sensibo šalje klima-uređaju IR naredbu za isključivanje. Pri uključivanju klima-uređaj nastavlja rad u posljednjem aktivnom načinu.

### Odabir načina rada klima-uređaja

Prekidač s više vrijednosti **Način rada klima-uređaja** upravlja načinom rada sa 6 stanja:

| Vrijednost | Način |
|-------|------|
| 0 | OFF |
| 1 | Cool |
| 2 | Heat |
| 3 | Fan |
| 4 | Dry |
| 5 | Auto |

Postavljanje načina na 0 (OFF) šalje naredbu za isključivanje umjesto promjene načina. Dostupni načini ovise o uparenom klima-uređaju: ne podržavaju svi klima-uređaji svaki način.

### Upravljanje brzinom ventilatora

Prekidač s više vrijednosti **Razina ventilatora** upravlja brzinom ventilatora sa 6 razina:

| Vrijednost | Razina ventilatora |
|-------|-----------|
| 0 | None |
| 1 | Low |
| 2 | Medium |
| 3 | High |
| 4 | Auto |
| 5 | Strong |

Dostupne razine ventilatora ovise o modelu uparenog klima-uređaja.

### Upravljanje okomitim njihanjem

Prekidač s više vrijednosti **Okomito njihanje** upravlja položajem okomite lamele s 10 stanja:

| Vrijednost | Položaj |
|-------|----------|
| 0 | Stopped |
| 1 | Fixed Top |
| 2 | Fixed Middle Top |
| 3 | Fixed Middle |
| 4 | Fixed Middle Bottom |
| 5 | Fixed Bottom |
| 6 | Range Top |
| 7 | Range Middle |
| 8 | Range Bottom |
| 9 | Range Full |

Dostupni položaji njihanja ovise o uparenom klima-uređaju. Mnogi klima-uređaji podržavaju samo dio tih položaja. Aplikacija TapHome prikazuje nazive vrijednosti iz Sensibo API-ja (na primjer `fixedTop`, `rangeFull`, `low`).

### Upravljanje svjetlom zaslona

Sklopka **Svjetlo zaslona** upravlja LED zaslonom na klima-uređaju. Ne podržavaju svi modeli klima-uređaja upravljanje svjetlom zaslona preko IR-a: ako upareni uređaj ne podržava tu funkciju, naredba nema učinka.

### Upozorenje za održavanje filtra

Senzor **Potrebno čišćenje filtra** (magnetski kontakt) pokazuje kada treba očistiti filtre klima-uređaja. Čita zastavicu `shouldCleanFilters` iz Sensibo API-ja: vrijednost je 1 kada filtre treba očistiti, a 0 kada su čisti. Pokazatelj filtra može se poništiti u mobilnoj aplikaciji Sensibo.

### Dodatne mogućnosti

Sensibo API daje i upravljanje vodoravnim njihanjem, funkcije timera, Climate React (automatsko upravljanje klimom na temelju pragova), povijesna mjerenja i senzore kvalitete zraka (TVOC, CO₂ na Air Pro). Mogu se dodati u budućem ažuriranju predloška.

## Rješavanje problema

### API vraća grešku ili nema podataka

1. Provjerite je li uređaj Sensibo na mreži: provjerite LED stanja i mobilnu aplikaciju Sensibo
2. Provjerite je li API ključ ispravan i nije li ponovno izrađen
3. Provjerite odgovara li parametar POD točno identifikatoru uređaja (razlikuju se velika i mala slova)
4. Provjerite imaju li centralna jedinica TapHome Core i uređaj Sensibo aktivnu internetsku vezu

### Greška „API Key is empty” ili „Pod is empty”

Predložak prije slanja API zahtjeva provjerava jesu li oba parametra postavljena. Ako vidite ovu grešku, u sustavu TapHome otvorite varijable modula i provjerite sadrže li polja API Key i POD ispravne vrijednosti.

### Naredbe nemaju učinka na klima-uređaj

Uređaj Sensibo upravlja klima-uređajem infracrvenim (IR) signalima. Između uređaja Sensibo i IR prijemnika klima-uređaja mora postojati izravna vidljivost. Ako određena funkcija (svjetlo zaslona, položaj njihanja) ne radi, upareni klima-uređaj možda ne podržava tu funkciju u svojem IR protokolu.

> [!WARNING]
> Sensibo Cloud API zahtijeva aktivnu internetsku vezu i ovisi o dostupnosti poslužitelja Sensibo. Tijekom prekida rada oblaka ili interneta predložak ne prima nove podatke i ne šalje naredbe. Ne postoji lokalni rezervni put: sva komunikacija ide preko poslužitelja Sensibo.

## Dostupni uređaji 8

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Sensibo Air Conditioner Smart Control Modul

Prilagođene varijable

|                   |                                                                               |
|-------------------|-------------------------------------------------------------------------------|
| `apiKey` (string) | API ključ za Sensibo Cloud API (dobiva se na https://home.sensibo.com/me/api) |
| `pod` (string)    | Identifikator uređaja Sensibo (POD ID, jedinstven za svaki uređaj Sensibo)    |

Čitanje (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
```

Trenutačna temperatura i vlažnost Senzor temperature Samo za čitanje

Ugrađeni senzori temperature i vlažnosti — vlažnost se dijeli sa 100 za raspon TapHome 0–1

numeric Jedinica: °C / % JSON parsejson()

Čitanje vlažnosti

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

Čitanje temperature

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

Razina ventilatora Prekidač s više vrijednosti Čitanje i pisanje

Upravljanje brzinom ventilatora klima-uređaja — low, medium, high, auto, strong (dostupne razine ovise o uparenom modelu klima-uređaja)

string → numeric JSON parsejson() + SWITCH mapping

Vrijednosti / stanja: low · medium · high · auto · strong

Čitanje stanja sklopke

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

Zapis stanja sklopke

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

Svjetlo zaslona Sklopka Čitanje i pisanje

Uključivanje i isključivanje LED zaslona klima-uređaja — ne podržavaju svi modeli klima-uređaja ovu funkciju

string/boolean JSON parsejson() + IF comparison

Vrijednosti / stanja: ON · OFF

Čitanje stanja sklopke

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

Zapis stanja sklopke

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

Način rada klima-uređaja Prekidač s više vrijednosti Čitanje i pisanje

Način rada klima-uređaja — OFF, Cool, Heat, Fan, Dry, Auto (dostupni načini ovise o uparenom modelu klima-uređaja)

string → numeric Custom variable + SWITCH mapping

Vrijednosti / stanja: OFF · Cool · Heat · Fan · Dry · Auto

Čitanje stanja sklopke

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

Zapis stanja sklopke

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

Uključivanje Sklopka Čitanje i pisanje

Uključivanje i isključivanje klima-uređaja IR naredbom

boolean JSON parsejson() + IF

Vrijednosti / stanja: ON · OFF

Čitanje stanja sklopke

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

Zapis stanja sklopke

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

Potrebno čišćenje filtra Magnetski kontakt Samo za čitanje

Upozorenje za održavanje filtra — pokazuje kada treba očistiti filtre klima-uređaja

boolean JSON parsejson() + IF

Čitanje

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

Okomito njihanje Prekidač s više vrijednosti Čitanje i pisanje

Upravljanje položajem okomite lamele — 10 položaja, od fiksnih do njihanja u rasponu (dostupni položaji ovise o uparenom modelu klima-uređaja)

string → numeric JSON parsejson() + SWITCH mapping

Vrijednosti / stanja: stopped · fixedTop · fixedMiddleTop · fixedMiddle · fixedMiddleBottom · fixedBottom · rangeTop · rangeMiddle · rangeBottom · rangeFull

Čitanje stanja sklopke

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

Zapis stanja sklopke

```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 Čitanje i pisanje

Upravljanje zadanom temperaturom s očitanjem trenutačne temperature i vlažnosti

numeric Jedinica: °C JSON parsejson()

Čitanje temperature

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

Čitanje vlažnosti

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

Čitanje željene temperature

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

Zapis željene temperature

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

**Povezivanje:** Packet Parser → HTTP

Moguća poboljšanja (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)

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano             |
|----------------------|--------------------|
| API Key              | Unosi se pri uvozu |
| POD                  | Unosi se pri uvozu |

## Izvori

- 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

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

