innovaphone wiki - User contributions [en]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-09-24T12:59:58Z

Kwa:

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', '''Shelly Pro2''' and '''Shelly Pro RGBWW''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Shelly RGBWW PM ==
This model is similar to the Shelly Pro 2 (DIN rail mount, LAN), but it has five inputs instead of two and is powered by 24V DC. If you are operating the system on 220V, you will need a transformer.

[[Image:Sh42.png|sh42.png/]]

It is important to note that the external switches connect the 0V line (minus) to the inputs (indicated by the ground symbol in the diagram).

[[Image:Sh41.png|sh41.png/]]

This model has several operating variants, for example, to control colored LED strips. You can set this under Device profile (scroll all the way down), we tested the 5 input operating mode.

[[Image:Sh40.png|sh40.png/]]

The individual inputs (Input 0–4) should be set to Button and Single input. In the Button app, the usual numbering from Serial-0 to Serial-4 will be used.

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-08-08T13:04:20Z

Kwa: /* Shelly RGBWW PM */

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', '''Shelly Pro2''' and '''Shelly Pro RGBWW''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Shelly RGBWW PM ==
This model is similar to the Shelly Pro 2 (DIN rail mount, LAN), but it has five inputs instead of two and is powered by 24V DC. If you are operating the system on 220V, you will need a transformer.

[[Image:Sh42.png]]

It is important to note that the external switches connect the 0V line (minus) to the inputs (indicated by the ground symbol in the diagram).

[[Image:Sh41.png]]

This model has several operating variants, for example, to control colored LED strips. You can set this under Device profile (scroll all the way down), we tested the 5 input operating mode.

[[Image:Sh40.png]]

The individual inputs (Input 0–4) should be set to Button and Single input. In the Button app, the usual numbering from Serial-0 to Serial-4 will be used.

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-08-08T13:02:48Z

Kwa: /* Introduction */

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', '''Shelly Pro2''' and '''Shelly Pro RGBWW''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Shelly RGBWW PM ==
This model is similar to the Shelly Pro 2 (DIN rail mount, LAN), but it has five inputs instead of two and is powered by 24V DC. If you are operating the system on 220V, you will need a transformer.

[[Image:Sh42.png]]

It is important to note that the external switches connect the 0V line (minus) to the inputs (indicated by the ground symbol in the diagram).

[[Image:Sh41.png]]

This model has several operating variants, for example, to control colored LED strips. You can set this under Device profile (scroll all the way down).

[[Image:Sh40.png]]

The individual inputs (Input 0–4) should be set to Button and Single input. In the Button app, the usual numbering from Serial-0 to Serial-4 will be used.

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-08-08T13:02:32Z

Kwa: /* Introduction */

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', '''Shelly Pro2''' and '''Shelly Pro RGBWW'''models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Shelly RGBWW PM ==
This model is similar to the Shelly Pro 2 (DIN rail mount, LAN), but it has five inputs instead of two and is powered by 24V DC. If you are operating the system on 220V, you will need a transformer.

[[Image:Sh42.png]]

It is important to note that the external switches connect the 0V line (minus) to the inputs (indicated by the ground symbol in the diagram).

[[Image:Sh41.png]]

This model has several operating variants, for example, to control colored LED strips. You can set this under Device profile (scroll all the way down).

[[Image:Sh40.png]]

The individual inputs (Input 0–4) should be set to Button and Single input. In the Button app, the usual numbering from Serial-0 to Serial-4 will be used.

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-08-08T13:01:53Z

Kwa: /* Shelly Pro 2 */

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Shelly RGBWW PM ==
This model is similar to the Shelly Pro 2 (DIN rail mount, LAN), but it has five inputs instead of two and is powered by 24V DC. If you are operating the system on 220V, you will need a transformer.

[[Image:Sh42.png]]

It is important to note that the external switches connect the 0V line (minus) to the inputs (indicated by the ground symbol in the diagram).

[[Image:Sh41.png]]

This model has several operating variants, for example, to control colored LED strips. You can set this under Device profile (scroll all the way down).

[[Image:Sh40.png]]

The individual inputs (Input 0–4) should be set to Button and Single input. In the Button app, the usual numbering from Serial-0 to Serial-4 will be used.

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

File:Sh42.png

2025-08-08T12:59:38Z

Kwa:

File:Sh41.png

2025-08-08T12:59:26Z

Kwa:

File:Sh40.png

2025-08-08T12:59:13Z

Kwa:

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-08-08T12:29:26Z

Kwa:

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-17T08:20:06Z

Kwa:

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-17T08:19:05Z

Kwa:

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}
{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-17T08:18:10Z

Kwa:

{{DISPLAYTITLE:Howto:Integrating Shelly IoT Devices with the Buttons App}}

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png|sh01.png/]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png|sh02.png/]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png|sh03.png/]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png|sh04.png/]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png|sh05.png/]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png|sh06.png/]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png|sh07.png/]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png|sh08.png/]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png|sh09.png/]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png|sh10.png/]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png|sh11.png/]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png|sh12.png/]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png|sh13.png/]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png|sh14.png/]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png|sh15.png/]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png|sh16.png/]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png|sh17.png/]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png|sh18.png/]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png|sh19.png/]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png|sh20.png/]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png|sh21.png/]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png|sh22.png/]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png|sh25.png/]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png|sh23.png/]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png|sh24.png/]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-17T08:02:43Z

Kwa:

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''Buttons App'''.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T15:33:37Z

