This guide helps you troubleshoot common issues that prevent push notifications from being delivered in the Telnyx WebRTC Android SDK.

One of the most common issues is that the FCM token is not being passed correctly during the login process.

How to verify:

• Check your application logs to ensure the FCM token is being retrieved successfully
• Verify that the login message contains the FCM token
• Look for logs similar to: FCM token received: [your-token]

Solution:

• Make sure you're retrieving the FCM token as shown in the App Setup guide
• Ensure the token is passed to the connect() method within the TelnyxConfig object (Ether Credential or Token)
• Verify that the token is not null or empty before passing it

If your Firebase configuration file is incorrect or outdated, push notifications will not work properly.

How to verify:

• Check that the google-services.json file is in the correct location (app module root directory)
• Verify that the package name in the google-services.json matches your application's package name

Solution:

• Download a fresh copy of the google-services.json file from the Firebase Console
• Make sure you're using the correct Firebase project for your application
• Follow the Portal Setup guide to properly configure Firebase

If the push credential is not correctly assigned to your SIP credential, the server won't know where to send push notifications.

How to verify:

• Log into the Telnyx Portal and check your SIP Connection settings
• Verify that the correct Android push credential is selected in the WebRTC tab

Solution:

• Follow the steps in the Portal Setup guide to properly assign the push credential
• Make sure you've selected the correct credential for your application

If your push credential contains incorrect information, push notifications will fail.

How to verify:

• Check the push credential in the Telnyx Portal
• Verify that the server key JSON is correctly formatted and valid

Solution:

• Generate a new server key in the Firebase Console
• Update your push credential in the Telnyx Portal with the new key
• Test push notifications after updating the credential

The way you authenticate with the Telnyx WebRTC SDK can affect push notification functionality.

How to verify:

• Check which login method you're using: SIP Connection, Generated Credential, or Token
• Refer to the Dialing Registered Clients documentation

Solution:

• Be aware that there are limitations on which registered clients can be called
• Test direct socket-connected calls before attempting push notification calls
• If using a token-based authentication, ensure the token has the necessary permissions

1. Check Firebase Console Logs

   • Go to the Firebase Console > Your Project > Engage > Messaging
   • Check for any errors or failed deliveries

2. Verify Android Manifest Configuration

   • Ensure your AndroidManifest.xml has the correct permissions and service declarations
   • Check that your FirebaseMessagingService is properly registered

3. Test with Firebase Test Notifications

   • Use the Firebase Console to send a test notification to your device
   • This can help determine if the issue is with Firebase or with Telnyx

4. Check Network Connectivity

   • Ensure your device has a stable internet connection
   • Firebase Cloud Messaging requires network connectivity to receive notifications

5. Verify Device Registration

   • Make sure your device is properly registered with Firebase
   • Check that the FCM token is being refreshed when needed

To help troubleshoot push notification issues, we provide a command-line tool that can send test VoIP push notifications directly to your Android device.

The Telnyx VoIP Push Notification Tester is a Node.js tool located in the push-notification-tool/ directory of the WebRTC Android SDK repository. This tool allows you to:

• Send test VoIP push notifications using Firebase Cloud Messaging HTTP v1 API
• Verify that your device can receive push notifications
• Test different caller information and payload data
• Work with any Firebase project (not limited to Telnyx projects)

1. Navigate to the tool directory:

   cd push-notification-tool

2. Install dependencies:

   npm install

3. Run the tool:

   npm start

4. Configure the tool with:

   • Your device's FCM token
   • Firebase Project ID (your Firebase project)
   • Firebase Service Account JSON credentials
   • Caller name and phone number for testing

The tool will guide you through an interactive setup process and save your configuration for future use.

This tool tests the push notification delivery path independently of the Telnyx WebRTC SDK. If notifications work with this tool but not through normal calls, the issue is likely in one of the following areas:

• SIP Connection configuration in Telnyx Portal
• Push credential assignment
• FCM token registration during SDK login
• Application's FirebaseMessagingService implementation

If notifications don't work with this tool, the issue is likely:

• Incorrect Firebase configuration
• Invalid FCM token
• Network connectivity issues
• Device-specific notification settings

If you've gone through all the troubleshooting steps and are still experiencing problems:

1. Check the Telnyx WebRTC SDK documentation for any updates or known issues
2. Contact Telnyx Support with detailed information about your setup and the issues you're experiencing
3. Include logs, error messages, and steps to reproduce the problem when contacting support