---
title: "Sensibo Air Conditioner Smart Control"
description: "Integrare Sensibo Cloud API pentru controlere inteligente de aer condiționat cu IR. Pornire, mod, ventilator, baleiere, termostat, temperatură, umiditate."
url: "https://taphome.com/ro/compatibility/sensibo-air-conditioner-smart-control/"
language: ro
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","air-conditioning","cloud-api","thermostat","hvac-control","smart-home"]
  questions: ["Cum se integrează Sensibo cu TapHome prin Cloud API?","Ce date oferă șablonul TapHome pentru Sensibo?","Cum se obține cheia API Sensibo pentru TapHome?","Pot controla viteza ventilatorului și poziția baleierii prin TapHome cu Sensibo?","Funcționează șablonul Sensibo cu orice aparat de aer condiționat?","Cum se configurează POD ID-ul Sensibo în TapHome?"]
---

# Sensibo Air Conditioner Smart Control

Comunicație: Packet Parser → HTTP

- [Site-ul oficial Sensibo](https://www.sensibo.com)

## Ghid de integrare

Ș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](https://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:

| Valoare | Mod |
|-------|------|
| 0 | OFF |
| 1 | Cool (răcire) |
| 2 | Heat (încălzire) |
| 3 | Fan (ventilator) |
| 4 | Dry (dezumidificare) |
| 5 | Auto (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:

| Valoare | Treaptă ventilator |
|-------|-----------|
| 0 | None (niciuna) |
| 1 | Low (redusă) |
| 2 | Medium (medie) |
| 3 | High (ridicată) |
| 4 | Auto (automată) |
| 5 | Strong (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:

| Valoare | Poziție |
|-------|----------|
| 0 | Stopped (oprită) |
| 1 | Fixed Top (fix sus) |
| 2 | Fixed Middle Top (fix mijloc-sus) |
| 3 | Fixed Middle (fix mijloc) |
| 4 | Fixed Middle Bottom (fix mijloc-jos) |
| 5 | Fixed Bottom (fix jos) |
| 6 | Range Top (baleiere sus) |
| 7 | Range Middle (baleiere mijloc) |
| 8 | Range Bottom (baleiere jos) |
| 9 | Range 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.

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

Aceste dispozitive apar în TapHome după import.

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

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

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

Citirea umidității

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

Citirea temperaturii

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

Treaptă ventilator Comutator cu mai multe valori Citire și scriere

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

Citirea stării comutatorului

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

Scrierea stării comutatorului

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

Iluminare afișaj Comutator Citire și scriere

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

Citirea stării comutatorului

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

Scrierea stării comutatorului

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

Mod aer condiționat Comutator cu mai multe valori Citire și scriere

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

Citirea stării comutatorului

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

Scrierea stării comutatorului

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

Pornire/oprire Comutator Citire și scriere

Pornirea/oprirea aerului condiționat prin comandă IR

boolean JSON parsejson() + IF

Valori / Stări: ON · OFF

Citirea stării comutatorului

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

Scrierea stării comutatorului

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

Citire

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

Baleiere verticală Comutator cu mai multe valori Citire și scriere

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

Citirea stării comutatorului

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

Scrierea stării comutatorului

```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 Citire și scriere

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

numeric Unitate: °C JSON parsejson()

Citirea temperaturii

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

Citirea umidității

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

Citirea temperaturii dorite

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

Scrierea temperaturii dorite

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

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit               |
|------------------------|------------------------|
| API Key                | Se introduce la import |
| POD                    | Se introduce la import |

## Surse

- 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

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)

