TapHome
Službeni · TapHome Provjereno HVAC integracija

Sensibo Air Conditioner Smart Control

Integracija preko Sensibo Cloud API-ja za pametne IR upravljače klima-uređaja (Sensibo Sky, Air, Air Pro). Upravljanje uključivanjem, načinom rada, brzinom ventilatora, njihanjem i termostatom te praćenje temperature i vlažnosti preko HTTPS-a, bez ožičenja.

SensiboPacket Parser → HTTP8 uređajaRevizija 1.1 Posljednje ažuriranje: 8. listopada 2026.
Sensibo Air Conditioner Smart Control

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

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

VrijednostNačin
0OFF
1Cool
2Heat
3Fan
4Dry
5Auto

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:

VrijednostRazina ventilatora
0None
1Low
2Medium
3High
4Auto
5Strong

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:

VrijednostPoložaj
0Stopped
1Fixed Top
2Fixed Middle Top
3Fixed Middle
4Fixed Middle Bottom
5Fixed Bottom
6Range Top
7Range Middle
8Range Bottom
9Range 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.

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)

Sensibo Air Conditioner Smart Control

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

Trenutačna temperatura i vlažnost

Čitanje vlažnosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čitanje temperature
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

Razina ventilatora

Čitanje stanja sklopke
VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel");
SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0);
Zapis stanja sklopke
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

Svjetlo zaslona

Čitanje stanja sklopke
IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)
Zapis stanja sklopke
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

Način rada klima-uređaja

Čitanje stanja sklopke
SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);
Zapis stanja sklopke
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

Uključivanje

Čitanje stanja sklopke
IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)
Zapis stanja sklopke
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

Potrebno čišćenje filtra

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

Okomito njihanje

Čitanje stanja sklopke
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
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()

Termostat

Čitanje temperature
PARSEJSON(responseJson,"$.result.measurements.temperature");
Čitanje vlažnosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čitanje željene temperature
PARSEJSON(responseJson,"$.result.acState.targetTemperature");
Zapis željene temperature
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 aplikacijiZadano
API KeyUnosi se pri uvozu
PODUnosi se pri uvozu

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Predložak · TapHome portal Sensibo Air Conditioner Smart Control Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog. Packet Parser → HTTP Pogledaj u TapHome portalu