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. Kaydırılarak kapatılan bir push kaybolur. Clean Beans uygulama içinde yedi günlük bir geçmiş tutar ve her ekranın başlığında okunmamış sayısını gösterir.
Clean Beans bildirim gelen kutusu

Gelen kutusu son bildirimleri listeler.

Uygulama bildirimleri kendisi kaydetmez. Bu, uygulama kapalıyken teslim edilen her şeyi kaçırırdı. OneSignal her push’u backend’e bir Event Stream aracılığıyla bildirir ve geçmişi backend tutar.
1

OneSignal her push için bir olay gönderir

Bir Event Stream, bir push gönderildiğinde ve tekrar tıklandığında bir backend fonksiyonuna POST isteği gönderir.
2

Fonksiyon bir satır saklar veya günceller

Gönderim olayı bir gelen kutusu girişi oluşturur. Tıklama olayı onu okundu olarak işaretler.
3

Uygulama tabloyu okur

Gelen kutusu ekranı ve başlıktaki rozet, kullanıcının kendi satırlarını sorgular.

Event Stream’i yapılandırın \

Kontrol paneli kurulumu. Data > Event Streams bölümünde şu ayarlarla bir stream oluşturun:
  • URL: fonksiyonunuzun adresi.
  • Başlık: paylaşılan bir gizli anahtar, örneğin X-Webhook-Secret.
  • Olaylar: message.push.sent ve message.push.clicked.
  • Gövde: isteği biçimlendiren bir Liquid şablonu.
Event Stream body
Yukarıdaki gibi her data anahtarına adıyla başvurun. Tek başına {{ message.data }}, nesnenin tamamını Python tarzı bir dict ({'type': 'kudos'}) olarak işler. Bu geçerli bir JSON değildir ve aşağıdaki fonksiyon gövdeyi ayrıştırırken isteği reddeder. Başlık ve içerik de aynı nedenle .en ile okunur. Gelen kutusunun yalnızca type değerine ihtiyacı vardır. Kendi webhook’unuzun kullandığı diğer her anahtar için bir satır ekleyin.Çift tırnak içeren bir değer de JSON’u bozar. Kudos push’ları kullanıcının yazdığı metni taşır, bu yüzden içinde " olan bir kudos mesajı fonksiyonun ayrıştıramayacağı bir gövde üretir ve o push gelen kutusuna asla ulaşmaz.
Bu stream, her cihaza teslim edilen her push için bir olay gönderir ve her olay planınızın mesaj olayı hacmine sayılır. Yalnızca kullandığınız olayları seçin.

Olayları alın \

Fonksiyon başka bir şey yapmadan önce gizli anahtarı kontrol eder.
supabase/functions/inbox-webhook/index.ts
Bir gönderim olayı gelen kutusunda bir satıra dönüşür. OneSignal’ın olay kimliği benzersiz anahtardır, bu yüzden iki kez teslim edilen bir olay iki satır oluşturmaz.
supabase/functions/inbox-webhook/index.ts
Bir tıklama olayı eşleşen satırı okundu olarak işaretler.
supabase/functions/inbox-webhook/index.ts
Dokunulan bir push’u yönlendiren data.type alanı her satırla birlikte saklanır, böylece gelen kutusu doğru simgeyi gösterebilir ve doğru ekranı açabilir.

Liquid’i saklamadan önce işleyin \

Stream, bir mesajı OneSignal onu her alıcı için kişiselleştirmeden önceki yazıldığı haliyle bildirir. Backend tarafından gönderilen bir push zaten son metnine sahiptir. Bir Journey push’u değildir. Clean Beans’in Journey mesajlarından birinin başlığı şudur:
Journey push
Telefon “Kitchen cleaned ✅” gösterir. Webhook yukarıdaki satırı alır ve gelen kutusunun ilk sürümü onu tam olarak bu şekilde gösteriyordu. Fonksiyon artık başlığı ve gövdeyi kaydetmeden önce, değer aramalarını ve default filtresini işleyen küçük bir işleyiciyle kendisi işler. Değerleri iki yerden alır:
  • Etiketler veritabanından okunur. Uygulama her etiketi sakladığı bir değerden ayarlar, bu yüzden fonksiyon aynı değerleri okur. Stream gövdesinde {{ user.tags.user_name }} iletmek de işe yarardı, ancak çift tırnak içeren bir ad bu gövdeyi geçersiz bir JSON yapardı.
  • Journey olay özellikleri stream’de kullanılamaz. Fonksiyon bunları özel olayı tetikleyen temizlik oturumundan yeniden oluşturur.
supabase/functions/inbox-webhook/index.ts
Event Streams’ten bir gelen kutusu veya günlük oluşturuyorsanız, Journey ve şablon mesajlarınızın geldiğinde nasıl göründüğünü kontrol edin. İçlerindeki Liquid hâlâ Liquid’dir. Ya burada olduğu gibi kendiniz işleyin ya da bu mesajları dışarıda bırakın.

Gelen kutusunu gösterin \

Satır düzeyi güvenlik, her kullanıcının yalnızca kendi satırlarını okuyabilmesini sağlar, bu yüzden uygulamanın sorgularının kullanıcıya göre filtrelemesi gerekmez.
app/inbox.tsx
src/components/InboxButton.tsx

E-posta tercihlerini uyumlu tutun \

Aynı stream ikinci bir sorunu da çözer. Biri bir e-postadaki Unsubscribe bağlantısına dokunduğunda OneSignal ona e-posta göndermeyi durdurur, ancak uygulamanın kendi “Weekly Email Summary” anahtarı hâlâ açık kalır. Ayarlar ekranı yanlış olur ve backend göndermeyi denemeye devam eder. Stream’e dört e-posta olayı eklemek bunu düzeltir. Fonksiyon hepsini aynı şekilde ele alır: OneSignal bu kişiye bir daha e-posta göndermeyecektir, bu yüzden uygulamanın tercihi de buna uygun olarak kapatılır.
supabase/functions/inbox-webhook/index.ts
Stream’in gövdesinde değişiklik gerekmez, çünkü gelen kutusunun zaten kullandığı alanlar (event_kind, event_id, external_id) yeterlidir.
Bu, uygulamayı OneSignal ile uyumlu tutar, tersini değil. Biri e-postayı uygulamada yeniden açarsa OneSignal aboneliği hâlâ iptal edilmiş durumdadır. Kişiyi yeniden abone yapmak için backend’inizin OneSignal’ın abonelik API’sini çağırması gerekir.
Aynı Event Stream kalıbı, kendi sistemlerinizi OneSignal’ın bildiği her şeyle uyumlu tutabilir: e-posta açılmaları, uygulama içi mesaj tıklamaları, SMS teslimatları ve daha fazlası.

Event Streams

Bir stream kurun ve olayları seçin.

Event Stream verileri

Gövde şablonunda kullanılabilen her alan.