> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Örnek uygulama: eksiksiz bir OneSignal entegrasyonu

> Push, uygulama içi mesajlar, e-posta, SMS, Live Activities ve Event Streams'in Expo ve Supabase ile nasıl birlikte çalıştığını görmek için gerçek bir uygulama olan Clean Beans'i takip edin.

OneSignal kılavuzlarının çoğu tek seferde bir özelliği açıklar. Bu kılavuz ise tek bir uygulamayı baştan sona takip eder ve her mesajlaşma özelliğinin nasıl bağlandığını, üretimde çalışan kodla birlikte gösterir.

Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan **Clean Beans**'tir. Expo (React Native) ile geliştirilmiştir ve veritabanı, kimlik doğrulama ve backend fonksiyonları için Supabase kullanır. Uygulamanın gönderdiği her mesajı OneSignal yönetir.

![Clean Beans'in üç ekranı: kontrol paneli, bir temizlik oturumu ve haftalık nöbet çizelgesi](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-dashboard-session-rota.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=f8fc7eac8e69faea6aece66f73c2d820)

Clean Beans: kontrol paneli, bir temizlik oturumu ve haftalık nöbet çizelgesi.

## Clean Beans ne yapar \\

Bir hane odalarını ekler ve uygulama bunları makul sıklıklara sahip bir temizlik görevleri listesine dönüştürür. Nöbet çizelgesi oluşturucu, bu görevleri her kişinin ayırabileceği zamana göre haftaya dağıtır. Üyeler temizlik oturumları başlatır, görevleri işaretler, günlük seriler oluşturur, birbirlerine kudos gönderir ve haftalık bir liderlik tablosunda yarışır.

Temizlik ortaktır, tekrarlanır ve zamana bağlıdır. Bu da onu neredeyse her tür mesaj için uygun kılar: hatırlatıcılar, sosyal güncellemeler, geri sayımlar, özetler ve yönlendirme.

## Bu kılavuz neden var \\

Kılavuzu üç soruyu yanıtlamak için kullanın:

* **Hangi OneSignal özelliği hangi işe uygun?** Her sayfa uygulamanın yapması gereken bir işle başlar, ardından bunu yapan özelliği gösterir.
* **Kod nereye gider?** Bazı işler uygulamaya, bazıları backend'inize, bazıları da OneSignal kontrol paneline aittir. Her örnek hangisi olduğunu belirtir.
* **Neler ters gider?** Her sayfadaki uyarılar ve notlar, özelliği yayına alırken öğrenilenleri kaydeder. `collapse_id` adlı bir ayar denendi ve sonra kaldırıldı. Nedenini [Güvenilir ve doğru davranan push](https://documentation.onesignal.com/docs/tr/example-full-integration-reliable-push.md) sayfası açıklar.

## Nasıl okunur \\

Kılavuz, her konu için bir sayfa olmak üzere bir dizi sayfadan oluşur. Sayfaları sırayla okumanız gerekmez. [SDK kurulumu ve kullanıcı kimliği](https://documentation.onesignal.com/docs/tr/example-full-integration-sdk-setup.md) diğer her şeyin temelidir. Bundan sonraki her sayfa kendi başına okunabilir.

Çoğu özellik aynı şekilde sunulur:

1. **Kullanıcının gördüğü**, genellikle bir ekran görüntüsüyle.
2. **Nasıl çalıştığı**, kimin ne yaptığını gösteren kısa bir adım dizisi olarak.
3. **Kod**, uygulamadan alınmıştır. Her kod bloğunun başlığı, kodun geldiği dosyadır.
4. **Kontrol paneli kurulumu**, özelliğin OneSignal'da yapılandırılması gerektiğinde.

Sınırlamalar ve beklenmedik davranışlar, etkiledikleri özelliğin yanında uyarı ve notlarla belirtilir.

> [!NOTE]
>
> Kod gerçektir, ancak tanımlayıcılar `YOUR_ONESIGNAL_APP_ID` ve `YOUR_PROJECT_REF` gibi yer tutucularla değiştirilmiştir. Uzun dosyalar önemli satırlara indirgenmiştir. Yalnızca `// ...` içeren bir satır, kodun çıkarıldığı yeri gösterir.

## Parçalar nasıl bir araya gelir \\

| Nerede | Neden sorumlu | Örnekler |
| - | - | - |
| **Expo uygulaması** | Cihaza veya oturum açmış kullanıcıya ihtiyaç duyan her şey | SDK'yı başlatma, izin isteme, kullanıcıyı tanımlama, etiketler, özel olaylar, uygulama içi mesaj tetikleyicileri, dokunmaları işleme |
| **Supabase backend'i** | Bir zamanlama veya veri değişikliğiyle tetiklenen her şey | Hatırlatıcılar, sosyal push'lar, haftalık e-posta, SMS kodları ve davetler, Live Activities başlatma, Event Stream webhook'larını alma |
| **OneSignal kontrol paneli** | Yeni sürüm yayınlamadan değişmesi gereken içerik ve hedefleme | Uygulama içi mesajlar, e-posta şablonu, segmentler, Conversion Metrics, Event Stream |

Üçünü **External ID** birbirine bağlar. Clean Beans oturum açıldığında bunu Supabase kullanıcı kimliğine ayarlar. Böylece backend, zaten sakladığı bir kimlikle herkese ulaşabilir.

![Expo uygulamasını, Supabase backend'ini ve OneSignal kontrol panelini gösteren mimari diyagramı](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/clean-beans-architecture.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=b6d5655991cdf5b4de0645b9d7f9cd95)

Uygulama, backend ve kontrol paneli OneSignal ile ayrı ayrı iletişim kurar. External ID onları tek bir kullanıcıya bağlar.

## Özellik haritası \\

| Uygulamanın ihtiyacı | OneSignal özelliği | Sayfa |
| - | - | - |
| Her cihazın kime ait olduğunu bilmek | External ID, e-posta aboneliği | [SDK kurulumu ve kullanıcı kimliği](https://documentation.onesignal.com/docs/tr/example-full-integration-sdk-setup.md) |
| Kişiselleştirme ve segmentasyon | Etiketler, özel olaylar, Conversion Metrics | [Etiketler, özel olaylar ve Conversion Metrics](https://documentation.onesignal.com/docs/tr/example-full-integration-tags-events.md) |
| Kişilere görevlerini hatırlatmak | Zamanlanmış fonksiyonlardan Create message API | [Backend'inizden push gönderme](https://documentation.onesignal.com/docs/tr/example-full-integration-backend-push.md) |
| Ev arkadaşlarına olanları bildirmek | Uygulama ve veritabanı olaylarından Create message API | [Backend'inizden push gönderme](https://documentation.onesignal.com/docs/tr/example-full-integration-backend-push.md) |
| Bir hatırlatıcıyı asla iki kez göndermemek | Idempotency anahtarları | [Güvenilir ve doğru davranan push](https://documentation.onesignal.com/docs/tr/example-full-integration-reliable-push.md) |
| Her push'un uygun şekilde davranmasını sağlamak | Süre sonu, gruplama, kesinti seviyeleri, rozetler | [Güvenilir ve doğru davranan push](https://documentation.onesignal.com/docs/tr/example-full-integration-reliable-push.md) |
| Bir dokunuş veya bağlantıdan doğru ekranı açmak | Tıklama dinleyicisi, derin bağlantılar, Universal Links | [Derin bağlantılar ve bildirim tıklamaları](https://documentation.onesignal.com/docs/tr/example-full-integration-deep-links.md) |
| Doğrudan bildirimden işlem yapılmasını sağlamak | Eylem düğmeleri, zamanlanmış teslimat | [Derin bağlantılar ve bildirim tıklamaları](https://documentation.onesignal.com/docs/tr/example-full-integration-deep-links.md) |
| Uygulama içinde kişilere rehberlik etmek ve hatırlatmak | Tetikleyicili ve özel HTML'li uygulama içi mesajlar | [Uygulama içi mesajlar](https://documentation.onesignal.com/docs/tr/example-full-integration-in-app-messages.md) |
| Haftalık özet göndermek | `custom_data` içeren e-posta şablonu | [custom\_data ile haftalık e-posta](https://documentation.onesignal.com/docs/tr/example-full-integration-weekly-email.md) |
| Bir telefon numarasının kullanıcıya ait olduğunu kanıtlamak | Ham telefon numarasına SMS, SMS aboneliği | [SMS: doğrulama kodları ve davetler](https://documentation.onesignal.com/docs/tr/example-full-integration-sms.md) |
| Uygulaması olmayan kişileri davet etmek | Ham iletişim bilgilerine SMS ve e-posta | [SMS: doğrulama kodları ve davetler](https://documentation.onesignal.com/docs/tr/example-full-integration-sms.md) |
| Kilit ekranında geri sayım göstermek | Live Activities | [Live Activities](https://documentation.onesignal.com/docs/tr/example-full-integration-live-activities.md) |
| Uygulamada bildirim geçmişi tutmak | Event Streams | [Event Streams ile bildirim gelen kutusu](https://documentation.onesignal.com/docs/tr/example-full-integration-inbox.md) |
| Uygulama ayarlarını abonelikten çıkmalarla uyumlu tutmak | Event Streams (e-posta olayları) | [Event Streams ile bildirim gelen kutusu](https://documentation.onesignal.com/docs/tr/example-full-integration-inbox.md) |

## İhtiyacınız olanlar \\

* iOS ve Android için push'un yapılandırıldığı, e-posta ve SMS'in de kurulduğu bir OneSignal uygulaması. [Kanal kurulumu](https://documentation.onesignal.com/docs/tr/channel-setup.md) sayfasına bakın.
* EAS Build ile derlenmiş bir Expo uygulaması. OneSignal SDK'sı yerel kod gerektirdiğinden Expo Go yeterli değildir. [Expo SDK kurulumu](https://documentation.onesignal.com/docs/tr/react-native-expo-sdk-setup.md) sayfasına bakın.
* App ID'niz ve bir App API key. [Anahtarlar ve ID'ler](https://documentation.onesignal.com/docs/tr/keys-and-ids.md) sayfasına bakın.
* Kodu bir zamanlamaya göre ve isteklere yanıt olarak çalıştırabilen bir backend. Clean Beans, `pg_cron` ile Supabase Edge Functions kullanır. Aynı kalıplar her backend için geçerlidir.

## İşe yarayan ilkeler \\

* **Önce External ID'yi ayarlayın.** Buradaki neredeyse her özellik buna bağlıdır. Backend'inizin zaten sakladığı bir kimliği kullanın.
* **Her işi ait olduğu yere koyun.** Uygulama cihazı ve oturum açmış kullanıcıyı yönetir. Backend zamanlamaları ve veri değişikliklerini yönetir. Kontrol paneli, yeni sürüm yayınlamadan değiştirmek istediğiniz her şeyi barındırır.
* **Göndermeden önce kontrol edin.** Backend'den yapılan her gönderim, kullanıcının tercihlerini kontrol eder ve söylemeye değer bir şey olduğunu doğrular.
* **Zamanlanmış gönderimleri tekrarlanabilir yapın.** Tür, alıcı ve tarihten oluşturulan bir idempotency anahtarı, yeniden denemeyi etkisiz bir işleme dönüştürür.
* **URL'ye göre değil, türe göre yönlendirin.** Bir `data.type` alanı, ekranlar taşındığında eski bildirimlerin çalışmaya devam etmesini sağlar.
* **Çağıranların size söylediklerini doğrulayın.** Mesaj gönderen bir fonksiyon, önce bilgileri kendi veritabanınızda doğrulamalıdır.

## Tüm özelliklere bir bakış \\

| Özellik | Kanal | Tetikleyici | Çalıştığı yer | Ana dosya |
| - | - | - | - | - |
| SDK başlatma ve izin | Push | Uygulamanın açılması | Uygulama | `app/_layout.tsx` |
| Kullanıcı kimliği | Tümü | Oturum açma ve kapatma | Uygulama | `app/_layout.tsx` |
| E-posta aboneliği | E-posta | Oturum açma | Uygulama | `src/lib/onesignalSync.ts` |
| İzin ve tercihler | Push, e-posta | Ayarlar ekranı | Uygulama ve veritabanı | `app/notification-settings.tsx` |
| Etiketler | Tümü | Oturum açma, oturum, profil düzenleme | Uygulama | `src/lib/onesignalSync.ts` |
| Özel olaylar | Tümü | Oturum başlangıcı ve bitişi | Uygulama | `src/lib/onesignalSync.ts` |
| Conversion Metrics | Tümü | Oturum bitişi | Kontrol paneli | |
| Günlük özet | Push | Saatlik zamanlama | Backend | `supabase/functions/send-daily-digest/` |
| Gecikmiş görev hatırlatıcısı | Push | Saatlik zamanlama | Backend | `supabase/functions/send-overdue-reminders/` |
| Temizlik hatırlatıcısı | Push | Saatlik zamanlama | Backend | `supabase/functions/send-cleaning-reminder/` |
| Oturum tamamlandı | Push | Uygulamadan çağrı | Backend | `supabase/functions/session-completed/` |
| Kudos | Push | Uygulamadan çağrı | Backend | `supabase/functions/send-kudos/` |
| Katılım onaylandı | Push | Veritabanı tetikleyicisi | Backend | `supabase/functions/join-approved/` |
| Idempotent gönderimler | Push, e-posta | Her zamanlanmış gönderim | Backend | `supabase/functions/_shared/idempotency.ts` |
| Teslimat profilleri | Push | Her push | Backend | `supabase/functions/_shared/delivery.ts` |
| Rozetler | Push | Görev push'ları | Backend | `supabase/functions/send-daily-digest/` |
| Dokunma yönlendirmesi | Push | Bir push'a dokunma | Uygulama | `app/_layout.tsx` |
| Eylem düğmeleri | Push | Push düğmesine dokunma | Backend ve uygulama | `supabase/functions/_shared/buttons.ts`, `src/lib/pushActions.ts` |
| Ertelenen hatırlatıcı | Push | Erteleme düğmesi | Backend | `supabase/functions/snooze-reminder/` |
| Bağlantı yeniden yazma | Bağlantılar | Uygulamanın bir URL'den açılması | Uygulama | `app/+native-intent.tsx` |
| Universal Links ve App Links | Bağlantılar | Bir web bağlantısına dokunma | Uygulama ve web sitesi | `app.json`, `website/.well-known/` |
| Yardım katmanları ve tanıtım turları | Uygulama içi | Yardım düğmesi | Uygulama ve kontrol paneli | `src/components/HelpButton.tsx` |
| Push izni ön istemi | Uygulama içi | Kontrol paneli kitlesi | Kontrol paneli | `docs/iam-html/push-permission-prompt.html` |
| Uygulama güncelleme istemi | Uygulama içi | Eski uygulama sürümü | Kontrol paneli | `docs/iam-html/app-update-prompt.html` |
| Değerlendirme istemi | Uygulama içi | Seri dönüm noktası | Uygulama ve kontrol paneli | `src/lib/reviewPrompt.ts` |
| Haftalık rapor | E-posta | Haftalık zamanlama | Backend ve kontrol paneli | `supabase/functions/weekly-report/` |
| SMS aboneliği | SMS | Telefon numarası doğrulandı, oturum açma | Uygulama | `src/lib/phone.ts` |
| Telefon doğrulama kodu | SMS | Uygulamadan çağrı | Backend | `supabase/functions/send-otp/`, `supabase/functions/verify-otp/` |
| Haneye davet | SMS, e-posta | Uygulamadan çağrı | Backend | `supabase/functions/send-invite/` |
| Seri uyarısı | Live Activity | Saatlik zamanlama | Backend ve widget | `supabase/functions/streak-warning/` |
| Temizlik hatırlatıcısı | Live Activity | Saatlik zamanlama | Backend ve widget | `supabase/functions/cleaning-activity/` |
| Bildirim gelen kutusu | Event Streams | Gönderilen veya tıklanan her push | Backend ve uygulama | `supabase/functions/inbox-webhook/` |
| E-posta tercihi senkronizasyonu | Event Streams | Abonelikten çıkılan, geri dönen veya spam olarak bildirilen e-posta | Backend | `supabase/functions/inbox-webhook/` |

## Gizli anahtarlar \\

Backend fonksiyonları bunları ortam değişkenlerinden okur. Hiçbiri uygulamayla birlikte dağıtılmaz.

```bash theme={null}
supabase secrets set ONESIGNAL_APP_ID=YOUR_ONESIGNAL_APP_ID
supabase secrets set ONESIGNAL_REST_API_KEY=YOUR_APP_API_KEY
supabase secrets set ONESIGNAL_WEEKLY_TEMPLATE_ID=YOUR_EMAIL_TEMPLATE_ID
supabase secrets set INBOX_WEBHOOK_SECRET=YOUR_SHARED_SECRET
supabase secrets set OTP_HASH_SECRET=A_LONG_RANDOM_STRING    # key for hashing SMS verification codes

# Optional
supabase secrets set ONESIGNAL_SMS_FROM=YOUR_SMS_SENDER      # if no default sender is set in the dashboard
```

> [!WARNING]
>
> App API key'iniz tüm kullanıcılara mesaj gönderebilir. Onu backend'inizde tutun. Uygulamanın kendisi yalnızca App ID'ye ihtiyaç duyar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.