Kwa:

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the innovaphone Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the innovaphone Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''innovaphone Buttons Ap'''p.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an innovaphone application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Reference15r1:Concept Buttons App

2025-07-16T14:32:25Z

Kwa:

[[Category:Concept|Apps]]
[[Category:Concept App Service Buttons]]
== Applies To ==

* innovaphone from version 15r1

== Overview ==

The myApps Buttons App is an open source app that deals with the integration of IoT devices and PBX features as triggers. In principle, it is about linking certain input triggers to various output actions

== Installation ==
Go to the '''Settings App''' (PBX manager) and open the '''"AP app installer"''' plugin. On the right panel, the App Store will be shown. ''Hint : if you access it for the first time, you will need to accept the "Terms of Use of the innovaphone App Store"''
* In the search field located on the top right corner of the store, search for '''"Buttons"''' and click on it
* Select the proper firmware version, for example '''"Version 15r1"''' and click on install
* Tick "I accept the terms of use" and continue by clicking on the install yellow button
* Wait until the install has been finished
* Close and reopen the '''Settings App''' (PBX manager) again in order to refresh the list of the available colored AP plugin
* Click on the '''"Buttons"''' and click on '''" + Add an App"''' and then on the '''"Buttons"''' button.
* Enter a '''"Name"''' that is used as display name ''(all character allowed)'' for it and the '''"SIP"''' name that is the administrative field ''(no space, no capital letters)''. ''e.g : Name: Buttons, SIP: buttons''
* Click OK to save the settings and a green check mark will be shown to inform you that the configuration is good

'''Buttons User'''

* You also need a separate User Object in the pbx which is used from the buttons app. The app will register on this object for...
** '''calls'''
*** an incoming call to this user will be used as trigger. therefor the incoming '''cgpn''' and sip of the internal caller and the '''cdpn''' as destination is used.
*** Triggernumber '''"99"''' is reserved for Working Toggle. All other destination can be defined per user.
*** you can setup MWI-Function keys to the number of the buttons-user + append own number checkmark.
**** in the MWI Key example you will see the 8599 which combines the number of the buttons user "85" with the triggerbumber "99" for working toggle
** '''chat'''
*** if you want to use outgoing chats from the app you have to assign the chat app to this user
*** place "chat" in the Home Screen Apps. Just type it in like this.

[[File:Buttons-mwi-working.png|thumb|none|/Buttons-mwi-working.png|/Buttons-mwi-working.png]]
[[File:Buttosapp user chat.png|thumb|none|/Buttosapp_user_chat.png|/Buttosapp_user_chat.png]]

== Buttons App - Overview ==
Every mentioned Input Trigger can be multiple combined wit output actions.

[[Image:Buttons overview.png|700px|/Buttons_overview.png|/Buttons_overview.png]]

=== Input trigger ===
===== PhoneKeys / Dial In =====
The Buttons app can be made available for calls via a dial-in number. This involves a comparison of the caller (cgpn, sip) and the number called (cdpn).

===== myApps Windows Client (Hotkey) =====
In the '''myApps Windows Launcher''', buttons can be assigned a hotkey. To do this, append the parameter <code>?hotkey=[number]</code> to the name of the app object.

'''Example:'''

If your app object is named '''"buttons"''' and you want to assign hotkey number '''1''', the entry would be: buttons?hotkey=1

===== Shelly Devices =====
Shelly devices can be used as trigger devices in the Buttons app. To do this, the app opens another web socket below the app path. The path name is “/shelly ”

For example: [https://your-app-platforn-dns/domain.com/buttons/shelly wss://your-app-platforn-dns/domain.com/buttons/shelly]

Most Devices that can establish an outgoing websocket are supported. You can also work with BLE devices if you have a BLE gateway or other Shelly device that is capable of both BLE and Websocket, so that it could work as gateway for BLE signals.

You can also take a look to this video. https://www.youtube.com/watch?v=lkMEf7CpXHo

====== Buttons ======
We have tested with Shelly BLU Button1 and Shelly BLU Gateway, but you can also use an other Shelly PRO or PLUS Device to handle BLE signals.

====== Windows-/ Door Sensor ======
We have tested with Shelly BLU Door/Window and Shelly BLU Gateway

====== Motionsensor ======
We have tested with Shelly BLU Motion and Shelly BLU Gateway

====== Webhook (''RestApi'') ======
In the SettingsPlugin (PbxManager), you can define an '''http-path''' and an '''http-api-key''' that can be used by general systems to perform general actions (e.g., monitoring). The idea is that server-based communication is combined with dynamic output actions, which are not triggered by user interaction.

The path and api-key a added to the reachable base url of the buttons app + /extapi. So, if your base url looks like this [https://APP-PLATFORM/domaine.de/buttons/extapi/mypath?key=Secretkey1234&msg=Test&dst=atlantis&type=connect&tags=abcd,1234 https://app-dnsname/test.local/buttons/] and you api-key is "Secretkey1234", the url looks like this, to do a Post to Connect App via Buttons App.

* Example: [https://APP-PLATFORM/domaine.de/buttons/extapi/mypath?key=Secretkey1234&msg=Test&dst=atlantis&type=connect&tags=abcd,1234 https://app-dnsname/test.local/buttons/extapi/mypath?key=Secretkey1234&msg=Test&dst=atlantis&type=connect&tags=abcd,1234]

======''Webhook Get Parameters''======

* key: your http-api, which you can define via SettingsPlugin
* type: type of output. at the moment only "connect" is possible.
* dst: destination for the action
* tags: tagging parameters for Connect Post
* msg: the content for your action.
* callto: (in case of Connect Post), also a call to a destination can be trigged
* srcqueue: the Waiting Queue Object, which should be used for the outgoing call. (you have to define it in the buttons-admin before).
* numbers:in case of call, a comma separated list of numbers can be placed, which should be get the call from the Waiting Queue Object

=== Output actions ===
===== Chat =====
Buttons allow you to send a chatmessage to a reachable user. Simply enter the SIP (or H.323) name of the destination and the message you wish to send.

===== Notify =====
Buttons allow you to a notify a to a reachable user. Simply enter the SIP (or H.323) name of the destination and the message you wish to send. A Notifiy is just a notification to the client and works with the notification policies of the used client.

===== Chat + Notify =====
This is a combination of both in one rule.

===== Presence =====
You can set the presence of users. In case of the buttons-user app, it's to the own user.

===== Phonemessage =====
Similiar to Chat, but it sends messages to innovaphone DesktPhones. As destination you can use the number or the name.

===== Phonecall =====
You need to assign a Waiting Queue via Buttons-Admin App. After that, this Waiting Queue is used to perform outgoing calls and stream the announcement. The Waiting Queue needs a special configuration. => '''<u>Alert Timout = 0</u>''' otherwise it would not work.

===== Connect App=====
If the Connect App is assigend to the buttons-user AppObject, buttons is able to create ConnectPosts. Also if you combine ConnectPosts and Calls with the same trigger actions, also interactions of the phonecalls are presented to the Connect Post.

===== Working App=====
If the Working App is assigned to the buttons-user AppObject, buttons is able to control your Working App. Also the Dial In Number "99" is reservered for Working Toggle. So, if your dial in number for buttons is 85, you can call 8599 from your extension and your working status is toggled.

You can also create own rules for working-start or working-stop

== Buttons App - Configuration ==

We have created a short configuration tutorial on youtube.

https://www.youtube.com/watch?v=ut3NI59BNl4

== Troubleshooting ==

== Related Articles ==

[[Howto:Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T14:08:51Z

Kwa:

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the innovaphone Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the innovaphone Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''innovaphone Buttons Ap'''p.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an innovaphone application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png]]

