Views

Difference between revisions of "myPortal to go"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
(Dependencies on Android devices)
 
(73 intermediate revisions by 4 users not shown)
Line 8: Line 8:
 
'''myPortal to go''' is a feature-rich unified communications app for iOS and Android smartphones. It is compatible to OpenScape Business V1R3 systems and higher and supports both UC Smart and UC Suite.  
 
'''myPortal to go''' is a feature-rich unified communications app for iOS and Android smartphones. It is compatible to OpenScape Business V1R3 systems and higher and supports both UC Smart and UC Suite.  
  
[[Image:OSBiz-MyPortal_to_go_5.gif|200px]]
+
[[Image:OSBiz-myPortal_to_go_5.jpg|600px]]
  
 
== Features ==
 
== Features ==
 
Besides convenient dialing incl. one number service, myPortal to go offers access to many other UC related features like:
 
Besides convenient dialing incl. one number service, myPortal to go offers access to many other UC related features like:
  
* favorites
+
* Favorites
* directories
+
* Directories
* journal
+
* Call Journal
* presence status
+
* Presence status
* voicemail access
+
* Voicemail Access
 +
* Option to (de)activate group calls
 +
* Access to local Smartphone contacts and Directories
 
* etc.
 
* etc.
  
The following document contains a comlete feature description of myPortal to go.
+
The following document contains a complete feature description of myPortal to go.
  
 
* {{File-DL|OpenScape Business myPortal to go Whitepaper EN|pdf|en}}
 
* {{File-DL|OpenScape Business myPortal to go Whitepaper EN|pdf|en}}
Line 26: Line 28:
 
== Supported Mobile Platforms ==
 
== Supported Mobile Platforms ==
  
* Apple iOS 6.0 or higher
+
* Apple iOS 12 or higher
* Android 2.3.3 or higher (Android 4.x recommended)
+
* Android 5.0 or higher
 
 
  
 
== VoIP Feature Device Dependencies ==
 
== VoIP Feature Device Dependencies ==
  
Dependent on the mobile operating system, the software version of OpenScape Business and the network environment, , myPortal to go offers the feature Voice over IP (VoIP).  
+
Dependent on the mobile operating system, the software version of OpenScape Business and the network environment, myPortal to go offers the feature Voice over IP (VoIP).
  
 +
Voice over IP can be used in local or remote WiFi environments with iOS or Android. The WiFi network, and mobile device, should be configured for VoIP and should support fast roaming and handover in the network.
 +
With Android, VoIP is also available over 4G/5G mobile data networks. This service has some specific restrictions which are listed below.
  
 
=== Dependencies on Android devices ===
 
=== Dependencies on Android devices ===
 
myPortal to go offers the Voice over IP (VoIP) option on Android, if following preconditions are fulfilled:
 
myPortal to go offers the Voice over IP (VoIP) option on Android, if following preconditions are fulfilled:
  
