> ## 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: Event Streams ile bildirim gelen kutusu

> Clean Beans örnek uygulamasının Event Streams'ten uygulama içi bir bildirim gelen kutusu nasıl oluşturduğu ve e-posta tercihlerini abonelikten çıkmalarla nasıl uyumlu tuttuğu.

Bu sayfa, gerçek bir uygulamayı baştan sona takip eden [Örnek uygulama: eksiksiz bir OneSignal entegrasyonu](https://documentation.onesignal.com/docs/tr/example-full-integration-overview.md) 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](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-inbox.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=b5e476387dfc0b32a56d71201879c0d0)

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.

```json Event Stream body theme={null}
{
  "event_kind": "{{ event.kind }}",
  "event_id": "{{ event.id }}",
  "timestamp": {{ event.timestamp }},
  "external_id": "{{ event.external_id }}",
  "message_id": "{{ message.id }}",
  "title": "{{ message.title.en }}",
  "contents": "{{ message.contents.en }}",
  "data": { "type": "{{ message.data.type }}" }
}
```

> [!WARNING]
>
> 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.

> [!NOTE]
>
> 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.

```typescript supabase/functions/inbox-webhook/index.ts theme={null}
const secret = req.headers.get('X-Webhook-Secret') ?? '';
if (!INBOX_WEBHOOK_SECRET || secret !== INBOX_WEBHOOK_SECRET) {
  return new Response('Unauthorized', { status: 401 });
}
```

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.

```typescript supabase/functions/inbox-webhook/index.ts theme={null}
if (event_kind === 'message.push.sent') {
  // ── Create inbox entry ──
  const notifType = (data?.type as string) || 'general';

  // inboxTitle and inboxBody are the title and contents with any Liquid
  // rendered. See "Render Liquid before you store it" below.

  const { error } = await supabase.from('inbox_messages').upsert(
    {
      user_id: profile.id,
      onesignal_event_id: event_id,
      onesignal_message_id: message_id,
      title: inboxTitle || 'Notification',
      body: inboxBody,
      type: notifType,
      data: data || {},
      read: false,
      created_at: payload.timestamp
        ? new Date(payload.timestamp * 1000).toISOString()
        : new Date().toISOString(),
    },
    { onConflict: 'onesignal_event_id' } // dedup
  );
```

Bir tıklama olayı eşleşen satırı okundu olarak işaretler.

```typescript supabase/functions/inbox-webhook/index.ts theme={null}
const { error, count } = await supabase
  .from('inbox_messages')
  .update({ read: true })
  .eq('onesignal_message_id', message_id)
  .eq('user_id', profile.id);
```

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:

```text Journey push title theme={null}
{{ journey.first_event.properties.room_name }} cleaned ✅
```

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.

```typescript supabase/functions/inbox-webhook/index.ts theme={null}
if (hasLiquid(inboxTitle) || hasLiquid(inboxBody)) {
  const context = await buildLiquidContext(supabase, payload);
  const renderedTitle = renderLiquid(inboxTitle, context);
  const renderedBody = renderLiquid(inboxBody, context);
  const unresolved = [...renderedTitle.unresolved, ...renderedBody.unresolved];

  if (unresolved.length > 0) {
    // Better no entry than one showing raw template tags
    console.warn(`Inbox: skipped ${message_id} for ${external_id}, unresolved Liquid: ${JSON.stringify(unresolved)}`);
    return jsonResponse({ skipped: true, reason: 'unresolved_liquid', unresolved });
  }

  inboxTitle = renderedTitle.text;
  inboxBody = renderedBody.text;
}
```

> [!WARNING]
>
> 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.

```typescript app/inbox.tsx theme={null}
const { data, error } = await supabase
  .from('inbox_messages')
  .select('id, title, body, type, data, read, created_at')
  .order('created_at', { ascending: false })
  .limit(50);
```

```typescript src/components/InboxButton.tsx theme={null}
const fetchCount = async () => {
  const { count, error } = await supabase
    .from('inbox_messages')
    .select('id', { count: 'exact', head: true })
    .eq('read', false);

  if (!cancelled && !error && count !== null) {
    setUnreadCount(count);
  }
};
```

## 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.

```typescript supabase/functions/inbox-webhook/index.ts theme={null}
const EMAIL_STOP_EVENTS: Record<string, string> = {
  'message.email.unsubscribed': 'unsubscribed',
  'message.email.reported_as_spam': 'reported_as_spam',
  'message.email.bounced': 'bounced',
  'message.email.suppressed': 'suppressed',
};

// ...

const { error: prefErr } = await supabase
  .from('profiles')
  .update({ email_weekly_summary: false })
  .eq('id', profile.id);
```

Stream'in gövdesinde değişiklik gerekmez, çünkü gelen kutusunun zaten kullandığı alanlar (`event_kind`, `event_id`, `external_id`) yeterlidir.

> [!NOTE]
>
> 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.

> [!TIP]
>
> 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ı.

> [card] [Event Streams](https://documentation.onesignal.com/docs/tr/event-streams.md)
>
> Bir stream kurun ve olayları seçin.

> [card] [Event Stream verileri](https://documentation.onesignal.com/docs/tr/event-streams-data.md)
>
> Gövde şablonunda kullanılabilen her alan.


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