Update the Shelly to the current stable firmware version.

After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/buttons," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T14:04:03Z

Kwa:

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the innovaphone Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the innovaphone Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''innovaphone Buttons Ap'''p.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an innovaphone application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in mind''': You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png]]

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png]]

Update the Shelly to the current stable firmware version. After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/button," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T14:00:55Z

Kwa:

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the innovaphone Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the innovaphone Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App.

It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''innovaphone Buttons Ap'''p.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an innovaphone application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the Buttons concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in min'''d: You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png]]

Here's a refined and improved English version of the entire text you provided, covering initial setup, connection details, and specific Shelly models, along with debugging.

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png]]

Update the Shelly to the current stable firmware version. After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/button," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T13:54:13Z

Kwa:

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the innovaphone Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the innovaphone Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App. It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''innovaphone Buttons Ap'''p.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an innovaphone application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in min'''d: You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png]]

Here's a refined and improved English version of the entire text you provided, covering initial setup, connection details, and specific Shelly models, along with debugging.

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png]]

Update the Shelly to the current stable firmware version. After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/button," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Shelly i4 (3rd Generation) ==
This model features 4 digital inputs (ON/OFF).

[[Image:Sh19.png]]

In the Shelly App, you'll see 4 "devices" (which is actually just one physical device), and each contact will be treated as if it were a single device.

The Shelly i4 Gen3 has 4 inputs (from port 0 to port 3, corresponding to SW1 to SW4), and all messages will be sent with the same serial number.

To add a Shelly i4 port to the Buttons App, press "Add Device," then under "New Device," select "Button" as the type, and enter the serial number followed by a hyphen "-" and the port number:

[[Image:Sh20.png]]

In the example above, we've created the connection with the first port (SW1); the second port (SW2) will be device e4b063d6a588-1, and so on.

== Shelly Plus 1 ==
The Shelly Plus 1 has one input and one output.

[[Image:Sh21.png]]

Similar to the Shelly i4, the input port should be indicated with "-0":

[[Image:Sh22.png]]

In the example above, the serial number for the Shelly Plus 1 is 78ee4ccf5930.

== Shelly Pro 2 ==
The Shelly Pro differentiates itself from other Shelly devices as it's designed exclusively for DIN rail mounting in electrical cabinets:

[[Image:Sh25.png]]

It also features a LAN port, allowing it to connect to an Ethernet network even without Wi-Fi or Bluetooth (though both are onboard). It doesn't require an internet connection, but it can be useful for initial setup and firmware updates.

It has two inputs and two outputs, all designed exclusively for 220V circuits (110-240 VAC 50/60 Hz).

