iOS critical alert, interruption level ve ses

Bu rehber Pushizo'nun iOS bildirimlerinde desteklediği aps alanlarını, ios_interruption_level (time-sensitive / critical) kullanımını ve ses/hacim davranışını açıklar. Critical alert, Apple'ın yalnızca başvuruyla verdiği bir entitlement gerektirir; Pushizo payload'ı üretir, entitlement ve izin uygulama tarafında kalır.

1. Desteklenen iOS alanlarıBağlantıyı kopyala

POST /v1/notifications (ve şablon/kampanya içeriği) alanlarının APNs karşılıkları (packages/providers/src/apns.ts buildApnsPayload):

aps.sound her zaman dize olarak yazılır; { "critical": 1, "name": "…", "volume": … } sözlüğü üretilmez (bkz. §3).

2. Interruption levelBağlantıyı kopyala

Gönderim:

await hs.notifications.create({
  target: { include_external_ids: ['user_42'] },
  headings: { tr: 'Güvenlik uyarısı' },
  contents: { tr: 'Hesabınıza yeni cihazdan giriş yapıldı' },
  ios_interruption_level: 'time-sensitive',
  ios_sound: 'alert.caf',
  thread_id: 'security',
});

ios_interruption_level: 'critical' değeri yalnızca entitlement'ı olan uygulamalara gönderilmelidir; entitlement yoksa APNs isteği reddetmez, ancak cihaz bildirimi normal (active) seviyede gösterir.

3. Critical alert kurulumu ve mevcut davranışBağlantıyı kopyala

Apple tarafıBağlantıyı kopyala

1. Critical alert entitlement başvurusu yapın (sağlık, güvenlik, kamu güvenliği gibi kullanım alanları gerekir).
2. Onay sonrası App ID'ye Critical Alerts yeteneğini ekleyin; .entitlements dosyasına com.apple.developer.usernotifications.critical-alerts = true.
3. İzin isteminde .criticalAlert seçeneğini ekleyin. Pushizo iOS SDK'sının Pushizo.Notifications.requestPermission çağrısı [.alert, .badge, .sound] (+ provisionalAuthorization açıksa .provisional) ister; .criticalAlert istemez. Bu nedenle critical alert iznini uygulamanız ayrıca istemelidir:

import UserNotifications

func requestCriticalAlerts() {
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound, .criticalAlert]) { granted, _ in
        // Kullanıcı critical alert iznini ayrı bir anahtarla yönetir (Ayarlar → Bildirimler → uygulama → Kritik Uyarılar)
    }
}

Bu çağrı Pushizo SDK'sının izin takibiyle çelişmez: SDK etkin izni UNUserNotificationCenter.getNotificationSettings üzerinden okur ve abonelik push_capable bilgisini günceller; addPermissionObserver değişikliği bildirir.

Pushizo tarafı (mevcut davranış)Bağlantıyı kopyala

• ios_interruption_level: "critical" → aps.interruption-level: "critical" yazılır.
• ios_sound → aps.sound: "<dosya>" (dize). Apple'ın critical alert için tanımladığı aps.sound = { "critical": 1, "name": "…", "volume": 0.0–1.0 } sözlüğü ve dolayısıyla hacim ezmesi (volume) desteklenmez; ses cihaz ayarındaki hacimle çalar. Bu alanlar eklendiğinde MessageContent (packages/db/src/schema/delivery.ts) ve OpenAPI sözleşmesi genişletilecek, mevcut alanlar değişmeyecektir (ekleme kırıcı değildir).
• Notification Service Extension (PushizoExtension) aps içeriğini mutableCopy ile korur; interruption-level ve sound değerleri NSE'den geçerken değişmez. NSE bir bildirimi critical seviyeye yükseltemez (bu yalnızca payload + entitlement ile mümkündür).
• Critical ve time-sensitive seviyeler sessiz saatler ve frekans sınırından otomatik muaf değildir; işlemsel/kritik mesajlarda quiet_hours_exempt: true ve frequency_cap_exempt: true alanlarını birlikte gönderin.

4. SesBağlantıyı kopyala

• ios_sound: uygulama paketindeki özel ses (alert.caf); default sistem sesi. Dosya bulunamazsa iOS varsayılan sesi çalar.
• Sessiz push (content_available: true) ses göndermez.
• Android'de karşılık android_sound (res/raw/<ad>), ya da Dashboard → Ayarlar → Android bildirim kategorileri içindeki kanal sesi (android_channel_id). Android 8+ sesi kanal belirler; mesaj başına ses yalnızca kanal yoksa uygulanır.
• Web'de ses tarayıcı/işletim sistemi ayarıdır; mesaj alanı yoktur.

5. DoğrulamaBağlantıyı kopyala

1. Test cihazında (gerçek cihaz; simülatörde APNs yoktur) uygulamayı sandbox ortamıyla çalıştırın, Dashboard → Kanallar → iOS Push ortamının eşleştiğini doğrulayın (BadDeviceToken ortam uyumsuzluğudur).
2. Cihazı Rahatsız Etme'ye alın; time-sensitive mesaj gelmeli, active mesaj özette kalmalıdır.
3. Critical alert entitlement'ı olan uygulamada cihazı sessize alıp ios_interruption_level: "critical" gönderin; ses çalmalıdır. Entitlement yoksa bildirim normal seviyede gelir, bu beklenen davranıştır.
4. Mesaj İzleme'de sent → received → opened zaman çizelgesi; received kaydı NSE tarafından yapılır (PushizoExtension eklenmemişse yalnızca opened görünür).