TapHome

Sensibo Air Conditioner Smart Control

Packet Parser → HTTP
Trimis de
Ultima actualizare: 10. 2026
Sensibo Air Conditioner Smart Control

Șablonul Sensibo Air Conditioner Smart Control conectează TapHome la orice aparat de aer condiționat controlat prin IR, printr-un controler inteligent Sensibo (Sky, Air sau Air Pro). Dispozitivul Sensibo se amplasează lângă unitatea de aer condiționat, învață codurile telecomenzii IR și oferă controlul complet al aerului condiționat prin Sensibo Cloud API v2. TapHome interoghează serverele Sensibo prin HTTPS și primește datele de stare în timp real în format JSON — nu este necesară nicio cablare fizică la aparatul de aer condiționat.

Șablonul oferă 8 dispozitive: pornire/oprire, selectarea modului de funcționare, viteza ventilatorului, poziția baleierii verticale, termostat cu setarea temperaturii, monitorizarea temperaturii și umidității, controlul iluminării afișajului și alerte de întreținere a filtrului. Este nevoie doar de un cont Sensibo, de un dispozitiv Sensibo conectat la Wi-Fi și de o cheie API.

Configurare

Configurarea contului și a dispozitivului Sensibo

Dispozitivul Sensibo (Sky, Air sau Air Pro) trebuie să fie instalat, asociat cu aparatul de aer condiționat prin aplicația mobilă Sensibo și conectat la rețeaua Wi-Fi. Înainte de a continua cu integrarea în TapHome, dispozitivul trebuie să apară online în aplicația Sensibo.

Obținerea cheii API
  1. Deschideți home.sensibo.com/me/api într-un browser web
  2. Conectați-vă cu datele contului Sensibo
  3. Faceți clic pe Generate API Key, dacă nu aveți deja o cheie
  4. Copiați cheia API — este un șir alfanumeric lung

Cheia API oferă acces la toate dispozitivele Sensibo din contul dvs.

Găsirea identificatorului POD

POD este un identificator unic al fiecărui dispozitiv Sensibo. Unde îl găsiți:

  • În aplicația Sensibo — deschideți setările dispozitivului și căutați Device ID
  • Prin API — apelați GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey} și notați câmpul id al fiecărui dispozitiv

Fiecare dispozitiv Sensibo are alt POD. Dacă aveți mai multe dispozitive Sensibo, importați șablonul separat pentru fiecare, cu propriul POD.

Parametri de import

La importul șablonului în TapHome introduceți:

  • API Key — cheia API din portalul pentru dezvoltatori Sensibo
  • POD — identificatorul unic al dispozitivului Sensibo respectiv
Dependența de internet

Aceasta este o integrare exclusiv prin cloud. Toate datele trec prin serverele Sensibo (home.sensibo.com:443). Șablonul nu funcționează fără o conexiune activă la internet atât pe TapHome Core, cât și pe dispozitivul Sensibo.

Funcțiile dispozitivelor

Monitorizarea temperaturii și umidității

Senzorul Temperatură și umiditate curente citește senzorii integrați de temperatură și umiditate ai dispozitivului Sensibo. Temperatura este raportată în unitatea configurată pe dispozitivul Sensibo (de obicei Celsius). Umiditatea este împărțită la 100 pentru intervalul 0–1 al intrării analogice TapHome (de ex. 60 % devine 0,60).

Controlul termostatului

Termostatul oferă controlul complet al climatizării, cu setarea temperaturii. Citește temperatura curentă din cameră, umiditatea și temperatura țintă din starea aerului condiționat. La setarea unei noi temperaturi țintă, TapHome trimite o cerere PATCH către API-ul Sensibo, care transmite apoi aparatului de aer condiționat comanda IR corespunzătoare. Intervalul de temperatură disponibil depinde de modelul de aer condiționat asociat (de obicei 16–32 °C).

Controlul pornirii/opririi

Comutatorul Pornire/oprire pornește sau oprește aparatul de aer condiționat. La oprire, Sensibo trimite unității de aer condiționat comanda IR de oprire. La pornire, aparatul de aer condiționat revine la ultimul mod activ.

