- On smartphones, notifications of new messages and calls are sent by sending a PUSH notification to the phone, upon which the phone wakes up and receives the call or message. Like other apps, the 3CX Android App relies on receiving these PUSH notifications. These PUSH notifications are generally sent out by Google, although Huawei and Samsung are now also sending out PUSH notifications. 3CX supports Google PUSH only for the moment. This is default behaviour, and there is nothing you need to or can do to change this.
So if you are receiving the calls, but it's not ringing when your phone is in sleep mode, then you are not receiving PUSH notifications. There are several checks you can do to try and fix this
It's obvious, but check first that the 3CX App has network connectivity. You can switch off mobile data for some apps, obviously it needs to be on for 3CX to work.
Check 1: Are you using the right phone, latest Android and 3CX?
To have good results, you will need to use a quality phone with a recent version of Android:
- Android 10+ - Check that you have Android 10 or above. Should really be at least Android 11.
- Recent quality phone - Ensure you have a quality phone from Google, Samsung, Oppo, Motorola, Oneplus for example. No-name China phones can cause problems. It’s not just the hardware, it's also the version of Android that gets installed on it and the agreements (or lack of agreements) they might have with Google with regard to Play Store and Push.
- 3CX V18 - Upgrade to v18 to get significant improvements in terms of using mobile phones with 3CX.
Please note, we will only support the latest versions of phones, Android and 3CX. We allow installation of the app on Android 8 or 9, but we will not support or troubleshoot.
Check 2: Switch off battery optimisation (REQUIRED for Android 14 & 15)
Some versions of Android have battery optimisation settings turned on that terminate background apps, including 3CX, of course. We need to switch that off:
- Launch “3CX”.
- Tap on the top left hamburger menu.
- Tap on “Settings > Advanced”.
- Enable “Switch Off Battery Usage Optimisation”.
- Select All Apps > 3CX
- Make sure ‘Allow background usage’ is turned on
- Tap on ‘Allow background usage’ text
- Select “Don’t Optimise / Unrestricted”. (Name differs on Android versions and Phones)
Please note for Oppo you should follow the steps below:
- Look for the Settings App.
- Tap on “App management”.
- Tap on “App list”.
- Find “3CX”.
- Tap on “Battery Usage”.
- Enable “Allow background activity”.
Check 3: Switch on Background Data for the 3CX App
Enabling background data is required to push through notifications even when the app is not in use. To switch it on:
- Launch “3CX”.
- Tap on the top left hamburger menu.
- Tap on “Settings > Advanced”.
- Enable “Switch On Background Data”.
- Select “Unrestricted data usage” and “Background data”.
Check 4: Using Android 13 or 14? Give the App full permissions
Starting with Android 13, Google has introduced a new runtime permission for app notifications. If this permission is not allowed, you will not receive any app notifications for 3CX. To enable this permission:
- Open Android settings and tap on “Apps”.
- Search for the 3CX app and tap on it.
- Tap on “Permissions”.
- Tap on “Notifications” under the 'Not allowed' section.
- Turn on the switch for “All 3CX notifications”.
Check 5: Is ‘Do Not Disturb’ enabled?
Enabling ‘Do Not Disturb’ will prevent the receipt of PUSH notifications. There are 2 ways to enable DND, from inside the app, and via the Android OS settings.
In-App DND
When opening the 3CX App, you will see a status icon at the top right corner in the header which shows your current status. If this is set to red, you are currently in DND mode. Change your status to ‘Available’ to receive notifications, simply by clicking on the Status icon and selecting the desired status.
Android OS DND
Android OS offers the ability to limit interruptions and silence your phone by setting it to ‘Do Not Disturb’. To turn off ‘Do Not Disturb’:
- Swipe down from the top of your screen to show the Notifications panel.
- Tap on ‘Do Not Disturb’ and set to ‘Off’.
Should this have been done intentionally, Android allows you to set which apps can ignore this rule.
Please follow this guide by Google which explains the steps needed in further detail.
Check 6: Pre-installed or third party cleaner apps
Certain apps may be installed on your phone either by the manufacturer or by you, which could be closing the 3CX app in the background to enhance your phone's speed. These apps are typically maintenance, cleaner or optimiser apps.
To avoid missing out on PUSH notifications, it is important to identify these apps and either disable, uninstall or whitelist the 3CX app client.
Examples of such apps:
- MIUI Optimisation by Xiaomi
- System Maintenance by Blackview
- Droid Optimiser
- Greenify
Check 7: Got a firewall in front of 3CX? Open the ports!
If you have installed 3CX on premise, or are self-hosting 3CX behind a firewall that you manage, it can very well be that your firewall is blocking communication to the Google Firebase Cloud Messaging (FCM) service. See this document to learn about the ports you have to open.
Check 8: Grant Permission for Full Screen Notifications
As of Android 14, Google has introduced a new runtime permission for showing incoming calls on your locked device. New app installs will be requested to grant this permission from the “Permission wizard”. Not doing so will result in an incoming call ringing, but the device not “waking up” or “reacting” unless you unlock your device.
Google states that users who upgrade from previous Android versions to Android 14 should have this permission enabled by default. If you experience the above problem after upgrading to Android 14, you need to enable this permission manually. To enable:
- Open the 3CX app
- Tap on the hamburger menu (top left icon of the app)
- Tap on “Settings” > “Advanced”
- Scroll down to “Notifications, audio & visual effects”
- Tap on the toggle next to ‘Answer on lock screen’
- A new window will appear. Tap on the toggle bar to allow “Full screen alerts”
Note: Certain MIUI devices running on older Android versions also require this permission to be enabled.
If all else fails - Enable “Keep Active” feature
If for some reason you cannot get Push to work, because you cannot change your phone or manage the network you are on, then you can temporarily enable the “Keep Active” function. This will keep a permanent connection open to your 3CX server. Battery usage will be significantly increased.
Send us technical feedback
You can provide us with your technical feedback by sending us a verbose log from the app while the issue occurs so we can investigate further:
- Open “3CX”.
- Enable Verbose Logs: “Android App Settings (top left hamburger menu) > Settings > Advanced > Troubleshooting > Verbose Logging”.
- Reproduce issue and “Generate Log Report”: Android App Settings (top left hamburger menu) > Settings > Advanced > Troubleshooting > Send Log Report.
- Send this log report via email to your PBX administrator so he can communicate with us via 3CX Support and/or Forum.