Ana içeriğe atla
Bu sayfa, gerçek bir uygulamayı baştan sona takip eden Örnek uygulama: eksiksiz bir OneSignal entegrasyonu kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan Clean Beans’tir ve Expo (React Native) ile bir Supabase backend’i kullanılarak geliştirilmiştir. Clean Beans bildirimlerinin çoğu backend tarafından gönderilir, çünkü bir zamanlamaya veya başka birinin yaptığı bir şeye bağlıdır. Hepsi aynı uç noktayı, Create message uç noktasını çağırır ve kişileri External ID ile hedefler.
Clean Beans push bildirimleri

Clean Beans'in gönderdiği push'lardan bazılarına örnekler.

Saat dilimlerine uyan zamanlanmış gönderimler \

Kişiler günlük hatırlatıcılarını almak istedikleri saati seçer. Clean Beans her kullanıcı için ayrı bir iş zamanlamaz. Her saat bir iş çalıştırır ve “şu anda saat kimin için o saat?” diye sorar.
1

Bir veritabanı zamanlaması her saat bir fonksiyon çağırır

pg_cron, bir Supabase Edge Function’a HTTP isteği gönderir. İhtiyaç duyduğu hizmet anahtarı Supabase Vault’tan okunur, bu yüzden SQL’de asla görünmez.
2

Fonksiyon yerel saati eşleşen kullanıcıları bulur

Bu hatırlatıcıyı açmış herkesi yükler, geçerli saati her kullanıcının saat dilimine dönüştürür ve seçtiği saat şu an olanları tutar.
3

Söylenecek bir şey olup olmadığını kontrol eder

Yapılacak görevi olmayan kullanıcı push almaz.
4

Her kullanıcı için OneSignal'ı bir kez çağırır

Her push’un kendi içeriği vardır, bu yüzden her biri ayrı bir istektir.
Zamanlama:
supabase/migrations/006_cron_daily_digest.sql
Saat dilimi eşleştirmesi:
supabase/functions/send-daily-digest/index.ts
Gönderim:
supabase/functions/send-daily-digest/index.ts
...DELIVERY.daily_digest, idempotency_key ve rozet alanları Güvenilir ve doğru davranan push sayfasında açıklanmıştır. data.type alanı, push’a dokunulduğunda uygulamanın hangi ekranı açacağını bilmesini sağlar. Derin bağlantılar ve bildirim tıklamaları sayfasına bakın. Başlık ve gövde görevlerden oluşturulur, böylece push belirli bir şey söyler.
supabase/functions/send-daily-digest/index.ts

Gecikmiş görev hatırlatıcısı: ikinci ve farklı bir dürtme \

Gecikmiş görev hatırlatıcısı aynı kalıbı iki değişiklikle yeniden kullanır. Kullanıcının özet saatinden altı saat sonra tetiklenir ve yalnızca süresi kesin olarak geçmiş görevleri sayar.
supabase/functions/send-overdue-reminders/index.ts
İşi her saatin buçuğunda çalışır, bu yüzden saat başında çalışan özet işiyle asla çakışmaz. Metin de farklıdır. İlkini tekrarlayan ikinci bir hatırlatıcı kolayca göz ardı edilir.
supabase/functions/send-overdue-reminders/index.ts

Temizlik hatırlatıcısı: birçok kişi için tek istek \

Temizlik hatırlatıcısı herkese aynı şeyi söyler, bu yüzden kişi başına bir istek gerektirmez. Fonksiyon uygun tüm kullanıcı kimliklerini toplar ve bunları gruplar halinde gönderir.
supabase/functions/send-cleaning-reminder/index.ts
İçerik farklı olduğunda kişi başına bir istek gönderin. İçerik aynı olduğunda birçok kişi için tek bir istek gönderin. Daha az istek, başarısız olabilecek daha az şey ve hız sınırları içinde kalmanın daha kolay olması demektir.

Oturum tamamlandı: uygulamadan tetiklenen bir push \