* Actual myPortal to go SW from Google Play Store
+
* Latest myPortal to go app from Google Play Store
* Device with Android 4.2 or higher
+
* Device with Android 5.0 or higher  
* Wi-Fi connection to OpenScape Business. Either via company WiFi or WiFi@home. (Configuration hints for WiFi@home can be found in the document [[How_to_collection_and_tutorials_for_OpenScape_Business#Device.40Home | '''How to configure system device@home''']])
+
* Battery saving options have to be disabled. In particular, under Android phone settings > Apps > App Info > tap myportal > Battery  Saver> select Not restricted
* OpenScape Business V2R1 or higher
+
* A stable data connection to OpenScape Business is required. This can be either via company WiFi, or WiFi@home or via a 4G/5G mobile data network. Weak signal levels will result in VoIp quality issues. (Configuration hints for WiFi@home can be found in the document [[How_to_collection_and_tutorials_for_OpenScape_Business#Device.40Home | '''How to configure system device@home''']])
 +
* A 4G/5G mobile data connection can be used with following restrictions:
 +
** Transitions of the environment (foreground to backgronnd, WiFi to mobile data, etc.) are not seamless and lead to brief interruptions oft he voIP registration status.
 +
** Network transitions (WiFi <-> 4G/5G) during active VoIP calls are currently not supported.
 +
** If available, it is strongly recommended to switch the feature Voice over LTE (VoLTE) on in your Android settings
 +
** A VoIP over 4G/5G call may be interrupted when a second incoming call comes in via GSM. This is dependent on the specific mobile service provider and the device settings. In case that the device / mobile network switches back from 4G/5G to GSM/Edge mode upon an incoming call, the data connection will be interrupted and thus the VoIP connection will be lost.
 +
** myPortal to go – and VoIP in particular – cannot be used when symmetric firewalls are in place between client and server.
 +
** Specific restriction for Android 12: Due to a known bug in the operating system, myPortal to go may not be able to switch the audio output from loudspeaker to earspeaker or bluetooth. In such a case, a device restart will be required to ocercome the issue. If you face such issues, we recommend to disable the flag "Force loudspeaker ringer" in the app's VoIP settings (this will reduce the chance of the error occuring).
 +
* OpenScape Business / Octopus F X V3 or higher is required. For VoIP over 4G/5G, OpenScape Business V3R2 or higher is required.
 +
* Configuration hints for WiFi@home can be found in the document [[How_to_collection_and_tutorials_for_OpenScape_Business#Device.40Home | '''How to configure system device@home''']]. Same settings are required for VoIp over 4G/5G.
 
* One additional licensed System Client (HFA) per myPortal to go VoIP user
 
* One additional licensed System Client (HFA) per myPortal to go VoIP user
  
'''Note:'''
+
'''Please note:'''
The voice quality of the myPortal to go VoIP client depends on the HW performance and on the SW version of the mobile device.  
+
* The voice quality of the myPortal to go VoIP client depends on the HW performance and on the firmware version of the mobile device.
 +
* Some versions of the Android operating system has known issues with WiFi roaming (dynamically connecting to the access point with the strongest signal). The Android community offers several workarounds - you may search the internet for "Android flaw wifi roaming" to find out more.
 +
* A data flatrate is strongly recommended as VoIP services can cause consumption of significant data volume.
  
 +
=== Dependencies on Apple iOS Devices ===
 +
myPortal to go offers the Voice over IP (VoIP) option on Apples iOS, if following preconditions are fulfilled:
  
{| {{DefaultTable}}
+
* Latest myPortal to go app from Apple App Store
| align="center" style="background:#f0f0f0;"|'''Manufacturer'''
+
* Device with iOS version 12 or higher
| align="center" style="background:#f0f0f0;"|'''Model'''
+
* A stable data connection to OpenScape Business is required. This can be either a company WiFi or WiFi@home. (Configuration hints for WiFi@home can be found in the document How to configure system device@home)
| align="center" style="background:#f0f0f0;"|'''Android Version'''
+
* OpenScape Business V3R2 or higher. The communcation system should always be updated to the latest available software release, because the APNS notification service required time-boxed certificates which are updated with every major/minor/fix release oft he product.
| align="center" style="background:#f0f0f0;"|'''Remarks'''
+
* One additional licensed System Client (HFA) per myPortal to go VoIP user
|-
+
 
| Archos||45B Platinum||4.3||ok
+
==== Background info for VoIP operation with the APNS (Apple Push Notification Server) ====
|-
+
 
| Huawei||Ascend Y530||4.3||ok
+
As long as the iPhone is unlocked and the app runs in foreground, incoming calls are signalled via the direct network connection from OSBiz to the app.
|-
 
| HTC||Desire 310||4.2.2||ok
 
|-
 
| HTC||Desire 510||4.4.3||ok
 
|-
 
| HTC||One Mini||4.4.2||high latency in VoIP calls
 
|-
 
| LG||G2||5.0.2||ok
 
|-
 
| Motorola||Moto G / Moto G LTE||5.0 / 5.1||ok. VoIP ''not'' usable with Android 4.4.x
 
|-
 
| Samsung||Galaxy Nexus||4.3||high latency in VoIP calls
 
|-
 
| Samsung||Galaxy Ace 3||4.2.2||ok
 
|-
 
| Samsung||S4 mini||4.4.2||ok
 
|-
 
| Samsung||S4 / S4 LTE / S5||5.0||ok. VoIP ''not'' usable with Android 4.4
 
|-
 
| Sony||Xperia Z1 Compact / Z3||4.4.4||high latency in VoIP calls
 
|-
 
|}
 
  
 +
APNS notifications are only used in background / screen lock / screen off mode, where the operating system prevents myPortal to go (iOS) from running in the background. APNS means that the OSBiz sends call notifications to Apples public push notification service, which forwards the notifications to the corresponding iOS device. Here, they are handled by the operating system (not by the app), showing the call notification popup and playing a notification tone - which is the Unify ringtone in our case.
 +
Clicking / swiping that iOS notification starts myPortal to go again and brings it to foreground, where the ringing call is detected, presented and where it can be answered.
  
Note: The information given within the table is without any warranty.
+
To get the APNS mechanism working, the following administration steps are required:
 +
* The latest myPortal to go (iOS) version from App Store needs to be installed.
 +
* Please make sure that the app has all required permissions (iOS settings -> apps section -> myPortal to go).
 +
* In OpenScape Business, we recommend to use the latest software release (V2R6 or higher)
 +
* OpenScape Business (and Booster Card/Server if present) require internet access, as they need to be able to send notifications to Apple's public APNS service. This requires also a proper DNS server configuration, which allows OSBiz to resolve public internet domain names like "gateway.push.apple.com".
 +
* If the company firewall restricts outbound internet access, then please make sure that the firewall is open for APNS related ports. For details see here: https://support.apple.com/en-us/HT203609
 +
* The iOS device obviously needs an active internet connection (WiFi or mobile data) to receive and handle APNS notifications.
  
=== Dependencies on Apple iOS Devices ===
+
Regarding WiFi availability when the iPhone is locked:
myPortal to go offers the Voice over IP (VoIP) option on Apples iOS, if following preconditions are fulfilled:
+
Please check if specific power saving settings are in use. For example, the iOS option "Low Power Mode" may have an impact if enabled, especially when the device's battery status is low.
  
* Actual myPortal to go SW from Apple App Store (at least app version V2R1.86.02)
+
In very rare cases, we have seen blocking situations in iOS regarding APNS which requires a device restart to overcome.
* Device with iOS version 9.3 or higher
 
* Wi-Fi connection to OpenScape Business. Either via company WiFi or WiFi@home. (Configuration hints for WiFi@home can be found in the document [[How_to_collection_and_tutorials_for_OpenScape_Business#Device.40Home | '''How to configure system device@home''']])
 
* OpenScape Business V2R1.1 or higher
 
* One additional licensed System Client (HFA) per myPortal to go VoIP user
 
  
'''Note:'''
+
'''Please note:''' Apple APNS service requires new certificates over time. Therefore we strictly recommend to keep OpenScape Business system always up to date and under active Software Support.
The VoIP app uses iOS framework functions with following restrictions which are defined by Apple.:
 
* iOS can terminate background mode of myPortal to go depending on battery current consumption.
 
* The myPortal to go app with an active VoIP call should not be placed into lock or home screen. Doing so the active call could be terminated.
 
* Automatic VoIP re-registration after WiFi signal lost and signal reestablish, can only be done if myPortal to go is active the foreground.
 
  
 
== SW Deployment ==
 
== SW Deployment ==
Line 121: Line 115:
  
  
{{en}} http://www.unify.com/us/Home/Internet/web/us/misc/tac/privacy_policy_myportal.aspx?tac=1
+
{{en}} https://unify.com/en/privacy-policy
 +
 
 +
{{de}} https://unify.com/de/datenschutz

Latest revision as of 09:08, 10 June 2022


myPortal to go


Overview

myPortal to go is a feature-rich unified communications app for iOS and Android smartphones. It is compatible to OpenScape Business V1R3 systems and higher and supports both UC Smart and UC Suite.

OSBiz-myPortal to go 5.jpg

Features

Besides convenient dialing incl. one number service, myPortal to go offers access to many other UC related features like:

  • Favorites
  • Directories
  • Call Journal
  • Presence status
  • Voicemail Access
  • Option to (de)activate group calls
  • Access to local Smartphone contacts and Directories
  • etc.

The following document contains a complete feature description of myPortal to go.

Supported Mobile Platforms

  • Apple iOS 12 or higher
  • Android 5.0 or higher

VoIP Feature Device Dependencies

Dependent on the mobile operating system, the software version of OpenScape Business and the network environment, myPortal to go offers the feature Voice over IP (VoIP).

Voice over IP can be used in local or remote WiFi environments with iOS or Android. The WiFi network, and mobile device, should be configured for VoIP and should support fast roaming and handover in the network. With Android, VoIP is also available over 4G/5G mobile data networks. This service has some specific restrictions which are listed below.

Dependencies on Android devices

myPortal to go offers the Voice over IP (VoIP) option on Android, if following preconditions are fulfilled:

  • Latest myPortal to go app from Google Play Store
  • Device with Android 5.0 or higher
  • Battery saving options have to be disabled. In particular, under Android phone settings > Apps > App Info > tap myportal > Battery Saver> select Not restricted
  • A stable data connection to OpenScape Business is required. This can be either via company WiFi, or WiFi@home or via a 4G/5G mobile data network. Weak signal levels will result in VoIp quality issues. (Configuration hints for WiFi@home can be found in the document How to configure system device@home)
  • A 4G/5G mobile data connection can be used with following restrictions:
    • Transitions of the environment (foreground to backgronnd, WiFi to mobile data, etc.) are not seamless and lead to brief interruptions oft he voIP registration status.
    • Network transitions (WiFi <-> 4G/5G) during active VoIP calls are currently not supported.
    • If available, it is strongly recommended to switch the feature Voice over LTE (VoLTE) on in your Android settings
    • A VoIP over 4G/5G call may be interrupted when a second incoming call comes in via GSM. This is dependent on the specific mobile service provider and the device settings. In case that the device / mobile network switches back from 4G/5G to GSM/Edge mode upon an incoming call, the data connection will be interrupted and thus the VoIP connection will be lost.
    • myPortal to go – and VoIP in particular – cannot be used when symmetric firewalls are in place between client and server.
    • Specific restriction for Android 12: Due to a known bug in the operating system, myPortal to go may not be able to switch the audio output from loudspeaker to earspeaker or bluetooth. In such a case, a device restart will be required to ocercome the issue. If you face such issues, we recommend to disable the flag "Force loudspeaker ringer" in the app's VoIP settings (this will reduce the chance of the error occuring).
  • OpenScape Business / Octopus F X V3 or higher is required. For VoIP over 4G/5G, OpenScape Business V3R2 or higher is required.
  • Configuration hints for WiFi@home can be found in the document How to configure system device@home. Same settings are required for VoIp over 4G/5G.
  • One additional licensed System Client (HFA) per myPortal to go VoIP user

Please note:

  • The voice quality of the myPortal to go VoIP client depends on the HW performance and on the firmware version of the mobile device.
  • Some versions of the Android operating system has known issues with WiFi roaming (dynamically connecting to the access point with the strongest signal). The Android community offers several workarounds - you may search the internet for "Android flaw wifi roaming" to find out more.
  • A data flatrate is strongly recommended as VoIP services can cause consumption of significant data volume.

Dependencies on Apple iOS Devices

myPortal to go offers the Voice over IP (VoIP) option on Apples iOS, if following preconditions are fulfilled:

  • Latest myPortal to go app from Apple App Store
  • Device with iOS version 12 or higher
  • A stable data connection to OpenScape Business is required. This can be either a company WiFi or WiFi@home. (Configuration hints for WiFi@home can be found in the document How to configure system device@home)
  • OpenScape Business V3R2 or higher. The communcation system should always be updated to the latest available software release, because the APNS notification service required time-boxed certificates which are updated with every major/minor/fix release oft he product.
  • One additional licensed System Client (HFA) per myPortal to go VoIP user

Background info for VoIP operation with the APNS (Apple Push Notification Server)

As long as the iPhone is unlocked and the app runs in foreground, incoming calls are signalled via the direct network connection from OSBiz to the app.

APNS notifications are only used in background / screen lock / screen off mode, where the operating system prevents myPortal to go (iOS) from running in the background. APNS means that the OSBiz sends call notifications to Apples public push notification service, which forwards the notifications to the corresponding iOS device. Here, they are handled by the operating system (not by the app), showing the call notification popup and playing a notification tone - which is the Unify ringtone in our case. Clicking / swiping that iOS notification starts myPortal to go again and brings it to foreground, where the ringing call is detected, presented and where it can be answered.

To get the APNS mechanism working, the following administration steps are required:

  • The latest myPortal to go (iOS) version from App Store needs to be installed.
  • Please make sure that the app has all required permissions (iOS settings -> apps section -> myPortal to go).
  • In OpenScape Business, we recommend to use the latest software release (V2R6 or higher)
  • OpenScape Business (and Booster Card/Server if present) require internet access, as they need to be able to send notifications to Apple's public APNS service. This requires also a proper DNS server configuration, which allows OSBiz to resolve public internet domain names like "gateway.push.apple.com".
  • If the company firewall restricts outbound internet access, then please make sure that the firewall is open for APNS related ports. For details see here: https://support.apple.com/en-us/HT203609
  • The iOS device obviously needs an active internet connection (WiFi or mobile data) to receive and handle APNS notifications.

Regarding WiFi availability when the iPhone is locked: Please check if specific power saving settings are in use. For example, the iOS option "Low Power Mode" may have an impact if enabled, especially when the device's battery status is low.

In very rare cases, we have seen blocking situations in iOS regarding APNS which requires a device restart to overcome.

Please note: Apple APNS service requires new certificates over time. Therefore we strictly recommend to keep OpenScape Business system always up to date and under active Software Support.

SW Deployment

The myPortal to go App is available in following AppStores

Android Store Apple Store
QR-Code QRcode android.png https://play.google.com/store QRcode apple.png http://store.apple.com

Privacy

International (English)  https://unify.com/en/privacy-policy

Deutschland  https://unify.com/de/datenschutz