# Uygulama Bildirimleri

FCM, APNs ve Expo sağlayıcısı, cihaz sayıları, deneme bildirimi
Kaynak: https://selwise.com/docs/messaging/app-push

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](/docs/mobile/push-notifications). 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](/docs/messaging/web-push).

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:

1. 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.
2. Kişi, uygulamanın onay ekranında **pazarlama** iznini vermiştir; geri çekerse telefon ulaşılamaz olur.
3. Telefonun anahtar ailesi için bağlı ve **doğrulanmış** bir sağlayıcı vardır.
4. 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ı](/docs/messaging/providers)).

## 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 `BadDeviceToken` yanıtı çoğunlukla sandbox ile üretimin karışması demektir; Firebase'in `SENDER_ID_MISMATCH` yanı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 |
