innovaphone wiki - User contributions [en]

Howto:Gigaset-DeskPhone-App - Gigaset - Partner App

2025-11-26T13:33:04Z

Radu.timar: /* Functions */

[[Image:Gigaset-logo.png|200px|right|gigaset-logo.png/|gigaset-logo.png/]]

==Product Name==


[[Image:Gigaset-DeskPhoneApp-Logo.png|100px|gigaset-deskphoneapp-logo.png/|gigaset-deskphoneapp-logo.png/]]
[https://www.gigaset.com Gigaset] Gigaset-DeskPhone-App

==Certification Status==



{{Template:Compat_Status_referral_product_new|type=App}}

This App has been listed July 2025.

==Category==

[[Category:Partner Apps|{{PAGENAME}}]]
{{Category:3rdParty_Terminal_Devices}}
[[Category:3rdParty Terminal Devices|{{PAGENAME}}]]

==Vendor==



[[Image:Gigaset-LOGO.png|150px|gigaset-logo.png/|gigaset-logo.png/]]



With innovative communication solutions from Gigaset professional, your organisation can unlock its true potential and stay ahead of the competition.
Our cutting-edge telephony technology is delivered by a community of dedicated partners that can help you create a complete communications solution rather than a multitude of products.
With Gigaset professional, you gain access to an open platform designed for its user-friendliness, flexibility and outstanding performance, while offering seamless compatibility with leading on-premise telephony systems and cloud-based service providers.

[https://www.gigaset.com/pro/en_en/ Gigaset - Pro]

==Description==

{| class="wikitable"
| colspan="5" |Gigaset-DeskPhone App supports:
!
!
!
|-
| colspan="5" |DeskPhone P-Series
!
!
!
|-
!
!P710 IP PRO
!P810 IP PRO
!P810B IP PRO
!P820 IP PRO
!P825 IP PRO
!P850W IP PRO
!P855BW IP PRO
|-
!
![[File:P710.png|frameless|p710.png/|p710.png/]]
! colspan="2" |[[File:P810.png|frameless|p810.png/|p810.png/]]
! colspan="2" |[[File:P82x.png|frameless|360x360px|p82x.png/|p82x.png/]]
! colspan="2" |[[File:P85x.png|frameless|358x358px|p85x.png/|p85x.png/]]
|-
|
|
| colspan="2" |
| colspan="2" |
| colspan="2" |
|-
|Display
|2,8" TFT colour
| colspan="2" |3,36" TFT colour
| colspan="2" |5" TFT colour
| colspan="2" |5" TFT colour
|-
|Resolution (pixels)
|320 x 240
| colspan="2" |320 x 240
| colspan="2" |480 x 272
| colspan="2" |480 x 272
|-
|Tiltable display
| -
| colspan="2" | -
| -
|Yes
| -
|Yes
|-
|LAN switch
|2 ports, Gbit
| colspan="2" |2 ports, Gbit
| colspan="2" |2 ports, Gbit
| colspan="2" |2 ports, Gbit
|-
|PoE
|IEEE 802.3af, class 2
| colspan="2" |IEEE 802.3af, class 2
| colspan="2" |IEEE 802.3af, class 3
| colspan="2" |IEEE 802.3af, class 3
|-
|IP
|IPv4 & IPv6
| colspan="2" |IPv4 & IPv6
| colspan="2" |IPv4 & IPv6
| colspan="2" |IPv4 & IPv6
|-
|WLAN IEEE 802.11n/ac
| -
| colspan="2" | -
| colspan="2" | -
| colspan="2" |Yes
|-
|Bluetooth
| -
| -
|Yes
| colspan="2" | -
| -
|Yes
|-
|Headset connection via
|EHS/DHSG/RJ9 interface
| colspan="2" |EHS/DHSG/RJ9 interface
| colspan="2" |EHS/DHSG/RJ9 interface
| colspan="2" |EHS/DHSG/RJ9 interface
|-
|Function keys
|4 self labeling
| colspan="2" |4 (12) self labeling
| colspan="2" |8 (28) self labeling
| colspan="2" |10 (36) self labeling
|-
|G.711 A-law, µ-law

G.722 (wideband)

G.726, G.729AB, GSM 6.10 (FR)
|
| colspan="2" |Yes
| colspan="2" |Yes
| colspan="2" |Yes
|-
|Soft-keys
|4
| colspan="2" |4
| colspan="2" |4
| colspan="2" |4
|-
|SIP accounts
|6
| colspan="2" |12
| colspan="2" |12
| colspan="2" |12
|-
|USB
|No
| colspan="2" |1
| colspan="2" |1
|2
|1
|-
|P800 KEY PRO support
|No
| colspan="2" |via USB
| colspan="2" |via USB
| colspan="2" |via USB
|-
|GRAPE (Redirect and Provisioning)
|Yes
| colspan="2" |Yes
| colspan="2" |Yes
| colspan="2" |Yes
|}


The Gigaset DeskPhone App integrates the Gigaset P-Series IP PRO Phones into the innovaphone PBX environment.
After the initial setup, user and phonebook management can be done from the innovaphone myApps environment,
so that no further activities need to be performed on the Gigaset Phones.

==Functions==




* Add / Remove Gigaset DeskPhones
* Configure the Phonebook, keys and PBX Menue on Gigaset DeskPhones

With the Gigaset DeskPhone App it is possible to automatically add and remove DeskPhones.
In addition, the Phonebook, keys and PBX Menu configuration can be provisioned.

===Multi-PBX ready===




n.a.

===Cloud ready===



YES

== Provided APIs ==




* Websocket
* AdminApi
* TableUsers
* Services
* PbxApi

==Licensing==


No license is required for this app

==Prerequisites==


For BLF key signaling and pick-up a Group is needed where all phones are member of and logged in.

a PBX Object DTMF Features must be configured, with activated "Autocomplete '#'"

The app must not be installed and set up via myApps, that must be done via browser!

Because the connection from myApps to the app platform is only recognised as an http connection by SDK, even if https is used.

at least knowledge about installing an App on the AP Platform and adding the App Object via PBX Manager

''If the instance is operated in the innovaphone myApps Cloud, please request the following approvals on the Cloud RP via ticket at cloud@innovaphone.com, specifying the “instance number|domain name”:''

''musterschuster-p.innovaphone.com -> SIPS 5061 mit Check Certificate''

''musterschuster-a.innovaphone.com -> SIP 5060 (= Realm'00')''

''If you require additional realms for multiple customer master locations, e.g., for multiple Gigaset apps or instances, the following must also be requested:''

''musterschuster-a.realm01 -> SIP 50601''

''- bis max. -''

''musterschuster-a.realm50 -> SIP 50650''

==Versions==


===Compatible innovaphone firmware versions===

* innovaphone V14r2
* innovaphone V15r1 final

===Application versions used for interop testing===


* Gigaset DeskPhone-App - 142001 sr1

* innovaphone V15r1 final
* Gigaset Desktop IP PRO 10.1.198.16

==Configuration==


===Install the App===

===Gigaset - DeskPhone - App===

==== innovaphone settings ====
As an admin, create the environment settings in the Gigaset DeskPhone App.

For the innovaphone PBX, enter the domain, the IP address of the PBX or the FQDN, the SIP- or SIP-TLS Port, the MasterPBX-Name and the PBX password. You can also set Longname or E164 as an alternative, when DN is not set. If you want to show VoiceMail Messages into Phone Display enter the VoiceMail Number. Also define if reverse proxy and/or STUN Server should be activated or not and configure it accordingly. 

[[File:DeskPhone inno settings.png|frameless|600x600px|deskphone_inno_settings.png/|deskphone_inno_settings.png/]]

==== Gigaset settings ====
Enter the parameters for the phones to reach the App Platform. SIP realm and App Platform adress as an IP adress or FQDN. Also SIP port and protocol. if you need other SIP port then 5060/5061 via reverse Proxy, maybe if you use Gigaset DECT Provisioning App in parallel, enter it here. Port to Reverse Proxy still stays as 5060/5061.

'''Please note:''' If you want to use more then one Gigaset App instance or Gigaset DECT Provisioning in parallel, you need for each instance a SIP realm and a dedicated forwarding rule to the AP must be configured on the reverse proxy!

Username and password will be set for the phones web-ui. The phone connects via SIP with the App Platform, therefore the SIP-Password is needed. You can generate a random Password by using the button below.

If activating the additional admin mode, only basic settings will be shown in the web UI. After entering the administrator mode password, the complete admin web UI of the phone will be unlocked again.

[[File:DeskPhone gigaset settings.png|frameless|600x600px|deskphone_gigaset_settings.png/|deskphone_gigaset_settings.png/]]

==== number formatting ====
access code, prefixes, country and area code will be automatically read from the system.

this settings are not used by the phone at the moment.

[[File:DeskPhone number formatting.png|frameless|600x600px|deskphone_number_formatting.png/|deskphone_number_formatting.png/]]

==== key settings ====
This DeskPhone app reads the user's key configuration in two places. 1. Configured keys of the type: Dial and Partner

and 2. The user's favorites.

You can choose the order in which these two are displayed on the phone:

* Favorites first, then keys
* Keys first, then favorites
* Do not provision any changes

[[File:DeskPhone key settings1.png|frameless|543x543px|deskphone_key_settings1.png/|deskphone_key_settings1.png/]]

and you can choose where these keys should start on the phone:

* Ocupy from first page
* Occupy from second page
* Assign to key module
* Do not provision any changes

[[File:DeskPhone key settings2.png|frameless|547x547px|deskphone_key_settings2.png/|deskphone_key_settings2.png/]]

==== PBX menu settings ====
DekPhone App will automatically provide a PBX menu to the phones, like Gigaset Feature Control App does for Gigaset DECT. [[Howto:Gigaset-Feature-Control-App - Gigaset - Partner App]]

* Directory: will provide the local innovaphone LDAP contacts for dialing
* Diversion: see actual call diversion, set/change/activate/deactivate Diversion targets for Always, Busy and on No response.
* Group: show, join and leave Groups
* Presence: see actual Presence, change Presence to Online/Away/Busy/DND
* Working: see actual status of working and Start/Stop working

[[File:DeskPhone pbxmenu settings.png|frameless|600x600px|deskphone_pbxmenu_settings.png/|deskphone_pbxmenu_settings.png/]]

* advanced call forwarding: extend the Diversion menu by Diversion Busy and on No response.
* static groups: static Groups are shown on buttom of the list.
* function key: F4 as default, but you can choose F1-F3 also, or deactivate. this are they keys below the display of the phone.
* context sensitivity of the function key: e.g. on F4 normally info button is displayed when info messages are present, and into info menu the PBX menu button will shown until all mssages ar read, which this switch you can deactivate this behavior.
* menu name: this name will be displayed on the previously selected key.

==== phone book settings ====
Under Phonebook settings you can activate sync for a phonebook.
{| class="wikitable"
|+
![[File:DeskPhone phonebook settings1.png|frameless|555x555px|deskphone_phonebook_settings1.png/|deskphone_phonebook_settings1.png/]]
![[File:DeskPhone phonebook settings2.png|frameless|542x542px|deskphone_phonebook_settings2.png/|deskphone_phonebook_settings2.png/]]
|}
there are three different phone books available, you can configure only one at a time. the same for all three, first thing to choose is phone book key and set a name that will be displayed on the key.

# the standard LDAP directory of the innovaphone PBX (PBX0), which is also integrated in PBX menu. Please enter the IP address, port and previously created access data for the innovaphone LDAP.
# LDAP server where you manuelly enter all parameters.
# Contacts APP, enter the neccessary parameters:
#* phone book key : F3 (default)
#* Phonebook key name: name that will be displayed on the key
#* Host : innoapp.domain.de (address of the AP)
#* Port : 636
#* TLS : yes
#* LDAP search base : dc=entries
#* Username : [from PBX-Manager / AP Contacts / Change Configuration / User (LDAP)]
#* Password : [from PBX-Manager / AP Contacts / Change Configuration / Password (LDAP)]
#* Name filter : (|(cn=%)(sn=%))
#* Number filter : (metaSearchNumber=%)
#* all other entries as shown in below screenshot are preconfigured

[[File:DeskPhone phonebook settings Contacts.png|frameless|762x762px|deskphone_phonebook_settings_contacts.png/|deskphone_phonebook_settings_contacts.png/]] 

==== custom provisioning settings ====
You have the possibility to add provisioning parameters by your own in xml strings. You can find an overview of provisioning parameters here: 
'''[https://teamwork.gigaset.com/gigawiki/display/GPPPO/FAQ+-+Auto+provisioning%3A+Parameters Gigaset Desktop Phone Settings] '''

[[File:DeskPhone custom settings.png|frameless|545x545px|deskphone_custom_settings.png/|deskphone_custom_settings.png/]]

 
please have in mind, that you have to replace special signs with placeholders: & - &amp;

‘ - &apos;

< - &lt;

> - &gt;

” - &quot;

Ä - &#196;

Ö - &#214;

Ü - &#220;

ä - &#228;

ö - &#246;

ü - &#252;

ß - &#223;

 

==== Advanced settings ====

* "Reload Gigaset Devices" will be reload all Gigaset DeskPhones from Devices List. Keyword is the APP-Name, which is also inserted into the Devices. Wildcards are allowed.
* Execute Provisioning NOW will send a SIP-Notify to every connected Phone to force them to pull again the Provisioning File from Provisioning App.
* Firmware URLs: if you want to Update DeskPhone Firmware by the Provisioning App enter here a Web Url where the Phone can download it. e.g. path from Gigaset Wiki Firmware File.
* provisioning via HTTP instead of HTTPS: Gigaset DeskPhones does '''NOT support self signed certificates!''' if you have no official sigend certificates, force the App to provide a HTTP Link insted of HTTPS. The fact that the Copy Link button is not displayed is a restriction in the innovaphone SDK for unsecure connections.
* generate new secret: if needed you can generate a new secret. or if you have to reinstall the app, you can copy your previously used secret in.
* provisioning path: The app generates a provisioning path from its data. This path does not change as long as you do not regenerate a new secret. Copy this path and paste it on every new phone, you have to copy the Provisioning URL into the phone via Web-Ui. Setup --> Advanced --> Update --> Setting URL: copy it here and apply. Afterwards type on the phone: Settings --> Maintenance (5) --> Synchronize Settings (4) --> Ok

 

===Add Devices to User and start Provisioning===

Now create new end devices as usual via UserAdmin or the Profile app. Select "Gigaset + ''APP-Name''" in the manufacturer selection field and then enter the MAC adress of the phone.
You can find the MAC of the phone on the box, under the phone or by pressing settings --> Information (6) --> System Info (2) on the phone.

After you have saved the new phone, you have to copy the Provisioning URL into the phone via Web-Ui.

Setup --> Advanced --> Update --> Setting URL: copy it here and apply.

Afterwards type on the phone: Settings --> Maintenance (5) --> Synchronize Settings (4) --> Ok

[[File:DeskPhone Users Admin.png|frameless|883x883px|deskphone_users_admin.png/|deskphone_users_admin.png/]][[File:DeskPhone Devices1.png|frameless|900x900px|deskphone_devices1.png/|deskphone_devices1.png/]]

[[File:DeskPhone Web-Ui.png|frameless|790x790px|deskphone_web-ui.png/|deskphone_web-ui.png/]][[File:DeskPhone Devices2.png|frameless|900x900px|deskphone_devices2.png/|deskphone_devices2.png/]]

==Release Notes==
===Update Notice===

Even though this should be the standard procedure, we would still like to point this out. 
Before installing an update, we recommend backing up the PBX and the Gigaset application on the application platform so that a rollback of the configuration is possible.

=== 142004 sr1 ===

* change in socket connection handling

=== 142003 sr1 ===

* change for MOH not working
* added SIP-Server and APP-Platform via provisioning Parameter to trusted Hosts.
* call forwardings service codes optimisation
* PBX menu Directory Edit Mode button fixed

=== 142001 sr1 ===
- Startversion 

==Known Problems==

=== ReProvisioning or check-sync for CallForwarding or others are not working after time ===
Socket connection does not recognised when the device port has changed. fixed in 142004 sr1

=== URLs are shown as http instead of https ===
The app must not be installed and set up via myApps, that must be done via browser!

Because the connection from myApps to the app platform is only recognised as an http connection by SDK, even if https is used.

=== MOH not working ===
put this parameter in the custom phone settings part:

<user_hold_inactive idx="1" perm="">on</user_hold_inactive>

=== Same SIP Port/Protocol for PBX and APP-Plattform via Reverse Proxy ===
is not working, due to load optimizations of Reverse Proxy. choose 5061/TLS for PBX and 5060/TCP for App Plattform.

===Provisioning of devices via Users Admin not working===
Please note the following for environments that do not have Internet access. In this case, the assignment of devices via the Users Admin may be disrupted.
The Gigaset App works together with the provisioning service of the Devices App. The online provisioning server from innovpahone "config.innovaphone.com" is entered as the default in the Devices app. If the environment cannot reach the server, the process is aborted.
To avoid this, offline provisioning must be configured for the domain in the Devices app.
https://wiki.innovaphone.com/index.php?title=Reference13r1:Concept_Offline_Provisioning

=== Provisioning option not available in Users Admin when giving Profile app a custom name ===
When the name or long name of your profile app PBX object differs from the default names "Profile" (long name) and "profile" (name), you won't have the option to select "Gigaset - Gigaset Provisioning" as the manufacturer of the phone if you try to create new phone registrations via Users Admin. 

=== no Audio / disconnect after 30 - Gigaset phone is connected through a Reverse Proxy ===
Media Relay works only in a LAN. For working through a Reverse Proxy a view more settings are needed. See here:
https://wiki.innovaphone.com/index.php?title=Howto13r3:Step-by-Step_Media_Relay_connection_for_third_party_phone

== Related Articles ==
*[[Howto:MyApps Cloud - Using Gigaset-Provisioning-App in innovaphone cloud environments| Howto:Using Gigaset-Provisioning-App in innovaphone myApps cloud environments]]

==Contact==
Gigaset Technologies GmbH 
Frankenstraße 2 
46395 Bocholt

Tel: +49 2871 91-0 
E-Mail: de.pro@gigaset.com

'''Support''' 
+49 (89) 8780 6575 + PIN Code 
support@gigaset.com

'''Become a partner''' 
https://gigasetportal.force.com/Partner

'''App Feature Request''' 
Dennis Zimmermann 
Technical Sales Manager 
dennis.zimmermann@gigaset.com

Howto:Gigaset-DeskPhone-App - Gigaset - Partner App

2025-11-26T13:29:34Z

Radu.timar: /* innovaphone settings */

[[Image:Gigaset-logo.png|200px|right|gigaset-logo.png/|gigaset-logo.png/]]

==Product Name==


[[Image:Gigaset-DeskPhoneApp-Logo.png|100px|gigaset-deskphoneapp-logo.png/|gigaset-deskphoneapp-logo.png/]]
[https://www.gigaset.com Gigaset] Gigaset-DeskPhone-App

==Certification Status==



{{Template:Compat_Status_referral_product_new|type=App}}

This App has been listed July 2025.

==Category==

[[Category:Partner Apps|{{PAGENAME}}]]
{{Category:3rdParty_Terminal_Devices}}
[[Category:3rdParty Terminal Devices|{{PAGENAME}}]]

==Vendor==



[[Image:Gigaset-LOGO.png|150px|gigaset-logo.png/|gigaset-logo.png/]]



With innovative communication solutions from Gigaset professional, your organisation can unlock its true potential and stay ahead of the competition.
Our cutting-edge telephony technology is delivered by a community of dedicated partners that can help you create a complete communications solution rather than a multitude of products.
With Gigaset professional, you gain access to an open platform designed for its user-friendliness, flexibility and outstanding performance, while offering seamless compatibility with leading on-premise telephony systems and cloud-based service providers.

[https://www.gigaset.com/pro/en_en/ Gigaset - Pro]

==Description==

{| class="wikitable"
| colspan="5" |Gigaset-DeskPhone App supports:
!
!
!
|-
| colspan="5" |DeskPhone P-Series
!
!
!
|-
!
!P710 IP PRO
!P810 IP PRO
!P810B IP PRO
!P820 IP PRO
!P825 IP PRO
!P850W IP PRO
!P855BW IP PRO
|-
!
![[File:P710.png|frameless|p710.png/|p710.png/]]
! colspan="2" |[[File:P810.png|frameless|p810.png/|p810.png/]]
! colspan="2" |[[File:P82x.png|frameless|360x360px|p82x.png/|p82x.png/]]
! colspan="2" |[[File:P85x.png|frameless|358x358px|p85x.png/|p85x.png/]]
|-
|
|
| colspan="2" |
| colspan="2" |
| colspan="2" |
|-
|Display
|2,8" TFT colour
| colspan="2" |3,36" TFT colour
| colspan="2" |5" TFT colour
| colspan="2" |5" TFT colour
|-
|Resolution (pixels)
|320 x 240
| colspan="2" |320 x 240
| colspan="2" |480 x 272
| colspan="2" |480 x 272
|-
|Tiltable display
| -
| colspan="2" | -
| -
|Yes
| -
|Yes
|-
|LAN switch
|2 ports, Gbit
| colspan="2" |2 ports, Gbit
| colspan="2" |2 ports, Gbit
| colspan="2" |2 ports, Gbit
|-
|PoE
|IEEE 802.3af, class 2
| colspan="2" |IEEE 802.3af, class 2
| colspan="2" |IEEE 802.3af, class 3
| colspan="2" |IEEE 802.3af, class 3
|-
|IP
|IPv4 & IPv6
| colspan="2" |IPv4 & IPv6
| colspan="2" |IPv4 & IPv6
| colspan="2" |IPv4 & IPv6
|-
|WLAN IEEE 802.11n/ac
| -
| colspan="2" | -
| colspan="2" | -
| colspan="2" |Yes
|-
|Bluetooth
| -
| -
|Yes
| colspan="2" | -
| -
|Yes
|-
|Headset connection via
|EHS/DHSG/RJ9 interface
| colspan="2" |EHS/DHSG/RJ9 interface
| colspan="2" |EHS/DHSG/RJ9 interface
| colspan="2" |EHS/DHSG/RJ9 interface
|-
|Function keys
|4 self labeling
| colspan="2" |4 (12) self labeling
| colspan="2" |8 (28) self labeling
| colspan="2" |10 (36) self labeling
|-
|G.711 A-law, µ-law

G.722 (wideband)

G.726, G.729AB, GSM 6.10 (FR)
|
| colspan="2" |Yes
| colspan="2" |Yes
| colspan="2" |Yes
|-
|Soft-keys
|4
| colspan="2" |4
| colspan="2" |4
| colspan="2" |4
|-
|SIP accounts
|6
| colspan="2" |12
| colspan="2" |12
| colspan="2" |12
|-
|USB
|No
| colspan="2" |1
| colspan="2" |1
|2
|1
|-
|P800 KEY PRO support
|No
| colspan="2" |via USB
| colspan="2" |via USB
| colspan="2" |via USB
|-
|GRAPE (Redirect and Provisioning)
|Yes
| colspan="2" |Yes
| colspan="2" |Yes
| colspan="2" |Yes
|}


The Gigaset DeskPhone App integrates the Gigaset P-Series IP PRO Phones into the innovaphone PBX environment.
After the initial setup, user and phonebook management can be done from the innovaphone myApps environment,
so that no further activities need to be performed on the Gigaset Phones.

==Functions==




* Add / Remove Gigaset DeskPhones
* Configure the Phonebook, keys and PBX Menue on Gigaset DeskPhones

With the Gigaset DeskPhone App it is possible to automatically add and remove DeskPhones.
In addition, the Phonebook, keys and PBX Menue configuration can be provisioned.

===Multi-PBX ready===




n.a.

===Cloud ready===



YES

== Provided APIs ==




* Websocket
* AdminApi
* TableUsers
* Services
* PbxApi

==Licensing==


No license is required for this app

==Prerequisites==


For BLF key signaling and pick-up a Group is needed where all phones are member of and logged in.

a PBX Object DTMF Features must be configured, with activated "Autocomplete '#'"

The app must not be installed and set up via myApps, that must be done via browser!

Because the connection from myApps to the app platform is only recognised as an http connection by SDK, even if https is used.

at least knowledge about installing an App on the AP Platform and adding the App Object via PBX Manager

''If the instance is operated in the innovaphone myApps Cloud, please request the following approvals on the Cloud RP via ticket at cloud@innovaphone.com, specifying the “instance number|domain name”:''

''musterschuster-p.innovaphone.com -> SIPS 5061 mit Check Certificate''

''musterschuster-a.innovaphone.com -> SIP 5060 (= Realm'00')''

''If you require additional realms for multiple customer master locations, e.g., for multiple Gigaset apps or instances, the following must also be requested:''

''musterschuster-a.realm01 -> SIP 50601''

''- bis max. -''

''musterschuster-a.realm50 -> SIP 50650''

==Versions==


===Compatible innovaphone firmware versions===

* innovaphone V14r2
* innovaphone V15r1 final

===Application versions used for interop testing===


* Gigaset DeskPhone-App - 142001 sr1

* innovaphone V15r1 final
* Gigaset Desktop IP PRO 10.1.198.16

==Configuration==


===Install the App===

===Gigaset - DeskPhone - App===

==== innovaphone settings ====
As an admin, create the environment settings in the Gigaset DeskPhone App.

For the innovaphone PBX, enter the domain, the IP address of the PBX or the FQDN, the SIP- or SIP-TLS Port, the MasterPBX-Name and the PBX password. You can also set Logname or E164 as an alternative, when DN is not set. If you want to show VoiceMail Messages into Phone Display enter the VoiceMail Number. Also define if reverse proxy and/or STUN Server should be activated or not and configure it accordingly. 

[[File:DeskPhone inno settings.png|frameless|600x600px|deskphone_inno_settings.png/|deskphone_inno_settings.png/]]

==== Gigaset settings ====
Enter the parameters for the phones to reach the App Platform. SIP realm and App Platform adress as an IP adress or FQDN. Also SIP port and protocol. if you need other SIP port then 5060/5061 via reverse Proxy, maybee if you use Gigaset DECT Provsioning App in paralell, enter it here. Port to Reverse Proxy still stays as 5060/5061.

'''Please note:''' If you want to use more then one Gigaset App instance or Gigaset DECT Provisioning in paralell, you need for each instance a SIP realm and a dedicated forwarding rule to the AP must be configured on the reverse proxy!

Username and password will be set for the phones web-ui. The phone connects via SIP with the App Platform, therefore the SIP-Password is needed. You can generate a random Password by using the button below.

If activating the additional admin mode, only basic settings will be shown in the web UI. After entering the administrator mode password, the complete admin web UI of the phone will be unlocked again.

[[File:DeskPhone gigaset settings.png|frameless|600x600px|deskphone_gigaset_settings.png/|deskphone_gigaset_settings.png/]]

==== number formatting ====
access code, prefixes, country and area code will be automatically read from the system.

this settings are not used by the phone at the moment.

[[File:DeskPhone number formatting.png|frameless|600x600px|deskphone_number_formatting.png/|deskphone_number_formatting.png/]]

==== key settings ====
This DeskPhone app reads the user's key configuration in two places. 1. Configured keys of the type: Dial and Partner

and 2. The user's favorites.

You can choose the order in which these two are displayed on the phone:

* Favorites first, then keys
* Keys first, then favorites
* Do not provision any changes

[[File:DeskPhone key settings1.png|frameless|543x543px|deskphone_key_settings1.png/|deskphone_key_settings1.png/]]

and you can choose where these keys should start on the phone:

* Ocupy from first page
* Occupy from second page
* Assign to key module
* Do not provision any changes

[[File:DeskPhone key settings2.png|frameless|547x547px|deskphone_key_settings2.png/|deskphone_key_settings2.png/]]

==== PBX menu settings ====
DekPhone App will automatically provide a PBX menu to the phones, like Gigaset Feature Control App does for Gigaset DECT. [[Howto:Gigaset-Feature-Control-App - Gigaset - Partner App]]

* Directory: will provide the local innovaphone LDAP contacts for dialing
* Diversion: see actual call diversion, set/change/activate/deactivate Diversion targets for Always, Busy and on No response.
* Group: show, join and leave Groups
* Presence: see actual Presence, change Presence to Online/Away/Busy/DND
* Working: see actual status of working and Start/Stop working

[[File:DeskPhone pbxmenu settings.png|frameless|600x600px|deskphone_pbxmenu_settings.png/|deskphone_pbxmenu_settings.png/]]

* advanced call forwarding: extend the Diversion menu by Diversion Busy and on No response.
* static groups: static Groups are shown on buttom of the list.
* function key: F4 as default, but you can choose F1-F3 also, or deactivate. this are they keys below the display of the phone.
* context sensitivity of the function key: e.g. on F4 normally info button is displayed when info messages are present, and into info menu the PBX menu button will shown until all mssages ar read, which this switch you can deactivate this behavior.
* menu name: this name will be displayed on the previously selected key.

==== phone book settings ====
Under Phonebook settings you can activate sync for a phonebook.
{| class="wikitable"
|+
![[File:DeskPhone phonebook settings1.png|frameless|555x555px|deskphone_phonebook_settings1.png/|deskphone_phonebook_settings1.png/]]
![[File:DeskPhone phonebook settings2.png|frameless|542x542px|deskphone_phonebook_settings2.png/|deskphone_phonebook_settings2.png/]]
|}
there are three different phone books available, you can configure only one at a time. the same for all three, first thing to choose is phone book key and set a name that will be displayed on the key.

# the standard LDAP directory of the innovaphone PBX (PBX0), which is also integrated in PBX menu. Please enter the IP address, port and previously created access data for the innovaphone LDAP.
# LDAP server where you manuelly enter all parameters.
# Contacts APP, enter the neccessary parameters:
#* phone book key : F3 (default)
#* Phonebook key name: name that will be displayed on the key
#* Host : innoapp.domain.de (address of the AP)
#* Port : 636
#* TLS : yes
#* LDAP search base : dc=entries
#* Username : [from PBX-Manager / AP Contacts / Change Configuration / User (LDAP)]
#* Password : [from PBX-Manager / AP Contacts / Change Configuration / Password (LDAP)]
#* Name filter : (|(cn=%)(sn=%))
#* Number filter : (metaSearchNumber=%)
#* all other entries as shown in below screenshot are preconfigured

[[File:DeskPhone phonebook settings Contacts.png|frameless|762x762px|deskphone_phonebook_settings_contacts.png/|deskphone_phonebook_settings_contacts.png/]] 

==== custom provisioning settings ====
You have the possibility to add provisioning parameters by your own in xml strings. You can find an overview of provisioning parameters here: 
'''[https://teamwork.gigaset.com/gigawiki/display/GPPPO/FAQ+-+Auto+provisioning%3A+Parameters Gigaset Desktop Phone Settings] '''

[[File:DeskPhone custom settings.png|frameless|545x545px|deskphone_custom_settings.png/|deskphone_custom_settings.png/]]

 
please have in mind, that you have to replace special signs with placeholders: & - &amp;

‘ - &apos;

< - &lt;

> - &gt;

” - &quot;

Ä - &#196;

Ö - &#214;

Ü - &#220;

ä - &#228;

ö - &#246;

ü - &#252;

ß - &#223;

 

==== Advanced settings ====

* "Reload Gigaset Devices" will be reload all Gigaset DeskPhones from Devices List. Keyword is the APP-Name, which is also inserted into the Devices. Wildcards are allowed.
* Execute Provisioning NOW will send a SIP-Notify to every connected Phone to force them to pull again the Provisioning File from Provisioning App.
* Firmware URLs: if you want to Update DeskPhone Firmware by the Provisioning App enter here a Web Url where the Phone can download it. e.g. path from Gigaset Wiki Firmware File.
* provisioning via HTTP instead of HTTPS: Gigaset DeskPhones does '''NOT support self signed certificates!''' if you have no official sigend certificates, force the App to provide a HTTP Link insted of HTTPS. The fact that the Copy Link button is not displayed is a restriction in the innovaphone SDK for unsecure connections.
* generate new secret: if needed you can generate a new secret. or if you have to reinstall the app, you can copy your previously used secret in.
* provisioning path: The app generates a provisioning path from its data. This path does not change as long as you do not regenerate a new secret. Copy this path and paste it on every new phone, you have to copy the Provisioning URL into the phone via Web-Ui. Setup --> Advanced --> Update --> Setting URL: copy it here and apply. Afterwards type on the phone: Settings --> Maintenance (5) --> Synchronize Settings (4) --> Ok

 

===Add Devices to User and start Provisioning===

Now create new end devices as usual via UserAdmin or the Profile app. Select "Gigaset + ''APP-Name''" in the manufacturer selection field and then enter the MAC adress of the phone.
You can find the MAC of the phone on the box, under the phone or by pressing settings --> Information (6) --> System Info (2) on the phone.

After you have saved the new phone, you have to copy the Provisioning URL into the phone via Web-Ui.

Setup --> Advanced --> Update --> Setting URL: copy it here and apply.

Afterwards type on the phone: Settings --> Maintenance (5) --> Synchronize Settings (4) --> Ok

[[File:DeskPhone Users Admin.png|frameless|883x883px|deskphone_users_admin.png/|deskphone_users_admin.png/]][[File:DeskPhone Devices1.png|frameless|900x900px|deskphone_devices1.png/|deskphone_devices1.png/]]

[[File:DeskPhone Web-Ui.png|frameless|790x790px|deskphone_web-ui.png/|deskphone_web-ui.png/]][[File:DeskPhone Devices2.png|frameless|900x900px|deskphone_devices2.png/|deskphone_devices2.png/]]

==Release Notes==
===Update Notice===

Even though this should be the standard procedure, we would still like to point this out. 
Before installing an update, we recommend backing up the PBX and the Gigaset application on the application platform so that a rollback of the configuration is possible.

=== 142004 sr1 ===

* change in socket connection handling

=== 142003 sr1 ===

* change for MOH not working
* added SIP-Server and APP-Platform via provisioning Parameter to trusted Hosts.
* call forwardings service codes optimisation
* PBX menu Directory Edit Mode button fixed

=== 142001 sr1 ===
- Startversion 

==Known Problems==

=== ReProvisioning or check-sync for CallForwarding or others are not working after time ===
Socket connection does not recognised when the device port has changed. fixed in 142004 sr1

=== URLs are shown as http instead of https ===
The app must not be installed and set up via myApps, that must be done via browser!

Because the connection from myApps to the app platform is only recognised as an http connection by SDK, even if https is used.

=== MOH not working ===
put this parameter in the custom phone settings part:

<user_hold_inactive idx="1" perm="">on</user_hold_inactive>

=== Same SIP Port/Protocol for PBX and APP-Plattform via Reverse Proxy ===
is not working, due to load optimizations of Reverse Proxy. choose 5061/TLS for PBX and 5060/TCP for App Plattform.

===Provisioning of devices via Users Admin not working===
Please note the following for environments that do not have Internet access. In this case, the assignment of devices via the Users Admin may be disrupted.
The Gigaset App works together with the provisioning service of the Devices App. The online provisioning server from innovpahone "config.innovaphone.com" is entered as the default in the Devices app. If the environment cannot reach the server, the process is aborted.
To avoid this, offline provisioning must be configured for the domain in the Devices app.
https://wiki.innovaphone.com/index.php?title=Reference13r1:Concept_Offline_Provisioning

=== Provisioning option not available in Users Admin when giving Profile app a custom name ===
When the name or long name of your profile app PBX object differs from the default names "Profile" (long name) and "profile" (name), you won't have the option to select "Gigaset - Gigaset Provisioning" as the manufacturer of the phone if you try to create new phone registrations via Users Admin. 

=== no Audio / disconnect after 30 - Gigaset phone is connected through a Reverse Proxy ===
Media Relay works only in a LAN. For working through a Reverse Proxy a view more settings are needed. See here:
https://wiki.innovaphone.com/index.php?title=Howto13r3:Step-by-Step_Media_Relay_connection_for_third_party_phone

== Related Articles ==
*[[Howto:MyApps Cloud - Using Gigaset-Provisioning-App in innovaphone cloud environments| Howto:Using Gigaset-Provisioning-App in innovaphone myApps cloud environments]]

==Contact==
Gigaset Technologies GmbH 
Frankenstraße 2 
46395 Bocholt

Tel: +49 2871 91-0 
E-Mail: de.pro@gigaset.com

'''Support''' 
+49 (89) 8780 6575 + PIN Code 
support@gigaset.com

'''Become a partner''' 
https://gigasetportal.force.com/Partner

'''App Feature Request''' 
Dennis Zimmermann 
Technical Sales Manager 
dennis.zimmermann@gigaset.com

Reference13r1:Install

2025-06-24T06:55:58Z

Radu.timar: /* Passwords */

With the Install you are able to create a new Setup or Upgrade an existing PBX.

== DNS ==
Starting with V13, DNS is an important part of communication. For a list of different customer scenarios and possible solutions, please look [[Howto:V13 Installation Scenarios|here]].

The installer checks during the installation whether the given DNS names for PBX and Application platform are reachable and valid.
If the necessary DNS entries do not yet exist, or if they show these on another IP or gateway, the entry fields are marked red in the installer. If you click "Next" in this state, the ''Operation without DNS'' mode (see ''IP address for App Platform '' in [[Reference13r1:PBX/Config/General]]) will be activated in the PBX.

If this mode is active, the installer can be run through and the machine can be configured. After the install process this mode has to be disabled again because some features will not work in this mode. Until the mode is manually disabled (by switching off the ''Operation without DNS'' check-mark), all devices use IP addresses for communication.

== Passwords ==
During the install process, you will get a screen which shows you two randomly created passwords. One is the administrative password and one the PBX password.
The administrative password applies to all passwords which we used our default passwords if you activate it.
You are able to install with default password if you append the parameter ''?stdpwd=on'' to the install.htm

If you provision a new gateway or phone, this new device will automatically get the administrative password.

=== PBX objects ===

There are a few objects which have no password set at all to avoid conflicts if you change the domain password to deploy a new administrative password. 
If no password is set, the admin password of the gateway is automatically used:
* AP object
* AP Manager (former Apps) object
* just in cloud environment: Devices object
* just in cloud environment: Devices API object

All other PBX App objects have an own randomly created password which is set in the App object itself and in the corresponding instance inside the Manager App.

== Options ==

* [[Reference13r1:Install/Master with local App Platform|Master with local App Platform]]
* [[Reference13r1:Install/Master with external App Platform&action=edit&redlink=1|Master with external App Platform]]
* [[Reference13r1:Install/Add device to existing installation&action=edit&redlink=1|Add device to existing installation]]
* [[Reference13r1:Install/Upgrade the existing PBX|Upgrade the existing PBX]]
* [[Reference13r1:Install/Upgrade with external App Platform|Upgrade the existing PBX with installation of an external App Platform]]
* Do manual configuration (Install will be closed and you will be redirected to the advanced UI)

== Known issues ==
* The PBX Password is passed in the URL. Please use a trusted environment and clean cache/history after finish the setup/upgrade.