Selectarea modului aerului condiționat

Comutatorul multivaloare Mod aer condiționat controlează modul de funcționare, cu 6 stări:

ValoareMod
0OFF
1Cool (răcire)
2Heat (încălzire)
3Fan (ventilator)
4Dry (dezumidificare)
5Auto (automat)

Setarea modului la 0 (OFF) trimite o comandă de oprire în locul schimbării modului. Modurile disponibile depind de aparatul de aer condiționat asociat — nu toate unitățile acceptă toate modurile.

Controlul vitezei ventilatorului

Comutatorul multivaloare Treaptă ventilator controlează viteza ventilatorului, cu 6 trepte:

ValoareTreaptă ventilator
0None (niciuna)
1Low (redusă)
2Medium (medie)
3High (ridicată)
4Auto (automată)
5Strong (puternică)

Treptele de ventilator disponibile depind de modelul de aer condiționat asociat.

Controlul baleierii verticale

Comutatorul multivaloare Baleiere verticală controlează poziția clapetei verticale, cu 10 stări:

ValoarePoziție
0Stopped (oprită)
1Fixed Top (fix sus)
2Fixed Middle Top (fix mijloc-sus)
3Fixed Middle (fix mijloc)
4Fixed Middle Bottom (fix mijloc-jos)
5Fixed Bottom (fix jos)
6Range Top (baleiere sus)
7Range Middle (baleiere mijloc)
8Range Bottom (baleiere jos)
9Range Full (baleiere completă)

Pozițiile de baleiere disponibile depind de aparatul de aer condiționat asociat. Multe unități acceptă doar o parte din aceste poziții. Aplicația TapHome afișează denumirile valorilor din Sensibo API (de exemplu fixedTop, rangeFull, low).

Controlul iluminării afișajului

Comutatorul Iluminare afișaj controlează panoul de afișaj cu LED al aparatului de aer condiționat. Nu toate modelele acceptă controlul iluminării afișajului prin IR — dacă unitatea asociată nu are această funcție, comanda nu are niciun efect.

Alertă de întreținere a filtrului

Senzorul Curățare filtru necesară (contact reed) indică momentul în care filtrele aerului condiționat trebuie curățate. Citește indicatorul shouldCleanFilters din API-ul Sensibo — valoarea este 1 când filtrele trebuie curățate și 0 când sunt curate. Indicatorul filtrului poate fi resetat din aplicația mobilă Sensibo.

Funcții suplimentare

API-ul Sensibo oferă și controlul baleierii orizontale, funcții de temporizare, Climate React (control automat al climatizării pe baza unor praguri), măsurători istorice și senzori de calitate a aerului (TVOC, CO2 la Air Pro). Acestea pot fi adăugate într-o actualizare viitoare a șablonului.

Depanare

API-ul returnează o eroare sau nu returnează date
  1. Verificați dacă dispozitivul Sensibo este online — verificați LED-ul de stare și aplicația mobilă Sensibo
  2. Verificați dacă cheia API este corectă și nu a fost generată din nou
  3. Asigurați-vă că parametrul POD corespunde exact identificatorului dispozitivului (contează literele mari și mici)
  4. Verificați dacă atât TapHome Core, cât și dispozitivul Sensibo au conexiune activă la internet
Eroarea „API Key is empty” sau „Pod is empty”

Șablonul verifică dacă ambii parametri sunt setați înainte de a trimite cereri API. Dacă vedeți această eroare, deschideți variabilele modulului în TapHome și verificați dacă câmpurile API Key și POD conțin valorile corecte.

Comenzile nu au efect asupra aparatului de aer condiționat

Dispozitivul Sensibo controlează aparatul de aer condiționat prin semnale IR (infraroșu). Asigurați-vă că dispozitivul Sensibo are vizibilitate directă către receptorul IR al unității de aer condiționat. Dacă o anumită funcție (iluminarea afișajului, poziția baleierii) nu funcționează, este posibil ca aparatul de aer condiționat asociat să nu accepte funcția respectivă prin protocolul său IR.