It's configured similarly to the other Shelly devices described above, but with the key difference that triggering by the Buttons App occurs on the '''outputs'''. The Buttons App therefore reacts to changes in the state of the outputs, regardless of whether they are switched via the web or other settings. If you want to transmit the state of the inputs (as in the case of the other Shelly models described), you'll need to configure the Shelly Pro 2 for its outputs to follow the state of its inputs.

Here's an example of this setting, where the input port (input 0) controls the output port (output 0):

[[Image:Sh23.png]]

Note that in the setup above, even after a restart, the output will follow the current state of the input (which is usually the desired behavior).

Once you've set the Ethernet parameters (Client, Server, and Static IP modes are available), you can disable Wi-Fi settings, cloud settings, and "Access Point" mode (which also disables "Range extender" mode).

'''Note''': With Wi-Fi disabled, you will no longer be able to access the Shelly Pro 2 from the Shelly App. However, the application remembers the settings you configured before disabling Wi-Fi access. This can be helpful if, for example, you want to check the IP address (unless it has been changed via LAN access).

== Debugging ==
Traffic between the Shelly and the Buttons App (once registered) can be monitored in the Buttons App's Log.

In the Application Platform (where you retrieved the path before), clear the Log, perform a contact closure or opening operation, and then select "Display" from the dropdown menu. A new page will open in your browser:

[[Image:Sh24.png]]

In the example above, you can see that the Shelly Device model "shellypro2" with serial number "ec626091d3f4" is sending a detected change on input and output "0" and activating "Trigger Switch 6," which sets user 'kwa's presence to "busy."

'''Note''': Changing the presence status is the simplest way to verify proper functionality and requires no additional setup.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T13:46:50Z

Kwa:

'''DRAFT'''

Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the innovaphone Buttons App.

The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions. That's because the innovaphone Buttons App allows you to assign a series of parallel actions to any specific event.

In this document, we'll walk you through every step of integrating your Shelly devices with the Buttons App. It's surprisingly straightforward - let's get started!

==Applies To==
• myApps V15r3 or higher

• Buttons App V15r4 or higher

Note: Tests with Shelly devices were conducted using Shelly firmware version 1.6.2.


==Introduction==
This article provides a straightforward explanation of the basic concepts needed to integrate '''Shelly devices''' with the '''innovaphone Buttons Ap'''p.

Please note: We are not Shelly specialists. For detailed information, consult the manufacturer's documentation, as well as the many forums and videos available online on this topic.

In this guide, we will specifically cover the integration of digital inputs (contacts) for the '''Shelly i4''', '''Shelly Plus1''', and '''Shelly Pro2''' models.

While motion sensors and the Shelly USB dongle can also be integrated, they are not covered in this article. However, as Shelly products share similar characteristics, you'll likely find useful insights applicable to other models as well.

Each Shelly device comes with its own mounting instructions; here, we will only briefly touch upon a few key details.

I'''t is crucial to read and strictly adhere to all safety guidelines.'''

These devices are typically powered by hazardous voltages (usually 220V in Europe). Installing a residual current device (RCD), also known as a ground-fault circuit interrupter (GFCI) in some regions, upstream in the electrical circuit is highly recommended and, in some countries, legally required.

===Overview===
The Buttons App is an innovaphone application that lets you link specific input events to various output actions. Examples of input events include calls, function keys on innovaphone IP phones, and other applications, as well as the messages received from Shelly devices. Output actions can be calls, notifications, chats, messages, or applications.

For a comprehensive description of the Buttons App itself and a complete list of supported input and output devices, refer to the concept article (link at the end of this document).

===Electrical Connections===
The Shelly models discussed in this article are powered by 110 to 240 Volt AC, 50/60 Hz. Please be aware that these voltages are hazardous. Never work on electrical networks without a residual current device (RCD/GFCI) installed. Before mounting or connecting any device, ensure that all wires (not just the live wire, but also the neutral) are disconnected.

Some models can also be powered by 12V or 24-48V DC. We have not tested this setup and will not describe it in this guide.

Third-generation Shelly devices feature polarity protection on the AC side. This means the Shelly will function correctly even if the live (L) and neutral (N) wires are inverted.

'''Important Note''': In networks with delta connections, both wires carry voltage.

For intrinsic safety reasons, it's often common practice to switch the neutral wire, which typically carries no voltage during normal operation. The drawback of this approach is that troubleshooting a potential interruption becomes more difficult (whereas with the live wire, a simple voltage tester suffices to follow the line). Both wiring variants are functional.

'''Note''': Shelly devices typically have the wiring diagram silk-screened directly on them, as shown in this example for the Shelly i4:

[[Image:Sh01.png]]

It represents the connections to the outside world, not the internal operation of the device, as further highlighted in the instructions:

[[Image:Sh02.png]]

'''Note''': As per the diagram, the Live (L) phase is connected to the output towards the contacts. If installed within the same electrical network, it's also possible to power the inputs directly from the live phase, rather than using the Shelly's output. However, in this case, ensure the polarity matches the diagram (L and N as shown). If inverted, you'll need to switch the neutral.

'''Note''': On Shelly Pro devices, the silk-screened diagram corresponds exactly to what's detailed in the instructions.

[[Image:Sh03.png]]

===Contacts===
Shelly devices are incredibly versatile, reacting to both the '''closing and opening''' of a contact. What's more, they send messages for various interactions like a quick '''click''' (fast open-close), '''double-click''', '''triple-click''', and even a '''prolonged closure''' (a "Long" press). This "Long" event is also sent for a static closure after a timeout, making it perfect for sustained button presses. The Buttons App can handle all these event types, individually or in combination, giving you immense flexibility.

In safety circuits, contacts are typically normally closed and open in the event of an alarm. This design ensures that a broken wire will also trigger a detection, enhancing safety.

Both Shelly and the Buttons App can be used with circuits featuring:

• Normally open contacts that close and remain closed.

• Normally closed contacts that open and remain open.

• Momentary contacts that close or open (like a push-button).

All transitions, meaning the change from one state to another, will be signaled and can be utilized for various actions.

If a Shelly device restarts, its current status is immediately reported to the Buttons App. Should the contact state change during a restart or while the device is powered off, this new state will be transmitted to the Buttons App, which will then react accordingly.

===Mounting===
For their "home" models, which are designed for installation in standard electrical boxes (typically for light switches), Shelly offers a DIN rail adapter. This allows for easy mounting in electrical cabinets:

[[Image:Sh04.png]]

The adapter features an opening on the back, allowing access to the reset button.

'''Keep in min'''d: You can only press this button if no other devices are installed close by on the DIN rail. The adapter can be mounted 180 degrees, making the reset button accessible from either the right or left side. Once configured, you typically won't need to use the physical reset button, as a reset can also be performed via the app or web interface if the device is reachable by IP. After a restart, the device's status is also refreshed.

In contrast, '''Pro models''' are designed exclusively for DIN rail mounting and have their reset button conveniently located on the front, accessible even with the cover closed. They also offer options to customize the behavior of the reset button.

[[Image:Sh05.png]]

Here's a refined and improved English version of the entire text you provided, covering initial setup, connection details, and specific Shelly models, along with debugging.

==Configuration==

===First Steps with Shelly Configuration===
Once a Shelly device is powered on, it starts up and is ready for use in approximately 5 seconds.

Shelly devices can be accessed via Wi-Fi or Bluetooth. The "Pro" family of devices can also be reached via an Ethernet connection.

'''Note''': Some products are also accessible via USB dongles, but this is not covered here.

For initial configuration, you'll need to install the manufacturer's '''Shelly Smart Control app''' on your smartphone. Afterward, you'll establish a Wi-Fi or Bluetooth connection between your smartphone and the Shelly device. For our application, Bluetooth is primarily used for the initial setup; subsequently, the device will connect to a local Wi-Fi network or, in the case of Pro models, your local area network (LAN).

Download and install the Shelly Smart Control application from your respective app store (Google Play or Apple App Store):

[[Image:Sh06.png]]

If you don't already have one, create a Shelly account (it is free).

You'll be prompted to set up the parameters for your local Wi-Fi network, which the device will then connect to. To make the device discoverable by your smartphone, press the reset button on the Shelly device for 10 seconds. Follow the app's instructions to add the device to your list.

'''Important Note''': A device initially registers with the Shelly manufacturer's platform, where its serial number is apparently stored. Once a device has been registered to one account, it '''cannot be registered to another account''', even after a factory reset of the Shelly. If a device is registered to your account, no one else can use it unless you first delete it from your account. This is presumed to be a security feature designed to protect a specific device from unauthorized use.

In the Shelly ecosystem, the '''serial number and MAC address are the same'''. Each Shelly device will register with its unique address to the Buttons App. If a device has multiple inputs or outputs, it will still have a single address, and the interface number will be contained within the message itself, even if they appear as distinct devices in the Shelly App.

===Initial Setup===
After adding your Shelly devices to your application, you can access the individual installed models. The example below shows the page for a Shelly i4, which offers four inputs:

[[Image:Sh07.png]]

At this stage, you can observe the opening and closing of contacts directly in the app; the display shows the status changes in real time. In the example above, contacts (inputs) 2 and 3 are closed, while contacts 1 and 4 are open. This test is convenient for verifying inputs but is not strictly necessary.

Clicking on any of the Shelly devices opens its configuration page. Here, you'll find the IP address at which the device is accessible via a web browser:

[[Image:Sh08.png]]

Access now the device via your browser, select "Settings," then "Firmware":

[[Image:Sh09.png]]

Update the Shelly to the current stable firmware version. After the required restart, return to the home page and select an input, for example, "Input(0)," and then "Input/Output settings":

[[Image:Sh10.png]]

If you have a '''Plus or i4 model''', select "Button" (the default setting is "Switch"). Repeat this setting for all inputs.
If you have a Pro model, this setting is different and described in its dedicated section below.

===Connecting Shelly and the Buttons App===
Shelly devices must register with the Buttons App to send status messages. Therefore, each Shelly device needs to be configured with the destination path to the Buttons App.

This path is configured on the Shelly in the menu "Settings," then "Outbound websocket":

[[Image:Sh11.png]]

Check "Enable," then under "Connection Type," select "TLS no validation."

The path is configured in the "Server:" field.

The format is: “'''wss:// + destination + /shelly'''”.

