# Telefonu Bildirime Kaydetme

Telefon anahtarını kaydetme, izin ve dokunulan bildirim
Kaynak: https://selwise.com/docs/mobile/push-notifications

Bir senaryonun **Uygulama bildirimi gönder** adımı, alışverişçinin telefonuna sizin Firebase, Apple ya da Expo hesabınız üzerinden bildirim yollar. Uygulamanın işi üç çağrıdır: telefonun anahtarını kaydetmek, işletim sisteminin iznini bildirmek ve bildirime dokunulunca açılacak bağlantıyı Selwise'e okutmak. Panel tarafı ve sağlayıcı kurulumu: [Uygulama Bildirimleri (panel)](/docs/messaging/app-push).

## Üç çağrı

```ts
import { Platform } from 'react-native';
import messaging from '@react-native-firebase/messaging';

// 1. İşletim sistemi bildirime izin veriyor mu?
const status = await messaging().hasPermission();
selwise.setPushPermission(
  status === messaging.AuthorizationStatus.AUTHORIZED ? 'granted'
    : status === messaging.AuthorizationStatus.DENIED ? 'denied'
    : 'undetermined',
);

// 2. Anahtarı her açılışta ve kütüphane yenilediğinde kaydedin.
const platform = Platform.OS === 'ios' ? 'ios' : 'android';
await selwise.registerPushToken({ token: await messaging().getToken(), provider: 'fcm', platform });
messaging().onTokenRefresh((token) => selwise.registerPushToken({ token, provider: 'fcm', platform }));

// 3. Bildirime dokunulunca bağlantıyı açın.
messaging().onNotificationOpenedApp((message) => {
  const link = selwise.trackPushOpen(message);
  if (link) Linking.openURL(link);
});
```

`registerPushToken` kaydedildiğinde `true`, onay yokluğu ya da ağ hatası yüzünden gönderilemediğinde `false` döner ve uygulamaya hata fırlatmaz; yalnızca olamayacak bir çağrıda (anahtar yok, bilinmeyen sağlayıcı, platform yok) hata verir. `unregisterPushToken()` uygulamanın kendi "bildirimleri kapat" düğmesi içindir.

## Hangi anahtar, hangi `provider`

Anahtarın ailesi, hangi sağlayıcınızın göndereceğini belirler; bu yüzden `provider` zorunludur.

| Bildirim kütüphaneniz | Anahtar | `provider` |
|---|---|---|
| `@react-native-firebase/messaging` `getToken()` (Android ve Firebase üzerinden iOS) | FCM kayıt anahtarı | `fcm` |
| `expo-notifications` `getDevicePushTokenAsync()`, Android | FCM kayıt anahtarı | `fcm` |
| `expo-notifications` `getDevicePushTokenAsync()`, iOS ya da yerel APNs kaydı | APNs cihaz anahtarı | `apns` |
| `expo-notifications` `getExpoPushTokenAsync()` | Expo push anahtarı | `expo` |

APNs anahtarı her zaman iOS'tur. FCM ve Expo anahtarlarında `platform` verin ya da `init` içinde belirtin. Android'de FCM, iOS'ta APNs kullanıyorsanız panelde iki sağlayıcıyı bağlarsınız ve senaryoda tek adım yazarsınız.

## SDK sizin yerinize neye dikkat eder

- **İzin kişinin cevabıdır.** Bir telefona yalnızca `setPushPermission('granted')` iken bildirim gider. İzin bildirilmeden kaydedilen anahtar *undetermined* tutulur ve hiç bildirim almaz; izin değiştiğinde (`denied`, sonradan `granted`) SDK yeni cevabı kayıtlı anahtar için yeniden yollar.
- **Önce onay.** Telefonu kaydetmek bir **pazarlama** kararıdır (`setConsent`). Onay yoksa anahtar gönderilmez; onay geri çekilirse telefon iptal edilir, uygulama kapalıyken geri çekilmişse bir sonraki açılışta. İptal edilmiş telefonu yalnızca yeni bir onay geri getirir: bildirim izni ya da yenilenen anahtar tek başına getirmez, çünkü SDK her kayıt isteğine pazarlama onayının açık olduğunu da yazar ve sunucu bunu yalnızca onay yüzünden iptal edilmiş telefon için arar.
- **Müşteri girişi izler.** `identify()` telefonu müşteriye bağlar (sunucu bağı yalnızca bu ziyaretçiyi o müşteriye bağlayabildiyse tutar), `logout()` çözer. Telefon bu kuruluma ait olarak ulaşılabilir kalır; giriş yapmış kişiyle başlayan bir senaryo, o kişinin telefonlarını bulur.
- **Yenilenen anahtar özel bir şey istemez.** Yenisini kaydedin; kurulumun eski anahtarı sunucuda iptal edilir.
- Sağlayıcının artık yok dediği telefon (uygulama silinmiş) ulaşılamaz olur; kişi uygulamayı yeniden açıp kaydı yenilerse canlanır.

## Bildirimin taşıdığı

Başlık, mesaj, isteğe bağlı görsel, sizin yazdığınız ek veri anahtarları ve **`sw_link`**: adımın işaret ettiği ekran ya da bağlantı. Bağlantıya senaryo kimliği (`sw_sc`) eklenmiştir; `trackPushOpen` bunu mesaj tıklaması olarak kaydeder ve ardından gelen sipariş, diğer mesaj kanallarında olduğu gibi o mesaja yazılır ([Siparişler ve ciro atfı](/docs/mobile/tracking)). Görseli uygulamanın kendisi çiziyorsa adresi `sw_image` anahtarında bulur. Selwise hiçbir zaman gezinmez: bağlantıyı açmak uygulamanın işidir.

Bağlantı, panelde seçilen bir uygulama ekranı (`app://basket`), uygulamanızın kendi derin bağlantısı ya da bir `https://` adresi olabilir. `app://` adresleri Selwise'in kendi ekran adlarıdır; yalnızca uygulamanız onları bir ekrana eşliyorsa açılır, aksi hâlde kendi derin bağlantı şemanızı kullanın.

## Cihazda gerekenler

Android 13 ve üstünde işletim sistemi bildirimi göstermeden önce `POST_NOTIFICATIONS` çalışma zamanı izni ister. iOS izin isteğini (`requestPermission`) ister; görselli bildirim için bir bildirim servis uzantısı gerekir. Bunların hepsi uygulamanın işidir; Selwise yalnızca cevabı okur.

## Akinon App Maker

App Maker'ın kendi bildirim eklentisi (`akinon-firebase-messaging-service`) FCM anahtarını başka eklentilerle paylaşmaz; bu yüzden uygulamanın kendi kodundan eklentiye `Selwise.registerPushToken` ve `Selwise.setPushPermission` çağırması gerekir. Bildirim App Maker'ın eklentisinden geçiyorsa o eklentinin `notification.deepLink.integrationMaps.urlPath` ayarını `data.sw_link` yapın: App Maker bağlantıya gider, Selwise eklentisi de App Maker'ın derin bağlantı servisini dinlediği için dokunuşu kaydeder. Ayrıntı: [Akinon App Maker Eklentisi](/docs/mobile/app-maker).