Biri bir temizlik oturumunu bitirdiğinde hanenin geri kalanı bundan haberdar olur. Uygulama bu push’u kendisi gönderemez, çünkü bir API anahtarı barındırmamalıdır. Bir backend fonksiyonunu çağırır ve push’u o fonksiyon gönderir.
src/lib/database.ts
İstek neyin temizlendiğini söyler, ama kimin temizlediğini söylemez. Fonksiyon, çağıranın kim olduğunu oturum belirtecinden okur, hanenin etkin bir üyesi olduğunu kontrol eder ve adını ve avatarını profilinden alır. Kimin çağırdığını kontrol edin bölümüne bakın. Ardından hanenin diğer üyelerini bulur ve bu push türünü kapatmış olanları çıkarır.
supabase/functions/session-completed/index.ts
Hepsine tek bir push gönderir. Gönderenin fasulye avatarı, her platform için farklı bir alan kullanılarak görsel olarak eklenir.
supabase/functions/session-completed/index.ts
Fasulye avatarı görselini gösteren genişletilmiş bir push bildirimi

Gönderenin avatarını göstermek için genişletilmiş bir oturum tamamlandı push'u.

Kudos: bir kişiden diğerine \

Kudos da aynı şekilde çalışır, tek bir alıcıyla. Etkinlik ekranında bir üye, ev arkadaşının oturumunda Send Kudos düğmesine dokunur, bir mesaj seçer ve uygulama send-kudos fonksiyonunu çağırır.
Hazır mesajların bulunduğu kudos alt sayfası

Bir ev arkadaşının temizlik oturumu için kudos mesajı seçme.

supabase/functions/send-kudos/index.ts

Katılım onaylandı: veritabanı tarafından tetiklenen bir push \

Bir haneye katılmak isteyen kişi, bir yöneticinin onaylamasını bekler. Bu gerçekleştiğinde üyelik satırı pending durumundan active durumuna geçer. Bu değişiklik üzerindeki bir veritabanı tetikleyicisi bir fonksiyonu çağırır ve fonksiyon kişiye haneye katıldığını bildirir. Tetikleyiciyi veritabanına koymak, onay nasıl gerçekleşirse gerçekleşsin push’un gönderileceği ve uygulamanın bunun için hiçbir koda ihtiyaç duymayacağı anlamına gelir.
supabase/migrations/027_join_approved_trigger.sql
Fonksiyon kendisine söylenene güvenmez. Üyeliği yeniden okur ve yalnızca onay gerçek ve yakın zamanlıysa gönderir.
supabase/functions/join-approved/index.ts
İstek üzerine mesaj gönderen bir fonksiyon, başkalarının çağırmayı deneyebileceği bir şeydir. Bunun yaptığı gibi göndermeden önce bilgileri kendi veritabanınızda kontrol edin ve doğrulamadığınız bir çağırandan asla mesaj içeriği veya alıcı kabul etmeyin.

Kimin çağırdığını kontrol edin \

Supabase, bir edge function’a yapılan isteğin geçerli bir belirteç taşıdığını doğrular, ancak oturum açmış bir kullanıcının belirteci de zamanlayıcınınki kadar geçerlidir. Ek bir kontrol olmadan herhangi bir kullanıcı herkes için günlük özeti tetikleyebilir veya başka birinin adına push gönderebilir. Bu nedenle her fonksiyon kimin kendisini çağırabileceğine kendisi karar verir. Zamanlanmış fonksiyonlar tek bir satırla başlar:
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
Rol kontrolü, Supabase’in belirtecin imzasını zaten doğrulamış olmasına dayanır. Bu fonksiyonları varsayılan olan JWT doğrulaması açıkken dağıtın. Bunları asla --no-verify-jwt ile dağıtmayın.
Uygulamadan çağrılan fonksiyonlar göndereni belirteçten tanımlar, ardından gönderenin alıcıya ulaşma izni olup olmadığını kontrol eder. Kudos yalnızca gönderenle aynı haneyi paylaşan birine gönderilebilir ve push’ta gösterilen ad gönderenin profilinden okunur.
supabase/functions/send-kudos/index.ts

Create message API

Her kanal için hedefleme, içerik ve zamanlama.

Zengin medya

Her platformda push bildirimlerindeki görseller.