Here's how to securely and easily determine the "destination":

Open the PBX advanced interface (devices) and then the "PBX" page. In the "DNS" field, you'll find the name of your PBX:

[[Image:Sh12.png]]

Make a note of this name, as it's the first part of your destination. Now, open the Application Platform and select the Buttons App.

'''Note''': If the Buttons App isn't installed, now is the time to install it on your Application Platform:

[[Image:Sh13.png]]

Clicking on "Buttons" will reveal the Webserver path:

[[Image:Sh14.png]]

Notice that the path ends with "buttons".

The complete path to enter into the Shelly will be composed of these two names.

For example, if your PBX DNS is "testpbx.com" and the Buttons App Webserver path is "butt.mypbx.com/button," the complete destination path to set in the Shelly will be:
“wss://testpbx.com/butt.mypbx.com/buttons/shelly”

Once correctly configured and put in the Server input field, the Shelly device will be registered with the Buttons App and start sending messages.

To verify registration, open the Buttons Admin App:

[[Image:Sh15.png]]

Clicking on the "Connected devices" button will display the name and serial number of the connected and registered Shelly devices:

[[Image:Sh16.png]]

In the example above, three Shelly devices (Plus 1, Pro 2, and i4) are connected.

This screen also shows the Shelly's serial number, which you'll need later to set up the Buttons App. You can also find the Shelly serial number on the Shelly's "Wifi" page:

[[Image:Sh17.png]]

'''Cautio'''n: The address shown in the Shelly's "Bluetooth" menu is different and will not be used by the Buttons App. For the Shelly Pro, the serial number is visible on the "Ethernet" page:

[[Image:Sh18.png]]

'''Note''': You can copy and paste the serial number into the Buttons App even with colons; they will be automatically discarded by the Buttons App.

'''Note''': You can also retrieve the serial numbers directly from the logging, as explained in the relevant section.

== Related Articles ==

[[Reference15r1:Concept_Buttons_App]]

[[Category:Howto|Integrating_Shelly_IoT_Devices_with_the_innovaphone_Buttons_App]]

File:Sh10.png

2025-07-16T13:40:46Z

Kwa:

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T13:31:47Z

Kwa:

Howto:Integrating Shelly IoT Devices with the innovaphone Buttons App

2025-07-16T13:11:48Z

Kwa: Created page with "'''DRAFT''' Shelly, a European (Bulgarian) manufacturer, offers a wide range of Internet of Things (IoT) sensors and actuators. This article will guide you through setting up and using Shelly digital inputs (contacts) to interact seamlessly with the innovaphone Buttons App. The possibilities are truly endless! Imagine triggering a phone call when a door contact closes, sending an instant message, initiating time tracking, or even setting up complex conditional actions...."

File:Sh25.png

2025-07-16T13:01:20Z

Kwa:

File:Sh24.png

2025-07-16T13:01:06Z

Kwa:

File:Sh23.png

2025-07-16T13:00:57Z

Kwa:

File:Sh22.png

2025-07-16T13:00:46Z

Kwa:

File:Sh21.png

2025-07-16T13:00:36Z

Kwa:

File:Sh20.png

2025-07-16T13:00:25Z

Kwa:

File:Sh19.png

2025-07-16T13:00:16Z

Kwa:

File:Sh18.png

2025-07-16T13:00:04Z

Kwa:

File:Sh17.png

2025-07-16T12:59:52Z

Kwa:

File:Sh16.png

2025-07-16T12:59:40Z

Kwa:

File:Sh15.png

2025-07-16T12:59:31Z

Kwa:

File:Sh14.png

2025-07-16T12:59:20Z

Kwa:

File:Sh13.png

2025-07-16T12:58:59Z

Kwa:

File:Sh12.png

2025-07-16T12:58:49Z

Kwa:

File:Sh11.png

2025-07-16T12:58:15Z

Kwa:

File:Sh09.png

2025-07-16T12:57:55Z