Sensibo Cloud API necesită o conexiune activă la internet și depinde de disponibilitatea serverelor Sensibo. În timpul întreruperilor cloud sau ale conexiunii la internet, șablonul nu primește date actualizate și nu trimite comenzi. Nu există o cale locală de rezervă — toată comunicația trece prin serverele Sensibo.

Dispozitive disponibile

Sensibo Air Conditioner Smart Control Modul
Variabile personalizate
apiKey (string)Cheia Sensibo Cloud API (se obține de la https://home.sensibo.com/me/api)
pod (string)Identificatorul dispozitivului Sensibo (POD ID, unic pentru fiecare dispozitiv Sensibo)

Sensibo Air Conditioner Smart Control

Citire (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
Temperatură și umiditate curente Senzor de temperatură Doar citire

Senzori integrați de temperatură și umiditate — umiditatea este împărțită la 100 pentru intervalul TapHome 0–1

numeric Unitate: °C / % JSON parsejson()

Temperatură și umiditate curente

Citirea umidității
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Citirea temperaturii
PARSEJSON(responseJson,"$.result.measurements.temperature");
Treaptă ventilator Comutator cu mai multe valori

Controlul vitezei ventilatorului aerului condiționat — low, medium, high, auto, strong (treptele disponibile depind de modelul de aer condiționat asociat)

string → numeric JSON parsejson() + SWITCH mapping
Valori / Stări: low · medium · high · auto · strong

Treaptă ventilator

Citirea stării comutatorului
VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel");
SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0);
Scrierea stării comutatorului
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+"\"}");
Iluminare afișaj Comutator

Pornirea/oprirea LED-ului panoului de afișaj al aerului condiționat — nu toate modelele acceptă această funcție

string/boolean JSON parsejson() + IF comparison
Valori / Stări: ON · OFF

Iluminare afișaj

Citirea stării comutatorului
IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)
Scrierea stării comutatorului
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/light?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Mod aer condiționat Comutator cu mai multe valori

Modul de funcționare al aerului condiționat — OFF, Cool, Heat, Fan, Dry, Auto (modurile disponibile depind de modelul de aer condiționat asociat)

string → numeric Custom variable + SWITCH mapping
Valori / Stări: OFF · Cool · Heat · Fan · Dry · Auto

Mod aer condiționat

Citirea stării comutatorului
SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);
Scrierea stării comutatorului
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
Pornire/oprire Comutator

Pornirea/oprirea aerului condiționat prin comandă IR

boolean JSON parsejson() + IF
Valori / Stări: ON · OFF

Pornire/oprire

Citirea stării comutatorului
IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)
Scrierea stării comutatorului
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Curățare filtru necesară Contact reed Doar citire

Alertă de întreținere a filtrului — indică momentul în care filtrele aerului condiționat trebuie curățate

boolean JSON parsejson() + IF

Curățare filtru necesară

Citire
IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0)
Baleiere verticală Comutator cu mai multe valori

Controlul poziției clapetei verticale — 10 poziții, de la poziții fixe la baleiere pe un interval (pozițiile disponibile depind de modelul de aer condiționat asociat)

string → numeric JSON parsejson() + SWITCH mapping
Valori / Stări: stopped · fixedTop · fixedMiddleTop · fixedMiddle · fixedMiddleBottom · fixedBottom · rangeTop · rangeMiddle · rangeBottom · rangeFull

Baleiere verticală

Citirea stării comutatorului
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);
Scrierea stării comutatorului
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

Setarea temperaturii, cu citirea temperaturii și umidității curente

numeric Unitate: °C JSON parsejson()

Termostat

Citirea temperaturii
PARSEJSON(responseJson,"$.result.measurements.temperature");
Citirea umidității
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Citirea temperaturii dorite
PARSEJSON(responseJson,"$.result.acState.targetTemperature");
Scrierea temperaturii dorite
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/targetTemperature?apiKey="+apiKey, "PATCH", "{\"newValue\": "+Se+"}");
Conexiune: Packet Parser → HTTP
Îmbunătățiri posibile (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)

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal