innovaphone wiki - User contributions [en]

Howto:Use bc conference object and push for smartphones

2026-06-18T15:33:24Z

Kpe:

==Applies To==
This information applies to
* PBX with firmware 12r2 or higher supporting push

==More Information==
General information about [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| Call Broadcast Conference]

===Details===
The [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| BC Conference Object] uses a group membership to call a group of users.

In case these users are smartphones, a special configuration is needed, because a BC Conference Call does NOT trigger the push mechanism.

To be able to call myApps clients on a Smartphones in the background or in standby mode, push is needed to trigger a call ringing on the smartphone.

===Problem===
A BC Conference call does '''NOT''' trigger the push mechanism.

===Solution===
A Waiting Queue call triggers the push mechanism.

===Configuration===
Make every smartphone user a group member of it's own dedicated waiting queue (static membership)

Make this dedicated waiting queu a static member of the BC Conference group and a static active member of this WQ-group.

=== Conclusion ===
Now it is possible to use Smartphones in a BC Conference group and receive BC Conference Calls on the myApps client in background or with the smartphone in standby modus.

== Related Articles ==

* [[Reference9:PBX/Objects/Call_Broadcast_Conference]]

* [[Howto13r1:Step-by-Step_Evacuation_alarm ]]

* [https://wiki.innovaphone.com/index.php?title=Howto:Use_soft_conference_interface_with_bc_conference_object| Howto:Use_soft_conference_interface_with_bc_conference_object ]

[[Category:Sample|{{PAGENAME}}]]
[[Category:Howto|{{PAGENAME}}]]

Howto:Use soft conference interface with bc conference object

2026-06-18T15:31:49Z

Kpe:

==Applies To==
This information applies to
* PBX with firmware with at least 13r1 sr13 or 13r2

==More Information==
General information about [https://wiki.innovaphone.com/index.php?title=Howto:How_to_implement_large_PBXs#Technical_data_and_recommended_number_of_users_supported]

===Details===
In the past, BC conference ( https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference ) were using the default conference interface or an external conference interface.

With the new v13, from 13r1 sr13, we can use soft conference channel together with the BC conference to make it works.

To do so, simply configure in the BC conference object, as hardware ID, macaddress-SCNF (for example, 0090330000-SCNF), where the mac address is the gateway were soft conference are available, and in the conference object, as hardware ID the same (for example, 0090330000-SCNF), and in the Devices tab, the same Hardware ID.

=== Conclusion ===
Now is possible to use soft conference also when configuring a BC conference object.

== Related Articles ==

* [[Reference9:PBX/Objects/Call_Broadcast_Conference]]

* [[Howto13r1:Step-by-Step_Evacuation_alarm ]]

* [https://wiki.innovaphone.com/index.php?title=Howto:Use_bc_conference_object_and_push_for_smartphones| Howto:Use_bc_conference_object_and_push_for_smartphones ]

[[Category:Sample|{{PAGENAME}}]]
[[Category:Howto|{{PAGENAME}}]]

Howto:Panic Button to trigger a Silent Alarm via Function Key on IP-Phone

2026-06-18T15:27:43Z

Kpe: /* Related Articles */

The following configuration based on BC Conference Object and a Function Key on an IP-Phone enables you to implement a panic button. The panic button triggers a silent alarm that is not noticeable on the triggering phone. The button can be used also if the phone is in an active call.

==Applies To==
This information applies to

*V10 SR10 PBX and later.



==More Information==
===Configuration===
; 1) Function Key: The functionality is based on the Function Key of type ''Dial'' that must be configured on the IP-Phone. The Option ''Send as Control Call'' must be activated on the Function Key the function is silent. As destination Number or Name must be a ''BC Conference'' Object.

<center>[[Image:Panic Button Silent Alarm 01.png]]</center> 

; 2) BC Conference : The ''BC Confernce Object'' takes care to call all the members of the alarm group. The ''BC Conference'' Object must be active in this group, all other members are passive in the group.

Generate a BC Conference Object with at least name (which is used in the F-Key above).
Not further settings needed here.

Considerations:

To provide an audio announcement to all members of the conference you have two possibilities:
* use a Waiting Queue with the ''1st Announcement URL'' as one of the conference members
** Pros: Ability to talk between each alarmed user while or after the announcement.
** Cons: Conference facility based on an innovaphone Gateway is required. Number of alarm group members is limited by the number of conference channels.
* connect all conference members to a HTTP-Interface broadcasting the announcement, instead to connect them to a real conference
** Pros: No conference facility hardware is required. Big number of alarm group members supported.
** Cons: No conversation possible between alarmed users.

; C1) BC Conference Variant 1 (real conference with an announcement at the beginning) :
Create a ''Waiting Queue'' Object with ''Alert Time'' set to 0 and only the ''1st Announcement URL'' configured. Place the ''Waiting Queue'' Object in to the group of the ''BC Conference'' Object.

<center>[[Image:Panic Button Silent Alarm 03.png]]</center> 

; C2) BC Conference Variant 2 (announcement only) : The difference to the previous configuration is to use the HTTP-Interface instead of CONF-Interface. To route all conference members to an announcement create a ''Gateway Object'' and register the HTTP-Interface on it.

<center>[[Image:Panic Button Silent Alarm 02.png]]</center> 
<center>[[Image:Panic Button Silent Alarm 04.png]]</center> 

Make sure you enable '#MOH Mode'' option to reduce load on the CPU - the same media stream will be played to all.
<center>[[Image:Panic Button Silent Alarm 07.png]]</center> 

This will create auto-generated routes in the relay:

<center>[[Image:Panic Button Silent Alarm 05.png]]</center> 

On the route from RWEB to HTTP add the URL to the announcement under ''Add UUI''. You can append <code>&repeat=true</code> to the URL in order to loop the announcement.

<center>[[Image:Panic Button Silent Alarm 06.png]]</center> 

== Related Articles ==

* [[Reference9:PBX/Objects/Call_Broadcast_Conference]]

* [[Howto13r1:Step-by-Step_Evacuation_alarm ]]

* [https://wiki.innovaphone.com/index.php?title=Howto:Use_bc_conference_object_and_push_for_smartphones| Howto:Use_bc_conference_object_and_push_for_smartphones ]

[[Category:Sample|{{PAGENAME}}]]
[[Category:Howto|{{PAGENAME}}]]

Howto:Use bc conference object and push for smartphones

2026-06-18T15:24:12Z

Kpe: /* Configuration */

Howto:Use bc conference object and push for smartphones

2026-06-18T15:23:27Z

Kpe: /* Applies To */

==Applies To==
This information applies to
* PBX with firmware 12r2 or higher supporting push

==More Information==
General information about [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| Call Broadcast Conference]

===Details===
The [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| BC Conference Object] uses a group membership to call a group of users.

In case these users are smartphones, a special configuration is needed, because a BC Conference Call does NOT trigger the push mechanism.

To be able to call myApps clients on a Smartphones in the background or in standby mode, push is needed to trigger a call ringing on the smartphone.

===Problem===
A BC Conference call does '''NOT''' trigger the push mechanism.

===Solution===
A Waiting Queue call triggers the push mechanism.

===Configuration===
Make every smartphone user a group member of it's own dedicated waiting queue (static membership)

Make this dedicated waiting queu a static member of the BC Conference group and an static active member of this WQ-group.

=== Conclusion ===
Now it is possible to use Smartphones in a BC Conference group and receive BC Conference Calls on the myApps client in background or with the smartphone in standby modus.

Howto:Panic Button to trigger a Silent Alarm via Function Key on IP-Phone

2026-06-18T15:21:02Z

Kpe: /* Related Articles */

The following configuration based on BC Conference Object and a Function Key on an IP-Phone enables you to implement a panic button. The panic button triggers a silent alarm that is not noticeable on the triggering phone. The button can be used also if the phone is in an active call.

==Applies To==
This information applies to

*V10 SR10 PBX and later.



==More Information==
===Configuration===
; 1) Function Key: The functionality is based on the Function Key of type ''Dial'' that must be configured on the IP-Phone. The Option ''Send as Control Call'' must be activated on the Function Key the function is silent. As destination Number or Name must be a ''BC Conference'' Object.

<center>[[Image:Panic Button Silent Alarm 01.png]]</center> 

; 2) BC Conference : The ''BC Confernce Object'' takes care to call all the members of the alarm group. The ''BC Conference'' Object must be active in this group, all other members are passive in the group.

Generate a BC Conference Object with at least name (which is used in the F-Key above).
Not further settings needed here.

Considerations:

To provide an audio announcement to all members of the conference you have two possibilities:
* use a Waiting Queue with the ''1st Announcement URL'' as one of the conference members
** Pros: Ability to talk between each alarmed user while or after the announcement.
** Cons: Conference facility based on an innovaphone Gateway is required. Number of alarm group members is limited by the number of conference channels.
* connect all conference members to a HTTP-Interface broadcasting the announcement, instead to connect them to a real conference
** Pros: No conference facility hardware is required. Big number of alarm group members supported.
** Cons: No conversation possible between alarmed users.

; C1) BC Conference Variant 1 (real conference with an announcement at the beginning) :
Create a ''Waiting Queue'' Object with ''Alert Time'' set to 0 and only the ''1st Announcement URL'' configured. Place the ''Waiting Queue'' Object in to the group of the ''BC Conference'' Object.

<center>[[Image:Panic Button Silent Alarm 03.png]]</center> 

; C2) BC Conference Variant 2 (announcement only) : The difference to the previous configuration is to use the HTTP-Interface instead of CONF-Interface. To route all conference members to an announcement create a ''Gateway Object'' and register the HTTP-Interface on it.

<center>[[Image:Panic Button Silent Alarm 02.png]]</center> 
<center>[[Image:Panic Button Silent Alarm 04.png]]</center> 

Make sure you enable '#MOH Mode'' option to reduce load on the CPU - the same media stream will be played to all.
<center>[[Image:Panic Button Silent Alarm 07.png]]</center> 

This will create auto-generated routes in the relay:

<center>[[Image:Panic Button Silent Alarm 05.png]]</center> 

On the route from RWEB to HTTP add the URL to the announcement under ''Add UUI''. You can append <code>&repeat=true</code> to the URL in order to loop the announcement.

<center>[[Image:Panic Button Silent Alarm 06.png]]</center> 

== Related Articles ==

* [[Reference9:PBX/Objects/Call_Broadcast_Conference]]

* [[Howto13r1:Step-by-Step_Evacuation_alarm ]]

* [[Howto:Use_bc_conference_object_and_push_for_smartphone ]]

[[Category:Sample|{{PAGENAME}}]]
[[Category:Howto|{{PAGENAME}}]]

Howto:Use bc conference object and push for smartphones

2026-06-18T15:20:51Z

Kpe: Created page with "==Applies To== This information applies to * PBX with firmware with at least 12r2 or higher supporting push  ==More Information== General information about [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| Call Broadcast Conference] ===Details=== The [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| BC Conference Object] uses a gro..."

==Applies To==
This information applies to
* PBX with firmware with at least 12r2 or higher supporting push

==More Information==
General information about [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| Call Broadcast Conference]

===Details===
The [https://wiki.innovaphone.com/index.php?title=Reference9:PBX/Objects/Call_Broadcast_Conference| BC Conference Object] uses a group membership to call a group of users.

In case these users are smartphones, a special configuration is needed, because a BC Conference Call does NOT trigger the push mechanism.

To be able to call myApps clients on a Smartphones in the background or in standby mode, push is needed to trigger a call ringing on the smartphone.

===Problem===
A BC Conference call does '''NOT''' trigger the push mechanism.

===Solution===
A Waiting Queue call triggers the push mechanism.

===Configuration===
Make every smartphone user a group member of it's own dedicated waiting queue (static membership)

Make this dedicated waiting queu a static member of the BC Conference group and an static active member of this WQ-group.

=== Conclusion ===
Now it is possible to use Smartphones in a BC Conference group and receive BC Conference Calls on the myApps client in background or with the smartphone in standby modus.

Reference16r1:Concept App Remote Control

2026-06-05T09:46:45Z

Kpe: /* General information */

[[Category:Concept|Apps]]
[[Category:Concept App Remote Control]]

== Applies to ==
* innovaphone PBX from version 16r1
== Requirements ==
* innovaphone PBX
* innovaphone Application Platform (minimum version 130015)
* V16r1
* Windows 10 and up
* Windows Server 2016 and later versions
* myApps launcher for Windows.
* Remote Control Client (portable .EXE) for external participants or Remote Control Client (installable .MSI) '''Note : in v16r1 the Remote Control Client is only available for Windows'''
* Additionally it is possible to join a session also via myApps opened in a web Browser

== Overview ==
Remote Control is an application to access a remote PC.
 The application can be used by the IT department to provide remote support or it could also be used as a collaborative tool for remote work.

== Licensing ==
* For the [[#Features|licensed features]] you will need to order the '''Service(innovaphone-remotecontrol)''' license, order number : ''02-00050-015''
* '''The application includes one session by default'''

== Installation ==
=== For new v16r1 installation ===
The Remote Control App is automatically installed by the installer and will be deployed in the '''Config User''' template. The service ID is activated and the address pre-configured
=== With the Settings App - AP app installer plug-in ===
[[File:Ap_app_installer.png|ap_app_installer.png/]]

Go to the Settings App 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 '''"remote control"''' and click on it
* Select the proper firmware version, here '''"v16"''' 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 open the Settings App to refresh the list of the available coloured AP plugin
* Click on the '''"AP remotecontrol"''' and click on '''" + Add an App"'''
* The '''"Name"''' display name field ''(all characters allowed)'' and the '''"SIP"''' administration field ''(no spaces, no capital letters)'' need to be filled. You can enter for example ''Remote Control/remotecontrol'' .
* Tick the appropriate template to distribute the App
* Enter the amount of purchased licenses
* Click OK to save the settings and a green check mark will be shown to inform you that the configuration is good
* Additionally you can enter the users that are allowed to start a remote session in the '''"configuration"''' menu of the plug-in, enter name comma separated and allow the usage of IDs with the Remote Control Client (external application available in our store)

== Apps ==
=== Remote Control (remotecontrol) ===
This is the standard App within myApps for Remote Control.
Parameters of the App object:
;Websocket: Connection between the PBX and the App Platform. the App Platform receives the number of licences via this connection.
;PbxSignal: Protocol to register to the PBX and do signalling with the JSON signalling protocol (necessary to retrieve the TURN server data from the PBX)
;Admin: Used for the administration configuration available in the AP remotecontrol plugin
;PbxApi: App notification and presence monitoring of in-app user list

== Concept ==
[[Image: Rcrounded.png|rcrounded.png/]]

A user (viewer) sends a request to another user (sharer) to access the sharer's PC.
 The sharer accepts the session and begins to share their desktop with the viewer.
 The viewer is also automatically given control of the mouse and keyboard.

=== Features ===
Here are the features available in the Remote Control App
==== Included features ====
* One session between Remote control App opened within myApps
* Start a session with myApps started in a browser (no control possible of the PC that have myApps opened in a web browser)
* App notification to start a session
* Multiple monitor support: Viewers can switch between desktops by clicking on the monitor icons
* Direction of control: Change the direction of sharing, a viewer would become a sharer
''Note: if the viewer use myApps Remote Control App in a browser, the direction of control will not work since the browser has no interaction with the local operating system''
* Screen scaling: Two different views of the remote desktop, original size or resized
* Notifications: On the remote PC, if the sharer does not have the remote control open or is busy with another session, the person requesting a session will be notified within the Remote Control App
* Text copy & paste support in both directions
* Support for same keyboard layouts (e.g. QWERTY to QWERTY).
* Multi-viewer support: several viewer can join a sharer session

==== Licensed features ====
* Support of external participants via the [[#The Remote Control Client|Remote Control Client]]
* Administration configuration (available in the Settings App - AP remotecontrol plugin) such as : users that can start a session, usage of IDs code.
* Launch the Remote Control App and start a session with an URL.
* Share a session from the Remote Control App opened in myApps
* Multiple sessions: If you need more than one session (e.g. many viewers for one sharer, more than one parallel session)

=== Technical overview ===
[[Image:Remote-control_technical-overview.png|remote-control_technical-overview.png/]]
 ''Note: SCTP packets are routed through the TURN server and therefore the transmission is not peer-to-peer if the TURN server is selected from the ICE candidate.''

=== Technical data ===
*The maximum bitrate can reach '''8 Mbps''' if there is no packet loss. In case of packet loss, the bitrate is reduced, with a minimum of '''1 Mbps''' for the user who is sharing their desktop UI(sharer). The viewer only sends mouse and keyboard events.
* Remote Control App is using the SCTP protocol with a fix UDP port range between [https://wiki.innovaphone.com/index.php?title=Howto:What_Ports_are_used_for_Signaling_and_Voice_Traffic_in_SIP_and_H.323%3F#Application_Sharing_(RTP)| 50200-50299] within the myApps client. Same range as the Application Sharing feature
*The Remote Control Client uses the same port range.
*In order to communicate with the Central ID Service, port '''443''' is used. The Remote Control client and the myApps Remote Control app must be able to communicate externally via port 443.

=== Central ID service server ===
innovaphone provides a centrally hosted ID service that simplifies the establishment of sessions between the myApps Remote Control App and the Remote Control Client but also between myApps Remote Control Apps. The service is pre-configured in the Settings App, under the AP remotecontrol configuration menu, with the address '''remotecontrol.innovaphone.com'''.
It is possible to enable or disable this feature.

In few steps it is explained how does the flow works:
#The myApps Remote Control App or the Remote Control Client automatically generates an ID ''(ID is user based)''
#The sharer sends the ID to the viewer or the viewer send its ID to the sharer
#The viewer enters the ID into their myApps Remote Control App or the sharer enter the code in the Remote Control Client
#The viewer’s myApps Remote Control App or the sharer's Remote Control Client communicates with the ID service to transmit a session hash link
#The ID service forwards the session hash link to the sharer/viewer in order to establish the session
#The sharer receives a connection request notification that must be accepted
#Once the session request is accepted, the viewer can access the sharer’s PC
''Note: For the Remote Control Client, it is possible to enable auto-connect to bypass manual acceptance of the session, see the notes in the [[#The Remote Control Client| General information]] section of the respective clients'' 
''Note: For the Remote Control Client, the STUN/TURN server information stored in your Remote Control App service (running in your App Platform) is also transmitted within the hashlink.''

== The Remote Control Client ==
=== Portable version ===
==== General information====
The portable Remote Control Client allows you to establish a remote session with people who are not part of your myApps environment. E.g. external participants such as your customers. External participants share their screen to the the myApps users. In order to use IDs to start a session, the Remote Control Client and the myApps Remote Control App has a default connection to the central ID service hosted by innovaphone.
* Compatible with Windows only
* Users are notified via an in-app notification when a new version is available. The new version is downloaded from the client and need to be started afterwards
* No installation needed, simple light .exe file that can be started without admin right
* You can download the Remote Control Windows .EXE file by a given link from the person that want to take the control from his myApps client or directly in our [https://store.innovaphone.com/release/160A000/download.htm store] under the section software, item name is '''Remote Control Windows Portable'''
#Open the shared session link in a web browser to download the ''remoteControl.exe''
#Launch the app and enter your name (and any additional information, if desired)
#Provide the code to the viewer
#Accept the Remote session
''Note: Optionally enable or disable the admin session and auto-connect features, works with ID code only'' 
''Note: If you have entered the provided link or a code in the "Link or ID" field, click on "Join Session"'' 
'''Important:''' For the automatic connection, you will need to enter one or several codes separated by commas. This allows the Remote Control Client to be accessed automatically from different viewers, in that case, you will need to request one or several codes from the viewer and you do not need to click on the "Join Session" button.

==== Parameters available in the UI ====
;Your ID: ''Can be copied and given to the person that want to start a session with the portable client''
;Display Name: ''You can enter a name that will be used to notify the myApps Remote Control App''
;Additional information: ''Such as company name''
;Link or ID: ''If you start a session via link or a code, link or code is provided by the viewer that want to take the control''
;Join session: ''To establish a remote session when the link/ID code is previously entered''
;Admin Session on/off: ''Allow to start a session without having the administration right from the Windows user''
;Autoconnect on/off: ''Allow to start a session without being accepted by the Windows user, works only with ID codes''
''Note: When you activate auto connect, a new field is displayed. There, you can enter the codes used for the auto-connect feature. Multiple codes can be entered, separated by commas.''

=== Installable version ===
==== General information====
The installable Remote Control Client allows you to establish a remote session with people who are not part of your myApps environment. E.g. external participants such as your customers. External participants share their screen to the the myApps users. In order to use IDs to start a session, the Remote Control Client and the myApps Remote Control App has a default connection to the central ID service hosted by innovaphone.
*Compatible with Windows only
*Pop-up notification when a new version is available
*Silent update installation
*Auto start
*Fast installation (require the admin right), you can download the Remote Control Windows .MSI file in our [https://store.innovaphone.com/beta/download.htm store] under the section software, item name is '''Remote Control Windows'''
#Get the version of ''remoteControlSetup.msi'' on our store and install it
#Launch the app and enter your name (and any additional information, if desired)
#Provide the code to the viewer
#Accept the Remote session

==== Parameters available in the UI ====
;Your ID: ''Can be copied and given to the person that want to start a session with the installed client''
;Display Name: ''You can enter a name that will be used to notify the myApps Remote Control App''
;Additional information: ''Such as company name''
;Link or ID: ''If you start a session via link or a code, link or code is provided by the viewer that want to take the control''
;Autoconnect on/off: ''Allow to start a session without being accepted by the Windows user, works only with ID codes''
''Note: When you activate it, a new field is displayed. There, you can enter the codes used for the auto-connect feature. Multiple codes can be entered, separated by commas.''
;Join session: ''To establish a remote session when the link/ID code is previously entered''

==== Parameters available in the tray icon menu ====
When you do a right click on the tray icon it offers you the following possibilities
;Open trace folder: ''Fast access to the folder where the debug files are stored''
;Show in task bar: ''Pin the application to your Windows taskbar''
;Autostart: ''The application starts when you log in''
;Exit Remote Control: ''Close the application''

== Use Case scenario==
The table below presents the different options for starting a session, depending on the environment. it indicates also if a licence is required or not
 ''Description'':
*myApps launcher: Remote Control App used within the myApps launcher for Windows
*myApps browser: Remote Control App used within myApps running in a web browser
''Note: myApps can be used within the Microsoft Teams client and is therefore considered as a myApps browser''
*Remote Control Client: Windows portable or installable client that does not require myApps launcher to be running

{| class="wikitable"
|-
! Viewer !! Sharer !! License needed
|-
| myApps launcher || Remote Control client || yes
|-
| myApps browser || Remote Control client|| yes
|-
| myApps browser|| myApps launcher|| not for the 1st session
|-
| myApps launcher|| myApps launcher || not for the 1st session
|-
|}

== Troubleshooting ==
When you open a support ticket, you will be asked to provide us with debugging data of your issue. You can also send us screenshots/videos of the behaviour you are reporting. Do not forget to send us also the PBX default configuration file.

=== Trace flags of the App instance on the App Platform ===
Select the corresponding App instance of the Remote Control App service and click on the '''Diagnostics button'''. Tick the following trace flags:
*App
*Database

=== Trace flags of the myAPPS Client ===
Go to the myApps '''Burger menu''', click on '''more''', and then click the '''magnifying glass'''. Tick the following trace flag:
*AppSharing

=== Trace of the myAPPS opened in a browser ===
Open the dev console ''(F12)'' and get the generated logs, you can copy them in a txt file

=== Trace of the Remote Control Windows Client (portable) ===
Trace are available under (''default path C:\Users\[YourUser]\AppData\Local\innovaphone\RemoteControl''), get the chromium log file, chromium + remoteControl txt files and zip them before sending to our support.

=== Trace of the Remote Control Windows Client (installable) ===
Do a right click on the app tray icon and click on open trace folder, get the chromium log file, chromium + remoteControl txt files and zip them before sending to our support.

== Known issues ==
*Push notifications on sharer's smartphone : if a viewer wants to start a remote session with a sharer who does not have the Remote Control App open on their PC, a push notification is triggered on the sharer's myApps mobile phone (if installed).

== Known limitations ==
*The language of the Remote Control Windows client is based on your operating system's language.
*Keyboards with different layouts are not supported yet (e.g. QWERTZ to QWERTY).

==Related Articles==
* [[{{NAMESPACE}}:Apps/PbxManager/App RemoteControl]] [[Category:Apps/PbxManager/App RemoteControl]]
*[[Howto:Innovaphones_public_services#Remote_Control_Central_ID_service]]

Reference16r1:Concept Push Notifications for iOS and Android

2026-05-27T12:46:03Z

Kpe: /* myApps for iOS push configuration checks */

[[Category:Concept|iOS Softwarephone]]
The PBX is able to send Push notifications to the Apple (APNs) or Android Push Notification services. As a result, incoming calls are also indicated when the myApps application is not started or runs in the background mode. The PBX is using a service provided by innovaphone AG at ''push.innovaphone.com'' to send the push notifications to the vendors Notification Service. No call meta data is transmitted, the push notification is only used to wake up the myApps application. Only one Push object is needed for a system.

== Requirements ==
=== PBX ===
* Firmware version 15r1 or higher
* Internet access via HTTPS
* device certificate (also on '''IPVA or AppIP''')
** this device certificate is not an own certificate, which you can upload yourself but which you need to retrieve through my.innovaphone (see [[#Initial configuration| Initial configuration]])!

=== Smartphone ===
* iOS Version 12.0.1 or higher
* Android Version 6.0 or higher

== Configuration ==
=== PBX ===
* verify that each pbx has the certificates <code>innovaphone Device Certification Authority 2</code> or the signed <code>push.innovaphone.com</code> in his local trust list. If you use the [[{{NAMESPACE}}:Concept App Service Devices#Certificates configuration|Devices - certificate trustlist concept]] the certificates will be installed automatically.
* create a PUSH object via the PBX manager,by clicking on the plugin Push (Black and White myApps symbol) The Plugin will create a PBX object in the PBX of type [[{{NAMESPACE}}:PBX/Objects/Push|Push]] per system, even in master/slave scenarios
** Name Push and SIP name push can be freely choosen, but the sip name must be used in the push field of user the objects. We advise leave the pre filled Standard names.
** the App URL must be <code>https://push.innovaphone.com/push/ws</code>
After clicking OK a green checkmark should appear, indicating that the Push object has a valid websocket connection to the innovaphone Push service.

=== User Objects ===
* For each user who is to receive push notifications on his myApps-application, the ''Name'' of the push-object must be entered in his userobject at the ''Push'' field in the ''User'' tab.

=== iOS specific settings ===
* On the iOS device make sure to allow push notifications for the myApps application.

=== Android specific settings ===

==How it works==
*First of all the mobile phone opens a connection to Apple or Google. If the phone is in a restricted Wi-Fi network (and has no GSM/LTE data connection to receive Push notifications), the appropriate ports of the firewall needs to opened as explained in the documentation of [https://support.apple.com/en-us/HT203609 apple] or [https://firebase.google.com/docs/cloud-messaging/concept-options#ports_and_your_firewall google].
*If the app is in the background and the user receives an incoming call, the App needs to be woken.
*Therefore the PBX sends a push request to innovaphones push servers (push.innovaphone.com)
*The communication is done with MTLS and our push servers check the client device certificate of the PBX
** the used certificate is the device certificate provided by innovaphone and not a certificate, which you can upload yourself
*push.innovaphone.com forwards the request to the Apple or Google Push service.
*The respective vendor sends the push request to the mobile phone and uses the ports opened in the first step.
*The app then registers at the PBX via H.323.
*In the last step the incoming call is sent (using the H.323 registration) to the mobile phone.

[[Image:push.gif|push.gif/|push.gif/]]

Note: the services.innovaphone.com in the picture must be replaced with push.innovaphone.com

=== Privacy ===
When using the Push service the PBX will send following data/information to [[Howto:Innovaphones public services|innovaphone]]:

* Notification Type (plain)
** ''call'' or ''notification''

* Detailed informations (enrypted)
** ''call''
*** number
*** name
*** callflow
** ''notification''
*** title
*** content

This information will send from the PBX to the Smartphone via the innovaphone Push-Service and forwarded to the Google/Apple push system. The Smartphone receives a decryption key via websocket or H323 (you have to use the secure version to transmit the key encrypted) from the PBX. Neither the push service at innovaphone nor the Apple / Google push system can read the encrypted information.

== Troubleshooting ==
=== Initial configuration ===
* Check the trust list for the certificate of the innovaphone AG.
* Make sure the PBX can resolve the DNS host ''push.innovaphone.com''.
* Make sure the PBX can reach ''push.innovaphone.com'' via HTTPS.
* Make sure that you have a innovaphone ''device certificate'' - even on '''IPVA or AppIP'''. The certificate is signed by ''innovaphone Device Certification Authority 2'' or on IPVA or AppIP since V14r1 by ''innovaphone Unverified Device CA''. If not, you can acquire a new one on the Gateway via [[{{NAMESPACE}}:General/License/my.innovaphone#Download_Certificate | General/License/my.innovaphone]]. '''This will not conflict with an existing certificate that you installed yourself on the gateway.'''
* Make sure the myApps application has Push Notifications allowed in the OS settings.
** iOS: Also make sure, the iOS device has a valid GSM data connection or a WiFi connection with the internet, especially TCP port 5223 (see [https://developer.apple.com/library/archive/technotes/tn2265/_index.html Troubleshooting Push Notifications] article by Apple).

=== Push looses connected state ===
* If the push object was already connected, and for some reason (after a firmware update or network connection problems), the object is not connected anymore, please check that PBX can reach and resolve "push.innovaphone.com" and the innovaphone AG certificate is still in the trust list.

===myApps for Android push configuration checks ===

[[Image:Troubleshoot_v13_Push_with_myApps_for_Android and iOS_1.jpg|troubleshoot_v13_push_with_myapps_for_android_and_ios_1.jpg/|troubleshoot_v13_push_with_myapps_for_android_and_ios_1.jpg/]]

Open myApps, and check you have a softphone app configured. Then tap on the "burger" menu on the top right, and check your default app is the softphone app.

Scroll down and tap on "More"
# Tap on "myApps events" and enable notification on the smartphone for myApps
# Tap on "Calling account" and enable myApps as call account
# Tap on "Data saver" and enable background data for myApps on the smartphone
# Tap on "Overlaying" and enable them on the smartphone

===myApps for iOS push configuration checks ===
Go through the following steps, to check that in your iPhone, Push is configured correctly.
#Open your iOS Settings app on your iPhone
#Go to the ''Notifications'' (German: Mitteilungen) section
#Find the myApps app and make sure notifications are allowed and that LockScreen, Notification Center and Banners are selected as Alerts 
For more information on howto enable Push notifications for an iOS-app, see also [https://support.apple.com/en-us/HT201925#If%20you%20don't%20see%20notifications%20for%20a%20specific%20app this Apple support page, section If you don't see notifications for a specific app]

Check the Apple's Full Immersion feature and make sure to allow the myApps App.

===innovaphone Push Service check===
Consult [https://status.innovaphone.com/ innovaphone services overview] to check if any unexpected service outage concerning push exists

== Known limitations ==
=== Number to Name resolution on Android Push Notifications could be missing ===
On incoming call Push Notification to Android the caller number will be included, if the Number to name resolution it's not yet finished no name will be included in this Push notification just the number. The Android doesn't allow a number/name update of that call afterwards so it will remain displaying only the number till we terminate the call. On iOS we don't have such issue since the system allows update of the number/name during call.

=== Push does work even when the myApps app is switched off ===
The Push mechanism will also work when the myApps app is turned off. This can lead to complains about receiving calls after working ours or during holidays.
With myApps as client, you can set the status to DND Do Not Disturb. Then close the myApps.
This will prevent the App to be started by the Push mechanism.
To receive calls again, open the myApps clients and set the status back to available.

You can disable the Push to the myApps by just ending the session for this device by logging out of the myApps application or Alternative you can go to the Hamburger Menu, Account Security and logout the active session.
You can also remove a session from another device for example a myApps Session from another Smartphone or browser.
Deselecting a default Softphone app, will also prevent the Push mechanism.

=== Customer uses HTTP-Proxy for Internet access ===
The WebSocket client does not support HTTP-Proxy connections, more specific HTTP Tunneling using HTTP CONNECT - therefore Push notifications will not work. See also: [[{{NAMESPACE}}:Services/HTTP/Client#Proxy_Servers|Reference15r1:Services/HTTP/Client#Proxy_Servers]]

=== BC Conference Object does NOT trigger the push mechanism ===
The BC Conference Object is not able to trigger the push mechanism for smartphone users. In case you want to have smartphone users as participants in your BC Conference Object, you need to use the following workaround:
* Create for every user a dedicated waiting queue object and add the smartphone user as only member to the group of this dedicated waiting queue.
* Instead of the user, you add the dedicated waiting queue as a member of the BC Conference Object group.
A BC Conference call will notify the dedicated waiting queue and the waiting queue will call the smartphone user which also triggers the push mechanism.

==Known issues==

===Cloning IPVA / AppIP===
If you clone an IPVA or AppIP with an existing device certificate, you'll also clone this certificate, so you'll have a wrong serial number inside the certificate afterwards. 
So '''do not clone''' IPVA or AppIP but setup a new VM and upload a modified configuration file afterwards and create a new certificate for the new machine.

Currently it is not possible to update or delete the device certificate.

== Related Articles ==
* [[Howto:Innovaphones_public_services]]

Template:HOWTOMOD13r2 Share files in FilesApp via Fileskey

2026-05-13T15:21:41Z

Kpe:

* in the ''Files'' App, click on the ''add folder'' symbol on the upper right
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-create folder.png]]
 
* rename the new folder to ''{{{folder}}}''
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-rename folder.png]]
 
* click on the ''Mark'' button on the upper right and make sure only the new ''{{{folder}}}'' folder is ticked
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-select folder.png]]
 
* click on the ''right arrow'' button on the right
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-share folder.png]]
 
* select ''share as link with filekey'' and leave all other fileds empty. Then click on ''Share''
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-share2 folder.png]]
 
* open the new folder by clicking on the folder name ''{{{folder}}}''
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-open folder.png]]
 
* copy all files (''{{{files}}}'') to the ''{{{folder}}}'' using drag-and-drop from the Windows-Explorer to the ''Files'' App
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-copy files.png]]
 
* finally click on the little ''i'' symbol on the upper right. Take note of the link shown (you may want to copy it to a text file)
: [[Image:{{NAMESPACE}}-{{PAGENAME}}-Share files in FilesApp via Fileskey-share link.png]]
 
You will need the ''fileskey={{{fileskey}}}'' option later on as it allows access to the shared files in you ''{{{folder}}}''.

Howto16r1:Create Apps for websites to open in a new window

2026-05-13T14:27:43Z

Kpe: /* Create a Shared Folder in Files App */

[[Category:Howto]]
==Applies to==
* firmware version V16 and higher
* it might work also with older Verions but it is not tested!

==More Information==
Create apps for (external) websites to be opened in a new browser tab (Browser version of myApps) or to be opened in a new docked out myApps window (Native myApps Client).
To make this possible you are going to host a html file in a shared folder from the Files App.
This html file will be accessed and will open the required Website URL that has been passed with this URL in a new window.

==Configuration==

===html file to download===
[[https://wiki.innovaphone.com/images/c/cf/Redirect_kpe.zip redirect_kpe.zip]]

===Create a Shared Folder in Files App===

In case you need a detailed example howto create a shared folder, check this wiki: [https://wiki.innovaphone.com/index.php?title=Template:HOWTOMOD13r2_Share_files_in_FilesApp_via_Fileskey_-_Sample Files_App_example]

# Open the Files App, click on the add folder symbol on the upper right and create a new folder with the name '''''html'''''
# Click on the Mark button on the upper right and make sure only the new '''''html folder''''' is ticked
# Click on the right arrow button on the right and share this folder with the fileskey access,
# Select share as link with filekey and leave all other fileds empty. Then click on Share
# Open the new folder by clicking on the folder name '''''html-folder'''''
# Copy and paste the downloaded html file '''''redirect_kpe.html''''' to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Copy and paste your optional icon files to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Finally click on the little '''''i''''' symbol on the upper right. Take note of the link shown and copy it to a text file for later use.
# Change the URL in the textfile for your purpose according to this example. The URL contains the destination to the redirect html file, added with the destination URL for the website to be opened and attached the fileskey to allow the acces to this html-folder. Example: "<nowiki>https://your.AppDNSname.com/yoursystemname.com/files/UI/html/</nowiki>'''''redirect_kpe.html?url=<nowiki>https://yourdestination.com</nowiki>'''''&'''''fileskey=Y0UrS3cr3tK3Y1234''''' "

===Create the App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert the used URL based on the example above - see also some examples below
# Insert optional the icon URL - see how to create an icon in the section below
# tick ''plain website''
# confirm with ''OK''

===Create an App Icon (Optional)===
* Search and download respective logo or create it with a screenshot tool. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.
* exampl of the icon URL: https://yourAP-DNSname.com/yoursystemname.com/files/UI/html/youriconfilename.png&fileskey=Y0UrS3cr3tK3Y1234

===Grant access to users===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
App html URL: https://your.AppDNSname.com/yoursystemname.com/files/UI/html/redirect_kpe.html? (followed by in theory any website URL that you want to use as the destination URL)
Some example listed:
* Here: <code>https://wego.here.com/p/here:cm:namedplace:20171588?map=48.71042,9.00612,13.24</code>
* Nextcloud: <code>https://nextcloud.com/</code>
* Karls: <code>https://www.karls.nl</code>
Followed by your Fileskey &fileskey=Y0UrS3cr3tK3Y1234

=== Web App example on the Community ===
If you want to see an example of this redirect Web App, go to the [https://community.innovaphone.com Community PBX] and go to the All Apps icon in the bottom right corner and add the URL Redirect App to your homescreen.

By opening this App it will open the redirect html file and after a timeout of 3 seconds it will open the innovaphone website about security in a new browser tab.

==Known issues==
* No known issues yet,
* Feel free to add if you find some

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

Howto16r1:Create Apps for websites to open in a new window

2026-05-13T14:26:49Z

Kpe: /* html file to download */

[[Category:Howto]]
==Applies to==
* firmware version V16 and higher
* it might work also with older Verions but it is not tested!

==More Information==
Create apps for (external) websites to be opened in a new browser tab (Browser version of myApps) or to be opened in a new docked out myApps window (Native myApps Client).
To make this possible you are going to host a html file in a shared folder from the Files App.
This html file will be accessed and will open the required Website URL that has been passed with this URL in a new window.

==Configuration==

===html file to download===
[[https://wiki.innovaphone.com/images/c/cf/Redirect_kpe.zip redirect_kpe.zip]]

===Create a Shared Folder in Files App===

In case you need a detailed example howto create a shared folder, check this wiki: [https://wiki.innovaphone.com/index.php?title=Template:HOWTOMOD13r2_Share_files_in_FilesApp_via_Fileskey_-_Sample Files_App_example]

# Open the Files App, click on the add folder symbol on the upper right and create a new folder with the name '''''html'''''
# Click on the Mark button on the upper right and make sure only the new '''''html folder''''' is ticked
# Click on the right arrow button on the right and share this folder with the fileskey access,
# Select share as link with filekey and leave all other fileds empty. Then click on Share
# Open the new folder by clicking on the folder name '''''html-folder'''''
# Copy and paste the downloaded html file '''''redirect_kpe.html''''' to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Copy and paste your optional icon files to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Finally click on the little '''''i''''' symbol on the upper right. Take note of the link shown and copy it to a text file for later use.
# Change the URL in the textfile for your purpose according to this example. The URL contains the destination to the redirect html file, added with the destination URL for the website to be opened and attached the fileskey to allow the acces to this html-folder. Example: "<nowiki>https://your.AppDNSname.com/yoursystemname.com/files/UI/html/</nowiki>'''''redirect_kpe.html?url=https://yourdestination.com'''''&'''''fileskey=Y0UrS3cr3tK3Y1234''''' "

===Create the App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert the used URL based on the example above - see also some examples below
# Insert optional the icon URL - see how to create an icon in the section below
# tick ''plain website''
# confirm with ''OK''

===Create an App Icon (Optional)===
* Search and download respective logo or create it with a screenshot tool. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.
* exampl of the icon URL: https://yourAP-DNSname.com/yoursystemname.com/files/UI/html/youriconfilename.png&fileskey=Y0UrS3cr3tK3Y1234

===Grant access to users===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
App html URL: https://your.AppDNSname.com/yoursystemname.com/files/UI/html/redirect_kpe.html? (followed by in theory any website URL that you want to use as the destination URL)
Some example listed:
* Here: <code>https://wego.here.com/p/here:cm:namedplace:20171588?map=48.71042,9.00612,13.24</code>
* Nextcloud: <code>https://nextcloud.com/</code>
* Karls: <code>https://www.karls.nl</code>
Followed by your Fileskey &fileskey=Y0UrS3cr3tK3Y1234

=== Web App example on the Community ===
If you want to see an example of this redirect Web App, go to the [https://community.innovaphone.com Community PBX] and go to the All Apps icon in the bottom right corner and add the URL Redirect App to your homescreen.

By opening this App it will open the redirect html file and after a timeout of 3 seconds it will open the innovaphone website about security in a new browser tab.

==Known issues==
* No known issues yet,
* Feel free to add if you find some

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

Howto16r1:Create Apps for websites to open in a new window

2026-05-13T12:56:56Z

Kpe: /* html file to download */

[[Category:Howto]]
==Applies to==
* firmware version V16 and higher
* it might work also with older Verions but it is not tested!

==More Information==
Create apps for (external) websites to be opened in a new browser tab (Browser version of myApps) or to be opened in a new docked out myApps window (Native myApps Client).
To make this possible you are going to host a html file in a shared folder from the Files App.
This html file will be accessed and will open the required Website URL that has been passed with this URL in a new window.

==Configuration==

===html file to download===
[[https://wiki.innovaphone.com/images/c/cf/Redirect_kpe.zip]]

===Create a Shared Folder in Files App===

In case you need a detailed example howto create a shared folder, check this wiki: https://wiki.innovaphone.com/index.php?title=Template:HOWTOMOD13r2_Share_files_in_FilesApp_via_Fileskey_-_Sample

# Open the Files App, click on the add folder symbol on the upper right and create a new folder with the name '''''html'''''
# Click on the Mark button on the upper right and make sure only the new '''''html folder''''' is ticked
# Click on the right arrow button on the right and share this folder with the fileskey access,
# Select share as link with filekey and leave all other fileds empty. Then click on Share
# Open the new folder by clicking on the folder name '''''html-folder'''''
# Copy and paste the downloaded html file '''''redirect_kpe.html''''' to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Copy and paste your optional icon files to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Finally click on the little '''''i''''' symbol on the upper right. Take note of the link shown and copy it to a text file for later use.
# Change the URL in the textfile for your purpose according to this example. The URL contains the destination to the redirect html file, added with the destination URL for the website to be opened and attached the fileskey to allow the acces to this html-folder. Example: "https://your.AppDNSname.com/yoursystemname.com/files/UI/html/'''''redirect_kpe.html?url=https://''''' '''''yourdestination.com'''''&'''''fileskey=Y0UrS3cr3tK3Y1234''''' "

===Create the App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert the used URL based on the example above - see also some examples below
# Insert optional the icon URL - see how to create an icon in the section below
# tick ''plain website''
# confirm with ''OK''

===Create an App Icon (Optional)===
* Search and download respective logo or create it with a screenshot tool. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.
* exampl of the icon URL: https://yourAP-DNSname.com/yoursystemname.com/files/UI/html/youriconfilename.png&fileskey=Y0UrS3cr3tK3Y1234

===Grant access to users===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
App html URL: https://your.AppDNSname.com/yoursystemname.com/files/UI/html/redirect_kpe.html? (followed by in theory any website URL that you want to use as the destination URL)
Some example listed:
* Here: <code>https://wego.here.com/p/here:cm:namedplace:20171588?map=48.71042,9.00612,13.24</code>
* Nextcloud: <code>https://nextcloud.com/</code>
* Karls: <code>https://www.karls.nl</code>
Followed by your Fileskey &fileskey=Y0UrS3cr3tK3Y1234

==Known issues==
* No known issues yet,
* Feel free to add if you find some

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

File:Redirect kpe.zip

2026-05-13T12:41:28Z

Kpe:

a html file that supports to open a website in a new window from a Web App.

Howto13r2:Create Apps for websites

2026-05-13T09:55:25Z

Kpe: /* More Information */

[[Category:Howto]]
==Applies to==
* firmware version 13r2 and higher

==More Information==
Create apps for (external) websites (that support iframe) to be opened within myApps

For websites that do not support iframe, there is a solution to open the website in a new window, see this wiki [[Howto16r1:Create Apps for websites to open in a new window]]

==Configuration==

===App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert used URL - see some examples below
# Insert optional icon URL - see how to create below
# tick ''plain website''
# confirm with ''OK''

===Icon (Optional)===
* Search and download respective logo. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.

===Grant access===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
(as of November 2022):
* Here: <code>https://wego.here.com/</code>
* Google: <code>https://www.google.com/search?igu=1</code>
* YouTube: <code>https://www.youtube.com/embed/vXgryhUik1U?autoplay=1&controls=0&showinfo=0</code>

==Known issues==
* Websites that don't allow to be opened within an iframe/xframe environment. Some websites do support iframe only with additional parameters for iframe in the URL.
* Websites using iframes are not supported to be displayed via App-objects
* myApps-Launcher does not store passwords entered in websites
* no spell check support in forms

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

Howto16r1:Create Apps for websites to open in a new window

2026-05-13T09:50:18Z

Kpe: Created page with "Category:Howto ==Applies to== * firmware version V16 and higher * it might work also with older Verions but it is not tested! ==More Information== Create apps for (external) websites to be opened in a new browser tab (Browser version of myApps) or to be opened in a new docked out myApps window (Native myApps Client). To make this possible you are going to host a html file in a shared folder from the Files App. This html file will be accessed and will open the requ..."

[[Category:Howto]]
==Applies to==
* firmware version V16 and higher
* it might work also with older Verions but it is not tested!

==More Information==
Create apps for (external) websites to be opened in a new browser tab (Browser version of myApps) or to be opened in a new docked out myApps window (Native myApps Client).
To make this possible you are going to host a html file in a shared folder from the Files App.
This html file will be accessed and will open the required Website URL that has been passed with this URL in a new window.

==Configuration==

===html file to download===

===Create a Shared Folder in Files App===

In case you need a detailed example howto create a shared folder, check this wiki: https://wiki.innovaphone.com/index.php?title=Template:HOWTOMOD13r2_Share_files_in_FilesApp_via_Fileskey_-_Sample

# Open the Files App, click on the add folder symbol on the upper right and create a new folder with the name '''''html'''''
# Click on the Mark button on the upper right and make sure only the new '''''html folder''''' is ticked
# Click on the right arrow button on the right and share this folder with the fileskey access,
# Select share as link with filekey and leave all other fileds empty. Then click on Share
# Open the new folder by clicking on the folder name '''''html-folder'''''
# Copy and paste the downloaded html file '''''redirect_kpe.html''''' to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Copy and paste your optional icon files to the '''''html-folder''''' using drag-and-drop from the Windows-Explorer to the Files App
# Finally click on the little '''''i''''' symbol on the upper right. Take note of the link shown and copy it to a text file for later use.
# Change the URL in the textfile for your purpose according to this example. The URL contains the destination to the redirect html file, added with the destination URL for the website to be opened and attached the fileskey to allow the acces to this html-folder. Example: "https://your.AppDNSname.com/yoursystemname.com/files/UI/html/'''''redirect_kpe.html?url=https://''''' '''''yourdestination.com'''''&'''''fileskey=Y0UrS3cr3tK3Y1234''''' "

===Create the App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert the used URL based on the example above - see also some examples below
# Insert optional the icon URL - see how to create an icon in the section below
# tick ''plain website''
# confirm with ''OK''

===Create an App Icon (Optional)===
* Search and download respective logo or create it with a screenshot tool. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.
* exampl of the icon URL: https://yourAP-DNSname.com/yoursystemname.com/files/UI/html/youriconfilename.png&fileskey=Y0UrS3cr3tK3Y1234

===Grant access to users===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
App html URL: https://your.AppDNSname.com/yoursystemname.com/files/UI/html/redirect_kpe.html? (followed by in theory any website URL that you want to use as the destination URL)
Some example listed:
* Here: <code>https://wego.here.com/p/here:cm:namedplace:20171588?map=48.71042,9.00612,13.24</code>
* Nextcloud: <code>https://nextcloud.com/</code>
* Karls: <code>https://www.karls.nl</code>
Followed by your Fileskey &fileskey=Y0UrS3cr3tK3Y1234

==Known issues==
* No known issues yet,
* Feel free to add if you find some

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

Howto13r2:Create Apps for websites

2026-05-13T08:17:51Z

Kpe: /* More Information */

[[Category:Howto]]
==Applies to==
* firmware version 13r2 and higher

==More Information==
Create apps for (external) websites to be opened within myApps

==Configuration==

===App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert used URL - see some examples below
# Insert optional icon URL - see how to create below
# tick ''plain website''
# confirm with ''OK''

===Icon (Optional)===
* Search and download respective logo. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.

===Grant access===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
(as of November 2022):
* Here: <code>https://wego.here.com/</code>
* Google: <code>https://www.google.com/search?igu=1</code>
* YouTube: <code>https://www.youtube.com/embed/vXgryhUik1U?autoplay=1&controls=0&showinfo=0</code>

==Known issues==
* Websites that don't allow to be opened within an iframe/xframe environment. Some websites do support iframe only with additional parameters for iframe in the URL.
* Websites using iframes are not supported to be displayed via App-objects
* myApps-Launcher does not store passwords entered in websites
* no spell check support in forms

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

Howto13r2:Create Apps for websites

2026-05-13T08:16:05Z

Kpe: /* Known issues */

[[Category:Howto]]
==Applies to==
* firmware version 13r2 and higher

==More Information==
Create apps for (external) websites

==Configuration==

===App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert used URL - see some examples below
# Insert optional icon URL - see how to create below
# tick ''plain website''
# confirm with ''OK''

===Icon (Optional)===
* Search and download respective logo. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.

===Grant access===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
(as of November 2022):
* Here: <code>https://wego.here.com/</code>
* Google: <code>https://www.google.com/search?igu=1</code>
* YouTube: <code>https://www.youtube.com/embed/vXgryhUik1U?autoplay=1&controls=0&showinfo=0</code>

==Known issues==
* Websites that don't allow to be opened within an iframe/xframe environment. Some websites do support iframe only with additional parameters for iframe in the URL.
* Websites using iframes are not supported to be displayed via App-objects
* myApps-Launcher does not store passwords entered in websites
* no spell check support in forms

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

Howto13r2:Create Apps for websites

2026-05-13T08:14:42Z

Kpe: added known issue

[[Category:Howto]]
==Applies to==
* firmware version 13r2 and higher

==More Information==
Create apps for (external) websites

==Configuration==

===App Object===
# Navigate in PBX-AdvancedUI to PBX/Objects
# Choose object type ''App'' from left sided drop down and confirm with ''New''
# Define app-object-name and app-object-longname and confirm with ''Apply''
# switch to tab ''App''
# Insert used URL - see some examples below
# Insert optional icon URL - see how to create below
# tick ''plain website''
# confirm with ''OK''

===Icon (Optional)===
* Search and download respective logo. Observe any copyrights and rights of use.
* Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
* Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
* paste the hex dump content including leading <code>data:image/png;base64,</code>into field ''Icon (URL)''
* pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.

===Grant access===
Tick respective App-Object-Name in ''Apps''-tab at user object or distributing configuration template object

===URL examples===
(as of November 2022):
* Here: <code>https://wego.here.com/</code>
* Google: <code>https://www.google.com/search?igu=1</code>
* YouTube: <code>https://www.youtube.com/embed/vXgryhUik1U?autoplay=1&controls=0&showinfo=0</code>

==Known issues==
* Websites that don't allow to be opened within an iframe/xframe environment
* Websites using iframes are not supported to be displayed via App-objects
* myApps-Launcher does not store passwords entered in websites
* no spell check support in forms

==Related articles==
* [[Reference13r1:PBX/Objects/App]]
* [[Reference13r2:Concept_Apps#App_Objects_Parameters]]
* [[Courseware:IT_Advanced_-_03_The_Application_Platform#App_objects]]
* [https://www.youtube.com/watch?v=vXgryhUik1U innovaphone video on how to integrate websites as apps]
* [https://www.base64-image.de/ Base 64 image encoder]

Howto:Algo 8301 IP Paging Adapter - Algo - 3rd Party Product

2026-04-28T08:33:57Z

Kpe: /* innovaphone WebRTC ready */

[[Image:AlgosolutionsLogo.png|200px|right|/AlgosolutionsLogo.png|algosolutionslogo.png/]]
==Product Name==
Algo [https://www.algosolutions.com/product/8301-ip-paging-adapter-scheduler/ 8301 IP Paging Adapter & Scheduler]

==Certification Status==

{{Template:Compat_Status_referral_terminals|manufacturername=Algo Communication Products Ltd.|certificationdate=in April 2026}}

==Category==

[[Category:Referral Product|{{PAGENAME}}]]
{{Category:3rdParty_Terminal_Devices}}
[[Category:3rdParty Terminal Devices|{{PAGENAME}}]]

==Vendor==
'''Algo Communication Products Ltd.''' is a manufacturer of network-based IP endpoints for voice paging, emergency alerting, visual notification, intercom, and secure door entry applications. Algo products are designed for integration with unified communications, collaboration, and mass notification platforms. The company’s portfolio includes IP speakers, paging adapters, intercoms, visual alerters, display speakers, and endpoint management tools for commercial, education, healthcare, transportation, and industrial environments.

==Description==
The Algo 8301 IP Paging Adapter & Scheduler is a wideband SIP paging adapter designed to connect traditional analog amplifiers and legacy paging infrastructure to modern IP-based communication environments.

The 8301 emulates a page port similar to what is found on a legacy PBX or key system, allowing a traditional amplifier to be integrated into a VoIP or unified communications environment. This enables organizations to retain existing analog speaker infrastructure while adding SIP paging, multicast distribution, scheduled bells, automated announcements, emergency notifications, and other IP-based communication capabilities.

The device includes a balanced and isolated line output to reduce hum and noise when connected to an amplifier, and it also supports multicast audio transmission to additional Algo IP endpoints and compatible multicast-enabled phones. The 8301 is appropriate for education, retail, manufacturing, transportation, healthcare, and other environments where hybrid analog and IP paging is required.

==Functions==
The '''Algo 8301 IP Paging Adapter & Scheduler''' supports a range of functions for paging, alerting, scheduling, and hybrid analog/IP deployments.

Core functions include:
* SIP-based voice paging through registration as a 3rd-party SIP endpoint
* Integration of traditional analog amplifiers into IP and UC environments
* Scheduled bells, tones, and automated announcements synchronized to NTP
* Emergency, safety, security, and customer service audio notifications
* Multicast transmission to Algo IP speakers, paging adapters, display speakers, and compatible multicast-enabled phones
* Ring, page, and alert extension support
* Relay input and relay output support for connected accessories and external triggers
* Music input and background audio distribution
* Web interface configuration and centralized provisioning support

The 8301 can be deployed either as a SIP extension or as a multicast endpoint, depending on the communication design. In hybrid systems, it can provide local analog paging output while simultaneously distributing audio to IP endpoints over the network.

==innovaphone CTI ready==
n.a.

==innovaphone Reverse Proxy ready==
'''Yes.''' Testing was performed in an innovaphone myApps Cloud environment using registration via the cloud reverse proxy. In the innovaphone user object, the hardware ID must match the Authentication ID configured on the Algo device, and Reverse Proxy plus Media Relay must be enabled. The validated setup used STUN, while TURN and ICE were not used. SIP over TCP was validated. SIP over UDP and SIP over TLS were available but not fully validated in this test case.

* STUN yes
* TURN no
* ICE no
* SIP/TCP yes
* SIP UDP yes (not tested)
* SIP/TLS yes (not tested)

==innovaphone WebRTC ready==
yes, the device supports SRTP, SDES-DTLS

==Supported Codecs==

* G.722 yes
* G.711 A-law yes
* G.711 u-law yes

==DTMF Support==


* RTP DTMF (RFC2833)

==Supports RFC3261 Digest Authentication Scheme (Section 22.4)==



==Support LDAP Phonebook==
n.a.

==Version==
Product versions used for interop testing:

* Algo 8301 IP Paging Adapter & Scheduler
* Algo 8186 SIP Horn
* Algo 8180 SIP Audio Alerter (G2)
* Algo 8128 (G2) SIP Strobe Light
* Algo 8201 SIP PoE Intercom

* Algo firmware requirement: version 5.4 or later

* innovaphone firmware / software version: innovaphone myApps Cloud IPVA, V15r1sr11

These devices represent Algo IP speakers, paging adapters, visual alerters, and door phones, and similar registration steps apply across Algo SIP endpoints.

==Configuration==
Algo SIP endpoints can register to innovaphone as 3rd-party SIP endpoints for voice paging, loud ringing, emergency alerting, visual notification, and secure door entry.

Interoperability testing was conducted using the Algo 8301 IP Paging Adapter & Scheduler, 8186 SIP Horn, 8180 SIP Audio Alerter (G2), 8128 (G2) SIP Strobe Light, and 8201 SIP PoE Intercom. These represent Algo IP speakers, paging adapters, visual alerters, and door phones, and similar registration steps apply to all devices.

=== '''Algo firmware requirements''' ===
All Algo devices must be running firmware version 5.4 or later. The current firmware version can be verified on the device and can be updated in '''System -> Firmware''' tab.

=== '''Algo device configuration''' ===

# Log in to the Algo device web interface. The device's IP address can be found by using an IP scanner tool such as [https://angryip.org/ Angry IP Scanne]r which is free and open-source.
# Go to '''Basic Settings -> SIP'''.
## [[File:Algo SIP Settings.png|none|thumb|/Algo_SIP_Settings.png|algo_sip_settings.png/]]
# Enter the SIP credentials under '''Base/Page''' using the values from innovaphone dashboard:
#* '''SIP Domain (Proxy Server):''' innovaphone System ID
#* '''SIP Extension:''' extension from innovaphone
#* '''Authentication ID:''' SIP username from innovaphone
#* '''Authentication Password:''' SIP password from innovaphone
# Select '''Save'''.
# Go to '''Advanced Settings -> Advanced SIP'''.
# Set '''SIP Transportation''' to '''TCP'''.
# Set the '''Outbound Proxy''' to the DNS name of the innovaphone system. Example: '''algosolutions-p.innovaphone.com'''
# Set '''SDP SRTP''' to '''Optional''' and '''AES CM 128 HMAC SHA1 80'''.
# Set '''STUN''' to '''stun.innovaphone.com'''.
# Select '''Save'''.
## [[File:AlgoSIPSettings2.png|none|thumb|/AlgoSIPSettings2.png|algosipsettings2.png/]]
#Go to the '''Status''' tab and verify that the configured extensions have registered correctly.
[[File:AlgoSIPConfirmation.png|none|thumb|473x473px|/AlgoSIPConfirmation.png|algosipconfirmation.png/]]

=== '''Configuration of the innovaphone user objects in innovaphone myApps''' ===

# Open the '''Users Admin App'''.
# [[File:UsersAdmin.png|thumb|none|/UsersAdmin.png|usersadmin.png/]]
# Create the user account for the Algo device. In this example we created a User account for Algo8180 and Algo8181.
# In the '''Devices''' table of the user account, make sure the '''hardware ID''' is the same as the '''Authentication ID''' used in the Algo device.
# Ensure that '''Reverse Proxy''' and '''Media Relay''' are enabled.
# [[File:Innovaphone Config Status.png|none|thumb|400x400px|/Innovaphone_Config_Status.png|innovaphone_config_status.png/]]
# [[File:Status Confirmation.png|none|thumb|402x402px|/Status_Confirmation.png|status_confirmation.png/]]
# Or, if preferred, the configuration can also be completed using the Advanced GUI, as shown in the example below.
# [[File:Innovaphone Config Status2.png|none|thumb|418x418px|/Innovaphone_Config_Status2.png|innovaphone_config_status2.png/]]
# Registration of the Algo device can then be checked within the innovaphone system.
# [[File:Innovaphone Config Status using GUI.png|none|thumb|400x400px|/Innovaphone_Config_Status_using_GUI.png|innovaphone_config_status_using_gui.png/]]
The same SIP registration workflow applies across Algo IP speakers, paging adapters, visual alerters, and intercoms. Device-specific behaviour and options depend on the endpoint and deployment.

==Summary==
Algo SIP endpoints can integrate with innovaphone as 3rd-party SIP endpoints across key endpoint categories, including paging adapters, IP speakers, visual alerters, and intercoms.

Interoperability in this validation scope was performed using the Algo 8301, 8186, 8180, 8128, and 8201. Similar SIP registration steps apply across these devices, with product-specific options such as analog paging output, multicast, visual alerting, door entry, or local audio behaviour configured according to the endpoint type.

==Contact==
{|
| Algo Communication Products Ltd.
|-
| Burnaby, BC, Canada
|-
| Tel: +1 604-454-3790
|-
| Support: +1 604-454-3792
|-
| Mail: [mailto:info@algosolutions.com info@algosolutions.com]
|}

For additional information please refer to [https://www.algosolutions.com/contact-us/ our contact page].

Howto:Algo 8301 IP Paging Adapter - Algo - 3rd Party Product

2026-04-15T10:18:37Z

Kpe: /* Certification Status */

[[Image:AlgosolutionsLogo.png|200px|right|algosolutionslogo.png/|algosolutionslogo.png/]]
==Product Name==
Algo [https://www.algosolutions.com/product/8301-ip-paging-adapter-scheduler/ 8301 IP Paging Adapter & Scheduler]

==Certification Status==


==Category==

[[Category:Referral Product|{{PAGENAME}}]]
{{Category:3rdParty_Terminal_Devices}}
[[Category:3rdParty Terminal Devices|{{PAGENAME}}]]

==Vendor==
Algo Communication Products Ltd. is a manufacturer of network-based IP endpoints for voice paging, emergency alerting, visual notification, intercom, and secure door entry applications. Algo products are designed for integration with unified communications, collaboration, and mass notification platforms. The company’s portfolio includes IP speakers, paging adapters, intercoms, visual alerters, display speakers, and endpoint management tools for commercial, education, healthcare, transportation, and industrial environments.

==Description==
The Algo 8301 IP Paging Adapter & Scheduler is a wideband SIP paging adapter designed to connect traditional analog amplifiers and legacy paging infrastructure to modern IP-based communication environments.

The 8301 emulates a page port similar to what is found on a legacy PBX or key system, allowing a traditional amplifier to be integrated into a VoIP or unified communications environment. This enables organizations to retain existing analog speaker infrastructure while adding SIP paging, multicast distribution, scheduled bells, automated announcements, emergency notifications, and other IP-based communication capabilities.

The device includes a balanced and isolated line output to reduce hum and noise when connected to an amplifier, and it also supports multicast audio transmission to additional Algo IP endpoints and compatible multicast-enabled phones. The 8301 is appropriate for education, retail, manufacturing, transportation, healthcare, and other environments where hybrid analog and IP paging is required.

==Functions==
The Algo 8301 IP Paging Adapter & Scheduler supports a range of functions for paging, alerting, scheduling, and hybrid analog/IP deployments.

Core functions include:
* SIP-based voice paging through registration as a 3rd-party SIP endpoint
* Integration of traditional analog amplifiers into IP and UC environments
* Scheduled bells, tones, and automated announcements synchronized to NTP
* Emergency, safety, security, and customer service audio notifications
* Multicast transmission to Algo IP speakers, paging adapters, display speakers, and compatible multicast-enabled phones
* Ring, page, and alert extension support
* Relay input and relay output support for connected accessories and external triggers
* Music input and background audio distribution
* Web interface configuration and centralized provisioning support

The 8301 can be deployed either as a SIP extension or as a multicast endpoint, depending on the communication design. In hybrid systems, it can provide local analog paging output while simultaneously distributing audio to IP endpoints over the network.

==innovaphone CTI ready==
n.a.

==innovaphone Reverse Proxy ready==
Yes, the tests has been performed on an innovaphone myApps Cloud environment with registration via the cloud reverse proxy. In the innovaphone PBX onn the users object hardware ID, media relay needs to be activated.

* STUN yes
* TURN no
* ICE no
* SIP/TCP yes
* SIP UDP yes (not tested)
* SIP/TLS yes (not tested)

==innovaphone WebRTC ready==
n.a.

==Supported Codecs==

* G.722 yes
* G.711 A-law yes
* G.711 u-law yes

==DTMF Support==


* RTP DTMF (RFC2833)

==Supports RFC3261 Digest Authentication Scheme (Section 22.4)==



==Support LDAP Phonebook==
n.a.

==Version==
Product versions used for interop testing:
* Algo 8301 IP Paging Adapter & Scheduler: version to be confirmed!
* innovaphone firmware / software version: innovaphone myApps Cloud IPVA, V15r1sr11

==Configuration==
Configuration details will be completed based on the validated test setup.

The planned configuration section will include:
* innovaphone-side SIP configuration
* Algo 8301 SIP registration settings
* paging behavior and extension mapping
* multicast settings, if used
* audio output connection to amplifier
* relay input / output use, if applicable
* any deployment notes, limitations, or prerequisites identified during testing

==Summary==
The Algo 8301 IP Paging Adapter & Scheduler provides a practical bridge between legacy analog paging infrastructure and modern IP-based communication systems. It enables organizations to preserve existing amplifier and speaker investments while adding SIP paging, scheduling, multicast distribution, and emergency notification capabilities. Final interoperability details with innovaphone will be updated after test validation and configuration review.

==Contact==
{|
| Algo Communication Products Ltd.
|-
| Contact Name: to be confirmed
|-
| Burnaby, BC, Canada
|-
| Tel: +1 604-454-3790
|-
| Support: +1 604-454-3792
|-
| Mail: [mailto:info@algosolutions.com info@algosolutions.com]
|}

For additional information please refer to [https://www.algosolutions.com/contact-us/ our contact page].

Howto:Algo 8301 IP Paging Adapter - Algo - 3rd Party Product

2026-04-15T09:43:47Z

Kpe: /* innovaphone Reverse Proxy ready */

[[Image:AlgosolutionsLogo.png|200px|right|algosolutionslogo.png/|algosolutionslogo.png/]]
==Product Name==
Algo [https://www.algosolutions.com/product/8301-ip-paging-adapter-scheduler/ 8301 IP Paging Adapter & Scheduler]

==Certification Status==


==Category==

[[Category:Referral Product|{{PAGENAME}}]]
{{Category:3rdParty_Terminal_Devices}}
[[Category:3rdParty Terminal Devices|{{PAGENAME}}]]

==Vendor==
Algo Communication Products Ltd. is a manufacturer of network-based IP endpoints for voice paging, emergency alerting, visual notification, intercom, and secure door entry applications. Algo products are designed for integration with unified communications, collaboration, and mass notification platforms. The company’s portfolio includes IP speakers, paging adapters, intercoms, visual alerters, display speakers, and endpoint management tools for commercial, education, healthcare, transportation, and industrial environments.

==Description==
The Algo 8301 IP Paging Adapter & Scheduler is a wideband SIP paging adapter designed to connect traditional analog amplifiers and legacy paging infrastructure to modern IP-based communication environments.

The 8301 emulates a page port similar to what is found on a legacy PBX or key system, allowing a traditional amplifier to be integrated into a VoIP or unified communications environment. This enables organizations to retain existing analog speaker infrastructure while adding SIP paging, multicast distribution, scheduled bells, automated announcements, emergency notifications, and other IP-based communication capabilities.

The device includes a balanced and isolated line output to reduce hum and noise when connected to an amplifier, and it also supports multicast audio transmission to additional Algo IP endpoints and compatible multicast-enabled phones. The 8301 is appropriate for education, retail, manufacturing, transportation, healthcare, and other environments where hybrid analog and IP paging is required.

==Functions==
The Algo 8301 IP Paging Adapter & Scheduler supports a range of functions for paging, alerting, scheduling, and hybrid analog/IP deployments.

Core functions include:
* SIP-based voice paging through registration as a 3rd-party SIP endpoint
* Integration of traditional analog amplifiers into IP and UC environments
* Scheduled bells, tones, and automated announcements synchronized to NTP
* Emergency, safety, security, and customer service audio notifications
* Multicast transmission to Algo IP speakers, paging adapters, display speakers, and compatible multicast-enabled phones
* Ring, page, and alert extension support
* Relay input and relay output support for connected accessories and external triggers
* Music input and background audio distribution
* Web interface configuration and centralized provisioning support

The 8301 can be deployed either as a SIP extension or as a multicast endpoint, depending on the communication design. In hybrid systems, it can provide local analog paging output while simultaneously distributing audio to IP endpoints over the network.

==innovaphone CTI ready==
n.a.

==innovaphone Reverse Proxy ready==
Yes, the tests has been performed on an innovaphone myApps Cloud environment with registration via the reverse proxy. On the innovaphone users object hardware ID, media relay was activated.

* STUN yes
* TURN no
* ICE no
* SIP/TCP yes
* SIP UDP yes (not tested)
* SIP/TLS yes (not tested)

==innovaphone WebRTC ready==
n.a.

==Supported Codecs==

* G.722 yes
* G.711 A-law yes
* G.711 u-law yes

==DTMF Support==


* RTP DTMF (RFC2833)

==Supports RFC3261 Digest Authentication Scheme (Section 22.4)==



==Support LDAP Phonebook==
n.a.

==Version==
Product versions used for interop testing:
* Algo 8301 IP Paging Adapter & Scheduler: version to be confirmed
* innovaphone firmware / software version: to be confirmed

==Configuration==
Configuration details will be completed based on the validated test setup.

The planned configuration section will include:
* innovaphone-side SIP configuration
* Algo 8301 SIP registration settings
* paging behavior and extension mapping
* multicast settings, if used
* audio output connection to amplifier
* relay input / output use, if applicable
* any deployment notes, limitations, or prerequisites identified during testing

==Summary==
The Algo 8301 IP Paging Adapter & Scheduler provides a practical bridge between legacy analog paging infrastructure and modern IP-based communication systems. It enables organizations to preserve existing amplifier and speaker investments while adding SIP paging, scheduling, multicast distribution, and emergency notification capabilities. Final interoperability details with innovaphone will be updated after test validation and configuration review.

==Contact==
{|
| Algo Communication Products Ltd.
|-
| Contact Name: to be confirmed
|-
| Burnaby, BC, Canada
|-
| Tel: +1 604-454-3790
|-
| Support: +1 604-454-3792
|-
| Mail: [mailto:info@algosolutions.com info@algosolutions.com]
|}

For additional information please refer to [https://www.algosolutions.com/contact-us/ our contact page].

Howto:Algo 8301 IP Paging Adapter - Algo - 3rd Party Product

2026-04-15T09:37:43Z

Kpe: /* innovaphone Reverse Proxy ready */

[[Image:AlgosolutionsLogo.png|200px|right|algosolutionslogo.png/]]
==Product Name==
Algo [https://www.algosolutions.com/product/8301-ip-paging-adapter-scheduler/ 8301 IP Paging Adapter & Scheduler]

==Certification Status==


==Category==

[[Category:Referral Product|{{PAGENAME}}]]
{{Category:3rdParty_Terminal_Devices}}
[[Category:3rdParty Terminal Devices|{{PAGENAME}}]]

==Vendor==
Algo Communication Products Ltd. is a manufacturer of network-based IP endpoints for voice paging, emergency alerting, visual notification, intercom, and secure door entry applications. Algo products are designed for integration with unified communications, collaboration, and mass notification platforms. The company’s portfolio includes IP speakers, paging adapters, intercoms, visual alerters, display speakers, and endpoint management tools for commercial, education, healthcare, transportation, and industrial environments.

==Description==
The Algo 8301 IP Paging Adapter & Scheduler is a wideband SIP paging adapter designed to connect traditional analog amplifiers and legacy paging infrastructure to modern IP-based communication environments.

The 8301 emulates a page port similar to what is found on a legacy PBX or key system, allowing a traditional amplifier to be integrated into a VoIP or unified communications environment. This enables organizations to retain existing analog speaker infrastructure while adding SIP paging, multicast distribution, scheduled bells, automated announcements, emergency notifications, and other IP-based communication capabilities.

The device includes a balanced and isolated line output to reduce hum and noise when connected to an amplifier, and it also supports multicast audio transmission to additional Algo IP endpoints and compatible multicast-enabled phones. The 8301 is appropriate for education, retail, manufacturing, transportation, healthcare, and other environments where hybrid analog and IP paging is required.

==Functions==
The Algo 8301 IP Paging Adapter & Scheduler supports a range of functions for paging, alerting, scheduling, and hybrid analog/IP deployments.

Core functions include:
* SIP-based voice paging through registration as a 3rd-party SIP endpoint
* Integration of traditional analog amplifiers into IP and UC environments
* Scheduled bells, tones, and automated announcements synchronized to NTP
* Emergency, safety, security, and customer service audio notifications
* Multicast transmission to Algo IP speakers, paging adapters, display speakers, and compatible multicast-enabled phones
* Ring, page, and alert extension support
* Relay input and relay output support for connected accessories and external triggers
* Music input and background audio distribution
* Web interface configuration and centralized provisioning support

The 8301 can be deployed either as a SIP extension or as a multicast endpoint, depending on the communication design. In hybrid systems, it can provide local analog paging output while simultaneously distributing audio to IP endpoints over the network.

==innovaphone CTI ready==
n.a.

==innovaphone Reverse Proxy ready==
Yes, the tests has been performed on an innovaphone myApps Cloud environment with registration via the reverse proxy. On the users object hardware ID, media relay was activated


==innovaphone WebRTC ready==
n.a.

==Supported Codecs==


==DTMF Support==



==Supports RFC3261 Digest Authentication Scheme (Section 22.4)==



==Support LDAP Phonebook==
n.a.

==Version==
Product versions used for interop testing:
* Algo 8301 IP Paging Adapter & Scheduler: version to be confirmed
* innovaphone firmware / software version: to be confirmed

==Configuration==
Configuration details will be completed based on the validated test setup.

The planned configuration section will include:
* innovaphone-side SIP configuration
* Algo 8301 SIP registration settings
* paging behavior and extension mapping
* multicast settings, if used
* audio output connection to amplifier
* relay input / output use, if applicable
* any deployment notes, limitations, or prerequisites identified during testing

==Summary==
The Algo 8301 IP Paging Adapter & Scheduler provides a practical bridge between legacy analog paging infrastructure and modern IP-based communication systems. It enables organizations to preserve existing amplifier and speaker investments while adding SIP paging, scheduling, multicast distribution, and emergency notification capabilities. Final interoperability details with innovaphone will be updated after test validation and configuration review.

==Contact==
{|
| Algo Communication Products Ltd.
|-
| Contact Name: to be confirmed
|-
| Burnaby, BC, Canada
|-
| Tel: +1 604-454-3790
|-
| Support: +1 604-454-3792
|-
| Mail: [mailto:info@algosolutions.com info@algosolutions.com]
|}

For additional information please refer to [https://www.algosolutions.com/contact-us/ our contact page].

Reference13r1:PBX/Objects/Edit Forks

2026-04-13T10:49:50Z

Kpe:

With this page call forking can be configured for a user. This means a call for this user is not only sent to endpoints registered to the user object, but also to the forking destination. If a mobility object is configured for the forking, the phone identified by the forking destination can use the mobility functions. A delay can be configured for the call to the mobile endpoint. This delay is not supported for normal call forking without mobility functions. Operator calls from a waiting queue require a UC license to be sent to forking destinations.

;No/Name: Forking destination, Mobility destination (the mobility destination must be a '''unique''' number, you cannot add the same number for different users)

;Bool/Not: The forking can be turned on and off by a Boolean object. With the '''Not''' checkmark the state is inverted.

== Properties of Mobility==

For the function of the Mobility features a Mobility license must be installed.

;Object: The [[Reference9:PBX/Objects/Mobility| Mobility]] Object (Long Name) must be set, if the mobile endpoint (GSM Phone) needs to use the [[Reference8:Administration/PBX/Objects/Mobility| mobility features]].
: Mobility license is required

;Device: The Device name of the User should be configured here (e.g. "Smartphone"). This name is used by SOAP (TAPI) to address this device for example when initiating a call, by myPBX to enable/disable Mobility for the User (on the Call Forward settings Screen of myPBX) and for Mobility Client OptiCaller for HTTP CallBack/CallThrough.

;App: Field that is used to configure the rcc app for callback feature available in the user profile App. To call the app just enter "rcc".

;Delay: A Delay in seconds can be configured to call the mobile endpoint.

;Disable: Disabling the Mobility features for the mobile device, this can also be en/disabled via [[Reference8:Administration/PBX/Objects/DTMF Features#Enable.2Fdisable mobility|DTMF featurecodes]]

;Call-Waiting: Enable or disable call-waiting for the mobile endpoint, if a mobile endpoint is in a call a call waiting tone will be played from the PBX to the mobile endpoint via the RTP stream. See [[Reference9:PBX/Objects/Mobility| R-Key Functions]] for waiting calls handling options.
: Mobility features are required

;GSM-License: When using the innovaphone GSM client a GSM license is needed and need to be activated. NB: obsolete

;Min-Alert: The minimum time in seconds a call must ring on the mobile phone until it can be accepted. If the call is accepted before this time, the call is rejected by the PBX. This way it can be achieved that the announcement from a mobile provider for phones not available does not accept a call and calls can be accepted on a fixed phone on the same number in case the mobile phone is switched off. The alert time is measured from the alert to the connect signalling. If there is no alert message (e.g. because there is a connect right away), the alert time is counted as null. '''Note: If the carrier doesn't send any Alert/180 Ringing, you may need to enable [[{{NAMESPACE}}:PBX/Objects/Mobility | Carrier w/o Alerting]] .'''
: Mobility features are required

;Max-Alert: Maximum time the mobile phone rings. After this time the PBX terminates the call to the mobile phone. This way it can be avoided that the mobile voicemail accepts the mobility call.
: Mobility features are required

[[Category:Concept App RCC|Related]]

Howto:PBX-Designer - K-Businesscom - Partner App

2026-04-09T08:45:12Z

Kpe: Replaced content with " ==Product Name==   This wiki is obsolete, please check this one instead [https://wiki.innovaphone.com/index.php?title=Howto:PBX-Designer_-_ITM_-_Partner_App Howto:PBX-Designer_-_ITM_-_Partner_App] ===Cloud === For cloud operators please see [https://wiki.innovaphone.com/index.php?title=Howto:Cloud-Designer_-_ITM_-_Partner_App Cloud-Designer] and [https://wik..."

==Product Name==


This wiki is obsolete, please check this one instead [https://wiki.innovaphone.com/index.php?title=Howto:PBX-Designer_-_ITM_-_Partner_App Howto:PBX-Designer_-_ITM_-_Partner_App]

===Cloud ===
For cloud operators please see [https://wiki.innovaphone.com/index.php?title=Howto:Cloud-Designer_-_ITM_-_Partner_App Cloud-Designer] and [https://wiki.innovaphone.com/index.php?title=Howto:Cloud-Manager_-_ITM_-_3rd_Party_Product Cloud-Manager]

Howto16r1:Firmware Upgrade V15r1 V16r1

2026-04-08T15:49:52Z

Kpe: /* Migration Policy */

== Applies To ==
This information applies to:

* All 16r1 capable innovaphone devices
: For a general overview of the upgrade process and a list of supported devices with 16r1, see [[Howto:Firmware Upgrade]]
== Licenses ==
In case of cloud or rental model, don't worry about licenses.

If the system is licensed on premise, you'll need to regenerate the license file for v16 in https://portal.innovaphone.com/ and load into the system before upgrade (The system needs to have the SSC up to date).

== Migration Policy ==
Before you begin, be sure that your whole installation is running the latest 15r1 service release. Create backups before you start and store them on an external location 

=== TechAssist Upgrade Helper ===
* Before you start, make sure that all TechAssist tests (you will receive the required tests in the last update in the previous major version) labelled <code>Pre Upgrade: xy</code> are positive, if available
* When you are finished, make sure that all TechAssist tests (you will receive new tests with the upgrade) are positive

=== New TLS Profile ===
Please note that we have changed our TLS profiles ([[Reference16r1:IP4/General/TLS]]). The new ''Normal'' setting, which is the default value, now only allows TLS 1.3 and TLS 1.2.

== Changes visible to the end customers ==
Listed here are changes that should be communicated by resellers to end users prior to a upgrade, as the change will be visible/audible in the behaviour of the application/device.

* ''Nothing''

== 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.

=== Connector for Microsoft 365 ===
If you plan to use the new '''Contact Search''' feature of the Connector for Microsoft 365, you need to perform two manual Steps:
# Create the '''microsoft365-api''' app object by using the Settings template
# Assign the '''microsoft365-api''' app object to every user who should be able to use the new Contact Search feature. (Of cause, you can use a template for that)
 
For a more detailed guide, please refer to the how-to article: [[Howto16r1:Configure Contact Search by Connector for Microsoft365#Creating the PBX app object using the PBX Manager Plugin]]

=== Remote Control ===
In order to use the Admin Configuration Panel of the Settings App – AP Remote Control, it is necessary to grant access to the '''admin''' API, available in the App tab of the Remote Control App object.

=== Working ===
For badge counts to work, the Working Manager app object must have '''Websocket''' and '''PbxSignal''' enabled.
For the Connect integration of the Working app, '''Websocket''', '''Services''' and '''Connect'''(in the Apps tab) must be enabled in the Working User app.

=== Switchboard ===
For the Connect Integration (Call Notes) to work, the Switchboard App must have the '''Services''' (App-tab) and '''connect''' and '''messages-api''' (Apps-tab) enabled.

== New Apps ==
New Apps will not be installed automatically by the upgrade. The installation description of new apps is usually in the concept article. Please rate per app whether you want to install/use the new app and configure it manually.

* App Polls: [[Reference16r1:Concept App Polls]]
* App Service Conference Transcriptions [[Reference16r1:Concept_App_Service_myApps_Assistant]]
* App Service Connector for Whatsapp: [[Reference16r1:Concept_App_Service_Connector_for_Whatsapp]]
* App Conference Scaler: [[Reference16r1:Concept_Conference_Scaler_App]]
* App Service IP: [[Reference16r1:Concept App Service IP]]

== Removed ==
The following software is no longer included.

* IP110A (can still be used with 15r1 firmware on current PBX versions)
* IP240A (can still be used with 15r1 firmware on current PBX versions)
* CA on CF card feature

== Deprecated ==
The following software is based on legacy technology, with no further development and limited maintenance and support.

* ''Nothing''

== 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.

* ''Nothing''

==Known Problems==
===Long Update-duration===
When you update, it can be up to 10 minutes before you have access to your app platform again.

== Related Articles ==
*[[Howto:Firmware_Upgrade]]
* [[Howto15r1:Firmware_Upgrade_V14r2_V15r1]]
[[Category:Howto|{{PAGENAME}}]]

Reference16r1:Concept App Service Queues

2026-04-08T14:11:52Z

Kpe: /* Right panel */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.''' 
When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Show Notes button in the Call History.''' 
Action key in the call history items to jump to the corresponding Notes in the Connect App.

'''Show fold/ unfold view for adjusting WQ height in Config''' 
changed design for configuring the showed Waiting Queue call section height.

'''Show Blf slider in Icons only view''' 
when selected the Icons only view of the BLF a slider will be shown.

'''Improved search funcionality.''' 
The improved search functionality is in line with the (Soft)Phone App search showing the source of the search result.

'''Improved search details.''' 
Improved the shown details from a search result and showing more info in the BLF entry details.

'''Create a popup box for already existing shortcuts.''' 
In case you enter a short cut that already excist, it will give you a warning that this shortcut is already created.

'''Fixed breakthrough option/button was not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Fix: Show CFx Icon on toggling from large to small Icon view''' 
Fixed to show the Call Forward Icon in the small view of the Busy Lamp Field.

'''Fix: Favorites did have less actions than other contacts in the BLF''' 
Fixed to show all possibile actions on the BLF entries in the favorites section

'''Fix Add option to fix WQ height in config''' 
Fixed added option to waiting queues height configuration

'''For further fixes to come with future service releases, please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;Services: to be able to connect to extra apis (eg connect/connect-api (*))
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

;Apps->messages-api: to be able to see/post call notes (*)

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed. The Notes Field when beeing used, will be on top off the Waiting Queues and Calls History section.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

==== Notes Field ====
During an active call you have the option to add a Note for this call and caller-id. The first notes information like name and/or number is added by the App service. You can add a personal note as additional information related to the call or caller-id.

The notes are stored in the Connect App in the zone Switchboard. To be able to see the Switchboard Notes from the service and other Switchboard operators, the Switchboard user should have read access to the zone Switchboard. To add personal notes to the discussion, the Switchboard User should also have the Connect App license (included in the UCC license)

In the call history you are also able to create, read and add notes.

With a new incoming call and there is already a note available for this caller-id, the note will be shown immediately in the right section of the screen.

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference15r1:Concept Push Notifications for iOS and Android

2026-03-23T09:18:45Z

Kpe: /* Customer uses HTTP-Proxy for Internet access */

[[Category:Concept|iOS Softwarephone]]
The PBX is able to send Push notifications to the Apple (APNs) or Android Push Notification services. As a result, incoming calls are also indicated when the myApps application is not started or runs in the background mode. The PBX is using a service provided by innovaphone AG at ''push.innovaphone.com'' to send the push notifications to the vendors Notification Service. No call meta data is transmitted, the push notification is only used to wake up the myApps application. Only one Push object is needed for a system.

== Requirements ==
=== PBX ===
* Firmware version 15r1 or higher
* Internet access via HTTPS
* device certificate (also on '''IPVAs''')
** this device certificate is not an own certificate, which you can upload yourself but which you need to retrieve through my.innovaphone (see [[#Initial configuration| Initial configuration]])!

=== Smartphone ===
* iOS Version 12.0.1 or higher
* Android Version 6.0 or higher

== Configuration ==
=== PBX ===
* verify that each pbx has the certificates <code>innovaphone Device Certification Authority 2</code> or the signed <code>push.innovaphone.com</code> in his local trust list. If you use the [[{{NAMESPACE}}:Concept App Service Devices#Certificates configuration|Devices - certificate trustlist concept]] the certificates will be installed automatically.
* create a PUSH object via the PBX manager,by clicking on the plugin Push (Black and White myApps symbol) The Plugin will create a PBX object in the PBX of type [[{{NAMESPACE}}:PBX/Objects/Push|Push]] per system, even in master/slave scenarios
** Name Push and SIP name push can be freely choosen, but the sip name must be used in the push field of user the objects. We advise leave the pre filled Standard names.
** the App URL must be <code>https://push.innovaphone.com/push/ws</code>
After clicking OK a green checkmark should appear, indicating that the Push object has a valid websocket connection to the innovaphone Push service.

=== User Objects ===
* For each user who is to receive push notifications on his myApps-application, the ''Name'' of the push-object must be entered in his userobject at the ''Push'' field in the ''User'' tab.

=== iOS specific settings ===
* On the iOS device make sure to allow push notifications for the myApps application.

=== Android specific settings ===

==How it works==
*First of all the mobile phone opens a connection to Apple or Google. If the phone is in a restricted Wi-Fi network (and has no GSM/LTE data connection to receive Push notifications), the appropriate ports of the firewall needs to opened as explained in the documentation of [https://support.apple.com/en-us/HT203609 apple] or [https://firebase.google.com/docs/cloud-messaging/concept-options#ports_and_your_firewall google].
*If the app is in the background and the user receives an incoming call, the App needs to be woken.
*Therefore the PBX sends a push request to innovaphones push servers (push.innovaphone.com)
*The communication is done with MTLS and our push servers check the client device certificate of the PBX
** the used certificate is the device certificate provided by innovaphone and not a certificate, which you can upload yourself
*push.innovaphone.com forwards the request to the Apple or Google Push service.
*The respective vendor sends the push request to the mobile phone and uses the ports opened in the first step.
*The app then registers at the PBX via H.323.
*In the last step the incoming call is sent (using the H.323 registration) to the mobile phone.

[[Image:push.gif|push.gif/|push.gif/]]

Note: the services.innovaphone.com in the picture must be replaced with push.innovaphone.com

=== Privacy ===
When using the Push service the PBX will send following data/information to [[Howto:Innovaphones public services|innovaphone]]:

* Notification Type (plain)
** ''call'' or ''notification''

* Detailed informations (enrypted)
** ''call''
*** number
*** name
*** callflow
** ''notification''
*** title
*** content

This information will send from the PBX to the Smartphone via the innovaphone Push-Service and forwarded to the Google/Apple push system. The Smartphone receives a decryption key via websocket or H323 (you have to use the secure version to transmit the key encrypted) from the PBX. Neither the push service at innovaphone nor the Apple / Google push system can read the encrypted information.

== Troubleshooting ==
=== Initial configuration ===
* Check the trust list for the certificate of the innovaphone AG.
* Make sure the PBX can resolve the DNS host ''push.innovaphone.com''.
* Make sure the PBX can reach ''push.innovaphone.com'' via HTTPS.
* Make sure that you have a innovaphone ''device certificate'' - even on '''IPVAs'''. The certificate is signed by ''innovaphone Device Certification Authority 2'' or on IPVAs since V14r1 by ''innovaphone Unverified Device CA''. If not, you can acquire a new one on the Gateway via [[{{NAMESPACE}}:General/License/my.innovaphone#Download_Certificate | General/License/my.innovaphone]]. '''This will not conflict with an existing certificate that you installed yourself on the gateway.'''
* Make sure the myApps application has Push Notifications allowed in the OS settings.
** iOS: Also make sure, the iOS device has a valid GSM data connection or a WiFi connection with the internet, especially TCP port 5223 (see [https://developer.apple.com/library/archive/technotes/tn2265/_index.html Troubleshooting Push Notifications] article by Apple).

=== Push looses connected state ===
* If the push object was already connected, and for some reason (after a firmware update or network connection problems), the object is not connected anymore, please check that PBX can reach and resolve "push.innovaphone.com" and the innovaphone AG certificate is still in the trust list.

===myApps for Android push configuration checks ===

[[Image:Troubleshoot_v13_Push_with_myApps_for_Android and iOS_1.jpg|troubleshoot_v13_push_with_myapps_for_android_and_ios_1.jpg/|troubleshoot_v13_push_with_myapps_for_android_and_ios_1.jpg/]]

Open myApps, and check you have a softphone app configured. Then tap on the "burger" menu on the top right, and check your default app is the softphone app.

Scroll down and tap on "More"
# Tap on "myApps events" and enable notification on the smartphone for myApps
# Tap on "Calling account" and enable myApps as call account
# Tap on "Data saver" and enable background data for myApps on the smartphone
# Tap on "Overlaying" and enable them on the smartphone

===myApps for iOS push configuration checks ===
Go through the following steps, to check that in your iPhone, Push is configured correctly.
#Open your iOS Settings app on your iPhone
#Go to the ''Notifications'' (German: Mitteilungen) section
#Find the myApps app and make sure notifications are allowed and that LockScreen, Notification Center and Banners are selected as Alerts 
For more information on howto enable Push notifications for an iOS-app, see also [https://support.apple.com/en-us/HT201925#If%20you%20don't%20see%20notifications%20for%20a%20specific%20app this Apple support page, section If you don't see notifications for a specific app]
===innovaphone Push Service check===
Consult [https://status.innovaphone.com/ innovaphone services overview] to check if any unexpected service outage concerning push exists

== Known limitations ==
=== Number to Name resolution on Android Push Notifications could be missing ===
On incoming call Push Notification to Android the caller number will be included, if the Number to name resolution it's not yet finished no name will be included in this Push notification just the number. The Android doesn't allow a number/name update of that call afterwards so it will remain displaying only the number till we terminate the call. On iOS we don't have such issue since the system allows update of the number/name during call.

=== Push does work even when the myApps app is switched off ===
The Push mechanism will also work when the myApps app is turned off. This can lead to complains about receiving calls after working ours or during holidays.
With myApps as client, you can set the status to DND Do Not Disturb. Then close the myApps.
This will prevent the App to be started by the Push mechanism.
To receive calls again, open the myApps clients and set the status back to available.

You can disable the Push to the myApps by just ending the session for this device by logging out of the myApps application or Alternative you can go to the Hamburger Menu, Account Security and logout the active session.
You can also remove a session from another device for example a myApps Session from another Smartphone or browser.
Deselecting a default Softphone app, will also prevent the Push mechanism.

=== Customer uses HTTP-Proxy for Internet access ===
The WebSocket client does not support HTTP-Proxy connections, more specific HTTP Tunneling using HTTP CONNECT - therefore Push notifications will not work. See also: [[{{NAMESPACE}}:Services/HTTP/Client#Proxy_Servers|Reference15r1:Services/HTTP/Client#Proxy_Servers]]

=== BC Conference Object does NOT trigger the push mechanism ===
The BC Conference Object is not able to trigger the push mechanism for smartphone users. In case you want to have smartphone users as participants in your BC Conference Object, you need to use the folowing workaround.

Create for evey user a dedicated waiting queue object and add the smartphone user as only member to the group of this dedicated waiting queue.

Instead of the user, you add the dedicated waiting queue as a member of the BC Conference Object group.

A BC Conference call will call the dedicated waiting queue and the waiting queue will call the smartphone user which also triggers the push mecahnism.

==Known issues==

===Cloning IPVAs===
If you clone an IPVA with an existing device certificate, you'll also clone this certificate, so you'll have a wrong serial number inside the certificate afterwards. 
So '''do not clone''' IPVAs but setup a new VM and upload a modified configuration file afterwards and create a new certificate for the new machine.

Currently it is not possible to update or delete the device certificate.

== Related Articles ==
* [[Howto:Innovaphones_public_services]]

Reference16r1:Concept App Service Queues

2026-03-16T09:34:15Z

Kpe: /* V16 Improvements */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.''' 
When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Show Notes button in the Call History.''' 
Action key in the call history items to jump to the corresponding Notes in the Connect App.

'''Show fold/ unfold view for adjusting WQ height in Config''' 
changed design for configuring the showed Waiting Queue call section height.

'''Show Blf slider in Icons only view''' 
when selected the Icons only view of the BLF a slider will be shown.

'''Improved search funcionality.''' 
The improved search functionality is in line with the (Soft)Phone App search showing the source of the search result.

'''Improved search details.''' 
Improved the shown details from a search result and showing more info in the BLF entry details.

'''Create a popup box for already existing shortcuts.''' 
In case you enter a short cut that already excist, it will give you a warning that this shortcut is already created.

'''Fixed breakthrough option/button was not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Fix: Show CFx Icon on toggling from large to small Icon view''' 
Fixed to show the Call Forward Icon in the small view of the Busy Lamp Field.

'''Fix: Favorites did have less actions than other contacts in the BLF''' 
Fixed to show all possibile actions on the BLF entries in the favorites section

'''Fix Add option to fix WQ height in config''' 
Fixed added option to waiting queues height configuration

'''For further fixes to come with future service releases, please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference16r1:Concept App Service Queues

2026-03-16T09:31:57Z

Kpe: /* V16 Improvements */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.''' 
When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Show Notes button in the Call History.'''

Action key in the call history items to jump to the corresponding Notes in the Connect App.

'''Show fold/ unfold view for adjusting WQ height in Config'''

changed design for configuring the showed Waiting Queue call section height.

'''Show Blf slider in Icons only view'''

when selected the Icons only view of the BLF a slider will be shown.

'''Improved search funcionality.'''

The improved search functionality is in line with the (Soft)Phone App search showing the source of the search result.

'''Improved search details.'''

Improved the shown details from a search result and showing more info in the BLF entry details.

'''Create a popup box for already existing shortcuts.'''

In case you enter a short cut that already excist, it will give you a warning that this shortcut is already created.

'''Fixed breakthrough option/button was not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Fix: Show CFx Icon on toggling from large to small Icon view'''

Fixed to show the Call Forward Icon in the small view of the Busy Lamp Field.

'''Fix: Favorites did have less actions than other contacts in the BLF'''

Fixed to show all possibile actions on the BLF entries in the favorites section

'''Fix Add option to fix WQ height in config'''

Fixed added option to waiting queues height configuration

'''For further fixes to come with future service releases, please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference16r1:Concept App Service Queues

2026-03-16T09:29:41Z

Kpe: /* V16 Improvements */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.''' 
When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Show Notes button in the Call History.'''

Action key in the call history items to jump to the corresponding Notes in the Connect App.

'''Show fold/ unfold view for adjusting WQ height in Config'''

changed design for configuring the showed Waiting Queue call section height.

'''Show Blf slider in Icons only view'''

when selected the Icons only view of the BLF a slider will be shown.

'''Improved search funcionality.'''

The improved search functionality is in line with the (Soft)Phone App search showing the source of the search result.

'''Improved search details.'''

Improved the shown details from a search result and showing more info in the BLF entry details.

'''Create a popup box for already existing shortcuts.'''

In case you enter a short cut that already excist, it will give you a warning that this shortcut is already created.

'''ed.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Fix: Show CFx Icon on toggling from large to small Icon view'''

Fixed to show the Call Forward Icon in the small view of the Busy Lamp Field.

'''Fix: Favorites did have less actions than other contacts in the BLF'''

Fixed to show all possibile actions on the BLF entries in the favorites section

'''Fix Add option to fix WQ height in config'''

Fixed added option to waiting queues height configuration

'''For further fixes to come with future service releases, please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Howto:How to Reset IPXXX

2026-02-20T11:32:10Z

Kpe: /* More Information */

==Summary==
Reset options for innovaphone devices

==Applies To==
This information applies to

* All innovaphone products with the latest boot code.


==More Information==
Different options resetting innovaphone devices.

* bringing to Factory default
* bringing to TFTP mode for GWLoad
* clearing config
* explaining the LED behavior

Additional Information for the following table, TFTP-Mode or TFTP-Mode + FACTORY RESET for the phones IP110, IP150, IP200, IP202, IP230, IP240

Seperating the phone from the power, press the Key/Button, keep on pressing the Key/Button, plug in the PSU or ethernet cable (in case of PoE), watch the status of the device (table: visual display), release the Key/Button after time shown in the table. If you want to reanimate this devices now with GWLoad, do not powercycle the device again. If the factory reset was successful the device is now in the defined TFTP-Mode and ready for GWLoad. If you just wanted to factory reset the device you can do a powercycle for sure.

If the factory reset was not successful please contact rma@innovaphone.com

or look at [[Howto:Get Access to Gateways if the Assistant doesn't boot the Device]].

{| border=1
!Device (visual display)
!Reset Button/Key
!Button pressed
!Clear Config
Firmware
Boot code update
!Pressing Button to TFTP without deleting config in seconds ca.
!Pressing Button to factory reset in seconds ca.
!GWLoad- / TFTP-Mode
!Firmware starting
!Firmware ready
!Firmware Error
|----
|IP21
(all LED's)
|Button
|ready: <5s blink, >5s constant flash

line1 + line2 + door + aux constant flash / link + act off

with plugged in ethernet cable 100M + link: <3s off, >3s normal operating state
|...

ready fast blink, line1 + line2 + door + aux off link + 100M normal operating

|3
|25
|all LED’s are constant flashing

link is blinking
|ready + line1/2 + door + aux + 100M (if link)

permanent for ca. 5s

link blinking
|ready + 100M (if link)

link blinking
|
|----
|IP400
(all LED’s)
|Button
|PPP+Tel.1+Tel.2: <5s blink, [5;8] constant flash, >8 ready + link + act constant flash

without ethernet cable plugged in: <8s off, 8s one blink, >8s off
|
|3
|25
|ready + link + act flashing constant
|<8 ready + PPP + tel1 + tel2 constant flash,

[3;10] link + act. uncoordinated flashing

>10s ready + link (if link) constant act. blinking
|ready + 100M (if link)

link blinking
|
|----
|IP3000
(all LED’s)
|Button
|<6s PRI1+PRI2+S/T+ready blink, [6;10] PRI1 + PRI2 + S/T + ready constant flash,

act + speed + link off

>10s PRI1 + PRI2 + S/T constant flash, ready + act + speed + link off

with ethernet cable plugged in: act + speed + link normal working state
|fast blink (green)
|3
|25
|all LED’s flashing permanent

ready off

link blinking
|>2 link + speed constant flashing, act blinking

<5s PRI1 + PRI2 + S/T constant flash

>5s ready constant flash, (if link) link + speed constant flashing, act blinking
|ready constant flash, (if link) link + speed constant flashing, act blinking
|blinking (green)
|----
|IP800/IP6000/IPx010
(red/green/orange ready LED )
|Button
|<6 slow gn blink

[6;10] constant red

[10;13] fast gn blink

<13 constant orange
|fast blink (green)
|3
|15 (IP800)

15-20 (IP6000/IPx010)
|constant orange
|red
|green
|blinking (red)
|----
|IP1200
|Button
|<2s alarm red constant flash, ready off

[2;7] alarm off, ready slow blink green

[7;13] alarm off, ready fast blink green

>13s alarm off, ready 2 Hz blink green
|fast blink
|3
|10
|slow flash ca. 2 Hz
|<2s alarm red constant flash

ready green constant flash

power orange constant flash

[2;4] alarm off, ready off, power orange

>4s alarm off, ready constant green flash, power constant green flash
|ready constant green flash and power constant orange flash
|alarm (red)
|----
|IP1202/IP1203
|Button
|<3s LED off

[3;10] LED blink fast blue 1 sec

>10s LED blink fast blue 1 sec,
than blink slow blue until factory reset completed,
than constant yellow/amber
|fast blink in blue
|3
|10
|constant yellow/amber
|LED red until firmware lstarted

LED blink fast red until ethernet link up

LED blink fast blue until Air Sync established

LED constant blue if Air Sync OK

|LED constant blue
|LED constant red
|----
|IP200/IP202
(red handset)
|alt key
|slow blink
|slow blink
|3
|5
|constant flash
|slow blink
|off
|constant flash
|----
|IP200A/IP210
(red handset)
|alt key
|slow blink
|fast blink
|3
|15
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP110
(LED’s in F1 key)
|save key
|slow blink
|F1 off
|3
|10 - 15
|slow flash
ca. 2 Hz
|constant F1 flash
|off
|blinking
|----
|IP101
(MWI LED)
|backspace key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP102
(MWI LED)
|backspace key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP111
(MWI LED)
|home key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP112
(MWI LED)
|home key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP150
|menu key
|press key when power cycle, hold till display flashing and goes off. Power cycle again
|
|
|
|
|
|
|
|----
|IP160
|star key
|press key when power cycle, hold ca 15 sec till display is on
|
|
|
|
|
|
|
|-
|IP17x
|button
|press button on PCB board when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP230
(menu key)
|menu key
|slow blink
|fast blink
|3
|10
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP240
(menu key)
|menu key
|slow blink
|fast blink
|3
|10
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP241
(menu key)
|alt key
|slow blink
|fast blink
|3
|10
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP222
(MWI LED)
|ESC key or Home key
|slow blink
|fast blink
|3
|15
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP232
(MWI LED)
|ESC key or Home key
|slow blink
|fast blink
|3
|15
|slow flash
ca. 2 Hz
|on
|off
|blinking
|-
|IP270
|Home key
|press key when power cycle, hold until LED remains steady
|
|
|
|
|
|
|
|}

== Related Articles ==
* [[Howto:How to use gwload]]
* [[Howto:How_to_Reset_IPXXX_(V10...)]]

[[Category:Howto|{{PAGENAME}}]]

Howto:How to Reset IPXXX

2026-02-20T11:31:04Z

Kpe: /* More Information */

==Summary==
Reset options for innovaphone devices

==Applies To==
This information applies to

* All innovaphone products with the latest boot code.


==More Information==
Different options resetting innovaphone devices.

* bringing to Factory default
* bringing to TFTP mode for GWLoad
* clearing config
* explaining the LED behavior

Additional Information for the following table, TFTP-Mode or TFTP-Mode + FACTORY RESET for the phones IP110, IP150, IP200, IP202, IP230, IP240

Seperating the phone from the power, press the Key/Button, keep on pressing the Key/Button, plug in the PSU or ethernet cable (in case of PoE), watch the status of the device (table: visual display), release the Key/Button after time shown in the table. If you want to reanimate this devices now with GWLoad, do not powercycle the device again. If the factory reset was successful the device is now in the defined TFTP-Mode and ready for GWLoad. If you just wanted to factory reset the device you can do a powercycle for sure.

If the factory reset was not successful please contact rma@innovaphone.com

or look at [[Howto:Get Access to Gateways if the Assistant doesn't boot the Device]].

{| border=1
!Device (visual display)
!Reset Button/Key
!Button pressed
!Clear Config
Firmware
Boot code update
!Pressing Button to TFTP without deleting config in seconds ca.
!Pressing Button to factory reset in seconds ca.
!GWLoad- / TFTP-Mode
!Firmware starting
!Firmware ready
!Firmware Error
|----
|IP21
(all LED's)
|Button
|ready: <5s blink, >5s constant flash

line1 + line2 + door + aux constant flash / link + act off

with plugged in ethernet cable 100M + link: <3s off, >3s normal operating state
|...

ready fast blink, line1 + line2 + door + aux off link + 100M normal operating

|3
|25
|all LED’s are constant flashing

link is blinking
|ready + line1/2 + door + aux + 100M (if link)

permanent for ca. 5s

link blinking
|ready + 100M (if link)

link blinking
|
|----
|IP400
(all LED’s)
|Button
|PPP+Tel.1+Tel.2: <5s blink, [5;8] constant flash, >8 ready + link + act constant flash

without ethernet cable plugged in: <8s off, 8s one blink, >8s off
|
|3
|25
|ready + link + act flashing constant
|<8 ready + PPP + tel1 + tel2 constant flash,

[3;10] link + act. uncoordinated flashing

>10s ready + link (if link) constant act. blinking
|ready + 100M (if link)

link blinking
|
|----
|IP3000
(all LED’s)
|Button
|<6s PRI1+PRI2+S/T+ready blink, [6;10] PRI1 + PRI2 + S/T + ready constant flash,

act + speed + link off

>10s PRI1 + PRI2 + S/T constant flash, ready + act + speed + link off

with ethernet cable plugged in: act + speed + link normal working state
|fast blink (green)
|3
|25
|all LED’s flashing permanent

ready off

link blinking
|>2 link + speed constant flashing, act blinking

<5s PRI1 + PRI2 + S/T constant flash

>5s ready constant flash, (if link) link + speed constant flashing, act blinking
|ready constant flash, (if link) link + speed constant flashing, act blinking
|blinking (green)
|----
|IP800/IP6000/IPx010
(red/green/orange ready LED )
|Button
|<6 slow gn blink

[6;10] constant red

[10;13] fast gn blink

<13 constant orange
|fast blink (green)
|3
|15 (IP800)

15-20 (IP6000/IPx010)
|constant orange
|red
|green
|blinking (red)
|----
|IP1200
|Button
|<2s alarm red constant flash, ready off

[2;7] alarm off, ready slow blink green

[7;13] alarm off, ready fast blink green

>13s alarm off, ready 2 Hz blink green
|fast blink
|3
|10
|slow flash ca. 2 Hz
|<2s alarm red constant flash

ready green constant flash

power orange constant flash

[2;4] alarm off, ready off, power orange

>4s alarm off, ready constant green flash, power constant green flash
|ready constant green flash and power constant orange flash
|alarm (red)
|----
|IP1202/IP1203
|Button
|<3s LED off

[3;10] LED blink fast blue 1 sec

>10s LED blink fast blue 1 sec,
than blink slow blue until factory reset completed,
than constant yellow/amber
|fast blink in blue
|3
|10
|constant yellow/amber
|LED red until firmware lstarted

LED blink fast red until ethernet link up

LED blink fast blue until Air Sync established

LED constant blue if Air Sync OK

|LED constant blue
|LED constant red
|----
|IP200/IP202
(red handset)
|alt key
|slow blink
|slow blink
|3
|5
|constant flash
|slow blink
|off
|constant flash
|----
|IP200A/IP210
(red handset)
|alt key
|slow blink
|fast blink
|3
|15
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP110
(LED’s in F1 key)
|save key
|slow blink
|F1 off
|3
|10 - 15
|slow flash
ca. 2 Hz
|constant F1 flash
|off
|blinking
|----
|IP101
(MWI LED)
|backspace key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP102
(MWI LED)
|backspace key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP111
(MWI LED)
|home key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP112
(MWI LED)
|home key
|press key when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP150
|menu key
|press key when power cycle, hold till display flashing and goes off. Power cycle again
|
|
|
|
|
|
|
|----
|IP160
|star key
|press key when power cycle, hold ca 15 sec till display is on
|
|
|
|
|
|
|
|-
|IP17x
|button
|press button when power cycle, hold ca 10 sec till led flashing. Power cycle again when slow blink
|
|
|
|
|
|
|
|----
|IP230
(menu key)
|menu key
|slow blink
|fast blink
|3
|10
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP240
(menu key)
|menu key
|slow blink
|fast blink
|3
|10
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP241
(menu key)
|alt key
|slow blink
|fast blink
|3
|10
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP222
(MWI LED)
|ESC key or Home key
|slow blink
|fast blink
|3
|15
|slow flash
ca. 2 Hz
|on
|off
|blinking
|----
|IP232
(MWI LED)
|ESC key or Home key
|slow blink
|fast blink
|3
|15
|slow flash
ca. 2 Hz
|on
|off
|blinking
|-
|IP270
|Home key
|press key when power cycle, hold until LED remains steady
|
|
|
|
|
|
|
|}

== Related Articles ==
* [[Howto:How to use gwload]]
* [[Howto:How_to_Reset_IPXXX_(V10...)]]

[[Category:Howto|{{PAGENAME}}]]

Howto:Update innovaphone.com Wildcard-Certificate in a Device Trustlist

2026-02-05T14:58:50Z

Kpe: /* Applies To */

'''This article is obsolete for the push service, please see [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com]]'''

==Applies To==
This information applies to
* All innovaphone IP-Phones and -Gateways with 12r2, 13r3, 14r1, 14r2 firmware and > V15r1 firmware and no Devices certificate deployment configured.

==More Information==

===Problem Details===
On the end date of the current certificate <code>*.innovaphone.com</code> it will expire. '''We will renew this certificate every year on time.''' This certificate is used in the PBX trust list to establish an encrypted connection between your PBX and the innovaphone services.
To ensure that a service also works for your customers after the excisting certificate end date, a new vlid certificate must be added to the trust list of the respective PBX.
After the excisting certificate end date, the old <code>*.innovaphone.com</code> certificate can be deleted.
This certificate is currently only relevant for gateways on which a service connection to innovaphone is established. During the transition period of the release of a new certificate and the end date of the old certificate, both <code>*.innovaphone.com</code> certificates are required.

Additionally, every time an innovaphone devices is restarted, the current <code>*.innovaphone.com</code> certificate generates a [[Reference9:Event/0x000c1001| x509: A certificate has expired or will expire soon]] event.

'''If you use the [[Reference14r2:Concept App Service Devices#Certificates configuration|Devices - certificate trustlist concept]] you are not affected, and the certificate will be installed automatically.'''

===Resolution===
Here are three ways to replace the certificate on all innovaphone devices.

1. In the version 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 the certificate will be added automatically during the update.
After the old certificate end date, it can be manually deleted. Also, current firmware includes a mechanism to prevent ''Certificate expiration events'' in case that a new certificate exists for the same CN.
Finally, devices with 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 firmware will have after a factory reset only the new *.innovaphone.com certificate.

2. The certificate can be added manually on the PBX. It can be downloaded [[:File:Star innovaphone cert 2025.zip|here]] and then be uploaded on the PBX under [[Reference14r2:General/Certificates&action=edit&redlink=1|General/Certificates/Trust list]].
After 27.12.2024, the old certificate can be manually deleted.

3. The new certificate can be added, and the old certificate can be deleted via commands (which can be sent using an update server or the [[Reference14r2:Concept App Service Devices#Expert configuration| Expert configuration]] in ''Devices''). This needs a reboot of the device.
Save the new certificate in the trust list:
!vars create X509/TRUSTED pba 3082063e30820526a00302010202107ac11bffa149788852b63d5a31ce0959300d06092a864886f70d01010b050030818f310b3009060355040613024742311b30190603550408131247726561746572204d616e636865737465723110300e0603550407130753616c666f726431183016060355040a130f5365637469676f204c696d69746564313730350603550403132e5365637469676f2052534120446f6d61696e2056616c69646174696f6e2053656375726520536572766572204341301e170d3234313132393030303030305a170d3235313233303233353935395a301c311a301806035504030c112a2e696e6e6f766170686f6e652e636f6d30820122300d06092a864886f70d01010105000382010f003082010a0282010100b94fa779dc824ea7e561d83ed2f2b3fd293752832526af285af8e728668323b3d7444e724dbd4a2792998c0eabbac0ec1fcb1ebc7db5dcb174cd74a8aa9763e3eeb2541f2302bcad45b3f4d09a95876ef15e670db519f5bd0b5092389f995e8e0a9241ee462fd34d3af41df4693b571b1bf1dfb4a74ab5a70e68e87c2c12c0e3be5b408ec4d61099f79338dcfa73277d4a237065946795753edb89c9f234329a7b5a47ebc87e86f779281b9381072e1db4f57a3b9f8df67bf65e6090d2ea2ab93deb0b9013b0f762977726c6708b33137d599f82c15c2d72a76e568e22a3fb717c9ddbc9e33b12aacb9fcb543df52f3520f117d0647617801a24d651709645fd0203010001a382030630820302301f0603551d230418301680148d8c5ec454ad8ae177e99bf99b05e1b8018d61e1301d0603551d0e04160414172bc6fe5fa1ed78d9f49257924a714a950d4503300e0603551d0f0101ff0404030205a0300c0603551d130101ff04023000301d0603551d250416301406082b0601050507030106082b0601050507030230490603551d20044230403034060b2b06010401b231010202073025302306082b06010505070201161768747470733a2f2f7365637469676f2e636f6d2f4350533008060667810c01020130818406082b0601050507010104783076304f06082b060105050730028643687474703a2f2f6372742e7365637469676f2e636f6d2f5365637469676f525341446f6d61696e56616c69646174696f6e53656375726553657276657243412e637274302306082b060105050730018617687474703a2f2f6f6373702e7365637469676f2e636f6d302d0603551d110426302482112a2e696e6e6f766170686f6e652e636f6d820f696e6e6f766170686f6e652e636f6d30820180060a2b06010401d679020402048201700482016c016a007700dddcca3495d7e11605e79532fac79ff83d1c50dfdb003a1412760a2cacbbc82a00000193788b6e35000004030048304602210095e474cfc8cb1391e90503117fbb02b3f218adc046ad654a742c554cea1aabb50221009ec6324267f294e3fd82042edc4f75b3d5045186a2c8d7a132cfb930040e6813007700ccfb0f6a85710965fe959b53cee9b27c22e9855c0d978db6a97e54c0fe4c0db000000193788b6df6000004030048304602210096c02ff89884ff81f1d1e06965cc8639e5775eda2548cdf6f1492fe9388edf1a022100f67955e0066763ba7f23020130fe625f9c41cbe5f49626ca71076202ffdece3300760012f14e34bd53724c840619c38f3f7a13f8e7b56287889c6d300584ebe586263a00000193788b6dd50000040300473045022100abec85798805aafecc03b4b9b6e0dbb2beab28b9a5d36ed5021a4fb40e477ed40220131255263bdf66bc618f9f531dedb249c30c6b5f98be23ced37100c7166571c2300d06092a864886f70d01010b05000382010100592acc609c02195145ee6abf875f3ced94e039f83e2f88022013ea40c65ae4738d80a07e518a28f996726422fefa2f53d04aa3635fe98c4c882132f86d92924bace80c185f6fea710bbf48ce12da24440651e6b58cf4f2101634a4c6ca506ea0a75a00266eca09f275d3389ae673fb48e9b587477ba642f95000b4331dd682426be4ac59dfc8e859f8771d1bf98fe7a95dade3f53844c774376f4ca2067953202ac4e1089bd179f124f3eac09d020eadf36b1b018caece0f7159c279801358f9b9b6f15e0d92b4784f5f49ba343b36baa1faab04ab29d6377ba2f9b8760b4a8ae88009de395c580ad97518697cb3a950762fe218b6d965a46eb0c6733f2017f7

Remove old certificate (optional):
!mod cmd X509 form /item-trusted-3ccaa98ee59e6fd2ae91299fab78970d4f9f39a37eed987b32982e6a8a201afb70f7068f on /trusted-delete Remove

===Additional Recommendation===

If you are still connected to the ''old'' push-service (services.innovaphone.com), we recommend switching to the new push-service described in the [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com| Push Migration (Shutdown planned for 31.12.2024)]]. We currently evaluate to change the certificate used on the push-service to an innovaphone CA-signed one, with a longer duration time.

== Related Articles ==
* [[Howto13r2:12r2/13r1_legacy_push_server_will_be_migrated_to_push.innovaphone.com]]
* [[Reference15r1:Concept App Service Devices#Certificates configuration]]

[[Category:Howto|{{PAGENAME}}]]

Howto:Update innovaphone.com Wildcard-Certificate in a Device Trustlist

2026-02-05T14:40:34Z

Kpe: /* Resolution */

'''This article is obsolete for the push service, please see [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com]]'''

==Applies To==
This information applies to
* All innovaphone IP-Phones and -Gateways with 12r2, 13r3, 14r1, 14r2, V15r1 firmware and no Devices certificate deployment configured.

==More Information==

===Problem Details===
On the end date of the current certificate <code>*.innovaphone.com</code> it will expire. '''We will renew this certificate every year on time.''' This certificate is used in the PBX trust list to establish an encrypted connection between your PBX and the innovaphone services.
To ensure that a service also works for your customers after the excisting certificate end date, a new vlid certificate must be added to the trust list of the respective PBX.
After the excisting certificate end date, the old <code>*.innovaphone.com</code> certificate can be deleted.
This certificate is currently only relevant for gateways on which a service connection to innovaphone is established. During the transition period of the release of a new certificate and the end date of the old certificate, both <code>*.innovaphone.com</code> certificates are required.

Additionally, every time an innovaphone devices is restarted, the current <code>*.innovaphone.com</code> certificate generates a [[Reference9:Event/0x000c1001| x509: A certificate has expired or will expire soon]] event.

'''If you use the [[Reference14r2:Concept App Service Devices#Certificates configuration|Devices - certificate trustlist concept]] you are not affected, and the certificate will be installed automatically.'''

===Resolution===
Here are three ways to replace the certificate on all innovaphone devices.

1. In the version 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 the certificate will be added automatically during the update.
After the old certificate end date, it can be manually deleted. Also, current firmware includes a mechanism to prevent ''Certificate expiration events'' in case that a new certificate exists for the same CN.
Finally, devices with 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 firmware will have after a factory reset only the new *.innovaphone.com certificate.

2. The certificate can be added manually on the PBX. It can be downloaded [[:File:Star innovaphone cert 2025.zip|here]] and then be uploaded on the PBX under [[Reference14r2:General/Certificates&action=edit&redlink=1|General/Certificates/Trust list]].
After 27.12.2024, the old certificate can be manually deleted.

3. The new certificate can be added, and the old certificate can be deleted via commands (which can be sent using an update server or the [[Reference14r2:Concept App Service Devices#Expert configuration| Expert configuration]] in ''Devices''). This needs a reboot of the device.
Save the new certificate in the trust list:
!vars create X509/TRUSTED pba 3082063e30820526a00302010202107ac11bffa149788852b63d5a31ce0959300d06092a864886f70d01010b050030818f310b3009060355040613024742311b30190603550408131247726561746572204d616e636865737465723110300e0603550407130753616c666f726431183016060355040a130f5365637469676f204c696d69746564313730350603550403132e5365637469676f2052534120446f6d61696e2056616c69646174696f6e2053656375726520536572766572204341301e170d3234313132393030303030305a170d3235313233303233353935395a301c311a301806035504030c112a2e696e6e6f766170686f6e652e636f6d30820122300d06092a864886f70d01010105000382010f003082010a0282010100b94fa779dc824ea7e561d83ed2f2b3fd293752832526af285af8e728668323b3d7444e724dbd4a2792998c0eabbac0ec1fcb1ebc7db5dcb174cd74a8aa9763e3eeb2541f2302bcad45b3f4d09a95876ef15e670db519f5bd0b5092389f995e8e0a9241ee462fd34d3af41df4693b571b1bf1dfb4a74ab5a70e68e87c2c12c0e3be5b408ec4d61099f79338dcfa73277d4a237065946795753edb89c9f234329a7b5a47ebc87e86f779281b9381072e1db4f57a3b9f8df67bf65e6090d2ea2ab93deb0b9013b0f762977726c6708b33137d599f82c15c2d72a76e568e22a3fb717c9ddbc9e33b12aacb9fcb543df52f3520f117d0647617801a24d651709645fd0203010001a382030630820302301f0603551d230418301680148d8c5ec454ad8ae177e99bf99b05e1b8018d61e1301d0603551d0e04160414172bc6fe5fa1ed78d9f49257924a714a950d4503300e0603551d0f0101ff0404030205a0300c0603551d130101ff04023000301d0603551d250416301406082b0601050507030106082b0601050507030230490603551d20044230403034060b2b06010401b231010202073025302306082b06010505070201161768747470733a2f2f7365637469676f2e636f6d2f4350533008060667810c01020130818406082b0601050507010104783076304f06082b060105050730028643687474703a2f2f6372742e7365637469676f2e636f6d2f5365637469676f525341446f6d61696e56616c69646174696f6e53656375726553657276657243412e637274302306082b060105050730018617687474703a2f2f6f6373702e7365637469676f2e636f6d302d0603551d110426302482112a2e696e6e6f766170686f6e652e636f6d820f696e6e6f766170686f6e652e636f6d30820180060a2b06010401d679020402048201700482016c016a007700dddcca3495d7e11605e79532fac79ff83d1c50dfdb003a1412760a2cacbbc82a00000193788b6e35000004030048304602210095e474cfc8cb1391e90503117fbb02b3f218adc046ad654a742c554cea1aabb50221009ec6324267f294e3fd82042edc4f75b3d5045186a2c8d7a132cfb930040e6813007700ccfb0f6a85710965fe959b53cee9b27c22e9855c0d978db6a97e54c0fe4c0db000000193788b6df6000004030048304602210096c02ff89884ff81f1d1e06965cc8639e5775eda2548cdf6f1492fe9388edf1a022100f67955e0066763ba7f23020130fe625f9c41cbe5f49626ca71076202ffdece3300760012f14e34bd53724c840619c38f3f7a13f8e7b56287889c6d300584ebe586263a00000193788b6dd50000040300473045022100abec85798805aafecc03b4b9b6e0dbb2beab28b9a5d36ed5021a4fb40e477ed40220131255263bdf66bc618f9f531dedb249c30c6b5f98be23ced37100c7166571c2300d06092a864886f70d01010b05000382010100592acc609c02195145ee6abf875f3ced94e039f83e2f88022013ea40c65ae4738d80a07e518a28f996726422fefa2f53d04aa3635fe98c4c882132f86d92924bace80c185f6fea710bbf48ce12da24440651e6b58cf4f2101634a4c6ca506ea0a75a00266eca09f275d3389ae673fb48e9b587477ba642f95000b4331dd682426be4ac59dfc8e859f8771d1bf98fe7a95dade3f53844c774376f4ca2067953202ac4e1089bd179f124f3eac09d020eadf36b1b018caece0f7159c279801358f9b9b6f15e0d92b4784f5f49ba343b36baa1faab04ab29d6377ba2f9b8760b4a8ae88009de395c580ad97518697cb3a950762fe218b6d965a46eb0c6733f2017f7

Remove old certificate (optional):
!mod cmd X509 form /item-trusted-3ccaa98ee59e6fd2ae91299fab78970d4f9f39a37eed987b32982e6a8a201afb70f7068f on /trusted-delete Remove

===Additional Recommendation===

If you are still connected to the ''old'' push-service (services.innovaphone.com), we recommend switching to the new push-service described in the [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com| Push Migration (Shutdown planned for 31.12.2024)]]. We currently evaluate to change the certificate used on the push-service to an innovaphone CA-signed one, with a longer duration time.

== Related Articles ==
* [[Howto13r2:12r2/13r1_legacy_push_server_will_be_migrated_to_push.innovaphone.com]]
* [[Reference15r1:Concept App Service Devices#Certificates configuration]]

[[Category:Howto|{{PAGENAME}}]]

Howto:Update innovaphone.com Wildcard-Certificate in a Device Trustlist

2026-02-05T14:38:51Z

Kpe: /* Related Articles */

'''This article is obsolete for the push service, please see [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com]]'''

==Applies To==
This information applies to
* All innovaphone IP-Phones and -Gateways with 12r2, 13r3, 14r1, 14r2, V15r1 firmware and no Devices certificate deployment configured.

==More Information==

===Problem Details===
On the end date of the current certificate <code>*.innovaphone.com</code> it will expire. '''We will renew this certificate every year on time.''' This certificate is used in the PBX trust list to establish an encrypted connection between your PBX and the innovaphone services.
To ensure that a service also works for your customers after the excisting certificate end date, a new vlid certificate must be added to the trust list of the respective PBX.
After the excisting certificate end date, the old <code>*.innovaphone.com</code> certificate can be deleted.
This certificate is currently only relevant for gateways on which a service connection to innovaphone is established. During the transition period of the release of a new certificate and the end date of the old certificate, both <code>*.innovaphone.com</code> certificates are required.

Additionally, every time an innovaphone devices is restarted, the current <code>*.innovaphone.com</code> certificate generates a [[Reference9:Event/0x000c1001| x509: A certificate has expired or will expire soon]] event.

'''If you use the [[Reference14r2:Concept App Service Devices#Certificates configuration|Devices - certificate trustlist concept]] you are not affected, and the certificate will be installed automatically.'''

===Resolution===
Here are three ways to replace the certificate on all innovaphone devices.

1. In the version 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 the certificate will be added automatically during the update.
After 27.12.2024 the old certificate can be manually deleted. Also, current firmware includes a mechanism to prevent ''Certificate expiration events'' in case that a new certificate exists for the same CN.
Finally, devices with 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 firmware will have after a factory reset only the new *.innovaphone.com certificate.

2. The certificate can be added manually on the PBX. It can be downloaded [[:File:Star innovaphone cert 2025.zip|here]] and then be uploaded on the PBX under [[Reference14r2:General/Certificates&action=edit&redlink=1|General/Certificates/Trust list]].
After 27.12.2024, the old certificate can be manually deleted.

3. The new certificate can be added, and the old certificate can be deleted via commands (which can be sent using an update server or the [[Reference14r2:Concept App Service Devices#Expert configuration| Expert configuration]] in ''Devices''). This needs a reboot of the device.
Save the new certificate in the trust list:
!vars create X509/TRUSTED pba 3082063e30820526a00302010202107ac11bffa149788852b63d5a31ce0959300d06092a864886f70d01010b050030818f310b3009060355040613024742311b30190603550408131247726561746572204d616e636865737465723110300e0603550407130753616c666f726431183016060355040a130f5365637469676f204c696d69746564313730350603550403132e5365637469676f2052534120446f6d61696e2056616c69646174696f6e2053656375726520536572766572204341301e170d3234313132393030303030305a170d3235313233303233353935395a301c311a301806035504030c112a2e696e6e6f766170686f6e652e636f6d30820122300d06092a864886f70d01010105000382010f003082010a0282010100b94fa779dc824ea7e561d83ed2f2b3fd293752832526af285af8e728668323b3d7444e724dbd4a2792998c0eabbac0ec1fcb1ebc7db5dcb174cd74a8aa9763e3eeb2541f2302bcad45b3f4d09a95876ef15e670db519f5bd0b5092389f995e8e0a9241ee462fd34d3af41df4693b571b1bf1dfb4a74ab5a70e68e87c2c12c0e3be5b408ec4d61099f79338dcfa73277d4a237065946795753edb89c9f234329a7b5a47ebc87e86f779281b9381072e1db4f57a3b9f8df67bf65e6090d2ea2ab93deb0b9013b0f762977726c6708b33137d599f82c15c2d72a76e568e22a3fb717c9ddbc9e33b12aacb9fcb543df52f3520f117d0647617801a24d651709645fd0203010001a382030630820302301f0603551d230418301680148d8c5ec454ad8ae177e99bf99b05e1b8018d61e1301d0603551d0e04160414172bc6fe5fa1ed78d9f49257924a714a950d4503300e0603551d0f0101ff0404030205a0300c0603551d130101ff04023000301d0603551d250416301406082b0601050507030106082b0601050507030230490603551d20044230403034060b2b06010401b231010202073025302306082b06010505070201161768747470733a2f2f7365637469676f2e636f6d2f4350533008060667810c01020130818406082b0601050507010104783076304f06082b060105050730028643687474703a2f2f6372742e7365637469676f2e636f6d2f5365637469676f525341446f6d61696e56616c69646174696f6e53656375726553657276657243412e637274302306082b060105050730018617687474703a2f2f6f6373702e7365637469676f2e636f6d302d0603551d110426302482112a2e696e6e6f766170686f6e652e636f6d820f696e6e6f766170686f6e652e636f6d30820180060a2b06010401d679020402048201700482016c016a007700dddcca3495d7e11605e79532fac79ff83d1c50dfdb003a1412760a2cacbbc82a00000193788b6e35000004030048304602210095e474cfc8cb1391e90503117fbb02b3f218adc046ad654a742c554cea1aabb50221009ec6324267f294e3fd82042edc4f75b3d5045186a2c8d7a132cfb930040e6813007700ccfb0f6a85710965fe959b53cee9b27c22e9855c0d978db6a97e54c0fe4c0db000000193788b6df6000004030048304602210096c02ff89884ff81f1d1e06965cc8639e5775eda2548cdf6f1492fe9388edf1a022100f67955e0066763ba7f23020130fe625f9c41cbe5f49626ca71076202ffdece3300760012f14e34bd53724c840619c38f3f7a13f8e7b56287889c6d300584ebe586263a00000193788b6dd50000040300473045022100abec85798805aafecc03b4b9b6e0dbb2beab28b9a5d36ed5021a4fb40e477ed40220131255263bdf66bc618f9f531dedb249c30c6b5f98be23ced37100c7166571c2300d06092a864886f70d01010b05000382010100592acc609c02195145ee6abf875f3ced94e039f83e2f88022013ea40c65ae4738d80a07e518a28f996726422fefa2f53d04aa3635fe98c4c882132f86d92924bace80c185f6fea710bbf48ce12da24440651e6b58cf4f2101634a4c6ca506ea0a75a00266eca09f275d3389ae673fb48e9b587477ba642f95000b4331dd682426be4ac59dfc8e859f8771d1bf98fe7a95dade3f53844c774376f4ca2067953202ac4e1089bd179f124f3eac09d020eadf36b1b018caece0f7159c279801358f9b9b6f15e0d92b4784f5f49ba343b36baa1faab04ab29d6377ba2f9b8760b4a8ae88009de395c580ad97518697cb3a950762fe218b6d965a46eb0c6733f2017f7

Remove old certificate (optional):
!mod cmd X509 form /item-trusted-3ccaa98ee59e6fd2ae91299fab78970d4f9f39a37eed987b32982e6a8a201afb70f7068f on /trusted-delete Remove

===Additional Recommendation===

If you are still connected to the ''old'' push-service (services.innovaphone.com), we recommend switching to the new push-service described in the [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com| Push Migration (Shutdown planned for 31.12.2024)]]. We currently evaluate to change the certificate used on the push-service to an innovaphone CA-signed one, with a longer duration time.

== Related Articles ==
* [[Howto13r2:12r2/13r1_legacy_push_server_will_be_migrated_to_push.innovaphone.com]]
* [[Reference15r1:Concept App Service Devices#Certificates configuration]]

[[Category:Howto|{{PAGENAME}}]]

Howto:Update innovaphone.com Wildcard-Certificate in a Device Trustlist

2026-02-05T14:37:43Z

Kpe: /* Problem Details */

'''This article is obsolete for the push service, please see [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com]]'''

==Applies To==
This information applies to
* All innovaphone IP-Phones and -Gateways with 12r2, 13r3, 14r1, 14r2, V15r1 firmware and no Devices certificate deployment configured.

==More Information==

===Problem Details===
On the end date of the current certificate <code>*.innovaphone.com</code> it will expire. '''We will renew this certificate every year on time.''' This certificate is used in the PBX trust list to establish an encrypted connection between your PBX and the innovaphone services.
To ensure that a service also works for your customers after the excisting certificate end date, a new vlid certificate must be added to the trust list of the respective PBX.
After the excisting certificate end date, the old <code>*.innovaphone.com</code> certificate can be deleted.
This certificate is currently only relevant for gateways on which a service connection to innovaphone is established. During the transition period of the release of a new certificate and the end date of the old certificate, both <code>*.innovaphone.com</code> certificates are required.

Additionally, every time an innovaphone devices is restarted, the current <code>*.innovaphone.com</code> certificate generates a [[Reference9:Event/0x000c1001| x509: A certificate has expired or will expire soon]] event.

'''If you use the [[Reference14r2:Concept App Service Devices#Certificates configuration|Devices - certificate trustlist concept]] you are not affected, and the certificate will be installed automatically.'''

===Resolution===
Here are three ways to replace the certificate on all innovaphone devices.

1. In the version 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 the certificate will be added automatically during the update.
After 27.12.2024 the old certificate can be manually deleted. Also, current firmware includes a mechanism to prevent ''Certificate expiration events'' in case that a new certificate exists for the same CN.
Finally, devices with 12r2sr72, 13r3sr22, 14r1sr10 and 14r2sr5 firmware will have after a factory reset only the new *.innovaphone.com certificate.

2. The certificate can be added manually on the PBX. It can be downloaded [[:File:Star innovaphone cert 2025.zip|here]] and then be uploaded on the PBX under [[Reference14r2:General/Certificates&action=edit&redlink=1|General/Certificates/Trust list]].
After 27.12.2024, the old certificate can be manually deleted.

3. The new certificate can be added, and the old certificate can be deleted via commands (which can be sent using an update server or the [[Reference14r2:Concept App Service Devices#Expert configuration| Expert configuration]] in ''Devices''). This needs a reboot of the device.
Save the new certificate in the trust list:
!vars create X509/TRUSTED pba 3082063e30820526a00302010202107ac11bffa149788852b63d5a31ce0959300d06092a864886f70d01010b050030818f310b3009060355040613024742311b30190603550408131247726561746572204d616e636865737465723110300e0603550407130753616c666f726431183016060355040a130f5365637469676f204c696d69746564313730350603550403132e5365637469676f2052534120446f6d61696e2056616c69646174696f6e2053656375726520536572766572204341301e170d3234313132393030303030305a170d3235313233303233353935395a301c311a301806035504030c112a2e696e6e6f766170686f6e652e636f6d30820122300d06092a864886f70d01010105000382010f003082010a0282010100b94fa779dc824ea7e561d83ed2f2b3fd293752832526af285af8e728668323b3d7444e724dbd4a2792998c0eabbac0ec1fcb1ebc7db5dcb174cd74a8aa9763e3eeb2541f2302bcad45b3f4d09a95876ef15e670db519f5bd0b5092389f995e8e0a9241ee462fd34d3af41df4693b571b1bf1dfb4a74ab5a70e68e87c2c12c0e3be5b408ec4d61099f79338dcfa73277d4a237065946795753edb89c9f234329a7b5a47ebc87e86f779281b9381072e1db4f57a3b9f8df67bf65e6090d2ea2ab93deb0b9013b0f762977726c6708b33137d599f82c15c2d72a76e568e22a3fb717c9ddbc9e33b12aacb9fcb543df52f3520f117d0647617801a24d651709645fd0203010001a382030630820302301f0603551d230418301680148d8c5ec454ad8ae177e99bf99b05e1b8018d61e1301d0603551d0e04160414172bc6fe5fa1ed78d9f49257924a714a950d4503300e0603551d0f0101ff0404030205a0300c0603551d130101ff04023000301d0603551d250416301406082b0601050507030106082b0601050507030230490603551d20044230403034060b2b06010401b231010202073025302306082b06010505070201161768747470733a2f2f7365637469676f2e636f6d2f4350533008060667810c01020130818406082b0601050507010104783076304f06082b060105050730028643687474703a2f2f6372742e7365637469676f2e636f6d2f5365637469676f525341446f6d61696e56616c69646174696f6e53656375726553657276657243412e637274302306082b060105050730018617687474703a2f2f6f6373702e7365637469676f2e636f6d302d0603551d110426302482112a2e696e6e6f766170686f6e652e636f6d820f696e6e6f766170686f6e652e636f6d30820180060a2b06010401d679020402048201700482016c016a007700dddcca3495d7e11605e79532fac79ff83d1c50dfdb003a1412760a2cacbbc82a00000193788b6e35000004030048304602210095e474cfc8cb1391e90503117fbb02b3f218adc046ad654a742c554cea1aabb50221009ec6324267f294e3fd82042edc4f75b3d5045186a2c8d7a132cfb930040e6813007700ccfb0f6a85710965fe959b53cee9b27c22e9855c0d978db6a97e54c0fe4c0db000000193788b6df6000004030048304602210096c02ff89884ff81f1d1e06965cc8639e5775eda2548cdf6f1492fe9388edf1a022100f67955e0066763ba7f23020130fe625f9c41cbe5f49626ca71076202ffdece3300760012f14e34bd53724c840619c38f3f7a13f8e7b56287889c6d300584ebe586263a00000193788b6dd50000040300473045022100abec85798805aafecc03b4b9b6e0dbb2beab28b9a5d36ed5021a4fb40e477ed40220131255263bdf66bc618f9f531dedb249c30c6b5f98be23ced37100c7166571c2300d06092a864886f70d01010b05000382010100592acc609c02195145ee6abf875f3ced94e039f83e2f88022013ea40c65ae4738d80a07e518a28f996726422fefa2f53d04aa3635fe98c4c882132f86d92924bace80c185f6fea710bbf48ce12da24440651e6b58cf4f2101634a4c6ca506ea0a75a00266eca09f275d3389ae673fb48e9b587477ba642f95000b4331dd682426be4ac59dfc8e859f8771d1bf98fe7a95dade3f53844c774376f4ca2067953202ac4e1089bd179f124f3eac09d020eadf36b1b018caece0f7159c279801358f9b9b6f15e0d92b4784f5f49ba343b36baa1faab04ab29d6377ba2f9b8760b4a8ae88009de395c580ad97518697cb3a950762fe218b6d965a46eb0c6733f2017f7

Remove old certificate (optional):
!mod cmd X509 form /item-trusted-3ccaa98ee59e6fd2ae91299fab78970d4f9f39a37eed987b32982e6a8a201afb70f7068f on /trusted-delete Remove

===Additional Recommendation===

If you are still connected to the ''old'' push-service (services.innovaphone.com), we recommend switching to the new push-service described in the [[Howto13r2:12r2/13r1 legacy push server will be migrated to push.innovaphone.com| Push Migration (Shutdown planned for 31.12.2024)]]. We currently evaluate to change the certificate used on the push-service to an innovaphone CA-signed one, with a longer duration time.

== Related Articles ==
* [[Howto13r2:12r2/13r1_legacy_push_server_will_be_migrated_to_push.innovaphone.com]]

[[Category:Howto|{{PAGENAME}}]]

Reference16r1:Concept App Service Queues

2026-01-27T17:22:24Z

Kpe: /* V16 Improvements */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.''' 
When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Improved search funcionality.'''

The improved search functionality is in line with the (Soft)Phone App search showing the source of the search result.

'''Improved search details.'''

Improved the shown details from a search result and showing more info in the BLF entry details.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference16r1:Concept App Service Queues

2026-01-15T10:17:01Z

Kpe: /* V16 Improvements */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.''' 
When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference16r1:Concept App Service Queues

2026-01-15T10:16:35Z

Kpe: /* V16 Improvements */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.'''
When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference16r1:Concept App Service Queues

2026-01-15T10:16:05Z

Kpe: /* V16 Improvements */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Callback request email during a call.'''

When having a call, a callback request per email can be generated. The email will have available callinformation already preloaded, like name, number and email-address of the caller if available.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Howto:Security works with innovaphone

2026-01-14T11:43:41Z

Kpe: /* Related Articles */

==Applies To==

* all innovaphone devices

==More Information==
Security issues in VoIP installations become more and more important to customers. While innovaphone very early has implemented a security framework based on the H.235 standard for H.323 supporting authentication and message integrity, the need for encryption to enforce privacy more and more emerges as a requirement.

This paper discusses the existing mechanisms in the version 6,7,8 and 9 release.

==Risks==

Voice over IP applications are like all other data applications exposed to a number of security threats.

These threats can be categorized as follows

• Availability

• Privacy

• Integrity

• Authenticity

• Accountability

===Availability===
As all devices attached to a network, VoIP devices may be subject to attacks against the availability of their offered services.

Such so-called Denial of Service Attacks may be attempted using various strategies, including amongst others exploiting weaknesses of the implementation or legal but excessive use of offered resources.

===Privacy===
As with all communication systems, VoIP devices may be misused to disclose confidential information. With telephone systems, this obviously involves unauthorized access to voice conversations. Moreover, access to configuration data (such as registration accounts, passwords, and extension numbers) can be of interest to attackers as well as call data (such as time and source/destination of calls). Call fraud or so called [[Howto:Protection against Brute Force Attacks | brute force attacks]] are very common these days.

===Integrity===
The integrity of call signalling data as well as of the voice communication itself can be of utmost importance. Spoofing of calling party ids for example may be used to obtain unaccounted access to particular resources (such as long distance calls or special services). But also more subtle and non-obvious tampering with call signalling data like faking cause codes (signalling busy when the party in fact does not respond) etc. or silently changing a call destination may cause severe harm.

==Security Features implemented in Version 6==

innovaphone products today feature a number of security features.

This article provides a rundown of the essential features and how they are enabled.

===Securing Configuration Data===
All configurations for innovaphone devices are stored in local flash memory.

While access to the data through normal interfaces is password protected, the content can potentially be examined if an attacker has physical access to the device (this would require disassembly of the device and examination of the flash EPROM).

Whenever you pass a configured device to someone else (e.g. when selling it), you should keep this in mind. If this is a concern, erase the data before (see related articles below). Configuration data can be dumped to text format using the “Config show” command.

From version 5 on, the resulting text file does not contain any clear-text passwords. Still, remaining configuration information may be considered sensitive. So be careful when providing this information to 3rd parties.

Because passwords are encrypted in the config file, you will need to remember the admin password of the device being dumped in order to load it to another device later on.

===Securing Access to Configuration Data===
innovaphone devices are configured through a web based interface using HTTP or HTTPS access.

===HTTP===
For HTTP authentication, both basic authentication (which is not encrypted) as well as digest authentication is available. You should make sure the browser you are using supports digest authentication which allows for reasonable security against password snooping and man-in-the-middle attacks. There is an option to enforce digest authentication in the “General Settings” (in other words, to disable basic authentication).

However, since the PBX’s SOAP interface is based on HTTP too, all SOAP clients not supporting digest authentication (and the TAPI driver currently is such a client) would be disabled using this option.

innovaphone devices feature non-protected access to the devices home page.

This is convenient; however, it may reveal some critical information to random port scanners targeting a device from the Internet. You may thus choose to password protect even the home page using an option in the “General Settings” area.

By default, all HTTP clients can gain access to the device configuration provided they have the right password. However, there is an option to restrict HTTP access generally to a particular host or network. This option allows you to restrict all HTTP access (and thus administrative access too) e.g. to hosts from within your own LAN.

If remote configuration access is required though (which would be disabled by this setting), you may consider to setup an administrative PPTP (or PPP over ISDN) dial-in access to the device. Many innovaphone devices do support such kind of dial-in out of the box. You would then use the “assign remote IP address” option and assign a local ip address to the dial-in client. This way, remote configuration is still possible and additionally secured by the PPTP encryption layer.

Due to the computational overhead of HTTPS, HTTP payload traffic is not encrypted in innovaphone devices. If payload encryption is critical to you for administration access, make sure you configure an encrypted PPTP dial-in access for configuration as described above.

There is a legacy, telnet based access to the configuration layer. Telnet is inherently unsafe since it transfers unencrypted passwords. It is not recommended to use this. From build 04-5807 on, telnet access is disabled by default. Previous builds can disable telnet access by specifying “/port 0” on the TELNET0 config file line.

===HTTPS===
HTTPS is supported in the since Version 6 Service Release 2 (V6 SR2). RFC 2818 defines use of TLS (Transport Level Security, RFC 2246) to secure the HTTP protocol.

===Managing Accounts===
All administrative functions are secured by account names and passwords. It is strongly recommended neither to keep the default account nor the default password setting.

===Access to VoIP resources===
Access to VoIP resources (such as gatekeeper registrations and access to trunk lines) can be secured by account and password. If securing VoIP resources is an issue, make sure that all gatekeeper accounts are secured by a password. You may even want to consider disallowing any registration without password, even from within the local area network. This can be done in the “general settings” area of the PBX.

To protect your trunk lines from unintended access, make sure to configure all gateways (GWxx entries) properly. For gatekeeper type entries, make sure there is a password, for gateway type entries, make sure the configured netmask suits your needs. Double check all routing entries to avoid unintended access e.g. to trunk lines.

===PPP and PPTP===
When using built-in dial-in (PPP, PPTP) interfaces, PAP, CHAP, MS-CHAPv1 and Ms-CHAPv2 are supported. PAP by design does not allow for password encryption and is thus not recommended. The CHAP variations do support password encryption using MD4 and DES and are therefore reasonably secure.

There is no payload encryption available for PPP (that is, PPP over ISDN) and PPPoE (i.e. xDSL). However, using ISDN dialup, payload encryption is not really an issue.

PPTP however features powerful payload encryption in addition to password encryption. It is using SHA-1 for session key encryption and RC4 up to 128bit for payload encryption. If payload encryption is an issue to you, you should check the “enable encryption” flag in the PPTP configuration. Keep in mind that payload encryption incurs computational overhead and the number of concurrent PPTP session the device can handle is reduced. Using PPTP is an option if fully payload encrypted configuration access is a requirement (see above).

===RAS Registrations===
H323 user account passwords are obviously sensitive information. innovaphone devices feature RAS RegistrationRequest (RRQ) password encryption based on the H.235 standard (H.235v2 Annex D – Baseline Security Profile). By requiring knowledge of a shared secret on both ends, mutual authentication is provided by this mechanism.

===H.225 Signalling===
Based on the H.235 authentication (see above), H.225 signalling messages carry a signature which ensure message integrity in both directions. While message content may still be looked at and thus possibly sensitive information may be disclosed, this mechanism effectively disallows corruption of call, authentication and accounting data and renders man-in-the-middle attacks ineffective.

===RTP===
RTP (i.e. media stream) traffic is not encrypted with Version 6. However, media stream endpoints are negotiated securely (see above), so that content spoofing is made difficult.

===SIP message security===
The current SIP implementation features mutual digest authentication and a reasonable protection against spoofed identities, there is currently no message digest signature available in SIP messages. The integrity of SIP messages thus is not ensured as is the integrity of H.225 and RAS messages (see above).

===SOAP Client account===
SOAP clients (such as the TAPI driver or the Operator) require an account/password for authentication at the HTTP layer. Although the devices admin account can be used for that, it is better practice to use the PBX user password for this. For the HTTP credentials, you can use the PBX users “Name” as account and it’s “Password” as the password. You will use the “Long Name” as SOAP access user name.

When configuring the TAPI driver e.g., you would create a user with Long Name _TAPI_, Name tapi and a password. You would then use tapi/password as Gateway Platform Access/Account/Password and _TAPI_ as PBX Access/Username.

===SNMP===
SNMP is only for monitoring and does not allow any configuration changes. You may want to restrict the list of “accepted hosts” using the gateway applets SNMP area. You may want to change the “community” to a non-standard value.

===ISDN data calls===
ISDN data calls are accepted by innovaphone devices as voice calls are and they are routed similarly. Although innovaphone devices may be configured to terminate a data call and thus access the local network via dial-in, this option must be explicitly enabled.

===Denial of Service attacks===
Like any other network device, innovaphone devices may be a target for a denial of service attack. It is therefore recommended, to protect against malicious access using standard firewall techniques. However, innovaphone devices feature a built-in DoS filter which will discard unreasonable inbound traffic. Also, it is based on a dedicated and proprietary operating system which is usually not a target for viruses and other malicious code.

===Arp Spoofing===
Tools performing VoIP privacy attacks have been made publicly available in order to tap in to VoIP conversations in a local area network. These attacks are based on spoofing layer 2 networks addresses to create a man-in-the-middle scenario where a conversation can be recorded without service interruption to the original participants.

Basically, the attack is based on the fact that the mapping between IP addresses and Layer2 (MAC) addresses is usually built on-the-fly using a protocol (ARP) that has no security built in. Attackers can change this association without notice and thus redirect any traffic to themselves. These kind of attacks have been addressed in V6.

innovaphone ARP stacks will reject unexpected changes to the address mapping, and furthermore cease any traffic to the poisened mac address for 5 seconds. This feature needs to be enabled [[Reference7:Configuration/ETH/IP]] with ''Check ARP''.

This way, an Arp spoofing attempt will be seen as service interruption by the end users, giving the network administrator a chance to investigate.

===Availability===
innovaphone devices have proved to be very robust and reliable. However, if availability is of utmost importance, redundancy options are available which allow for outstanding protection against loss of service.

Also, all innovaphone devices may be powered via power over Ethernet (PoE) which when combined with an uninterrupted power supply (UPS) ensure seamless operation even in the case of a local power failure.

PoE may be used concurrently with a local power supply.

==Additional Security Features in Version 7==
Although at present there are a number of security features implemented in innovaphone VoIP devices, there is still a lack of protection for the privacy of communications. This reflects the fact that previously, the source of attacks usually was expected to be outside of the own organization.

Such risks have been defended using sophisticated firewalls and VPN appliances on the own network border which provide for encryption and thus privacy protection. However, today’s security risks are more and more expected to emerge from within the organization.

The inability of contemporary local area network equipment to provide for encryption and thus privacy of communications puts the burden on the application. VoIP application as well as other data applications must provide for end-to-end encryption.

The V7 introduces a number of features which help to defend against the risks of security attacks.

===SRTP===
Secure RTP is a security mechanism defined by RFC 3711. SRTP can be used for voice encryption with H.323 and SIP.
SRTP encrypts the RTP stream with AES. As a result the key will be chosen randomly on both sites and sent with the signaling data.

Only if both sites have activated encryption SRTP is used.

SRTP can not be forced.

innovaphone supports with Version 7:

*AES-128
*AES-192
*AES-256

all with 32 or 80 bit SHA1 hashed message authentication codes (HMAC).

====SRTP Interoperability====
No interop problems are to be expected if other vendor device offers exactly one of the above crypto suites. Innovaphone equiment will always adapt to the offered crypto suite.

Problems will araise if other vendor device offers multiple crypto suites during call establishment.
In this case all innovaphone devices must be configured to that crypto suite, which is offered at first position.

===TLS===
The TLS protocol obsoletes SSL and allows applications to communicate across a network in a way designed to prevent eavesdropping, tampering, and message forgery. TLS provides endpoint authentication and communications privacy over the Internet using cryptography.

Typically, only the server is authenticated (i.e., its identity is ensured) while the client remains unauthenticated; this means that the end user (whether an individual or an application, such as a Web browser) can be sure with whom they are communicating. The next level of security—in which both ends of the ''conversation'' are sure with whom they are communicating—is known as mutual authentication. Mutual authentication requires public key infrastructure (PKI) deployment to clients.

TLS is needed for
* HTTPS
* secure SIP (SIPS)

innovaphone supports TLS with the following methods:

* RSA with 3DES
* RSA with AES-128
* RSA with AES-256

all with SHA1 hashes.

===H.235===
We currently use H.235v2 Annex D – Baseline Security Profile. It relies on symmetric techniques and provides authentication and/or message integrity based on shared secrets. H.235v3 Annex G – SRTP & MIKEY usage discusses a key management scheme suitable for use of SRTP (RFC 3711).

As SRTP does not specify a key management scheme by itself, the MSEC working group within the IETF discusses key management solutions and currently favours MIKEY. MIKEY defines AES as mandatory transport encryption enforces the use of X.509v3 certificates for public key encryption and digital signatures.

innovaphone implemented H.235 key Exchange for SRTP in Version 7.

===SIPS===
SIPS is SIP over TLS, which is mandated for proxies, redirect servers and registrars by RFC 3261. However, use of TLS requires a secure transport protocol, i.e. TCP.

The mechanisms supported are: TLS, HTTP Digest.

SIPS is supported since version 7.

===Telnet===
The secure shell protocol as per RFC 4251 can be used to apply content encryption to telnet sessions. We will not implement secure shell as we do not recommended to use Telnet at all, and telnet access is disabled by default.

===LDAP===
LDAP uses the SASL security as per RFC 2222. Unfortunately, this does not account for content encryption. LDAP v3 thus has defined extension for use of TLS with LDAP (in RFC 2830).

With Version 9 innovaphone will support LDAP via TLS

===SNMP===
SNMP versions 1 and 2 have been considered “insecure”. SNMP Version 3 includes considerably enhanced security mechanisms (as per RFC 3414). Unfortunately, this puts some difficult burden on SNMP implementations resulting in a rather little deployment compared to SNMP V2. There will be no SNMP security implementation on innovaphone side, as it is read only on the devices.

===802.1X port security===
Port security secures physical ports by enforcing a user authentication before allowing data transfer through a given Ethernet switch port. The endpoint needs to perform this authentication in order to be able to communicate.

As VoIP telephones usually work as an Ethernet switch (featuring a second “PC port”) they would need to enforce port security on this second port too in order not to compromise the security setup. The switch implementation must support multiple authentications on one port.

innovaphone supports the 802.1x feature on all products.

===X.509 Certificates===
Cryptographic certificates assign a public key to an identity. This is needed for the authentication of communication endpoints. The X.509 standard defines one commonly used format for such certificates.

innovaphone supports management functionality for both trusted CA certificates and device certificates / private keys.

We use X.509v3.

==Additional Security Features in Version 8==

===Kerberos based Authentication ===

A single innovaphone device can act as an authentication server for all other innovaphone devices. User accounts that are managed on the authentication server can be used to login on each device in the installation. You can also configure devices to accept user accounts from a PBX (full admin rights) or a Windows domain.

===IP Filter===

Separate IP filter for log-ins with password and without password.

==Additional Security Features in Version 9==

===Object Device===

*In case of registrations to a PBX using incorrect passwords, all other registrations to the relevant object are blocked for 20secs ([[Reference9:PBX/Objects#Security_issues | ''Security issues'' in PBX/Objects]]).

*It is possible to define at the object (for each [[Reference9:PBX/Objects#Devices | device ]]) that the admin password is needed to log in.

*It is possible to delete all [[Reference9:PBX/Objects#Devices |devices ]] at an object and thus completely deny any registration.

===HTTP Access Filter ===

Support for multiple networks in IP filter for the HTTP server (administration).

=== Unknown registrations===

It is possible to use the admin password for unknown registrations (deployment of new endpoints).

=== Voicemail===

The innovaphone voicemail supports SRTP via H.323 or SIPS.

===LDAP via TLS===

With version 9 innovaphone supports LDAP via TLS, for LDAP replication between master/slave/standby/standby-slave PBX.

==Additional Security Features in Version 10==

===TLS===

From v10sr8 certificates with SHA2 signatures are accepted. The new supported signature algorithms are SHA256, SHA384 and SHA512 with RSA encryption.

=== SIP Blacklist ===
Introduced in v10sr9. The SIP stack maintains an automated blacklist. When a REGISTER message is received for either a non-existing user or for an existing user but with a wrong password, the messages source IP address is put on a blacklist for at least 20s. SIP messages received from IP addresses in the blacklist are ignored.

==Additional Security Features in Version 11==

===H.460.17===

Endpoints can now register using H323/TLS. Device certificates can be used for authenticating registrations.

===TLS===

From version 11 TLS protocol version 1.1 and renegotiation (RFC 5746) is supported.

Support for certificates with SHA2 signatures (SHA224, SHA256, SHA384, SHA512).

===DTLS-SRTP===

Up to version 10 SDES was used for the exchange of SRTP keys between endpoints. This means the SRTP key is transported hop-to-hop inside signalling.

From version 11 DTLS-SRTP (RFC 5764) is available as an additional key exchange method. DTLS-SRTP uses end-to-end encryption and is done inband in the media stream. This means that the PBXes and proxies that forward signalling messages can not see the SRTP key. As a drawback, DTLS-SRTP adds a delay at the begin of calls.

DTLS-SRTP supports negotiation of the following SRTP cipher suites:
* AES-128 with 32-bit SHA1 HMAC
* AES-128 with 80-bit SHA1 HMAC

See also: [[Reference13r3:Concept_DTLS-SRTP]]

===Session border controller - SBC===
The Session Border Controller provides the session border functionality, which is that a device can register to an session border object and the session border object establishes the registration to a configured PBX. This can be used when for example the device is located within the public internet and the PBX in a private network.

===Disable NetBIOS===
You can disable the NetBIOS NameServer Feature in the [[Reference11r2:IP4/ETH/DHCP|DHCP Server]] configuration for a specific interface.

==Additional Security Features in Version 12==

===TLS===

From version 12r1 we support the following cipher suites. The DHE and ECDHE suites provide perfect forward secrecy.

* TLS_RSA_WITH_AES_128_CBC_SHA
* TLS_RSA_WITH_AES_256_CBC_SHA
* TLS_DHE_RSA_WITH_AES_128_CBC_SHA (new)
* TLS_DHE_RSA_WITH_AES_256_CBC_SHA (new)
* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA (new)
* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA (new)

The following cipher suites have been deactivated and are no longer in use.

* TLS_RSA_WITH_3DES_EDE_CBC_SHA (deactivated)

==Additional Security Features in Version 13r1 ==
===TLS===

'''Note: With 13r1 SR35 we merged-back the TLS functionality from 13r2. So the feature set is identical with the lastest versions.'''

Supported TLS versions:

* TLS 1.0
* TLS 1.1
* TLS 1.2 (new)
* DTLS 1.0
* DTLS 1.2 (new)

Supported ciphers in version 13r1:

* TLS_RSA_WITH_AES_128_CBC_SHA
* TLS_RSA_WITH_AES_256_CBC_SHA
* TLS_DHE_RSA_WITH_AES_128_CBC_SHA
* TLS_DHE_RSA_WITH_AES_256_CBC_SHA
* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
* TLS_RSA_WITH_AES_128_CBC_SHA256 (new)
* TLS_RSA_WITH_AES_256_CBC_SHA256 (new)
* TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 (new)
* TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 (new)
* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 (new)
* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 (new)
* TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 (new, DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 (new, DTLS only)

TLS_RSA_WITH_3DES_EDE_CBC_SHA was finally removed and can't be activated in v13r1.

Additionaly we added the configuration of TLS profiles. They can be used to configure the selection and priority of used TLS versions and ciphers.

{|
!style="text-align:left;width:100px;"|Cipher suite
!style="width:100px"|TLS (normal)
!style="width:100px"|TLS (fast)
!style="width:100px"|TLS (secure)
!style="width:100px"|DTLS
|-
|TLS_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|}

===Random numbers===
For creating private keys for certificates and certificate request, we now use the HMAC-DBRG random number generator based on HMAC-SHA512.

===STARTTLS in SMTP client===
The SMTP client in the firmware and on the app platform now implements STARTTLS for encrypted communication with mail servers.

===myApps Password policy===
{{myApps Password Policy}}

==Additional Security Features in Version 13r2 ==
===TLS===
Supported TLS versions:

* TLS 1.0
* TLS 1.1
* TLS 1.2
* DTLS 1.0
* DTLS 1.2

Supported ciphers in version 13r2:

* TLS_RSA_WITH_AES_128_CBC_SHA
* TLS_RSA_WITH_AES_256_CBC_SHA
* TLS_DHE_RSA_WITH_AES_128_CBC_SHA
* TLS_DHE_RSA_WITH_AES_256_CBC_SHA
* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
* TLS_RSA_WITH_AES_128_CBC_SHA256
* TLS_RSA_WITH_AES_256_CBC_SHA256
* TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
* TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
* TLS_RSA_WITH_AES_128_GCM_SHA256 (new)
* TLS_RSA_WITH_AES_256_GCM_SHA384 (new)
* TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 (new)
* TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 (new)
* TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (new)
* TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (new)
* TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 (new, DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 (new, DTLS only)

Major changes in 13r2:
* Added support for GCM cipher suites
* Removed SHA cipher suites from profile "secure"
* Added a new profile "strict"

{|
!style="text-align:left;width:100px;"|Cipher suite
!style="width:100px"|TLS (normal)
!style="width:100px"|TLS (fast)
!style="width:100px"|TLS (high security)
!style="width:100px"|TLS (strict)
!style="width:100px"|DTLS
|-
|TLS_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_128_GCM_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_GCM_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|}

The following TLS versions are activated in the corresponding profiles:

{|
!style="text-align:left;width:100px;"|Version
!style="width:100px"|TLS (normal)
!style="width:100px"|TLS (fast)
!style="width:100px"|TLS (high security)
!style="width:100px"|TLS (strict)
!style="width:100px"|DTLS
|-
|1.2
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|1.1
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|N/A
|-
|1.0
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|}

===myApps brute force protection===
Attackers trying to guess user passwords are blocked by temporarily [[Reference13r3:Concept_myApps#Brute_force_protection|preventing login attempts for an increasing amount of time and generation of events to notify the administrator]].

===IPv4: prevent direct routing between interfaces (since V13r2sr16) ===

Incoming frames directed to another interface are passed directly to this interface by default.
When "IP4/General/Settings/Isolate Interfaces" in the advanced GUI is checked such frames are dropped and the SNMP counter IPROUTINGDISCARDS is incremented.

The corresponding flag can also be set with
!config add IP0 /isolate-interfaces
!config write

==Additional Security Features in Version 13r3 ==
===TLS===
Supported TLS versions:

* TLS 1.0
* TLS 1.1
* TLS 1.2
* TLS 1.3 (new)
* DTLS 1.0
* DTLS 1.2

Supported ciphers in version 13r3:

* TLS_RSA_WITH_AES_128_CBC_SHA
* TLS_RSA_WITH_AES_256_CBC_SHA
* TLS_DHE_RSA_WITH_AES_128_CBC_SHA
* TLS_DHE_RSA_WITH_AES_256_CBC_SHA
* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
* TLS_RSA_WITH_AES_128_CBC_SHA256
* TLS_RSA_WITH_AES_256_CBC_SHA256
* TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
* TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
* TLS_RSA_WITH_AES_128_GCM_SHA256
* TLS_RSA_WITH_AES_256_GCM_SHA384
* TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
* TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
* TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
* TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
* TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 (DTLS only)
* TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 (DTLS only)
* TLS_AES_128_GCM_SHA256 (new, TLS 1.3 only)
* TLS_AES_256_GCM_SHA384 (new, TLS 1.3 only)

Major changes in 13r3:
* Added support for TLS 1.3
* Added a new profile "experimental" used for testing of new features. The configuration of that profile is subject to change without notice. So it should not be used for productive environments.
* Removed ciphers TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 and TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 from "strict" profile.

{|
!style="text-align:left;width:100px;"|Cipher suite
!style="width:100px"|TLS (normal)
!style="width:100px"|TLS (fast)
!style="width:100px"|TLS (high security)
!style="width:100px"|TLS (strict)
!style="width:100px"|TLS (experimental)
!style="width:100px"|DTLS
|-
|TLS_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_128_GCM_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_GCM_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_AES_128_GCM_SHA256 (TLS 1.3)
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_AES_256_GCM_SHA384 (TLS 1.3)
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|}

The following TLS versions are activated in the corresponding profiles:

{|
!style="text-align:left;width:100px;"|Version
!style="width:100px"|TLS (normal)
!style="width:100px"|TLS (fast)
!style="width:100px"|TLS (high security)
!style="width:100px"|TLS (strict)
!style="width:100px"|TLS (experimental)
!style="width:100px"|DTLS
|-
|1.3
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|1.2
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|1.1
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|N/A
|-
|1.0
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|}
=== X.509 certificates ===
13r3 Service Release 10 adds support for additional signature schemes in X.509 certificates with RSA keys:
* sha256WithRSASSAPSS
* sha384WithRSASAAPSS
* sha512WithRSASSAPSS
all with mgf1 as mask generation function.

==Additional Security Features in Version 16r1 ==
===X.509 certificates===
Version 16r1 adds support for ECDSA certificates based on the secp256r1, secp384r1 and secp521r1 elliptic curves.

===TLS===
Major changes in 16r1:
* Added support for ECDSA certificates and cipher suites
* DTLS 1.0 has been removed.
* DHE cipher suites have been removed.
* Consolidation of TLS profiles. We now have three profiles:
** legacy - all TLS versions and ciphers for compatibility with legacy endpoints
** normal (default setting) - TLS 1.2 and 1.3
** strict - TLS 1.3

Supported TLS versions:
{|
!style="text-align:left;width:100px;"|Version
!style="width:100px"|Profile legacy
!style="width:100px"|Profile normal
!style="width:100px"|Profile strict
!style="width:100px"|DTLS
|-
|1.3
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|1.2
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|1.1
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|1.0
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|}

Supported cipher suites:
{|
!style="text-align:left;width:100px;"|Cipher suite
!style="width:100px"|Profile legacy
!style="width:100px"|Profile normal
!style="width:100px"|Profile strict
!style="width:100px"|TLS 1.0
!style="width:100px"|TLS 1.1
!style="width:100px"|TLS 1.2
!style="width:100px"|TLS 1.3
!style="width:100px"|Perfect forward secrecy
!style="width:100px"|AEAD
|-
|TLS_AES_256_GCM_SHA384

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_AES_128_GCM_SHA256

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_RSA_WITH_AES_256_GCM_SHA384

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_128_GCM_SHA256

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|-
|TLS_RSA_WITH_AES_256_CBC_SHA256

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_RSA_WITH_AES_128_CBC_SHA256

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_RSA_WITH_AES_256_CBC_SHA

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|-
|TLS_RSA_WITH_AES_128_CBC_SHA

|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:green;text-align:center"|✔
|style="color:red;text-align:center;font-weight:bold;"|X

|style="color:red;text-align:center;font-weight:bold;"|X
|style="color:red;text-align:center;font-weight:bold;"|X
|}

Supported signature schemes:
* sha256WithECDSA
* sha384WithECDSA
* sha512WithECDSA
* sha256WithRSAEncryption
* sha384WithRSAEncryption
* sha512WithRSAEncryption
* sha256WithRSAPSSRSAE
* sha384WithRSAPSSRSAE

Supported mask generation functions for RSASSA-PSS:
* mgf1

Supported elliptic curves for ECDSA:
* secp256r1
* secp384r1
* secp521r1

== Session Riding / "Cross-Site-Request-Forgery"==

For safe administration, see [[Howto:Protection against "Cross-Site-Request-Forgery"]].

== IP Phone USB Interfaces ==
Some of the innovaphone hardware phones feature a USB host interface which supports connection of USB headsets (a.k.a. audio and HID devices) and proprietary innovaphone extension modules. No other device types are supported or recognized.

Like all innovaphone devices, the phones run a proprietary operating system (think of it as ''the innovaphone OS''). It has been written from the ground by innovaphone and is not based on any existing operating system such as Windows, Linux or VxWorks. As such, it does not allow execution of any code (e.g. drivers) derived from such systems. Also, the operating system does not allow execution of user code (that is, code that has been crafted by a user and is not integral part of the operating system). Execution of malware is not possible thus.

All headset drivers are entirely written by innovaphone too. No 3rd party code (such as vendor SDKs) are used.

From V12r1 SR14, you have the option to disable the USB port(s) altogether. Also, you can limit its use to audio or HID devices. See [[Reference12r1:Phone/Protect]] for details.

From V12r2 SR21, you can request informations about the connected USB Device via ''!mod cmd USB-HOST port''
<info><port type="hub" port="1"/><port type="device" port="4" vendor="0xb0e" product="0x245d" release="0x118" product_name="Jabra Link 370"/></info>

In addition, a syslog entry is generated.
20190103-140636 USB-DEVICE plugged: vendor=1395 'Sennheiser' product=0051 'Sennheiser USB-ED CC 01' release=0603
20190103-140637 USB-DEVICE unplugged: vendor=1395 'Sennheiser' product=0051 'Sennheiser USB-ED CC 01' release=0603

== DECT Handsets and IP-DECT ==
The current DECT infrastructure components based on the base stations IP1202 and DECT handsets IP64/IP65 are supporting the Enhanced DECT Security (ETSI TS 102 841, GAP.N.35). Starting with version 2.1.4 of the DECT handset firmware also Step B of the DECT Security Roadmap by DECT Forum was implemented, supporting DECT Standard Authentication Algorithm 2 (DSAA2) based on 128 bit AES encryption, which also implies DECT Standard Ciphering Algorithm (DSCA) based on 64 bit DECT encryption with rekeying interval of 60 seconds.

==Conclusion==
Given the fact that today’s IT managers consider threats originating from inside the organisation as (at least) as critical as those originating externally, the only viable solution is a combination of media stream and signalling encryption performed directly by the endpoints.

Fortunately, both relevant signalling protocols in the PBX environment (H.323 and SIP) seem to converge as far as the media stream encryption (SRTP) and the key management are concerned. This should ensure end-to-end compatibility between SIP and H.323 endpoints. The necessary definitions for use of SRTP with H.323 are part of H.235-Annex G, for SIP it is SIPS - SIP via TCP and TLS.
innovaphone has implemented SRTP according to H.235 Annex G as well as according to the SIP/SDP (SIPS/TLS) key management. The TLS is also used for HTTP, it requires an X.509 public key/certificate.infrastructure in place.

As the security of data transfer used for configuration is considered crucial, HTTPS is a mandatory requirement. This implies the existence of an X.509 certificate on each device. innovaphone devices entertain various http-based client connections to foreign http servers (e.g. for voice announcements, configuration provisioning). Since these connections are (at least) as critical as configuration sessions where the device acts as an http server, both proper http digest authentication and also TLS content encryption (https) is implemented by innovaphone.

The use of telnet to access innovaphone devices is deprecated and thus there is no need to address possible security issues related to the telnet access. As a “best practice” rule it is recommended to disable telnet access anyway (which in fact is the default configuration anyway).

While innovaphone devices do support SNMP, they do not allow any modification or retrieval of sensitive data using this mechanism. It is merely meant to facilitate maintaining devices health status. SNMP should be guarded against risk originating externally anyway (e.g. using firewall techniques). Risks originating from inside the organisation are considered less important. innovaphone will thus stay with the current SNMP v1 implementation.

innovaphone systems make extensive use of LDAP queries to synchronize distributed PBX systems. These communications obviously carry sensitive data (although from the very beginning there were no passwords conveyed in clear). innovaphone has implemented TLS for LDAP for inter-PBX communication. Securing LDAP access by clients (i.e. phones) to organisational directory services is considered less important as the conveyed data usually is not as critical. Also, existing directory servers may not support TLS for LDAP.

While 802.1X port security adds some extra barrier against certain types of internal risks, it also creates a number of open issues. Telephones usually are considered to work even if they are currently not authenticated by user. This may be mandatory for emergency calls for example. Use of port security would then mandate the storage of a fixed password within the non-volatile memory of an IP phone. Furthermore, the authentication of the second (PC) port needs to be performed with 802.1.x multiple authentications. innovaphone has implemented 802.1x on all of its devices.

As [[Howto:Protection against Brute Force Attacks | brute force attacks]] are very common these days, it is recommended to limit the ip subnets for configuration access (HTTP access filter). Configure that only registrations with password are allowed. For each object set a complex password or configure them with the [[Reference9:PBX/Objects#Devices |admin password check-mark]]. Set the device field empty at the object when no registration should take place, thus nobody can register at all at this object. Deactivate "unknown registrations" or set them with admin password check-mark. From version 11r1 on, it is recommended to use [[Reference11r1:Concept_H.323_over_TCP/TLS_(H.460.17) | H.323/TLS certificate based registration ]] whenever possible.

===Related Articles===
* [[Reference13r3:Concept_myApps#Brute_force_protection]]
* [[Howto:Protection against Brute Force Attacks]]
* [[Howto:How to physically erase flash memory content]]
* [[Howto:SIPS will work with V7]]
* [[Howto:Certificate_management]]
* [[Reference9:PBX/Config/Security]]
* [[Support:Protection against "Cross-Site-Request-Forgery"]]
* [[Reference12r1:Concept_Reverse_Proxy]]

[[Category:Howto|{{PAGENAME}}]]

Reference16r1:Concept App Service Queues

2025-12-17T15:46:16Z

Kpe: /* Limit displayed calls in waiting queues section */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If disabled: a long list of incoming calls will be shown.
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
** Fix WQ height optional with height setting between 0 and 50
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference14r2:Concept App Service Queues

2025-12-17T11:16:18Z

Kpe: /* Switchboard Admin App - User interface */

Reference16r1:Concept App Service Queues

2025-12-17T11:15:27Z

Kpe: /* Switchboard Admin App - User interface */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
* If disabled: a long list of incoming calls will be shown.
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference15r1:Concept App Service Queues

2025-12-17T11:14:57Z

Kpe: /* Switchboard Admin App - User interface */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 15r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V15r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V15 Improvements==
'''Show call diversions for BLF entries.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Break-through of call diversions from BLF and Search details.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Fix for handling connections from multiple PBXs.''' 
An overall improvement of the handling when multiple calls are ringing.

'''Hotkeys for accepting and releasing calls.''' 
The myApps provide hotkeys functionality to start an App from anywhere within windows with this hotkey.
The Switchboard App now supports this hotkey functionality.

'''Focus call panel when starting switchboard''' 
When starting the Switchboard App, the focus will be in the call section, so that an incoming call can be answered immediately by pressing the enter-key.

'''Transfer button on the second call for intuitive transfer handling.''' 
When having an incoming call, a click on the Transfer button, did already show multiple transfer icons on the BLF entries. When having also an outgoing call, this icons now also appears on the outgoing call for a more user-friendly and intuitive transfer of the call. By clicking this icon on the outgoing call, the incoming call will be transferred to the outgoing call.

'''Pickup in BLF Favorites.''' 
The Phone and Softphone favorites are shown in the BLF field from the Switchboard App. New in this version, when a call is ringing at one of the favorites, a pickup symbol will be shown. By clicking on the pickup symbol, the call will start ringing on your phone and can be answered by the Switchboard App User.

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be applied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
* If disabled: a long list of incoming calls will be shown.
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference16r1:Concept App Service Queues

2025-12-17T11:13:57Z

Kpe: /* Switchboard Admin App - User interface */

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App must '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

'''Note''': Make sure to close the Switchboard App of the user when adjusting the config this user via the Switchboard Admin App. This ensure that changes are not overwritten again with the old values.

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

Before doing any changes for any switchboard user, make sure that this user has closed the Switchboard App. Perform the changes, and afterward the Switchboard App user can reopen the Switchboard App and the changes will be aplied.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
* If disabled: a long list of incoming calls will be shown.
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference16r1:Concept App Service Queues

2025-12-09T15:53:20Z

Kpe:

[[Category:Concept|Apps]]
The Queues App Service can be installed on an innovaphone App Platform and will provide services for several Apps that can be used to manage calls and waiting queues with myApps. For example the Switchboard App.

== Applies To ==

* innovaphone PBX from version 16r1final

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* Firmware V16r1xx
* UsersAdminApp
* (Soft)PhoneApp
* ProfileApp
* CalllistApp
* Calllist-API
* RCC-API
* configured Waiting Queues in the PBX
* configured group(s) in the PBX assigned as "Static" and "Active" to the Waiting Queue
* License “App(innovaphone-switchboard)13” (order no. 02-00050-007) per application-user
* A dedicated group(queues) in the PBX assigned as "Static" to all Waiting Queues used by the Switchboard App and assigned as "Static and Active" to all Switchboard Users

==V16 Improvements==
'''Show call diversions for the favorites section in the BLF.''' 
This feature shows, with a colored label in the BLF entry, the configured call forwarding from the respective User. The color of the label depends on the type of configured forwarding, CFNR (orange/yellow), CFB (red) or CFU (purple). A click on the label, shows the configured forwarding destination.

'''Breakthrough of call diversions from BLF in favorites section.''' 
With a new icon (handset with arrow) it is possible to call to the User with a Call forward and breakthrough this call forward. This applies for CFB and CFU. In case of a CFNR the CFx-breakthrough does not apply because the call rings first at the user and after the configured timer the CFNR will be executed.

'''Edit mobility destination for users.''' 
An improvement for changing the mobility destination of the users.

'''Enable numeric + key as shortcut for transfer option.''' 
The Switchboard App now supports the shortkey + as shortkey for the transfer functionality.

'''Focus on second call for easier transfer ''' 
When starting a second call in the Switchboard App, the focus will be in the call section on this second call, so that a transfer can be initiated immediately by pressing the configured short-cut, for example the numeric + key. In case the focus is in the search field, press the TAB key first.

'''Call state in outgoing call section.''' 
When having an outgoing call, the status of this call (ringing or connected) will be shown in this outgoing call for a more user-friendly and intuitive feedback.

'''Notes for in- and outgoing calls in connect.''' 
When having an in- or outgoing call, you can add a note for this call in the Connect App. When a new call arrives, the Note can be consulted as additional information about this caller or called number.

'''Fix: Issue breakthrough option/button not updated.''' 
Fixed breakthrough option/button was not updated (added/removed) when eg a CFu is set/removed.

'''Fix: Issue added users not visible immediately in BLF.''' 
Show users immediately in the BLF after adding them to a group.

'''Fix: Issue missing call-leg2 Info.''' 
Missing Call-leg2 Info now showed after connecting a Call.

'''Fix: Issue to many calls when starting call forward breakthrough.''' 
Fixed call forward breakthrough that leaded to many calls.

'''Fix: Issue to less space between buttons in BLF Details.''' 
Fixed the space between buttons in BLF user details.

'''Fix: Issue with Queues-plugin Group Configuration.''' 
The Display Name was wrongly used as User Identifier/Common Name to assign the 'queue'-group.

'''Fix: Issue Display of mismatched number with name in outgoing calls.''' 
Fixed the display of mismatched number with name in outgoing calls section on pickup.

'''Fix: Issue with missing CFx on a user after a change by the Switchboard App.''' 
Fixed the forwardings stored in PBX after a change by the Switchboard App.

'''Fix: Issue Users displayed multiple times when we click on BLF duplication button.''' 
Fixed the behavior when we click on BLF duplication button.

'''Fix: Issue when Transfer-button clicked twice.''' 
Fixed when transfer-button clicked twice, the transfer button was not removed on second call.

'''Fix: Issue Missing call after selecting IVR option.''' 
Fixed when selecting IVR option, show the waiting Queue again in the call panel section.

'''Fix: Issue transfer button shown on active calls.''' 
Fixed don't show the transfer button on active calls.

'''Further fixes will come with future service releases. Please consult our release notes accordingly.''' 

== Apps ==
=== Switchboard App (innovaphone-switchboard) ===
[[Image: Switchboard-App.png|50px|switchboard-app.png/|switchboard-app.png/]]

The Switchboard App is an attendant workstation integrated into the myApps user interface. At a switchboard workstation, an employee of a company or a telephone network operator can process incoming calls and connection requests from external or internal callers. An employee can accept connections, request information, put calls on hold, transfer them to the desired destination, or reject the connection. The calls displayed are the ones from the monitorized phone device and they are managed using the RCC-API. The Switchboard App needs a license per Switchboard user, called the Switchboard App.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard</pre>
;Websocket
;TableUsers: to be able to replicate the users for the BLF
;Admin: to be able to edit the User object to monitor or un-monitor a waiting queue
;PbxApi: to edit the presence information
;RCC: to use the RCC API to manage the calls
;Impersonation: to get the Phone App favorites

=== Switchboard Admin App (innovaphone-switchboard-admin) ===
[[Image: Innovaphone-switchboard-admin.png|50px|innovaphone-switchboard-admin.png/|innovaphone-switchboard-admin.png/]]

With the Switchboard Admin App an administrator can manage the user(s) rights, can assign waiting queues to users and can pre-configure the Busy Lamp Field BLF.

Parameters:
;URL: <pre>http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-switchboard-admin</pre>
;Websocket
;TableUsers: to be able to replicate the users from the PBX
;Admin: to be able to assign the waiting queue groups to the user

== PBX Manager Plugins ==

=== Queues ===

With the Queues plugin the Switchboard App and Switchboard Admin App Objects can be created, edited and deleted on the PBX.

==Configuration==
# Install the Queues App
#* Option 1: Settings Apps/App Installer plugin - Search and Install the Queues App or
#* Option 2: AP Manager/App Store:
#** Search and Install the Queues App
#** Create an Instance of the Queues App
#** Start the created instance
# Settings App/Queues Plugin - Create the necessary App Objects:
#* Switchboard App: e.g. 'Switchboard'/'switchboard'
#* Switchboard Admin App: e.g. 'Switchboard Admin'/'switchboard-admin'
# Assign the Switchboard App and License to the correct users (can be done User- or Config Template-based)
# Assign the Switchboard Admin App to the correct Admin-users (can be done User- or Config Template-based)
# Configure Master PBX via the Switchboard Admin App Settings (optional with a single PBX):
#* PBX Name: PBX Name (PBX/Config/General/PBX Name) of the Master PBX
#* DNS (optional): DNS Name (PBX/Config/General/PBX Name) of the Master PBX Restart the Queues Instance after changing (so the App Objects can re-connect).
# Configure Waiting Queues via the Settings App/Waiting Queues Plugin or check existing Waiting Queues:
#* Waiting Queues monitored by the Switchboard App must have a '''Primary Group''' (used by the Switchboard Admin App to assign groups to Users)
#* Waiting Queues monitored by the Switchboard App may '''not''' have the ''''Operator connect for SOAP''''-checkbox ticked (needed to release calls correctly when taken/accepted by another Switchboard User)
# Create a Monitoring Group '''queues''' for the Switchboard (Admin) App. This can be done easily via the Queues Plugin of the Settings App (Groups configuration) or via the Advanced UI of the PBX:
#* '''Waiting Queues''' to be seen by the Switchboard App must have this group assigned '''Static only'''
#* '''Switchboard Users''' must have this group assigned '''Static and Active'''
# Configure the Switchboard Users via Switchboard Admin App:
#* Assign the correct rights / Waiting Queues to be monitored
#* (Optional) Create or Assign an already created Busy Lamp Field
# Adjust the Switchboard User Object and Phone Config (can also be done via a Config Template (desk phones only)):
#* Object: '''Untick 'Twin Phones'''' => Picking alerting calls (BLF or Waiting Queue-section) is possible
#* (Soft)Phone: '''Enable 'Call Waiting'''' => handling of multiple calls is possible (e.g. pickup call while there is an already alerting call)
# (Optional) Adjust the PBX/Phone/myApps/UsersAdmin App Config for better usage:
#* PBX: Configure the Recall Timeout of the PBX (PBX/Config/General/Recall Timeout) => Blind Transferred calls can be taken back
#* Phone: Configure a Park-key on the phone(s) of the Switchboard User(s) => visual/audio reminder of Parked Calls after X seconds
#* myApps: Deselect the default (Soft)Phone App + Untick the "Bring AppSharing/Video always to front" in your (Soft)Phone App => prevention of the (Soft)Phone App to popup.
#* UsersAdmin App: Tick the 'Privacy/Display e-mail address' in the Settings of the Users Admin, so that a callback-button is shown for User-search results.
# Open the Switchboard App and Select a (Soft)Phone to be controlled in the Settings/Hamburger Menu

==Switchboard Admin App - User interface==
When opening the Switchboard Admin App the Switchboard Admin App shows only a search field at start (since release V14r1).
It will not list all users anymore, which speeds up the start of the App in big environments with many users.
At this point, closing the Switchboard Admin App, doesn't make any changes to the Switchboard App database.

===Search field===
Search for the user of your choice by typing its name.
The users details include their configured CFx since V15r1 and up.
When multiple user are shown, select the correct user.
The more detailed information (Rights / Busy lamp field) shown is retrieved from the Switchboard App database, while the existing user's group membership of the configured waiting queues, is retrieved from the PBX.

===Rights===
Here, you can define the rights of the Switchboard App user:
* Edit waiting queues: the user is allowed to add or delete waiting queues in the Switchboard App, to receive calls from.
* Edit presence: the user is allowed to change the presence state and presence note from other users in the system.
* Edit call diversions and mobility: the user is allowed to change other user's call forwards, mobility and its destinations.

===Waiting Queues===
This section shows the membership of primary group activity from the respective waiting queue.
This information is retrieved from the PBX. Changes will be saved into the PBX and the Switchboard App database.
Be aware that when making any changes to the selected user, it will be saved in the PBX and the Switchboard App database as well.
It might overwrite the latest group membership change done by the Switchboard App user itself. 
To make sure that your Administrative group membership settings will apply, make sure that the user's Switchboard App is closed before doing any changes. 
You might want to verify the user's preferred settings before, to apply them respectively with your changes.

The, in the PBX manager, pre-configured waiting queues will be shown to select the possible group membership. The possible choices are:
* Off: this waiting queue will not be shown in the user's Switchboard App for login.
* Dynamic-In: this waiting queue will be shown in the user's Switchboard App and the user is automatically logged-in the group with the start of the App (the user logs off from the group when closing the Switchboard App).
* Dynamic-Out: this waiting queue will be shown in the user's Switchboard App and the user is logged-off at start of the App (the user logs off from the group when closing the Switchboard App).
* Static: this waiting queue will be shown in the user's Switchboard App and the user is static in the group without the option to log-off (the user stays active in the group after closing the Switchboard App).

===Busy Lamp Field===

The Busy Lamp Field (BLF) section in the Switchboard Admin App, allows you, as admin, to pre-define the BLF groups and the PBX Users in the groups.
There is also the option to copy an already configured BLF from another user and edit it to your preferences.

==Switchboard App - User interface==
[[File:Switchboard app user interface.png|thumb|switchboard_app_user_interface.png/|switchboard_app_user_interface.png/]]
The user interface is divided in 3 panels:
* Left panel : Busy Lamp Field and users search
* Central panel: Calls
* Right panel: Waiting queues and calls history

There is also a hamburger menu, where some configuration settings can be edited.

=== Left panel ===
==== Busy Lamp Field ====
[[File:Switchboard app BLF contact.png|thumb|switchboard_app_blf_contact.png/|switchboard_app_blf_contact.png/]]
The '''BLF''' is displayed on the left panel. There all the users replicated from the PBX are displayed and it can be undocked and displayed on another window.
Information displayed by user:
* Profile picture
* Presence
* Common name
* Phone number
* CFx label if a CFx is configured (destination of the CFx is visible with a click on the label)

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a call by using the phone button
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display users detailed contact information
* Create BLF groups
* Re-arrange BLF groups by moving one entry '''on top of''' another entry in order to place it '''before it'''.
* Add a user to a BLF group
* Delete a user from a BLF group by long press left mouse
* Call Breaktrough on configured CFB or CFU

The BLF contacts is limited to PBX users and Contacts from the Contacts App with the proper detailed information. A Name, sip-name and number must be available as minimum information

==== Users search ====
[[File:Switchboard app contact information search result.png|thumb|switchboard_app_contact_information_search_result.png/|switchboard_app_contact_information_search_result.png/]]
The '''users search''' (Search-API) can be done with the input field. This input field can also be used to directly dial using the phone button.
Information displayed by user:
* Profile picture
* Presence
* Common name
* CFx if configured

Actions allowed:
* Select a user to Transfer a call by clicking on it
* Start a chat
* Start a call
* Start a Breakthrough call on CFB or CFU
* Send an email
[[File:Switchboard app BLF contact information detailed.png|thumb|switchboard_app_blf_contact_information_detailed.png/|switchboard_app_blf_contact_information_detailed.png/]]
The user '''details''' can also be expanded by clicking on the arrow icon.
Data displayed (read only) for the user:
* Profile picture
* Common name
* SIP
* Phone number
* Email
* PBX
* Node

Data displayed that can also be edited for the user (if the user has the appropriate rights):
* Presence note
* Presence
* Call diversions
* Mobility

Actions allowed:
* Start a chat
* Start a call (by SIP and phone number)
* Send an email
* Send a "Call me back" notification by email
* Add the user to a BLF group

=== Center panel ===
On the center panel the calls are displayed.

==== Calls ====
The calls are divided in 5 sections: in the waiting queue, incoming, outgoing, parked and transferred.

Depending on the call state, different '''actions''' are allowed to manage the calls:
* Connect/Disconnect a call
* Mute/Unmute a call
* Hold/Release a call
* Park/Unpark a call
* Transfer a call to a user or connect 2 calls
* Pick up a transferred call or a call from the waiting queue

=== Right panel ===
On the right panel the waiting queues and the calls history are displayed.

==== Waiting Queues ====
On the right panel the '''waiting queues''' are displayed. They can be added by clicking on "Add waiting queue" (only displayed if the user has the appropriate right), which will automatically add the user to the given group. The calls will be displayed on the calls section and from there they can be picked up or transferred to an user.

==== Calls history ====
On this panel also the '''calls history''' is displayed, which is received from the Call List-API.

Information displayed on entry:
* Call flow
* Call information (source/destination, date and duration)

Actions allowed:
* Start a call
* Start a chat
* Send an email
* Send a "Call me back" notification by email
* Display contact information
* Add the user to a BLF group

=== Hamburger menu ===
On the hamburger menu the '''shortcuts''' can be edited and the size of the users items from the BLF can be customized.
==== Edit shortcuts ====
To edit a shortcut, the shortcut must be selected and then the desired key pressed. Afterwards it has to be clicked again to finish the editing. To remove a shorcut, select the shortcut and press the "Del" key on your keyboard.

==== Size of the user items (BLF) ====
There are 2 different size:
* Icons only: only the profile picture, presence and common name will be displayed.
* Detailed large: the phone number and the call button are displayed too.

==== Limit displayed calls in waiting queues section ====
Different view of incoming calls in the waiting queues section
* If enabled: a short list of incoming calls will be shown and a scrollbar will appear in this section
* If disabled: a long list of incoming calls will be shown.
The amount of showed calls in both scenarios depends on the used display size and resolution configuration (adaptive design)

==== Select monitored device ====
If a device is selected, all the calls from/to that device will be monitored by the app.

==Additional information==
===Licensing===
* When using the OperatorV13 license in a pre V13r2 release, and you want to use the Switchboard App instead in a > V13r2, you need to download a new license file from my.innovaphone
* Upgrade from Operator, the Operator13 license will result in 3 times App(innovaphone-switchboard)13 in addition.

===Reverse Lookup from Contacts===
For Reverse Lookup to work both for Queue-calls as Operator-calls, the Directory must have the correct Access Rules:
* if the directory has no ACL-rules => will work for Queue- and Operator Calls
* if the directory has ACL-rules => a rule for each object (WQ and Operator) must apply:
** the name of the WQ/Operator-object
** an active group of the WQ/Operator

===Info field for BLF contact details, Operator Note===
The Switchboard Operator can use the Contacts App to add or edit the contact details with the Info field, to show additional information like an "Operator Note".

The information added to the Info field, will be shown in the detailed view of a BLF Contact or in the detailed view of a searched contact at the bottom as additional information aka "Operator Note"

==Known issues==
* When closing the Switchboard App, the user will be logout of all the waiting queues groups. When opening the app again, the user will be automatically logged-in on this groups again. (This is by design)
* Shortcuts may not be triggered on the Switchboard App if the app is not on focus. For this just click on the UI of the app.
* If a softphone is being monitored, the Softphone App must be opened on background. Otherwise the RCC-API will not sent calls information to the Switchboard App. Since >= V13r3 this will be done automatically.
* If no (soft)phone device has been selected on the hamburger menu of the Switboard App, the calls may be displayed duplicated because that means that the app is monitoring all the devices. To avoid this please select your default (Soft)Phone App on the phone devices section.
* When using the Softphone App with the same name and hardware-id on multiple devices (PC and Smartphone) an incoming call will be shown more than once, depending on the amount of used devices. You can add a Softphone with different naming and hardware-ID for the Switchboard User to use with the Switchboard App only.
* As Switchboard App "Operator" you will work mainly with the Switchboard App. To have video from internal callers, you need to have a (Soft)Phone App open in the background. Deselect your Default Phone device in the myApps otherwise this App will get focus during the incoming call and on connect after answering a call. Best Practice to undock the Video from your (Soft)Phone App in the background and deselect the option "Bring AppSharing/Video always to front" as this would bring your (Soft)Phone App to the front as well.
* When using Softphone App on X multiple devices, incoming calls will be displayed X multiple times. In scenarios where the Switchboard App user has multiple devices with myApps(Smartphone, tabblet, PC) it might make sense to create a Softphone with different name for each device or at least for the device where you want to use the Switchboard App with the Softphone App. Using different names for the Softphones, creates respectively different hardware-ID's. This assures that only the selected specific Softphone App and device will be monitored by the Switchboard App based on this specific name and HW-ID.
* If LDAP contacts are not displayed on the search results, please check if the rights for the LDAP object have been given to the Switchboard App.
* It is possible that the app instance needs to be restarted if the PBX name has changed on the hamburger menu of the Switchboard Admin App.
* Use unique group name per waiting queue. The Group and group name, assigned to your waiting queue, should not be (re)used for other Waiting Queues or other groups.

==Trouble shooting==
* If any issue can be reproduced, open the console output of your browser or right-click and inspect in the native client version of the Switchboard App. Clear the console output and reproduce the issue and copy past the output as a textfile and send this attached in your support ticket.

==Related Articles==
* SDK Integration (if the content is available)

Reference14r1:Concept Contact Widgets

2025-10-24T09:04:49Z

Kpe: /* Adding Agent to Widget */

[[Category:Concept|Conference]]

= Applies To =
* innovaphone PBX from version 14r1
* innovaphone Application Platform

= Requirements =
* innovaphone PBX
* innovaphone Application Platform
* Firmware Version 14r1
* One '''Port License''' is used by the app service to establish a VoIP registration at the PBX
* '''Video License''' (optional) is required to establish video connections [*]
* '''Widget License''' (optional) is required to remove any 'innovaphone' branding from the Widget UI

[*] '''UC License''' can also be used since it includes a '''Video License'''

= What is a Contact Widget? =
A Contact Widget (or Website Widget) is an element that can be added to a website. It offers to website visitors a way to get in contact with agents (e.g. help-desk). Website visitors can start chat sessions (asking questions, getting answers) or can start voice or even video calls.

An nice example for a "Sidebar Widget" can be viewed [https://www.innovaphone.com/de/ip-telefonie/innovaphone-pbx.html here]. 
When you have opened this website the Sidebar Widget comes slowly into view on the right side.

Example of a Business-Cards-Widget:

[[File:Cardset-widget.png]]

Example of a Sidebar-Widget:

[[File:Sidebar-Widget.png]]

= Overview =
[[File:Concept-widgets-overview.png|thumb|Overview]]
The central part of the new Widgets-Concept is the '''Contact-Widgets-App'''.
The Contact Widgets App is installed on the innovaphone Application Platform and it allows a PBX user to define Contact Widgets.

Contact Widgets can be integrated in a Website to offer easy ways to website users to contact '''Agents'''. Agents are PBX users meant to communicate with external clients. 
There are 2 fundamental types of Contact Widgets:
* '''Sidebar Widgets'''
* '''Business Cards Widgets'''

A Sidebar Widget appears one side of the website trying to take as less space as possible. The website visitor can expand the Sidebar Widget if interested. 
A Business Cards Widget appears as integrated part of the website content, offering one (or more) contacts in form of ordinary business cards.

= Configuration =
For non experienced technicians have a look at [[Howto14r1:Install_Contact_Widget_App#Installation]] and follow the installation steps mentioned in the how-to article.

Others:
* Download the 'Contact Widgets App' via App Store.
* Install the App on the App Platform Manager.
* Create an instance for the Widgets App on the Manager. We recommend to use no capital letters and no special characters (also not such as space).
* Create a new PBX Object with the PBX Manager Plugin. (*)
* Assign App to authorized (admin) users, which will be allowed to create/change/delete Contact Widgets.

Experts:
(*) You can also create the PBX Object manually: 
* Create a new object of type "App".
* Give it a "Long Name" ("Contact Widgets") and a Name ("widgets") same as the instance-name.
* Give it a password, same as the instance password.
* On the "App" tab configure URL to App Service on App Platform ("http://<ipaddress-or-dnsname>/<instance-name>/innovaphone-widgets").
* Activate option "Websocket"
* Grant access to APIs: "PbxSignal" (mandatory), "Admin" (optional) and "PbxApi" (mandatory)

= Using the Contact Widgets App =
Click on one of the buttons (depending on what type of widget you want to create):
* [+ Add new sidebar widget]
* [+ Add new business cards widget]
A new (empty) widget is displayed. You can give the widget a name by clicking the pen-symbol. The widget name helps to identify widgets as soon the number of widgets starts to grow. 
You can expand and collaps widgets by clicking the header of each widget.
[[Image:Widget-code-new-widget.png|thumb|New Widget]]

== Creating a new Widget ==

New Widget features and options

*You can add the main contact details for this widget
*Select the default language
*Set your prefered font settings *
*Change the colour settings *
*Change the margin settings *
*z-index
*Options Require license (when this checkbox is ticked, this widget will consume 1 license of type: Service(innovaphone-widgets) and the widget will be shown without advertisement)
(* By default, the Widget will use the default website font, colour and margin settings. Change can be needed depending on the website settings)
[[Image:Widget-new-widget-features.png|thumb|Widget Features]]

== Adding Agent to Widget ==
You can add and remove Agents to a Widget. Agents can be contacted by external website visitors. 
New agents are added by clicking the [+] button inside the agents container.
[[File:Adding-new-agents.png|thumb|Adding agents]]
A dialog opens where you can define the agent. It all starts with the agent's 'SIP-ID'. That's the dialable PBX user address. You can use the search function to find a PBX user by name.

There are several (optional) attributes you can set for an agent, like 'Display name', 'Phone number', 'Email address' and 'Picture'. A picture can be placed by drag & drop or can be selected from local disk by clicking the placeholder rectangle.

Finally you can define the ways of communication the agent is available for:
* Voice-only calls
* Video calls (including voice)
* Chat
* Email

For a Business-Cards-Widget the order of agents could be relevant. You can change the order of agents in the Widgets-App by easy drag & drop using the mouse.

Each widget gets a unique ID (uuid) assigned on its initial creation. This uuid is used to identify the widget when it is integrated into a website.

In case of a sidebar widget, the agent's card will be displayed by default depending on its status(availability) unless you checked "Always show widget" under the sidebar settings.

In case of a business cards widget, the agent card will always be shown, but its availability is depending on its status.

The following settings are possible:
* Presence*: Display/availability of the card based on the presence status of the agent. Presence available (green), Presence unavailable, busy (red). Usage: Normal agent based on availability.
* Always online: Permanent display/availability of the card regardless of its presence or busy status. Usage: Multiple consecutive calls to the same destination, an agent with multiple line configuration, a group or waiting queue.
* Boolean*: Display of the card depending on the true status of a Boolean object. Usage: Agent, group or waiting queues based on boolean settings.
* Inactive: Agent card is permanently in the status unavailable (red). Usage: Showing the agent in a business cards widget, but limit the access to the agent for a longer period. (holiday, sick-leave or other reasons)
'''Important!''': Presence and boolean status are dependent on the visibility configured on all the monitored objects, eg. agent user objects and monitored boolean objects. The boolean object must have the visibility option "calls" checked before adding the boolean to the widget!

= Integrating Widgets into Website =
Now it is the website admin's turn to integrate the widget into the website. 
To do this, click the [Code] button in the Widgets App at that widget you want to include. A popup appears showing a handful of code lines (HTML and Javascript). 
[[File:Widget-code-popup.png|thumb|Code Popup]]
You can ''copy'' the code lines into clipboard by clicking the [Copy] button. 
You can ''paste'' the code lines from clipboard into your website code. 
There's also a [Download] button. When clicking this button a small HTML file is saved on your local computer. This HTML file can be opened in a browser to preview the widget and test the widget's functionality.

== Content-Security-Policy ==
If the website uses Content-Security-Policy (CSP) it could be necessary to add entries to config sections 'default-src' and 'img-src'.
* The Widget opens a secure websocket connection (wss:)
* The Widget loads images via Data-URL (data:).
* The Widget uses Mail-Links (mailto:).
* The Widget uses Tel-Links (tel:).
<meta
http-equiv="Content-Security-Policy" content="
default-src 'self' '''wss://*.innovaphone.com'''; child-src 'self' '''mailto:''' '''tel:'''; img-src '''data:'''"
/>

= After Integration =
Once your widget is live on the website you can still change and update the widget in the Widgets-App. You can update the list of agents or change any other attribute. As soon as you click the widget's [Save] button any open widget instance in a web browser will update immmediately. No need for the website administrator to update the code.

= Widget-API — Protocol between Website Widget and App Service =
Basically, this section does not matter. To create and use widgets, knowledge about the protocol is not required. 
All who are interested in technical details are welcome to read on.

== Loading the Widget ==

When a widget is loaded in the browser window of the website visitor, a websocket connection is opened to the app service on the innovaphone Application Platform. Once the websocket connection is established it goes like this:
<pre>
[1] {"mt":"Start","uuid":"fadc5da4cae94bfc9434d9957ea08ccb"}
[2] {"mt":"Session","name":"Visitenkarten","lang":"de","strings":{...}}
[3] {"mt":"Info","id":"atlantis","dn":"Atlantis","department":"","phonenumber":"","email":"","company":{},"presence":"online","media":["voice","video","email","chat"],"order":0}
[4] {"mt":"GetPicture","id":"atlantis"}
[5] {"mt":"Info","id":"columbia","dn":"Columbia","department":"","phonenumber":"","email":"","company":{},"presence":"offline","media":["voice","video","email","chat"],"order":1}
[6] {"mt":"GetPicture","id":"columbia"}
[7] {"mt":"IceConfig","stun":"stun.innovaphone.com","turn":"turn.innovaphone.com"}
[8] {"mt":"Picture","id":"atlantis","url":"data:image/jpeg;base64..."}
[9] {"mt":"Picture","id":"columbia","url":"data:image/jpeg;base64..."}
[10] {"mt":"Info","id":"atlantis","dn":"Atlantis","department":"","phonenumber":"","email":"","company":{},"presence":"offline","media":["voice","video","email","chat"],"order":0}
[11] {"mt":"Info","id":"atlantis","dn":"Atlantis","department":"","phonenumber":"","email":"","company":{},"presence":"online","media":["voice","video","email","chat"],"order":0}
</pre>

[1] The "Start" request is sent with the unique id of the widget. 
[2] The app service sends the "Session" response providing the widget's display-name and other parameters. 
[3]-[6] The app service sends "Info" messages for all configured agents. Each "Info" message triggers a "GetPicture" request to get a picture of the agent. 
[7] The app service sends "IceConfig" providing the STUN and TURN config required for media calls. 
[8]-[9] The app service sends "Picture" messages for all agents. 
[10]-[11] The presence of an agent may change over time. Presence updates are provided with "Info" messages.

== Initiating a call ==

<pre>
[1] {"mt":"CreateCall","dest":"atlantis","dn":"Mein Name"}
[2] {"mt":"Channels","cmd":"PROPOSAL","sdp":"..."}
[3] {"mt":"CallInfo","state":"alerting"}
[4] {"mt":"CallInfo","state":"connected","cmd":"SELECT","sdp":"..."}
[5] {"mt":"ClearCall"}
[6] {"mt":"CallInfo","state":"terminated"}
</pre>

[1] "CreatCall" message sets the target of the call ('dest') and the own display name ('dn'). 
[2] "Channels" message provides the media offer for this call. Complete SDP offer is provided. 
[3] "CallInfo" is received giving information about the call's current state. 
[4] Next "CallInfo" is received telling the call was answered and deliviering the remote side's media answer. 
[5] Web site user terminates the call. 
[6] The final "CallInfo" message is received. 

= Known issues and limitations =
* The widgets are not multi-instance capable. Multiple widgets on one and the same website are not possible. Every subpage on the website can have its own widget.
* We have seen some cases where an existing web widget from other software did have a negative impact on our widget on the website. Rearranging the widget in the HTML code might help.
* The number of Agents in a single Sidebar or Business Cards is limited by the length of the sidebar/business card configuration. Just over 100 agents will normally not be a problem. From V15r1sr4 onwards a config check has been built in to prevent too lengthy configurations, so this version is recommended for sidebars and business cards with plenty of agents.

= Troubleshooting =
<big>If an issue can be reproduced</big>

'''*Web visitor in a browser.''' 
The myApps web uses the logging facilities provided by the browser it runs in (i.e. JavaScript function <code>console.log</code>). In most browser this is available as ''Console'' after pressing F12.

'''*The called agent working with myApps client.''' 
The myApps platform services provide more elaborate tracing mechanisms. See ''Troubleshooting'' in [[Reference14r1:Concept_myApps_platform_services#Troubleshooting|Concept myApps platform services]].

'''*Troubleshooting AP Services on the AP.''' 
Troubleshooting a specific App instance on the AP [[Courseware:IT_Plus_-_Tools_for_Troubleshooting#App_Service_Logs|Courseware:IT_Plus_-_Tools_for_Troubleshooting#App_Service_Logs]]

Go to the AP Manager and select the App instance from the Contact Widgets App.
Click on Diagnose and make sure that the box App is ticked.
[[File:AP-Diagnostics.png|thumb|none|AP-Diagnostics]]
Make sure that the logging of the App instance has been activated.
[[File:AP-DiagnosticsLogging.png|thumb|none|AP-Diagnostics-Logging]]
= Related Articles =
[[Howto14r1:Install_Contact_Widget_App|Howto14r1:Install_Contact_Widget_App]]

Reference15r1:Concept App Service Devices

2025-10-20T11:09:25Z

Kpe: /* Apps */

[[Category:Concept|Apps]]
The App Service Devices is an App Service which can be installed on an innovaphone App Platform. It is used to administrate the innovaphone devices which belong to the whole installation.
== Applies To ==

* innovaphone PBX from version 13r1

== Apps ==

=== Devices App (innovaphone-devices) ===
This is the standard UI App for Devices.

Parameters:

;Websocket: to publish the com.innovaphone.devicesui-API, which can be used to link directly to devices (which is done e.g. inside the Events app)

=== Devices API (innovaphone-devices-api) ===
This is a hidden App, which provides the Devices API (com.innovaphone.devices). This API can be used to find and communicate with devices which are registered to the Devices App.

Additionally it acts as a provider of the Search API (com.innovaphone.search). So you can find devices and domains in other apps like the Search App.

Parameters:

;Hidden: DevicesApi must be a hidden App
;Websocket: to get the URL of the Devices App itself which is used for provisioning

== PBX Manager Plugins ==

=== Devices ===

With the Devices plugin App objects can be created, edited and deleted for Devices and the Devices API on the PBX.

== Concepts ==
All innovaphone hard phones and gateways starting from version 13r1 can establish a registration inside the Devices App and therefor administrative tasks can be performed through the App.

=== Domains ===

In a hosted environment, it might be needed to add multiple domains to the Devices App. 
After the initial installation of Devices through Install, you have administrative rights and can add more domains.

==== Administrative rights ====
You have administrative rights if the configured PBX App object for Devices uses the password of the instance which is configured in the Manager App and the PBX uses the same domain as this instance.

==== Domain local rights ====
You have just rights to a certain domain if the configured PBX App object for Devices uses the domain password which can be configured in Devices for each domain and the PBX uses the same domain name as configured in Devices.

==== Assign rights to other domains ====
Domains can gain access to other domains by configuring these access rights in the Devices App.

==== Deploy passwords and access rights ====
During install, a domain is created inside the Devices App. There is a checkmark Deploy the domain password on all devices which is set by default and which is the same as the administrative password.
If you change the domain password, all passwords on all administrative devices and app platforms which are connected to this domain will be also changed. 
Since 13r2sr25/13r3sr7/14rx: devices which are auto provisioned or provisioned through the Profile/Users Admin App will get a random password instead of the domain password.
If you add a phone device manually to a domain inside the Devices App, this phone device will also get a random password. Other device types added manually or devices added with a provisioning code which has been created within the Devices App directly, will get the domain password instead. 
 
This will also set the manager password and the SSH passwords of App Platforms. 
 
The clear text random passwords can be requested and viewed in the settings of a device in the Devices App.

Attention: If you untick the '''Deploy administrative devices passwords''' checkmark, the password won't be deployed anymore, but also not reconfigured to the default password!

Attention: After each reconnect of a client, the password will be deployed again.
This means, if the checkmark is set and you set another password somewhere else (e.g. under General::Admin),
this password will be just valid until the next reboot or reconnect to the Devices App!

;Create new random passwords
You can rollout new random passwords by unticking the '''Deploy administrative devices passwords''' checkmark and ticking it again. 

;Devices with multiple domains (Cloud)
In a hosted environment, you can use the Devices App with multiple domains. The corresponding instance of Devices has a configured domain and an instance password set inside the manager. 

The hosting PBX has a domain inside Devices with a specific password. 
If this domain name matches the instance domain of the Devices instance and the password matches either the instance password or the domain password, you will be logged in as admin and have access to all domains. 

Each newly created domain has its own password inside Devices. If you create an App Object inside a PBX with this domain and the password of this domain (inside Devices), you will just have access to this single domain. 

Devices also has the possibility to grant access to other domains for a specific domain.

=== Categories ===

There are two types of categories:
* provisioning category: used for device configurations and provisioning
* standard category: used for update/backup jobs and device management

Each device can have just a '''single''' provisioning category, as it receives it's configuration by all configured device configurations for this provisioning category.

In addition, a provisioning category, which is used inside an analogue phone/phone device configuration '''cannot''' be used to provision a gateway.

=== Device connections ===
The Devices registration is done through a websocket connection to the webserver of the App Platform and the Devices instance (standard HTTP/s port). 
The URL used can be configured manually under [http://wiki.innovaphone.com/index.php?title={{NAMESPACE}}:General/Devices_Registration Devices Registration] or through a new provisioning mechanism. 
 
A binary protocol is used to transfer information between the device and the devices App. The MAC address is the unique key to identify a device. 
 
If a device is added to a domain in Devices, the device gets a unique random password. Without such a password, a device shows up as '''unassigned''' in the Devices app.
This is also the case after a long reset or when the device lost its configuration. 
 
In such a case, the device has to be manually added again to a domain or it has to be provisioned again.

If a device is not assigned to a domain or provisioning category, it won't receive any configurations.

==== Devices Registrations ====
See [http://wiki.innovaphone.com/index.php?title={{NAMESPACE}}:General/Devices_Registration Devices Registration]

==== Second Devices Registration URL ====

The firmware has a second SYSCLIENT2 module, which can be configured to point to a different Devices instance and the AP Manager also has a second Devices Registration URL. 
 
If you use this configuration option, you should take care and consider:

* if the Devices domain from the second configuration provides a password for all devices, the password is ignored, as it would lead to inconsistend passwords otherwise (from 13r1 SR12 on)
* the Devices domain from the second configuration should not provide Devices Configurations or Update Jobs as these might collide with configurations from the first Devices instance!

Generally, only one of the two ''Devices'' App instances connected to the device must apply changes to the device.

We strongly discourage the usage of this second configuration option due to unexpected behaviour if incorrectly used!
Never use the second URL if you use software or hardware rental!

==== Device information ====

The following data is transferred:
* MAC address
* device type (e.g. IPVA, AppPlatform, IP112)
* IP addresses (IPv4, IPv6)
* version (not searchable)

You can also search for this data inside the devices tab in the App.


=== Provisioning ===
Devices can be added by provisioning (both phones and gateways).
The standard online provisioning looks like this:
* a user or administrator creates a provisioning code in the Devices or Users App (this stores the Devices URL on the provisioning server side)
* a device with 13r1 or newer is connected to the network after a long reset
* the provisioning code has to be entered within one hour (after one hour, the Update URL isn't polled anymore)
* the device sends this code to config.innovaphone.com and retrieves the Devices URL
* the device connects to the Devices URL and is added to the domain where the code has been created

There is also an [http://wiki.innovaphone.com/index.php?title={{NAMESPACE}}:Concept_Offline_Provisioning offline provisioning mode]. 
There is also an [http://wiki.innovaphone.com/index.php?title={{NAMESPACE}}:Concept_Provisioning#Automatic_provisioning automatic provisioning mode].

Note: provisioning is cancelled if the device already belongs to another domain in the same Devices instance! This prevents the unauthorized move of a device between different domains.

==== Devices Registration URL ====

The Devices Registration URL which is set through the provisioning process, always starts with '''wss'''. This is not dependent anymore on the App URL which is configured inside the PBX Devices App object.

=== Updates ===
The Devices App can be used to rollout updates. 

==== JSON files ====
The update files have to be acccessible on a webserver without authentication and four json files are used:
* firmware.json: innovaphone device firmware
* apps.json: Apps for the App Platform
* software.json: contains software for DECT handsets
** just IP64 and IP65 are used and supported
* phoneplatform.json: contains the phone platform image for e.g. the IP270

You can either use the standard innovaphone App Store for these files or your own local webserver. 

==== Update jobs ====
You can configure several update jobs with different categories to organize your updates. 
Update jobs are always sequentially processed and inside one update job, just '''20''' devices are updated at the same time.

==== Device update check after the update job has been already executed====
If a device goes online, the newest suitable update job is searched for this device (depending on the categories). 
If an update job is found, the update is just performed, if there has been '''no''' successfull update for this device in this job before and the version does not match (simply string compare).

====Update errors====
If an update fails, the Devices App shows an error. You may have to enable further tracing on the updated device itself to find out the reason of the failure. 
 
* on a gateway/phone add a trace flag to the UP1 and HTTPCLIENT0 module and take a look at the events which may already tell you the reason
* on an App Platform, enable the App and HTTP Client trace flag on the manager

An update job is retried '''two''' times if updates inside this job failed. The retry is done '''ten''' minutes after the update job finished previously.

====innovaphone myApps====
The path to the App Store and the used innovaphone myApps version is updated to the version of the gateway on gateways with an enabled PBX after a successfull update. 
This configuration can be found [http://wiki.innovaphone.com/index.php?title={{NAMESPACE}}:PBX/Config/myApps here]

Inside the configuration on an update job, the flag "Do not update myApps launcher software" disables the update of the innovaphone myApps version inside PBXes.

====DECT handsets====
If you check the update DECT handsets checkmark, all DECT devices will be configured to rollout updates to DECT handsets. 
See [[{{NAMESPACE}}:Concept_App_Service_Devices#Supported_DECT_handsets | Supported DECT handsets]].

The DECT handset firmware will be searched inside the configured software.json.

=== Backups ===
The Devices App can be used to backup the configuration and data of Apps and devices. 

====Webserver requirements====
Backups are stored on a webserver with or without Digest/Basic authentication and with the '''webdav PUT''' method.

====Backup jobs====
Backup jobs are executed sequentially. Inside one backup job, just '''20''' backups are performed at the same time.

====Phones or gateways====
The configuration file is stored. Therefor the Devices App tells the device to store the configuration with a !mod cmd UP0 /sync prot URL.

====Apps on an App Platform====
The databases of all existing instances and the manager are stored. 
Each installed App Service can have multiple instances and each App instance has its own database. 
A database contains '''both''' configuration and data of an App instance! 
The manager database contains the webserver certificate and further manager related configuration settings.

The Devices App establishes a websocket connection to the manager and tells the manager where to store the backups. 
The manager on the backuped App Platform itself performs the HTTP requests to store the files.

====Backup errors====
If a backup fails, the Devices App shows an error. You may have to enable further tracing on the backuped device itself to find out the reason of the failure.

* on a gateway/phone add a trace flag to the UP1 and HTTPCLIENT0
* on an App Platform, enable the App and HTTP Client trace flag on the manager

=== Restore ===
====Phones or gateways====
Just as always under [http://wiki.innovaphone.com/index.php?title={{NAMESPACE}}:Administration/Upload/Config Upload Config].

====Apps====
The App Service itself has to be installed on the App Platform prior restoring of a single instance. 
The restoring is done in the Manager App on the App Platform itself. 
The instance settings, the configuration and data are restored in a single process.

=== Device Configurations ===

You can define several device configurations. These configurations are either applied to all devices inside this domain or to selected categories. 
Configurations are applied on creation and on every reconnect of a matching device.

==== Transfer checkmarks ====

Some configuration options have a specific checkmark to enable the transfer of the option. 
 
* Checkmark disabled:
** configuration option field(s) are disabled
** option values are '''not''' transferred at all
* Checkmark enabled:
** configuration option field(s) are enabled
** option values are transferred, even if field values are empty

==== Expert configuration ====

The expert configuration can be used to configure different settings which are not available inside the other device configurations. 
You can use the standard syntax of an update server script (see [[ {{NAMESPACE}}:Concept_Update_Server | Concept Update Server ]] for a general overview and the section on [[Howto:PHP_based_Update_Server_V2#Hints_for_writing_your_update_snippets | Hints for writing your update snippets ]] (note that the remainder of this article relates to the now deprecated old mechanism, so please disregard the rest)). 
 
Some hints:
* the expert configuration is just executed once after a device restarted and on change of the expert configuration itself
* the expert configuration is executed after all other device configuration types, so that you can override changes
* to make configuration changes effective, you may also need to issue a final ''config write'', ''config activate'' and ''iresetn'' command (see the [[ {{NAMESPACE}}:Concept_Update_Server#Check_command | ''check'' command]] for details)
* some commands shouldn't be used inside the script:
** [[ {{NAMESPACE}}:Concept_Update_Server#Times_command |''times'']]: since the expert configuration is executed only once after a reboot of the device and when changes are made, it does not make sense to use the ''times'' command
** [[ {{NAMESPACE}}:Concept_Update_Server#Prot_command |''prot'']]|[[ {{NAMESPACE}}:Concept_Update_Server#Boot_command |''boot'']]: use an update job instead
** [[ {{NAMESPACE}}:Concept_Update_Server#Scfg_command |''scfg'']]: use a backup job instead
** [[Howto:PHP_based_Update_Server_V2#Using_vars_create|''vars create'']]: this cmd will always raise the ''reset needed condition'' and the aforementioned ''iresetn'' command would always execute therefore. As a result, the devices would enter a boot loop. Be sure to avoid this using an appropriate [[ {{NAMESPACE}}:Concept_Update_Server#Check_command |''check'' command ]] and update its ''<serial>'' properly whenever the expert configuration is changed

==== Certificates configuration ====
You can use this configuration to rollout certificates to the trust list of your devices. 

* Manual upload certificates.
* Configure up to five URLs which are polled every 24 hours. They must return files with PEM formatted public keys (one or more) which are then rolled out.
** certificates are just rolled out if differences are determined, so if URLs are polled and no changes are detected, certificates are not rolled out again. Changes are detected by fingerprint comparison of each embedded certificate
** if a device restarts, the configuration is applied again. Just the fingerprints of the device trust list are checked against the configuration trust list and just on differences, certificates are rolled out again
* Configure https://download.innovaphone.com/certificates/innovaphone.pem to always have the innovaphone public keys in your trust list (e.g. used for our push service).
* Configure https://download.innovaphone.com/certificates/ca.pem to always have the innovaphone Device Certification Authority certificates in your trust list.
* Configure https://download.innovaphone.com/certificates/ca-unverified.pem to always have the innovaphone Unverified Device Certification Authority certificates in your trust list.
** The Unverified CA is used for non hardware devices, e.g. IPVAs, which are not shipped with an official innovaphone Device Certification Authority certificate, as innovaphone has no control over the serial number here.

Using this configuration, the trust list can only be managed through ''Devices'' because it is cleared before each rollout.

==== DECT Handsets ====

This configuration can be used to configure specific options like language, voicemail number etc. for DECT handsets. 
 
* all DECT devices like IP1202, IP1203 etc. will receive this configuration (of course just if the configured categories match)
* Devices configures a URL like https://domain.com/domain.com/devices/parameters/id.xml on the specific DEVMANBW module.
* This file is then polled by the basestations and the read values are transfered to the DECT handsets.
* see [[{{NAMESPACE}}:IP1202/IP1203_DECT_System#Configuration_of_Handset_parameters]]

See [[{{NAMESPACE}}:Concept_App_Service_Devices#Supported_DECT_handsets | Supported DECT handsets]].

=== Software rental ===
Regarding the Software Rental program and the Payment Method, please refer to:
* [[{{NAMESPACE}}:Concept_Software_Rental|Concept Software Rental]]

Software rental can be done for innovaphone Cloud installations or for software, which operates on the customer premisis. This could eventually be customer owned hardware or a privat virtual machine, managed by the customer.

==== Hardware licenses ====
Hardware licenses have to be bound on the specific device in my.innovaphone itself and currently can't be handled within the Devices App itself. So you also need to download the licenses from my.innovaphone and upload them on the device with the already known methods.

===== Hardware licenses with software rental =====
If your device has software rental licenses, you can bind hardware licenses within my.innovaphone in the software rental project itself.

===== Hardware licenses without software rental =====
If your device does not have software rental licenses, you should bind hardware licenses in a separate non rental project in my.innovaphone.

==== innovaphone Cloud ====
Inside the innovaphone Cloud, you just have to upload your activation keys with iSCs to add licenses to one or more gateways. 

==== Email expiry notifications ====
You will receive an email notification if the rental of a project expires. This notification will be sent '''seven''' weeks before the expiry and then once a week until the rental expires. 
You can configure one or more email recipients in the domain settings. 
If no email address is configured, the email address of the logged in user account is used.

==== History ====
You can download the history in the Devices App. You'll get a CSV file (semicolon separated). The date and number format depends on the selected language in the UI. 
There is also an API available for automated downloas, which is described [[ {{NAMESPACE}}:Concept_App_Service_Devices#API_to_download_rental_history|here ]].

====Own installation====
Inside your own installation, you have to register a new my.innovaphone account or you can use an existing account inside the Devices App. 
One domain inside Devices belongs to one project inside your my.innovaphone company, so you can handle multiple domains with one my.innovaphone account.

====Technical aspects====
A new rental expiration date is calculated on each license or balance change in the domain. 
So after each change new licenses with a new date are transfered to the gateways and also stored in the Devices App itself. 
If the rental expires, the gateway reboots and the licenses are not available anymore. 
The licenses are also transfered after each reconnect of a gateway to the Devices App. 
 
For license and balance changes, the Devices App must be online and have access to my.innovaphone.com!

====Usage====
You have to add (use the + symbol) a PBX and select all licenses you want to rent. 
Use the '''apply''' button to really bind these licenses. Without usage of the apply button, you can just see a precalculation of the iSCs/month and the rental end date, but nothing is really charged from your balance.

===Change of IP address/DNS name in PBX object===
If the IP address or DNS name inside the PBX object of the Devices App changes, all currently connected clients get a new Devices Registration URL and also all clients, which connect afterwards with the old host name.

== Appendix ==
=== Sample firmware.json ===
<code type="javascript">
{
"devices": [
{ "id": "IP0010", "versions": [ "13r1" ] },
{ "id": "IP0011", "versions": [ "13r1" ] },
{ "id": "IP101", "versions": [ "13r1" ] },
{ "id": "IP102", "versions": [ "13r1" ] },
{ "id": "IP1060", "versions": [ "13r1" ] },
{ "id": "IP110", "versions": [ "13r1" ] },
{ "id": "IP110A", "versions": [ "13r1" ] },
{ "id": "IP111", "versions": [ "13r1" ] },
{ "id": "IP112", "versions": [ "13r1" ] },
{ "id": "IP1130", "versions": [ "13r1" ] },
{ "id": "IP1260", "versions": [ "13r1" ] },
{ "id": "IP150", "versions": [ "13r1" ] },
{ "id": "IP2000", "versions": [ "13r1" ] },
{ "id": "IP200A", "versions": [ "13r1" ] },
{ "id": "IP22", "versions": [ "13r1" ] },
{ "id": "IP222", "versions": [ "13r1" ] },
{ "id": "IP230", "versions": [ "13r1" ] },
{ "id": "IP232", "versions": [ "13r1" ] },
{ "id": "IP24", "versions": [ "13r1" ] },
{ "id": "IP240", "versions": [ "13r1" ] },
{ "id": "IP241", "versions": [ "13r1" ] },
{ "id": "IP29", "versions": [ "13r1" ] },
{ "id": "IP3010", "versions": [ "13r1" ] },
{ "id": "IP3011", "versions": [ "13r1" ] },
{ "id": "IP302", "versions": [ "13r1" ] },
{ "id": "IP305", "versions": [ "13r1" ] },
{ "id": "IP311", "versions": [ "13r1" ] },
{ "id": "IP411", "versions": [ "13r1" ] },
{ "id": "IP6000", "versions": [ "13r1" ] },
{ "id": "IP6010", "versions": [ "13r1" ] },
{ "id": "IP800", "versions": [ "13r1" ] },
{ "id": "IP810", "versions": [ "13r1" ] },
{ "id": "IP811", "versions": [ "13r1" ] },
{ "id": "IPVA", "versions": [ "13r1" ] }
],
"versions": [
{ "id": "13r1", "build": "131705", "text": "13r1 dvl [131705]", "wiki": "" }
]
}
</code>

=== Sample apps.json ===
<code type="javascript">
{
"apps": [
{
"id": "apidemo",
"folder": "apidemo",
"binary": "apidemo",
"versions": [
{ "id": "13r1", "build": "131705", "label": "dvl" }
],
"manufacturer": "innovaphone",
"title": "Apidemo",
"description": "The Apidemo"
},
{
"id": "appstore",
"folder": "appstore",
"binary": "appstore",
"versions": [
{ "id": "13r1", "build": "131705", "label": "dvl" }
],
"manufacturer": "innovaphone",
"title": "AppStore",
"description": "AppStore"
}
]
}
</code>

=== Sample software.json ===
<code type="javascript">
{
"software": [
{
"id": "myappsandroid",
"folder": "myappsandroid",
"binary": "myapps.apk",
"versions": [
{ "id": "13r1", "build": "131705", "label": "dvl" }
],
"manufacturer": "innovaphone",
"title": "myApps Android",
"description": "myApps for Android"
},
{
"id": "myappswindows",
"folder": "myappswindows",
"binary": "myAppsSetup.msi",
"versions": [
{ "id": "13r1", "build": "131705", "label": "dvl" }
],
"manufacturer": "innovaphone",
"title": "myApps Windows",
"description": "myApps for Windows"
}
]
}
</code>

=== Sample phoneplatform.json ===
<code type="javascript">
{
"phoneplatforms": [
{
"id": "arm64",
"text": "Phone Platform",
"file": "phone-platform.img",
"folder": "yocto2",
"version": "2063"
}
],
"devices": [
{
"id": "IP270",
"phoneplatforms": [
"arm64"
]
}
]
}
</code>

=== API to download rental history ===

You can download the history as a UTF-8 CSV file with simple '''HTTP GET''' requests with '''digest''' authentication. 
The CSV file uses the semicolon as delimiter. 
 
The URL to download the history is e.g.: 
'''<code>https://mydomain.com/mydomain.com/devices/csvapi?...</code>'''

You can find this path by editing the instance in the AP manager.
In the listed paths, you'll find something which ends with csvapi

In the innovaphone Cloud environment, the URL can be retrieved by taking a look at the Devices App object inside the cloud PBX and replacing the ending '''innovaphone-devices''' with '''csvapi''' inside the App URL, so it looks e.g. like this:

https://cloud-apps0.innovaphone.com/cloud.innovaphone.com/devices/csvapi

====CSV columns====
Most columns should be self explaining, but the column '''invoice reference''' refers to a value which you can configure manually in the domain settings in the Devices App!

====Digest authentication====
You can login with two different username/password combinations, while the domain is the digest username:

* If you use the domain and password of your Devices App instance inside the AP Manager, you have automatically access to all domains. 
* If you use the domain name of any domain as digest username and the configured domain password, you'll have access to this domain and all domains to which this domain has access to

====Query parameters====
The following query parameters can be used (don't forget to URL encode the parameter values, if neccessary!):
* all: if '''1''' or '''true''', the history is queried for all domains where the digest user has access to
* domain: required, if ''all'' is not set
* lang: the output language of the CSV file, which also controls date and number formats, e.g. '''en''', '''de''', ...
* tz: the timezone for dates, e.g. '''Europe/Berlin'''
* type: two types are available:
** '''history''': history which contains changes
** '''overview''': a monthly overview with the iSC costs at the first of the last months
* from: unix timestamp (UTC) in milliseconds, ignored for type=overview
* to: unix timestamp (UTC) in milliseconds, ignored for type=overview

====Example requests====
* <code>https://mydomain.com/mydomain.com/devices/csvapi?domain=mydomain.com&type=overview&lang=en&tz=Europe%2FBerlin</code>
* <code>https://mydomain.com/mydomain.com/devices/csvapi?domain=mydomain.com&type=history&lang=en&tz=Europe%2FBerlin&from=1601903431000&to=1601903385000</code>
* <code>https://mydomain.com/mydomain.com/devices/csvapi?all=1&type=overview&lang=en&tz=Europe%2FBerlin</code>

=== Supported DECT handsets ===

The following handsets are supported for update jobs and the DECT handsets configuration:

* IP64
* IP65
* D81
* D83

== Known issues ==

===SoftwarePhone===
The Devices App is not meant to be used with the windows SoftwarPhone standalone installation.

== Related Articles ==
* [[Howto:Software_Rental]]