My Android device did not display a PUSH notification for an incoming Call/Chat

How it works.
3CX uses Google Firebase Cloud Messaging (FCM) to send Push messages to Android devices for incoming calls and chats. When an FCM Push message is received by the Android device, it notifies the 3CX app for the event so that the app can present relevant actions, i.e. answer, decline, etc.

Why is this happening?
The Push message may not reach the 3CX app due to issues with:
    • Connectivity to the FCM service: If your Android device loses connectivity to the Firebase Cloud Messaging (FCM) instance it will not receive Push messages sent by the 3CX Server for incoming calls and chats. This can occur due to your specific device / network environment parameters and/or connection availability to the FCM service. Please review the Google FCM requirements on maintaining connectivity to the FCM service.

    • The built-in device battery management: The battery / power management mechanism is specific to each device firmware and can throttle notifications or even close the 3CX app. In these cases the 3CX app cannot receive Push notifications consistently to display and handle incoming calls and chats. If you experience this issue, check the documentation for your device and update its configuration to enable the 3CX app to receive Push notifications.


How can I troubleshoot?

To troubleshoot Google FCM delivery issues you can use the Android 'FCM Diagnostics' tool (depends on availability/compatibility):

  1. Open the GSM phone app and go to the keypad.

  2. Dial *#*#426#*#* or *#*#8255#*#* to open the FCM Diagnostics app.

  3. Verify that the connection to FCM is established, i.e. the text 'Server: Connected' is displayed.

  4. Tap on 'EVENTS' and check the log for any connectivity errors, e.g. 'Close err:6 ...'. Capture screenshot(s) to record any errors you notice and provide to your PBX administrator for troubleshooting.

  5. You PBX Administrator can then consult the Google FCM requirements and help you fix the connectivity between your Mobile Device and the Google FCM service.