---
title: "Shelly Pro 3"
description: "Sterowanie trzema niezależnymi kanałami przekaźnika przez HTTP JSON-RPC. Przełącznik DIN 3-kanałowy z WiFi, Ethernet i Bluetooth. Szablon: Shelly Pro 3."
url: "https://taphome.com/pl/compatibility/shelly-pro-3/"
language: pl
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","i/o-module","wifi","relay","din-rail","3-channel","mdns","ethernet"]
  questions: ["Jak zintegrować Shelly Pro 3 z TapHome?","Czym steruje szablon Shelly Pro 3 w TapHome?","Jak podłączyć Shelly Pro 3 przez HTTP do TapHome?","Jaka jest różnica między Shelly Pro 3 a Pro 3EM?","Czy Shelly Pro 3 może przełączać obwody trójfazowe?","Dlaczego Shelly Pro 3 nie reaguje na polecenia z TapHome?"]
---

# Shelly Pro 3

Komunikacja: Packet Parser → HTTP

- [Strona produktu Shelly Pro 3](https://www.shelly.com/en/products/shop/shelly-pro-3)

> Adres w sieci
> 
> TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres.
> 
> [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/)

## Poradnik integracji

Shelly Pro 3 to 3-kanałowy moduł przekaźnikowy na szynę DIN z bezpotencjałowymi stykami. Każde z trzech niezależnych wyjść może przełączać do 16 A (łącznie 48 A na wszystkich kanałach), co czyni go odpowiednim do sterowania obwodami oświetleniowymi, elementami grzewczymi lub obciążeniami trójfazowymi, gdzie każda faza jest przełączana osobno. TapHome komunikuje się z urządzeniem przez HTTP za pomocą API Gen2 JSON-RPC 2.0 w sieci lokalnej — połączenie z chmurą nie jest wymagane.

W odróżnieniu od Shelly Pro 3EM, który jest licznikiem energii (tylko monitoring), Pro 3 jest czystym urządzeniem przełączającym bez możliwości pomiaru mocy. Urządzenie łączy się przez WiFi, Ethernet (RJ45) lub Bluetooth i jest przeznaczone do profesjonalnej instalacji w rozdzielnicach elektrycznych.

## Konfiguracja

Shelly Pro 3 łączy się przez WiFi lub Ethernet. Podczas importu szablonu do TapHome wprowadź adres IP urządzenia (domyślny placeholder `192.168.0.1`).

> [!WARNING]
> Uwierzytelnianie musi być **wyłączone** na urządzeniu Shelly dla integracji z TapHome. TapHome nie obsługuje HTTP Digest Auth używanego przez urządzenia Gen2. Otwórz interfejs webowy Shelly (`http://{device-ip}`) → Settings → Authentication i upewnij się, że jest wyłączone.

> [!WARNING]
> Kabel LAN można podłączać lub odłączać tylko gdy urządzenie jest **wyłączone**. Podłączanie kabla Ethernet pod napięciem może powodować problemy.

> [!NOTE]
> Jeśli tryb ECO jest włączony na urządzeniu Shelly, może powodować timeouty komunikacji z powodu szybkich interwałów odpytywania szablonu (2,5–3 sekundy). Wyłącz tryb ECO w interfejsie webowym Shelly, jeśli doświadczasz przerywanych problemów z łącznością.

## Możliwości urządzenia

### Sterowanie przekaźnikiem

Szablon udostępnia trzy niezależne urządzenia przełącznikowe, po jednym dla każdego kanału przekaźnikowego. Stan każdego przekaźnika odczytywany jest z odpowiedzi `/rpc/Switch.GetStatus?id=N` (pole `output`, boolean) i sterowany przez `/rpc/Switch.Set?id=N&on=true` lub `on=false`, gdzie N to 0, 1 lub 2.

Wszystkie trzy kanały działają niezależnie — mogą być na różnych obwodach, różnych fazach AC, a nawet na mieszanych obciążeniach AC/DC. Styki przekaźnikowe są bezpotencjałowe (styki suche), więc każde wyjście może przełączać zupełnie oddzielny obwód od zasilania samego urządzenia.

### Diagnostyka serwisowa

Szablon udostępnia atrybuty serwisowe na poziomie modułu do monitorowania urządzenia:

- **WiFi** — nazwa podłączonej sieci SSID
- **Adres IP** — aktualny adres IP stacji
- **Siła sygnału** — WiFi RSSI w dB
- **MAC** — adres MAC urządzenia

Skrypt odczytu modułu sprawdza również dostępność aktualizacji firmware i oczekujące wymagania restartu, wyświetlając je jako ostrzeżenia w interfejsie TapHome.

### Akcje serwisowe

Dwie akcje serwisowe są dostępne na poziomie modułu:

- **Aktualizacja firmware** — uruchamia aktualizację firmware do najnowszej stabilnej wersji przez `/rpc/Shelly.Update`
- **Restart** — uruchamia restart urządzenia przez `/rpc/Shelly.Reboot`

### Dodatkowe możliwości

Shelly Pro 3 udostępnia również stany fizycznych wejść przełączników/przycisków (S1, S2, S3) przez komponent Input, wewnętrzną temperaturę urządzenia, czas pracy, wykorzystanie RAM, czas urządzenia i status Ethernetu przez API RPC. Timer auto-off jest dostępny przez parametr `toggle_after` polecenia Switch.Set. Te możliwości mogą zostać dodane w przyszłej aktualizacji szablonu.

## Rozwiązywanie problemów

### Urządzenie nie odpowiada

1. Sprawdź, czy Shelly jest połączony z WiFi lub Ethernet i ma prawidłowy adres IP
2. Spróbuj użyć nazwy hosta mDNS (`ShellyPro3-AABBCCDDEE.local`) zamiast adresu IP — IP mógł się zmienić po odnowieniu DHCP
3. Otwórz `http://{device-ip}/rpc/Shelly.GetDeviceInfo` w przeglądarce — jeśli odpowie JSON-em, urządzenie jest osiągalne
4. Sprawdź, czy TapHome Core i Shelly są w tej samej sieci / VLAN
5. Potwierdź, że uwierzytelnianie jest wyłączone na urządzeniu Shelly

### Tylko niektóre kanały reagują

1. Sprawdź, czy każdy kanał jest prawidłowo zaadresowany (id=0 dla Wyjścia 1, id=1 dla Wyjścia 2, id=2 dla Wyjścia 3)
2. Sprawdź wskaźniki LED przekaźników na panelu przednim urządzenia — czerwona LED oznacza, że odpowiedni przekaźnik jest zamknięty (WŁ)
3. Przetestuj niereagujący kanał ręcznie przez przeglądarkę: `http://{device-ip}/rpc/Switch.Set?id=N&on=true`

### Problemy z obciążeniem indukcyjnym

Dla obciążeń indukcyjnych (wentylatory, transformatory, sterowniki LED) zalecany jest układ RC (0,1 uF / 100 Ohm / 1/2 W / 600 VAC) na wyjściu przekaźnika w celu ochrony przed skokami napięcia i wydłużenia żywotności przekaźnika.

> [!WARNING]
> Urządzenia Shelly Gen2 obsługują do **6 jednoczesnych połączeń HTTP**. Unikaj odpytywania z zbyt wielu systemów jednocześnie (TapHome, Home Assistant, własne skrypty), aby zapobiec wyczerpaniu połączeń.

## Jak zainstalować w TapHome

### Wymagania wstępne

- Urządzenie Shelly zainstalowane i włączone
- Lokalna sieć Wi-Fi (2,4 GHz)
- TapHome CCU w tej samej sieci

### Krok 1 — Podłącz Shelly do Wi-Fi

**Opcja A — Aplikacja Shelly (zalecana):**

1. Pobierz [aplikację Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Dotknij **+** → **Add Device** i postępuj zgodnie z kreatorem parowania Bluetooth
3. Wprowadź dane logowania Wi-Fi, gdy zostaniesz o to poproszony

**Opcja B — Tryb AP (bez aplikacji):**

1. Przy pierwszym uruchomieniu urządzenie tworzy hotspot: `ShellyXXX-AABBCCDDEE`
2. Połącz telefon/PC z tym hotspotem
3. Otwórz `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Wprowadź SSID i hasło → **Save**

> [!NOTE]
> Shelly obsługuje tylko sieci **2,4 GHz**. Sieci 5 GHz nie pojawią się podczas skanowania.

### Krok 2 — Znajdź adres IP

Po połączeniu z Wi-Fi znajdź przypisany adres IP za pomocą jednej z poniższych metod:

- **Aplikacja Shelly:** Szczegóły urządzenia → **Device info** → Adres IP
- **Interfejs webowy Shelly:** Połącz się z AP urządzenia przed konfiguracją Wi-Fi — IP zostanie wyświetlone po zapisaniu
- **Tabela DHCP routera:** Szukaj nazwy hosta takiej jak `shelly1pm-AABBCCDDEE`
- **mDNS:** Pinguj `shelly<model>-<mac>.local` (np. `shelly1pm-AABBCCDDEE.local`) z tej samej sieci

> [!TIP]
> Przypisz urządzeniu Shelly **statyczny IP** (rezerwację DHCP) w routerze, aby adres nie zmieniał się po ponownym uruchomieniu routera.

### Krok 3 — Konfiguracja w TapHome

1. W TapHome dodaj nowy moduł **Packet Parser (HTTP)**
2. **IP Address:** wprowadź IP z kroku 2 (np. `192.168.1.50`)
3. **Port:** `80` (domyślny, nie wymaga zmiany)
4. Zaimportuj szablon — TapHome będzie okresowo odpytywać `/status` w celu odczytu stanu urządzenia

> [!NOTE]
> Uwierzytelnianie HTTP jest domyślnie wyłączone na urządzeniach Shelly. Jeśli włączyłeś ochronę logowaniem, TapHome obecnie nie obsługuje HTTP Basic Auth — pozostaw uwierzytelnianie wyłączone dla integracji z TapHome.

## Dostępne urządzenia 3

Te urządzenia pojawią się w TapHome po imporcie.

Shelly Pro 3 Moduł

Atrybuty serwisowe

|              |
|--------------|
| WiFi         |
| Adres IP     |
| Siła sygnału |
| MAC          |

Akcje serwisowe

|                       |
|-----------------------|
| Aktualizacja firmware |
| Restart               |

Zmienne niestandardowe

Odczyt (moduł)

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
```

Atrybuty serwisowe

Wifi

```taphome
PARSEJSON(WiFi.GetStatus, "ssid")
```

${ipAddress}

```taphome
PARSEJSON(WiFi.GetStatus, "sta_ip")
```

${xml\_signal\_strength} \[dB]

```taphome
PARSEJSON(WiFi.GetStatus, "rssi")
```

MAC

```taphome
PARSEJSON(Sys.GetStatus, "mac")
```

Akcje serwisowe

${xml\_update\_fw}

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END

```

Reboot

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
```

Przełącznik 1 Przełącznik Odczyt i zapis

boolean

Wartości / Stany: ON · OFF

Odczyt stanu przełącznika

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
```

Zapis stanu przełącznika

```taphome
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
```

Przełącznik 2 Przełącznik Odczyt i zapis

boolean

Wartości / Stany: ON · OFF

Odczyt stanu przełącznika

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
```

Zapis stanu przełącznika

```taphome
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
```

Przełącznik 3 Przełącznik Odczyt i zapis

boolean

Wartości / Stany: ON · OFF

Odczyt stanu przełącznika

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
```

Zapis stanu przełącznika

```taphome
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
```

**Połączenie:** Packet Parser → HTTP • Hostname: `ShellyPro3-{MAC}.local`

Możliwe ulepszenia (9)

- Input 1 State — Physical switch/button input S1 state, available via /rpc/Input.GetStatus?id=0
- Input 2 State — Physical switch/button input S2 state, available via /rpc/Input.GetStatus?id=1
- Input 3 State — Physical switch/button input S3 state, available via /rpc/Input.GetStatus?id=2
- Device Temperature — Internal temperature in °C, available in Switch.GetStatus response (non-metered devices may still report temperature)
- Uptime — Seconds since last reboot, available in Sys.GetStatus response
- RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
- Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
- Auto-off Timer — Auto-reset timer in seconds via toggle\_after parameter, could be added as switch parameter for all 3 channels
- Ethernet Status — Pro 3 has RJ45 LAN port; Ethernet status (IP, link) available via /rpc/Ethernet.GetStatus

## Parametry importu

Te wartości podajesz podczas importu pliku XML.

| Pytanie w aplikacji | Domyślnie     |
|---------------------|---------------|
| Adres IP            | `192.168.0.1` |

## Źródła

- Shelly Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-29
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-29
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Pro 3 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-pro-3) 2026-03-29

## Powiązana dokumentacja

- [Integracja Packet Parser](https://taphome.com/pl/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/)
- [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/)
- [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)