iOS FCM Push Notifications

FCM doesn’t support VoIP pushes; use APNs + PushKit for VoIP calls.

iOS UI Kit Sample App

Reference implementation of iOS UIKit, FCM and Push Notification Setup.

What this guide covers

CometChat dashboard setup (enable push, add FCM iOS + APNs providers) with screenshots.
Firebase/FCM + CometChat provider wiring (credentials, Podfile, capabilities).
Token registration/rotation with CometChat Push Notifications (FCM iOS provider).
Incoming message/call handling and deep links.
Payload customization and testing.

How FCM + CometChat work together

FCM’s role: Firebase issues the iOS FCM registration token and delivers the push payload. On iOS, FCM hands off to APNs using the APNs key/cert you upload in Firebase.
CometChat Notifications’ role: The FCM iOS provider you create in the CometChat dashboard holds your Firebase service account. When you call CometChatNotifications.registerPushToken(..., .FCM_IOS, providerId), CometChat binds that FCM token to the logged-in user and sends pushes to FCM on your behalf.
Flow (same bridge used in android-push-notifications.mdx): Request permission → register for remote notifications → FCM returns the registration token → after CometChat.login succeeds, register that token with CometChatNotifications using the FCM provider ID → CometChat sends payloads to FCM → FCM hands to APNs → UNUserNotificationCenterDelegate surfaces the notification/tap.

1. Enable push and add providers (CometChat Dashboard)

Go to Notifications → Settings and enable Push Notifications.

On Firebase:
- Go to Project Settings → Service accounts and generate a new private key; download the JSON file.

On CometChat Dashboard:
- Add an FCM iOS provider and upload your Firebase service account JSON; copy the Provider ID.

2. Upload your APNs Certificates

In the Firebase Console, go to Project Settings → Cloud Messaging.
Under iOS app configuration, upload your APNs authentication key or certificates.

Upload APNs Certificates in Firebase Console

3. Prepare Firebase and CometChat

Firebase Console: download and add GoogleService-Info.plist to your target.

Xcode capabilities: Push Notifications, Background Modes → Remote notifications.

Enable Push Notifications and Background Modes for FCM

4. Add dependencies (Podfile)

target 'YourApp' do
  use_frameworks!

  pod 'CometChatCallsSDK'
  pod 'CometChatUIKitSwift', '5.1.7'
  pod 'Firebase/Messaging'   # add for FCM
end

Run pod install.

5. Wire AppDelegate (Firebase + delegates)

import UIKit
import FirebaseCore
import FirebaseMessaging
import CometChatUIKitSwift
import CometChatSDK

@main
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate, MessagingDelegate {

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {

        FirebaseApp.configure()

        Messaging.messaging().delegate = self

        UNUserNotificationCenter.current().delegate = self
        UNUserNotificationCenter.current().requestAuthorization(
            options: [.alert, .badge, .sound]
        ) { granted, error in
            print("Notification permission granted:", granted)
            if let error = error {
                print("Permission error:", error.localizedDescription)
            }
            
            // Only register for remote notifications if permission granted
            if granted {
                DispatchQueue.main.async {
                    print("Registering for remote notifications...")
                    application.registerForRemoteNotifications()
                }
            } else {
                print("Push notification permission denied by user")
            }
        }

        return true
    }

    func application(
        _ application: UIApplication,
        didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data
    ) {
        Messaging.messaging().apnsToken = deviceToken
        
        // Store the token for later registration after login
        let hexString = deviceToken.map { String(format: "%02.2hhx", $0) }.joined()
        UserDefaults.standard.set(hexString, forKey: "apnsPushToken")
        print("APNs token received and stored: \(hexString)")
    }
    
    func application(
        _ application: UIApplication,
        didFailToRegisterForRemoteNotificationsWithError error: Error
    ) {
        print("Failed to register for remote notifications: \(error.localizedDescription)")
    }
    
    func application(
        _ application: UIApplication,
        didReceiveRemoteNotification userInfo: [AnyHashable : Any],
        fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void
    ) {
        print("Background notification received:", userInfo)
        completionHandler(.newData)
    }

    func messaging(
        _ messaging: Messaging,
        didReceiveRegistrationToken fcmToken: String?
    ) {
        guard let fcmToken = fcmToken else {
            print("FCM token is nil")
            return
        }

        print("FCM Token received:", fcmToken)
        
        // Store FCM token as well
        UserDefaults.standard.set(fcmToken, forKey: "fcmPushToken")
        
        if let apnsToken = UserDefaults.standard.string(forKey: "apnsPushToken") {
            print("Registering APNs token with CometChat: \(apnsToken)")
            CometChatNotifications.registerPushToken(
                pushToken: fcmToken,
                platform: CometChatNotifications.PushPlatforms.FCM_IOS,
                providerId: AppConstants.PROVIDER_ID,
                onSuccess: { success in
                    print("APNs token registered with CometChat: \(success)")
                },
                onError: { error in
                    print("APNs token registration failed: \(error.errorCode) - \(error.errorDescription)")
                }
            )
        } else {
            print("No stored APNs token found - Check if Push Notifications capability is enabled in Xcode")
        }
    }


    func userNotificationCenter(
        _ center: UNUserNotificationCenter,
        willPresent notification: UNNotification,
        withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
    ) {
        completionHandler([.banner, .sound, .badge])
    }
    
    // Call this method AFTER CometChat login succeeds
    static func registerStoredPushToken() {
        guard CometChat.getLoggedInUser() != nil else {
            print("Cannot register push token: User not logged in")
            return
        }
        
        // Register APNs token
        if let apnsToken = UserDefaults.standard.string(forKey: "apnsPushToken") {
            print("Registering APNs token with CometChat: \(apnsToken)")
            CometChatNotifications.registerPushToken(
                pushToken: apnsToken,
                platform: CometChatNotifications.PushPlatforms.APNS_IOS_DEVICE,
                providerId: AppConstants.PROVIDER_ID,
                onSuccess: { success in
                    print("APNs token registered with CometChat: \(success)")
                },
                onError: { error in
                    print("APNs token registration failed: \(error.errorCode) - \(error.errorDescription)")
                }
            )
        } else {
            print("No stored APNs token found - Check if Push Notifications capability is enabled in Xcode")
        }
        
        // Register FCM token
        if let fcmToken = UserDefaults.standard.string(forKey: "fcmPushToken") {
            print("Registering FCM token with CometChat...")
            CometChat.registerTokenForPushNotification(
                token: fcmToken,
                onSuccess: { message in
                    print("CometChat FCM token registered successfully")
                },
                onError: { error in
                    print("CometChat FCM token registration failed:", error?.errorDescription ?? "Unknown error")
                }
            )
        } else {
            print("No stored FCM token found")
        }
    }
}