Kwa:

File:Sh08.png

2025-07-16T12:57:44Z

Kwa:

File:Sh07.png

2025-07-16T12:57:30Z

Kwa:

File:Sh06.png

2025-07-16T12:57:16Z

Kwa:

File:Sh05.png

2025-07-16T12:57:05Z

Kwa:

File:Sh04.png

2025-07-16T12:56:45Z

Kwa:

File:Sh03.png

2025-07-16T12:55:56Z

Kwa:

File:Sh02.png

2025-07-16T12:55:35Z

Kwa:

File:Sh01.png

2025-07-16T12:54:56Z

Kwa:

Reference13r1:Concept IP29-20

2025-06-04T12:58:18Z

Kwa: /* Patch-panel based connection */

[[Category:Concept|IP29-20]]
=Applies To=
This information applies to
* innovaphone IP29-20

= Overview =
innovaphone IP29-20 is an IP adapter for twenty analogue interfaces (FXS).

It includes 20 interface licenses upon delivery.

= Requirements =

* Firmware 13r1sr11
* innovaphone PBX with appropriate amount of Port<v> Licenses
* Power over Ethernet'''+''' supply according to IEEE 802.3at, Class 4 ('''PoE+''')
* appropriate adapter cable - see below

= Configuration =

== Connection ==

As different cabling concepts might be applied, innovaphone does not deliver any connection cables with the system.

Note: Below mentioned 3rd-pty-products are subject to change and there might be alternative products of other manufacturers/resellers.

Find below a list of possible connection concepts and their realisation:

=== PinOUT ===
Built-in 8P8C connectors provide following pinout:

[[Image:RJ45-dn.gif|rj45-dn.gif/]]

{| border=1
|+
|Pin
|Function
|-
|1
|RING-2
|-
|2
|TIP-2
|-
|3
|RING-3
|-
|4
|TIP-1
|-
|5
|RING-1
|-
|6
|TIP-3
|-
|7
|RING-4
|-
|8
|TIP-4
|-
|}
This pinout is especially designed for use with twisted-pair Ethernet patch cables

=== Direct terminal connection ===

In case of direct connection of analogue terminals by use of 2-wire-a/b-connectors RJ-11 / modular jack 6P2C, a special adapter has to be used.

This adapter has to distribute above mentioned IP29-20 pinout to four 6P2C connectors using the pinout below:

[[Image:RJ11.gif|rj11.gif/]]

{| border=1
|+
|Pin
|Function
|-
|3
|TIP
|-
|4
|RING
|-
|}

