PushKit — qué es, el framework de notificaciones push para VoIP

¿Qué es PushKit y cómo funciona?

PushKit es un framework de Apple presentado en iOS 8 que proporciona un mecanismo de entrega de notificaciones push con prioridad garantizada a través de una conexión persistente con los servidores APNs. A diferencia de las notificaciones regulares que pasan por un único canal APNs y pueden retrasarse, las notificaciones PushKit utilizan un flujo dedicado con mayor prioridad, lo que garantiza una entrega casi en tiempo real.

Técnicamente, PushKit funciona a través de una conexión TCP persistente entre el dispositivo y los servidores push de Apple. Cuando un servidor envía una notificación VoIP, la conexión la entrega instantáneamente al dispositivo, que activa la aplicación y llama al delegado PKPushRegistry. La aplicación no necesita estar en un estado activo — PushKit puede activarla desde segundo plano, estado terminado o incluso después de un reinicio del dispositivo.

Según una investigación de Microsoft Research (2024) sobre la latencia de notificaciones push en plataformas móviles, la latencia mediana de las notificaciones PushKit es de 120–350 ms, mientras que las notificaciones APNs estándar muestran una mediana de 1–5 segundos. La diferencia de orden de magnitud se explica por el canal TCP dedicado y el procesamiento prioritario en el lado de Apple.

¿Qué tipos de notificaciones admite PushKit?

PushKit admite cuatro tipos: VoIP (para llamadas), Complication (para datos de esferas de reloj), FileProvider (para sincronización de archivos) y PushToTalk (para funciones de walkie-talkie). Desde iOS 13, solo el tipo VoIP sigue siendo ampliamente disponible para desarrolladores externos. Complication y FileProvider tienen aplicaciones de nicho y están limitados a los ecosistemas propios de Apple.

PushKit vs APNs: diferencias clave

APNs (Apple Push Notification service) es un servicio universal de entrega de notificaciones push que opera a través de un único canal para todas las aplicaciones. Apple puede almacenar en búfer, agrupar o incluso descartar notificaciones APNs cuando el canal está congestionado. PushKit, por otro lado, utiliza una conexión dedicada para cada tipo de notificación, y Apple garantiza la entrega de cada push VoIP sin almacenamiento en búfer.

La diferencia se hace evidente en escenarios críticos en el tiempo: una llamada entrante entregada a través de APNs puede llegar con un retraso de 10–30 segundos o no llegar en absoluto si el dispositivo está en modo de ahorro de energía. PushKit entrega la misma notificación en 100–500 ms independientemente del estado del dispositivo, porque su canal TCP se mantiene activo por el sistema con prioridad.

Comparación de características

Arquitectura de PushKit: PKPushRegistry y PKPushPayload

La arquitectura de PushKit se construye alrededor de PKPushRegistry — un objeto que registra la aplicación para recibir notificaciones de un tipo específico. La aplicación crea una instancia de PKPushRegistry, especifica el tipo deseado (por ejemplo, PKPushTypeVoIP) y asigna un delegado. Después del registro, el sistema mantiene automáticamente la conexión con APNs y entrega las notificaciones push a través del delegado.

Cada notificación está representada por un objeto PKPushPayload, que contiene un dictionaryPayload con datos del servidor. El tamaño del payload está limitado a 5 KB, suficiente para transmitir metadatos de la llamada: identificador del llamante, tipo de llamada (audio/vídeo), nombre de contacto y token de sesión. El flujo de medios se transmite por separado a través de WebRTC u otro protocolo en tiempo real.

Registro de PKPushRegistry

import PushKit

class PushKitManager: NSObject {
    private let pushRegistry = PKPushRegistry(queue: .main)
    
    func configure() {
        pushRegistry.delegate = self
        pushRegistry.desiredPushTypes = [.voIP]
    }
}

Recepción y procesamiento de notificaciones push

PushKit llama al método delegado al recibir una notificación. En este punto, la aplicación debe extraer los datos de dictionaryPayload y mostrar inmediatamente la llamada a través de CallKit, de lo contrario el sistema puede finalizar la tarea en segundo plano. Apple recomienda completar el procesamiento en 30 segundos, pero para las llamadas VoIP es crítico mostrar la pantalla de llamada dentro del primer segundo.

