Course13:IT Connect - 10.1 Push Object

From innovaphone-wiki

Jump to: navigation, search

How to configure a Push Object

The Push Object

The PBX is able to send Push notifications to the Apple Push Notification service (APNs). As a result incoming calls are indicated on a iOS device when myApps is not started or runs in the background mode. The PBX is using a service provided by innovaphone AG at to send the push notifications to Apple APNs. No call meta data is transmitted, the push notification is only used to wake up the myApps app.

If your customer plans to use myApps on an iOS device, you therefore need to setup a Push Object on your PBX.


Open the PBX Manager plugin screenshot.png App Platforms and add screenshot.png Innovaphones Services-App Platform. This will ask you to configure:

  • Title/SIP Id: Both must be unique in the system, but have no relevance for the user or admin. Best would be to use for title and SIP Id services. Don't name it Push as we use it later on.
  • Host Name: here you configure the host-name of the remote Application Platform, in our case

The email address entered when asked for email verification, is stored together with the Domain/System Name of the PBX/App Platform for authentication of Push requests. The email should be in custody of the end-customer because in case of conflicts with the domain-name (e.g. 2 Innovaphone customers have a PBX with the same domain name), Innovaphone would use this mail-address as contact.

To test Push in our training scenario you need to enter your dvl-ckl2@class.local e-mail address because the services instance of the training environment can only deliver mails to the training mailserver.

After confirmation of the screenshot.png verification mail, a new PBX-Manager plugin called screenshot.png services Push will appear. Use the plugin to screenshot.png create a Push object. Please use the preconfigured values for Name/ID. If you want to use other Name/ID values, you must adapt the PBX-Manager plugin Templates and change the name of your Push object in the settings sections.

Your PBX will now try to connect to using HTTPS. If everything goes well, your configuration is finished and myApps running on iOS devices will receive Push notifications from Apple.

You can check the state of the push App if you go to the user interface of the device (screenshot.png Admin UI of IP411Left) via the Devices app and there in the screenshot.png PBX/Objects section. The best case scenario is if the screenshot.png Push-object shows connected. If not, check certificates in the advanced UI to trust the certificate or even better "COMODO RSA Domain Validation Secure Server CA".

If the state still doesn’t change to connected, make sure that the PBX HTTPS-connection is not blocked by some firewall at the customer site.

Personal tools