Next to own assembling, below listed are some 3rd-party-products (information is subject ot change):
* [http://www.logilink.org/Produkte_LogiLink/Passive_Netzwerkkomponenten/Telefonzubehoer/Modular_Adapter-4-Port.htm?seticlanguage=en LogiLink-Adapter]
* [https://www.l-com.com/ethernet-tia568b-splitter-8x8-plug-4-6x2-jacks L-Com-Adapter]

[[Image:ll_adapter_8p8c_6p2c.png|300px|ll_adapter_8p8c_6p2c.png/]]

=== Patch-panel based connection ===

In case of patch-panel based connection, used adapter cable depends on used patch panel:

* patch-panel with 8-wire-connectors (8P8C): use twisted-pair Ethernet patch cables
* patch-panel with 2-wire-connectors (8P2C): use of an adapter cable splitting up 8P8C to 4 x 8P2C.
:For the 2nd option, innovaphone offers a quadruple adapter cable, order-no. 03-00029-001. To connect all 5 interfaces of IP29-20, five of those adapters have to be used. Lenght: 180 cm

[[Image:ip2920_adaptercable.png|ip2920_adaptercable.png/]]

== Provisioning ==

IP29-20 is added to an existing V13-PBX-system by execution of V13-installer upon initial device startup.

Analogue extensions connected to IP29-20 are bound to the innovaphone PBX by use of the V13-device-provisioning.

{| class="wikitable"
|-
|Within UserAdminAPP/RegisterPhones, unique provisioning code are generated for dedictated users.
|
|At PBXManager/FXS-Plugin, IP29-20 device can be selected as FXS-adapter and offers 20 TEL-interfaces for configuration.<br>
Previously generated provisioning codes can be assigned to each TEL-interface.
|- style="vertical-align:top;"
|[[Image:ip2920_provisioning_useradmin.png|ip2920_provisioning_useradmin.png/]]
|
|[[Image:ip2920_provisioning_pbxmanager.png|ip2920_provisioning_pbxmanager.png/]]
|}

If an appropriate number of Port<v> licenses is available in the corresponding innovaphone PBX,<br>
the registration of analogue terminals to the selected users takes place immediately after the provisioning is confirmed.

= Restrictions =

* In case of Class3-PoE power supply (<u>no PoE+</u>), the first eight FXS interfaces (1-8) are available within the device.
[[Image:ip2920_poedisplay.png|ip2920_poedisplay.png/]]

= Related Articles =

* [[Reference11r1:Interfaces/FXS/Physical]]
* [[Howto:Maximum wire length|Maximum wire length]]

Dati tecnici IP65

2024-10-07T12:55:10Z

Kwa: IP40 -> IP44

{{datasheet_header|innovaphone IP65|Portatile IP DECT con grande display a colori e Bluetooth}}
<div class="datasheets-mehrspaltig">
[[Image:IP65.png]]
===Box===
Dimensioni (L × B × H): 137 x 52 x 21.5 mm (senza clip)

Peso: 135 g (senza Clip)

Materiali: Box: PC; Tastiera: silicio duro; Clip: PA

Colore: nero

Display: Dimensioni (B x H): 31 x 41 mm, TFT; A colori HD, colori individuali 262 K; 240 x 320 pixel LCD con retroilluminazione bianca LED

Clip: cerniera (standard) oppure orientabile

===Interfaccia utente===
Display: Display illuminato per la visualizzazione delle chiamate in entrata e dello stato della batteria

Vibracall: per chiamate in entrata

Tastiera: Chiavi illuminate; 3 tasti funzione; Tasto multifunzione; Risposta, svincolo/On/Off; Tasto di navigazione; Tastiera numerica; Impostazione volume + / - ; Suoneria on/off

===Batteria & carica===
Tipo: Polimeri di litio 3.7V 920 mAh

Tempo di conversazione: 20 ore in condizioni ottimali

Tempo di stand-by: 240 ore in condizioni ottimali

Tempo di carica: < 4 ore

Cicli di scarica/carica: >=80% della capacità disponibile dopo 400 cicli completi di scarica/carica

===Interfacce===
Connessione USB multifunzione: Software Download, configurazione e carica batteria

Connessione cuffia: Bluetooth e Standard 3.5 mm

===Audio===
*23 diverse suonerie, Differenziabili tra chiamate interne, esterne e richiamate; Volume impostabile in 8 diversi livelli
* Volume di ascolto: impostabile in 8 diversi livelli fino a 3dB
* Volume massimo suoneria: 88 dBA @ 10 cm
* Altoparlante: vivavoce

===Lingue===
Lingue menu e messaggi: Danese, Tedesco, Inglese, Finnlandese, Francese, Greco, Italiano, Olandese, Norvegese, Polacco, Portoghese (Brasiliano), Russo, Sloveno, Spagnolo, Svedese, Ceco, Turco e Ungherese.

===Rubriche===
* Centrale: Lunghezza max. nome: 40 caratteri; Lunghezza max. numero: 20 cifre;
* Aziendale: Voci max.: 1000; Lunghezza max. nome: 24 caratteri; Lunghezza max.numero: 24 cifre (un numero per nome)
* Locale: Voci max.: 250; Lunghezza max. nome: 24 caratteri; Lunghezza max. numero: 24 cifre (3 numeri per nome - ufficio, cellulare, altro)

===Telefonia===
Segnalazione: 23 toni di suoneria, display retroilluminato e vibracall

Risposta: con tasto o automatica

Lista chiamate: lista delle ultime 25 chiamate (risposte, selezionate, perse) con indicazione orario

===DECT===
GAP/CAP

Riconoscimento automatico protocollo DECT: riconoscimento e configurazione automatica per DECT-US e DECT-EU alla registrazione iniziale.

Frequenze:
* EU: 1880-1900 MHz
* US: 1920-1930 MHz
* LA: 1910-1930 MHz
* BR: 1910-1920 MHz

Frequenze Bluetooth: ISM 2.4000-2.4835 MHz

Modulazione: GFSK

Distanza canali: 1.728 MHz

Antenna: integrale

Sensibilità: -93 dBm

Potenza trasmissione dinamica:
* EU/LA/BR: 10 mW (potenza media massima)
* US: 4 mW (potenza media massima)

===Condizioni di esercizio===

Temperatura di esercizio: da 0°C a +40°C

Temperatura di stoccaggio: da -20°C a +60°C

Temperatura di carico: +5°C a +40°C

Classe di protezione: IP44, IEC EN60529

Resistenza ai campi irradiati: 3V/m EN61000-4-3

Resistenza alle scariche elettrostatiche: 4 kV su contatto e 8 kV all'aria aperta (EN61000-4-2)

Test di caduta libera:
*IEC 60068-2-32, Procedura 1, 12 volte da un metro di altezza
*IEC 60068-2-32, Procedura 2, 1000 volte da 0.5 metri di altezza

{{Template:Leistungsmerkmale IT - Lizenzen Telefone}}
{{Template:CE-Decl_DECT|Conformità|vedi cheda informativa separata}}
===Numero d'ordine Portatile: 50-00065-001===
===Numero d'ordine Caricatore: 50-00060-001===
===Numero d'ordine Caricatore programmazione: 50-00060-21===
</div>
{{Template:Datasheet_footer|IT}}
[[Category:Dati tecnici Phones IT‏‎|{{PAGENAME}}]]

Howto14r2:Firmware Upgrade V14r1 V14r2

2024-08-01T13:22:50Z

Kwa: /* App Platform and Apps */

== Applies To ==
This information applies to:

* All 14r2 capable innovaphone devices
: For a general overview of the upgrade process and a list of supported devices with 14r2, see [[Howto:Firmware Upgrade]]
== Licenses ==
In case of cloud or rental model, don't worry about licenses.

If the system is licensed on premise, and you already have V14 licenses, there is nothing to do. Otherwise, you'll need to regenerate the license file for V14 in https://portal.innovaphone.com/ and load into the system before upgrade.

== Migration Policy ==
Here is how you upgrade a system to 14r1 from 14r2.

=== App Platform and Apps ===
14r2 Apps are no longer compatible with App Platform Images version 11xxxx or below due to a major update of the used OpenSSL library, as the old 1.1 version is deprecated.<br/>

* first update your Apps to the latest 14r1 version (this is important, don't skip this step!)
* upgrade your App Platform to version 12xxxx in the settings of your App Platform Manager via the Update option (open the AP Manager, Burger menu, Settings, update -> update to 12xxxx) and then carry out the restart offered in the update procedure
* upgrade your Apps to version 14r2 now

Note that all previous versions of Apps will still run on App Platform version 12xxxx, just 14r2 Apps require this new image version.

=== App Platform replication ===
Sadly it's not possible to upgrade the App Platform on App Platform Standbys directly due to a major version change of the PostgreSQL database. So follow these steps:

* follow the steps above to upgrade your '''primary''' server
* update the App Platform Manager and Webserver to the latest 14r1 version on each '''standby''' (this is important, don't skip this step!)
* disable replication on each '''standby''' completely
* upgrade your App Platform to version 12xxxx in the settings of your App Platform Manager on each '''standby'''
* upgrade your Apps to version 14r2 now on each '''standby'''
* activate standby replication on the '''standbys''' again now -> this will do a full replication again which might take some time

Alternativly you can install the standbys from scratch.

== Changes visible to the end customers ==
Listed here are changes that should be communicated by resellers to end users prior to a 14r2 upgrade, as the change will be visible/audible in the behaviour of the application/device.

* '''myApps accessibility''': Several improvements in myApps accessibility like '''screen reader support''' and '''keyboard control''' [[Reference14r2:Concept_myApps#Accessibility]]
* '''Connect UI''': Changes and improvements in the UI of the Connect app
* '''Fax Cover Page''': For outgoing FAX documents, a cover page with user content can be prepend

== Manual steps needed after upgrade ==
If the installer is not used for a new installation, some new default settings are not set. Please evaluate per app whether you want to configure the new default settings manually.

=== Calendar App ===
Microsoft Office 365 Exchange. Microsoft [https://techcommunity.microsoft.com/t5/exchange-team-blog/retirement-of-rbac-application-impersonation-in-exchange-online/ba-p/4062671 Retirement of RBAC Application Impersonation in Exchange Online] . You have to change some configurations in the PBX Manager Plugin for the Calendar App. See [[Howto13r2:Setting up Calendar with OAuth2]]

=== Connect App / Search App ===
In order for the Search App to find Connect posts, you need to make sure to change the following things:
* PBX Manager plugin "AP messages" - "Api" - Make sure to enable "Config User" for the Messages API Object. ('''Not''' Administrators or Moderators)
* For the "Connect" PBX-Object
** In the "App"-Tab enable "PbxApi" (additionally to "Websocket" and "PbxSignal")
** In the "Apps"-Tab enable "messages-api"

=== Contacts App ===
You have to enable the checkmark "Websocket" in the App Object. Otherwise you will not have new "Add Contacts" functions inside the PhoneApps

=== Mail2Fax ===
You can now enter mail server settings in the PBX Manager plugin for the fax app, to use the Mail2Fax feature. See [[Reference14r2:Concept_App_Service_Fax]]

== New Apps ==
New Apps will not be installed automatically by the 14r1 to 14r2 upgrade. The installation description of new 14r2 apps is usually in the concept article. Please rate per app whether you want to install/use the new app and configure it manually.

* [[Reference14r2:Concept_App_Remote_Control]]
* [[Reference14r2:Concept_App_Service_Translations]]

== Removed ==
The following software is no longer included in 14r2.

* Nothing

== Deprecated ==
The following software is based on legacy technology, with no further development and limited maintenance and support.
We strongly recommend migrating to our successor products that are fully compatible with 14r2 and myApps technology.

* running an AP on the CF card of an IPxx10 gateway is no longer supported, use a gateway with an SSD or a Virtual Machine to run the AP instead. The Linux/AP functionality is not yet removed from the firmware, so when migrating to 14r2, existing installations will continue to work (even if unsupported).
* iQM (innovaphone Queue Monitor) is deprecated, and we recommend migrating to the [[Howto:Queueboard_-_MediaRunway_-_Partner_App|Queueboard App]].

== Previously deprecated and now no longer supported ==
The following software is based on legacy technology, with no further development and no more maintenance and support.<br>
See: [[Howto14r1:Firmware_Upgrade_V13r3_V14r1#Deprecated_in_14r1]]<br>
We strongly recommend migrating to our successor products.

;Linux Application Platform (v10)
:Please migrate to the '''innovaphone App Platform'''.
;innovaphone Faxserver (v10)
:Please migrate to the '''Fax App'''.
;innovaphone Reporting (v10)
:Please migrate to the '''Reports App'''.
;innovaphone Exchange (v10)
:Please migrate to the '''Calendar App'''.
;Operator (v9)
:Please migrate to the '''Switchboard App'''.
;innovaphone Voice Recording 2014
:Please migrate to the '''Recordings App'''.
;PBX Object External UC
:Existing configurations still work. But new configurations can't be done using the advanced UI anymore.
:Please use the integrated '''UC''' and '''federation''' features of the '''innovaphone PBX'''.
:For presence synchronization with other systems we recommend using
:* '''innovaphone myApps Connector for Microsoft 365'''
:* '''Connector for kuando®'''
:* '''Calendar App'''

==Known Problems==
===Long Update-duration===
When you update, it can be up to 10 minutes before you have access to your app platform again.

===Downgrade on IPVA with large configuration===
The number of 64kB memory segments that an IPVA uses internally to store "VARS" has been increased from 10 to 20. This is only an internal adjustment and does not require any adjustment to the virtual machine.

After an upgrade to v14r2 a downgrade is possible as long as the total space used by VARS is less than 540 kB, i.e. <code>mod cmd FLASHMAN0 info</code> -> VARS - used=nk (n <= 540)

Because VARS data may be scattered over all assigned segments, the downgrade procedure must be:
# "config download" to gather the potentially scattered VARS
# downgrade
# "config upload" to restore the VARS as densely packed

== Resources Considerations ==
New firmware always has more features which in turn requires more resources. Growing firmware will thus consume both more flash and RAM for sure. A given system configuration will run flawlessly after a firmware largely only if there is still enough memory left after boot.

Standard configurations which are according the specs will run on all supported hardware. However, unusual configurations may not. It is a good idea to examine both flash and RAM memory left on high load situations in your existing configuration to see if there is enough resources left for an upgrade. Please find details in Reference:Device Health Check.

=== RAM ===
As a rough rule of thumb, a 14r2 release will consume the same amount of RAM compared to a v14r1 firmware.

=== Flash Memory ===
As a rough rule of thumb, a v14r2 release will consume ~ 64KB more flash memory compared to a v14r1 firmware.
New firmware comes with new code for new features which consumes more flash memory for the firmware image. For this reason, devices may run out of flash memory during upgrade to v14r2. Here is the recommended procedure for upgrade on such devices:

* save entire configuration
* reset to factory defaults
* load saved configuration (this will reorganize the flash memory usage)
* upgrade to new firmware

When there is still not enough flash memory available to store the new firmware (Web GUI ends up in a ''Firmwareupdate failed:no space'' / Update client end in a ''Error 0x00130001 Major FLASHMAN0 no space'' event) please open a support case with your current configuration file.