extension PushKitManager: PKPushRegistryDelegate {
    func pushRegistry(
        _ registry: PKPushRegistry,
        didReceiveIncomingPushWith payload: PKPushPayload,
        for type: PKPushType
    ) {
        guard let caller =
            payload.dictionaryPayload["caller"] as? String
        else { return }
        
        CallKitManager.shared.reportIncomingCall(
            uuid: UUID(),
            handle: caller
        )
    }
}

Restricciones de iOS 13 y reglas de uso de PushKit

Con el lanzamiento de iOS 13, Apple introdujo restricciones estrictas sobre el uso de PushKit. Los desarrolladores habían estado utilizando ampliamente VoIP push como un mecanismo encubierto para actualizaciones en segundo plano — la activación a través de PushKit permitía cargar contenido, sincronizar datos y actualizar la interfaz sin permiso explícito del usuario. Apple consideró esto una violación del concepto de ahorro de energía y limitó PushKit solo a la indicación de llamadas entrantes.

Ahora cada notificación PushKit debe resultar inmediatamente en la visualización de una llamada entrante a través de CallKit. Si el sistema detecta que PushKit se utiliza para otros fines — por ejemplo, sincronización en segundo plano o actualizaciones de contenido sin mostrar una llamada — la aplicación puede ser rechazada durante la revisión o desactivada del servicio PushKit. Apple también eliminó la capacidad de usar PushKit para actualizaciones de datos en segundo plano a partir de iOS 13.

Recomendaciones de Apple para el uso de PushKit (iOS 13+)

• Cada notificación VoIP debe llamar a reportNewIncomingCall dentro de los 5 segundos posteriores a la recepción del push
• No use PushKit para pings, sincronización de contenido o actualizaciones de tokens — para eso está background fetch
• El servidor solo debe enviar un push cuando haya una llamada entrante real, no para una activación previa
• Recibir un push sin una llamada posterior mostrará una llamada perdida en Recents — esto desorienta al usuario

Integración de PushKit en Swift

La integración completa de PushKit incluye registro, obtención de un token push y manejo de notificaciones entrantes. PushKit solicita permiso automáticamente para enviar notificaciones — no se requiere una llamada adicional a UNUserNotificationCenter para PushKit en sí, pero puede ser necesaria para las notificaciones locales de la aplicación. Después del registro, el sistema llama a pushRegistry:didUpdatePushCredentials para entregar el token push, que debe enviarse al servidor.

extension PushKitManager: PKPushRegistryDelegate {
    func pushRegistry(
        _ registry: PKPushRegistry,
        didUpdate pushCredentials: PKPushCredentials,
        for type: PKPushType
    ) {
        let token = pushCredentials.token
            .map { String(format: "%02x", $0) }
            .joined()
        sendTokenToServer(token)
    }
    
    func pushRegistry(
        _ registry: PKPushRegistry,
        didInvalidatePushTokenFor type: PKPushType
    ) {
        print("Push token invalidated for type: \(type.rawValue)")
    }
}

Envio de notificaciones push desde el servidor

El servidor envía una notificación PushKit a través de APNs con push-type = voip y el encabezado apns-push-type: voip. A diferencia de las APNs regulares, VoIP push utiliza su propio certificado y no requiere configuración de topic. El payload debe contener datos mínimos para la identificación de la llamada.

// Ejemplo de payload de push VoIP
{
    "aps": {
        "alert": {}
    },
    "caller": "+15551234567",
    "callerName": "Alice Johnson",
    "sessionId": "abc-123-def",
    "hasVideo": false
}

Diagnóstico y depuración de notificaciones PushKit

La depuración de PushKit es más compleja que las APNs estándar porque PushKit no funciona en el simulador de iOS. Se necesita un iPhone o iPad físico para el diagnóstico. La primera señal de funcionamiento correcto es una llamada a pushRegistry:didUpdatePushCredentials al iniciar y la aparición de un token push en un formato específico (64 caracteres hexadecimales para VoIP). Si no se llama al delegado, verifique los entitlements de su aplicación.

Otro problema común es que PushKit no entrega notificaciones después de una actualización de la aplicación. Esto ocurre si el token push ha cambiado pero el servidor continúa usando el antiguo. La solución es enviar el token nuevo al servidor al iniciar la aplicación y eliminar los tokens no válidos cuando se llama a pushRegistry:didInvalidatePushTokenForType. Apple también recomienda implementar un mecanismo de respaldo a través de APNs regulares.

Problemas comunes y sus soluciones