What this code is doing

Initializes Firebase, sets MessagingDelegate and UNUserNotificationCenterDelegate, asks for alert/badge/sound permission, and registers for remote notifications.
Sets Messaging.messaging().apnsToken so FCM can map the APNs token and later deliver via APNs.
Stores the FCM registration token and calls registerStoredPushToken() so CometChat can bind the token to your logged-in user (using the Provider ID you configured).
Leaves willPresent to show banners/sounds in foreground instead of silently ignoring the notification.

6. Create FCM helper

Create CometChatFCMHelper.swift and add:

import UIKit
import UserNotifications

final class CometChatFCMHelper {

    static let shared = CometChatFCMHelper()
    private init() {}

    /// Configure push notifications (iOS-safe)
    func configure(application: UIApplication, delegate: UNUserNotificationCenterDelegate) {

        // 1. Request permission
        UNUserNotificationCenter.current().requestAuthorization(
            options: [.alert, .badge, .sound]
        ) { granted, error in
            print("Notification permission:", granted)
            if let error = error {
                print("Permission error:", error.localizedDescription)
            }
        }

        // 2. Set delegate
        UNUserNotificationCenter.current().delegate = delegate

        // 3. Register for APNs
        DispatchQueue.main.async {
            application.registerForRemoteNotifications()
        }
    }
}

What this helper is doing

Wraps permission prompts + delegate wiring so you can call one method from AppDelegate.
Sets the notification delegate early and registers for APNs on the main queue (Apple requirement).
Keeps all push setup in a reusable singleton to call from tests, scenes, or multi-target setups.

7. Testing checklist

FirebaseApp.configure() runs; FCM token logs after login; registration with CometChat succeeds.
Message from another user:
- Foreground: willPresent behavior as expected.
- Background/terminated: tap opens the correct chat.
Rotate the FCM token (didReceiveRegistrationToken) and confirm re-registration.
VoIP: VoIP token registers; incoming call shows CallKit; Accept/Decline controls the CometChat call.

8. Troubleshooting

Symptom	Quick checks
No FCM pushes	`GoogleService-Info.plist` present; APNs key uploaded to Firebase; bundle ID matches; permission granted.
Token registration fails	Run after login; provider ID matches FCM iOS provider; `Messaging.messaging().delegate` set.
Taps ignored	Ensure `UNUserNotificationCenterDelegate` methods fire and navigation is ready before routing.
Call UI missing	Add PushKit + CallKit wiring; register VoIP token with an APNs VoIP provider; ensure VoIP/background modes are enabled.

iOS UI Kit Sample App

​What this guide covers

​How FCM + CometChat work together

​1. Enable push and add providers (CometChat Dashboard)

​2. Upload your APNs Certificates

​3. Prepare Firebase and CometChat

​4. Add dependencies (Podfile)

​5. Wire AppDelegate (Firebase + delegates)

​6. Create FCM helper

​7. Testing checklist

​8. Troubleshooting

What this guide covers

How FCM + CometChat work together

1. Enable push and add providers (CometChat Dashboard)

2. Upload your APNs Certificates

3. Prepare Firebase and CometChat

4. Add dependencies (Podfile)

5. Wire AppDelegate (Firebase + delegates)

6. Create FCM helper

7. Testing checklist

8. Troubleshooting