Uygulama Bildirimleri
FCM, APNs ve Expo sağlayıcısı, cihaz sayıları, deneme bildirimi
Uygulama bildirimi (app push), senaryonun alışverişçinin telefonuna gönderdiği bildirimdir. E-posta ve SMS gibi gönderimi sizin kendi hesabınız yapar: Firebase projeniz, Apple geliştirici ekibiniz ya da Expo hesabınız. Selwise bildirimi yazar, kime gideceğine karar verir ve sonucu ölçer; Apple ya da Google'a kendi adına hiçbir şey göndermez. Telefonu SDK kaydeder: Telefonu Bildirime Kaydetme. Bu sayfa panel tarafını anlatır.
Panelde nerede
Sol menüde Ayarlar → Mesajlaşma Sağlayıcıları (Settings → Messaging Providers), adres /dashboard/settings/messaging. Uygulama kanalında liste, e-posta ve SMS sağlayıcılarının yanında FCM, APNs ve Expo sağlayıcılarını da sunar ve sayfada App notifications (Uygulama bildirimleri) kartı görünür. Web kanalında bu üç sağlayıcı sunulmaz ve kart yoktur: bir web sitesinin cihaz anahtarı olmaz, onun bildirimi tarayıcı bildirimidir.
Kart; bildirim gönderilebilen, bildirimleri kapatan, henüz sorulmayan ve artık ulaşılamayan telefon sayısını, en yeni kaydın tarihini ve bir Send a test notification (Deneme bildirimi gönder) düğmesini gösterir. Henüz kaydolan telefon yoksa sıfırlar yerine uygulamanın ne çağıracağını yazar.
Sağlayıcıyı bağlama
Bir telefon, anahtarının ailesine göre kendi sağlayıcısından gider. Android'de FCM, iOS'ta APNs (ya da Firebase üzerinden FCM) kullanıyorsanız ikisini de bağlarsınız ve senaryoya tek bir adım yazarsınız; her telefon kendi sağlayıcısına yönlenir.
| Sağlayıcı | Alan | Nereden alınır |
|---|---|---|
| FCM | Service account key (JSON) | Firebase konsolu → Proje ayarları → Hizmet hesapları → Yeni özel anahtar oluştur; inen dosyanın tamamını yapıştırın |
| APNs | Authentication key (.p8), Key ID, Team ID, Bundle ID, Use the sandbox | Apple Developer → Anahtarlar bölümünde APNs yetkili bir anahtar; paket kimliği uygulamanızınki. Geliştirme derlemelerinin anahtarları Apple'ın sandbox ortamına kaydolur; o derlemeleri de gönderecekseniz kutuyu işaretleyin |
| Expo | Access token (isteğe bağlı) | Expo hesabınızın erişim anahtarları; yalnızca projenizde gelişmiş güvenlik açıksa gerekir |
Anahtar dosyaları hiçbir ekranda geri gösterilmez; kayıtlı bir değer yalnızca noktalarla belirtilir, boş bırakılan alan kayıtlıyı korur. Bir anahtarı değiştirmek bağlantıyı yeniden doğrulatır. Kaydedince Test connection kendiliğinden çalışır ve hiçbir telefona bildirim göndermeden kimlik bilgisini sınar: FCM'de gönderimi doğrulayan bir istek, APNs'de var olmayan bir cihaza istek (anahtar ve paket kimliği Apple tarafından önce kontrol edilir), Expo'da tanınmayan bir anahtar. Send a test notification ise kayıtlı bir cihaza ya da kendi deneme telefonunuzdan yapıştırdığınız anahtara gerçek bir bildirim yollar.
Expo'da teslim makbuzları okunmaz
Expo bir bildirimi önce kabul eder, telefona ulaşıp ulaşmadığını dakikalar sonra bir makbuzla bildirir. Selwise makbuzları okumaz: gönderim, Expo'nun kabulüyle Delivered sayılır ve Expo'nun bildirmediği ölü bir anahtar, o anahtara bir sonraki gönderimde reddedilince ulaşılamaz olarak işaretlenir. Expo ayrıca birleştirme anahtarını desteklemez.
Bir telefona ne zaman bildirim gider
Bir bildirim ancak şunlar birlikte doğruysa bir telefona gider:
- Telefon uygulama tarafından kaydedilmiştir ve işletim sistemi izni granted (verilmiş) olarak bildirilmiştir. İzni bildirilmemiş telefon undetermined sayılır ve bildirim almaz.
- Kişi, uygulamanın onay ekranında pazarlama iznini vermiştir; geri çekerse telefon ulaşılamaz olur.
- Telefonun anahtar ailesi için bağlı ve doğrulanmış bir sağlayıcı vardır.
- Kişi, ziyaretçi kimliğiyle ya da giriş yaptıysa üye kimliğiyle bu telefonla eşleşir.
Bir kişinin birden çok telefonu olabilir; bildirim hepsine gider ve bir tanesi bile kabul ederse teslimat Delivered sayılır. Aynı bildirimin iki kez gitmemesini aynı üç koruma sağlar (Mesajlaşma sağlayıcıları).
Gönderim sırasında
- Sıklık sınırı ve sessiz saatler e-posta, SMS ve tarayıcı bildirimiyle ortaktır. Sessiz saatte bekleyen bildirim atlanmaz, saat dolunca gider; süresi dolarsa Expired olur. Uygulama bildirimlerinin kendi sessiz saat penceresi ayrıdır (varsayılan 21:00-09:00, İstanbul saati).
- Gönderilebilir kalma süresi en çok 72 saattir. Bu süre sağlayıcıya da iletilir: kapalı bir telefon, süre dolmadan açılırsa bildirimi alır, dolduysa almaz.
- Birleştirme anahtarı boşsa her senaryo adımı için bir tane kullanılır: telefon kapalıyken aynı adımın yeni bir hatırlatması eskisinin yerini alır, yığın oluşmaz.
- Ağ hatası ve geçici sağlayıcı hatasında gönderim en çok üç kez denenir.
- Sağlayıcı bir telefonun artık yok olduğunu söylerse (uygulama silinmiş) o telefon Artık ulaşılamıyor olarak işaretlenir. Kişinin bütün telefonları böyleyse teslimat Failed değil Skipped, sebebi Not reachable olur: ölen bir liste normal bir olaydır. Uygulama yeniden açılıp kayıt yenilenirse telefon yeniden canlanır.
- Bir ayar yüzünden olan ret bir telefonu silmez. Apple'ın
BadDeviceTokenyanıtı çoğunlukla sandbox ile üretimin karışması demektir; Firebase'inSENDER_ID_MISMATCHyanıtı başka bir Firebase projesinin anahtarı demektir. Bu yanıtlar teslimatı Failed yapar ve sebebi yazar, ama telefonlar korunur. Aynı turda bir sağlayıcının her gönderimi böyle reddedilirse sağlayıcı doğrulanmamış sayılır ve ekranı sebebi yazar. - Anahtarın, paket kimliğinin ya da yetkinin reddi (APNs
InvalidProviderToken,TopicDisallowed; FCM 401 ya da 403; Expo geçersiz erişim anahtarı) bağlantının sorunudur: sağlayıcı doğrulanmamış olur, kuyruktaki bildirimler denenmeden bekler ve bir bağlantı testi geçince gider.
Gönderim kaydı ve sağlık
Otomasyon → Mesajlar (Automation → Messages) ekranının gönderim kaydı sekmesinde uygulama bildirimleri de listelenir. Alıcı sütununda telefon, yalnızca platform ve anahtarın son altı karakteri olarak (iOS · …a1b2c3) görünür ve bu sütunu yalnızca kişi iletişim görüntüleme yetkisi olanlar görür. Anahtarın kendisi hiçbir yerde listelenmez. Ana sayfadaki gönderim sağlığı satırı kanalı e-posta ve SMS ile birlikte değerlendirir.
Sık sorunlar
| Belirti | Neden |
|---|---|
| Kart "0 telefon" diyor | Uygulama SDK'nın registerPushToken çağrısıyla yayımlanmamış ya da pazarlama onayı verilmemiş |
| Telefonlar Henüz sorulmadı sayılıyor | Uygulama setPushPermission çağırmıyor |
Her gönderim BadDeviceToken ile reddediliyor | Use the sandbox kutusu derlemenizin ortamıyla uyuşmuyor, ya da paket kimliği yanlış |
TopicDisallowed | APNs anahtarı bu paket kimliği için yetkili değil |
| FCM'de 403 | Firebase projesinde Firebase Cloud Messaging API (V1) etkin değil ya da hizmet hesabının Firebase Cloud Messaging API Yöneticisi rolü yok |
| iOS'ta görsel görünmüyor | Görseli çizmek uygulamada bir bildirim servis uzantısı ister; Android görseli kendisi çizer |
Son güncelleme: 17 Kasım 2026
