Open navigation

Push Notifications

UniTel Voice offers Push Service to users to allow users to receive incoming calls when UniTel Voice is in the background or exited.

Enabling push notifications

If the primary team member set up an additional SIP account, the SIP accounts have the UniTel Push Service enabled by default. If the UniTel Push Service is not enabled, use the following procedure to turn it on.

To enable push notifications
  1. Go to Settings > Accounts and tap More Info beside the SIP account you want to enable push notifications for.
  2. Turn off Enabled.
  3. Turn on Use Push Notifications.
  4. If required, change the settings for Registration Mode and NAT Emulation.
  5. For most VoIP service providers, no changes are required in Advanced Settings. If your VoIP service provider requires you to use difference SIP proxies for the Unitel Voice server, change the settings for SIP Proxy. If your VoIP service provider does not follow the SIP RFC specifications, find out from your VoIP service provider if you should enable Insert R Instance, Disable Hash Token, Auto Send 180, and Disable Override Domain, and set Service Refresh Interval.
  6. Turn on Enabled.

The Unitel Voice Service is enabled. You will receive calls if Unitel Voice is in the background or exited.

To make sure that push notifications are enabled, look at the icon beside the account in Settings > Accounts. If the account has push enabled, there will be green lines above the SIP account icon.


Push Registration Mode

This option controls how the combination of the UniTel Voice client and the UniTel Push server interact with the SIP server. For some customer’s SIP servers, the registration mode may not matter or make a substantive difference to the behavior of the SIP Server or the reliability of the reachability of the UniTel client. For another customer’s, the registration mode will matter quite a bit because one of the registration modes works best to address the particular limitations of the customer’s SIP Server. Customer administrators and IT staff should carefully understand these registration mode options and their potential impacts.


Nat Emulation

This option instructs the UniTel Voice Push server to simulate that the UniTel Voice Push server is registering from behind a Network Address Translation (NAT) router or another network element. Enable NAT Emulation if your VoIP service provider uses a session border controller. If enabling NAT Emulation results in no push notifications or no audio, disable NAT Emulation.

Advanced push settings

SIP Proxy

The option allows the customer to specify a SIP Proxy specifically for use by the UniTel Voice Push Server. It is important to note that this is an alternative to the SIP proxy configured as part of the regular SIP account configuration. In some very specific customer deployments, the customer would like the UniTel Voice Push server to register and receive calls from the SIP Server using a particular proxy while the UniTel Voice clients would use a different SIP Proxy either internally to a customer’s local network or external to the customer’s network.

Insert R Intstance

The Insert RInstance option instructs the UniTel Voice Push server to use a hash token as the rinstance in the contact header of SIP register. RInstance assists some SIP servers with identifying different clients contact addresses when servers support multiple registrations for a single SIP account. Refer to the Disable Hash Token option for an example of when to use RInstance.

Disable Hash Token

The UniTel Voice Push server generates a globally-unique hash token for each customer to avoid possible SIP username collisions. The UniTel Voice Push server uses this token when registering to the SIP service on behalf of the UniTel Voice client's SIP account. In most cases, using the hash token is beneficial and does not cause any problems for registration and call processing. However, some SIP servers, mainly PBXs that are not compliant to the SIP RFC specifications, cannot handle this token. If this is the case, disable hash token and try using RInstance instead in order to help the UniTel Voice Push server identify the clients. Note that some PBXs do not support RInstance either.

Testing push notifications

After setting up push on your SIP account, you can use the Test Push Service button to make sure that your device can communicate with the UniTel Voice Push server and that your device is able to receive push notifications from the Apple APNS push notification system. Your SIP account must be enabled in order to test push notifications.

To test push notifications

1. Go to Settings > Accounts and tap More Info beside the SIP account you to test.

2. Tap Test Push Service.

If you see Push test passed, push notifications are working. If push notifications fail, review your push notification settings and check the UniTel Voice Mobile Push Checklist to see if your device and your server can be used with the UniTel Voice Push Service.

You can also test push notifications by putting UniTel Voice in the background and trying to call it from another number. If you receive a notification of an incoming call, you have correctly set up the UniTel Voice Push Service.

Stop receiving push notifications

There are multiple ways to stop receiving push notifications.

To stop receiving push notifications on you Team Voice account.

1. Log out: Go to Settings and tap Logout.

To stop receiving push notifications on additional SIP accounts
  • Disable the UniTel Voice Push Service: Go to Settings > Accounts and tap beside the SIP account and turn off Settings > Accounts > Account (SIP) > Enabled. Turn off Settings > Accounts - UniTel Voice Push Service > Use Push Notifications. Make sure to turn on Enabled to use the SIP account.
  • Disable the SIP account: Go to Settings > Account and tap beside the SIP account and turn off Enabled.
  • Change your presence to Do Not Disturb: When you change your presence to Do Not Disturb, incoming calls are rejected. Calls show in History as a Missed Call entry.
  • Turn on Do Not Disturb on your device: When you use the device’s Do Not Disturb setting, the call is shown on the screen but you will not hear an audible alert.
  • Turn on Client-Side Call Forwarding: Go to Settings > Preferences > Forward Calls. Enter the number you want to forward the calls to in To Number.
  • Turn off device notifications for UniTel Voice: Go to the device Settings > Notifications > UniTel Voice and clear Show Notifications.
  • Log out: Go to Settings and tap Logout.

Further instructions on setting up push notifications.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.