Reference12r2:Concept Push Notifications for myPBX on iOS

From innovaphone-wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 16:32, 20 February 2019 (edit)
Nfi (Talk | contribs)
(Troubleshooting)
← Previous diff
Current revision (16:44, 20 February 2019) (edit) (undo)
Vsc (Talk | contribs)
m (Troubleshooting)
 
Line 48: Line 48:
* Only if you are not sure if the push service is operational at the moment, open a support ticket and send an email to ''push-support@innovaphone.com''. * Only if you are not sure if the push service is operational at the moment, open a support ticket and send an email to ''push-support@innovaphone.com''.
* Make sure the myPBX App has Push Notifications allowed in the iOS settings. 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). * Make sure the myPBX App has Push Notifications allowed in the iOS settings. 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).
-* If a domain is already registered with a mail address, this domain cannot be authenticated with another mail address. In this case you will not receive any mail from our push service.+* Once a domain is already registered with an email address, <span style="color:red">this domain cannot be authenticated with another email address.</span> In this case you will not receive any email from our push service.
== Known limitations == == Known limitations ==

Current revision

With firmware version 12r2 sr20 the PBX is able to send Push notifications to the Apple Push Notification service (APNs). As a result, incoming calls are also indicated when the myPBX app is not started or runs in the background mode. The PBX is using a service provided by innovaphone AG at services.innovaphone.com to send the push notifications to Apple APNs. No call meta data is transmitted, the push notification is only used to wake up the myPBX app. Only one Push object is needed for a system.

Contents

Requirements

PBX

  • Firmware version 12r2sr20 [125501] or higher
  • Internet access via HTTPS

myPBX iOS

  • Version 12r2sr20 [125501] or higher

iOS

  • Version 12.0.1 or higher

Configuration

PBX

  • Check the System Name of the PBX - it must be globally unique. We recommend to use the DNS domain name of the company using the PBX.
  • For the next steps, do not use Internet Explorer, Edge or FrontMotion Firefox Browser at the moment. It will not work!
  • Create a new PBX object of type Push.
    • The Name of the Push object is case sensitive and will be used in the User objects to identify the push service.
    • Do NOT set a password - this is later-on filled-in automatically!
    • Make sure to click on OK or Apply button before proceeding with next steps.
  • Navigate to the Push tab of the Push object and provide a valid E-Mail address that can be used to send an HTTP link for verification.
    • E-Mail must not be an E-Mail already used as E-Mail of another object.
  • Press Connect button, do not close the window until E-Mail verification is done.
  • Wait for the E-Mail and open the verification link in the browser.
  • Press OK button after Connect succeeded appears.
  • Navigate to Reference9:General/Certificates and trust to certificate *.innovaphone.com that should appear on the list of rejected certificates. You have to do this on every slave and/or standby PBX.

Image:Rejected certs.png

  • The trust list should look like this afterwards:

Image:Trusted certs.png

User Objects

  • For each user who is to receive push notifications on his myPBX-iOS-application, the Name of the push-object must be entered in his userobject at the Push field in the User tab.

myPBX iOS

  • On the iOS device make sure to allow push notifications for the myPBX app.

Troubleshooting

  • Check the trust list for certificate of the innovaphone AG.
  • Make sure the PBX can resolve the DNS host services.innovaphone.com.
  • Make sure the PBX can reach services.innovaphone.com via HTTPS.
  • Make sure you do not use Internet Explorer or Edge.
  • Make sure the mail used for Push is not used by another PBX object.
  • If there are problems with setting up the Push Service or if individual subscribers can not be reached, open a Support Ticket.
  • Only if you are not sure if the push service is operational at the moment, open a support ticket and send an email to push-support@innovaphone.com.
  • Make sure the myPBX App has Push Notifications allowed in the iOS settings. Also make sure, the iOS device has a valid GSM data connection or a WiFi connection with the internet, especially TCP port 5223 (see Troubleshooting Push Notifications article by Apple).
  • Once a domain is already registered with an email address, this domain cannot be authenticated with another email address. In this case you will not receive any email from our push service.

Known limitations

Push object creation and configuration of the connection is not working with Internet Explorer/Edge.

Use Firefox or Chrome to create and configure the Push object.

Call accept time for users with myPBX client only

In case no other endpoints are registered on the User object, but only the myPBX iOS client, the PBX will not provide any alerting message to the calling party, until the myPBX client on the iOS device restores the registration to the PBX via push notification. In case no registration appears after 10 seconds, the PBX will send "no user responding" as cause code to the calling party.

Personal tools