> ## 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: backend'inizden push gönderme

> Supabase Edge Functions'tan Create message API ile bir zamanlamaya göre, uygulamadan ve bir veritabanı tetikleyicisinden gönderilen altı push bildirimi.

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.

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](https://documentation.onesignal.com/reference/create-message.md) uç noktasını çağırır ve kişileri External ID ile hedefler.

| Push | Ne zaman gönderilir | Tetikleyici |
| - | - | - |
| Günlük özet | Kullanıcının seçtiği saatte, yapılacak görev varsa | Saatlik zamanlama |
| Gecikmiş görev hatırlatıcısı | Özetten altı saat sonra, görevler hâlâ gecikmişse | Saatlik zamanlama |
| Temizlik hatırlatıcısı | Kullanıcının temizlik zaman aralığından bir saat önce | Saatlik zamanlama |
| Oturum tamamlandı | Bir ev arkadaşı temizliği bitirdiğinde | Uygulamadan çağrı |
| Kudos | Bir ev arkadaşı kudos gönderdiğinde | Uygulamadan çağrı |
| Katılım onaylandı | Bir yönetici katılım isteğini onayladığında | Veritabanı tetikleyicisi |

![Clean Beans push bildirimleri](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-push-examples.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=f26bc81be159fba77a9873e119ccb19e)

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:

```sql supabase/migrations/006_cron_daily_digest.sql theme={null}
select cron.schedule(
  'send-daily-digest',          -- job name
  '0 * * * *',                  -- every hour at :00
  $$
  select
    net.http_post(
      url := 'https://YOUR_PROJECT_REF.supabase.co/functions/v1/send-daily-digest',
      headers := jsonb_build_object(
        'Content-Type', 'application/json',
        'Authorization', 'Bearer ' || (select decrypted_secret from vault.decrypted_secrets where name = 'service_role_key')
      ),
      body := '{}'::jsonb
    );
  $$
);
```

Saat dilimi eşleştirmesi:

```typescript supabase/functions/send-daily-digest/index.ts theme={null}
for (const profile of profiles) {
  try {
    // Get current hour in user's timezone
    const localHour = parseInt(
      now.toLocaleString('en-US', {
        timeZone: profile.timezone || 'UTC',
        hour: 'numeric',
        hour12: false,
      }),
      10
    );

    if (localHour === profile.notification_hour) {
      eligibleUsers.push({
        id: profile.id,
        householdId: profile.household_id,
        localDate: localDate(now, profile.timezone || 'UTC'),
      });
    }
  } catch {
    // Invalid timezone — skip this user
    console.warn(`Invalid timezone for user ${profile.id}: ${profile.timezone}`);
  }
}
```

Gönderim:

```typescript supabase/functions/send-daily-digest/index.ts theme={null}
const onesignalPayload = {
  app_id: ONESIGNAL_APP_ID,
  // One digest per user per local day: a retried or duplicated cron
  // run reuses this key and OneSignal will not send it twice.
  idempotency_key: await idempotencyKey('daily_digest', digest.userId, digest.localDate),
  include_aliases: {
    external_id: [digest.userId],
  },
  target_channel: 'push',
  ...DELIVERY.daily_digest,
  headings: { en: heading },
  contents: { en: body },
  url: 'cleaning-rota:///(tabs)/clean',
  // App icon badge = number of tasks due. The OneSignal SDK clears the
  // badge automatically the next time the app is opened.
  ios_badgeType: 'SetTo',
  ios_badgeCount: digest.tasks.length,
  // Action buttons, revealed by expanding the notification
  buttons: TASK_BUTTONS,
  data: { type: 'daily_digest', taskCount: String(digest.tasks.length) },
};

const res = await fetch('https://api.onesignal.com/notifications', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Key ${ONESIGNAL_REST_API_KEY}`,
  },
  body: JSON.stringify(onesignalPayload),
});
```

`...DELIVERY.daily_digest`, `idempotency_key` ve rozet alanları [Güvenilir ve doğru davranan push](https://documentation.onesignal.com/docs/tr/example-full-integration-reliable-push.md) 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ı](https://documentation.onesignal.com/docs/tr/example-full-integration-deep-links.md) sayfasına bakın.

Başlık ve gövde görevlerden oluşturulur, böylece push belirli bir şey söyler.

```typescript supabase/functions/send-daily-digest/index.ts theme={null}
function buildDigestContent(tasks: TaskRow[]): { heading: string; body: string } {
  const count = tasks.length;
  const heading = count === 1
    ? '1 cleaning task due today'
    : `${count} cleaning tasks due today`;

  // Collect unique room names
  const rooms = [...new Set(tasks.map(t => t.room_name))];

  let body: string;
  if (rooms.length === 1) {
    body = `Your ${rooms[0]} needs some attention!`;
  } else if (rooms.length === 2) {
    body = `Your ${rooms[0]} and ${rooms[1]} need some attention!`;
  } else {
    const last = rooms.pop()!;
    body = `Your ${rooms.join(', ')}, and ${last} need some attention!`;
  }

  return { heading, body };
}
```

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

```typescript supabase/functions/send-overdue-reminders/index.ts theme={null}
// Overdue hour wraps around midnight
const overdueHour = (profile.notification_hour + OVERDUE_OFFSET_HOURS) % 24;

if (localHour === overdueHour) {
  eligibleUsers.push({
    id: profile.id,
    householdId: profile.household_id,
    localDate: localDate(now, profile.timezone || 'UTC'),
  });
}
```

İş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.

```typescript supabase/functions/send-overdue-reminders/index.ts theme={null}
function buildOverdueContent(tasks: TaskRow[]): { heading: string; body: string } {
  const count = tasks.length;
  const heading = count === 1
    ? '1 overdue task still waiting'
    : `${count} overdue tasks still waiting`;

  const rooms = [...new Set(tasks.map((t) => t.room_name))];

  let body: string;
  if (rooms.length === 1) {
    body = `Your ${rooms[0]} still needs some love today!`;
  } else if (rooms.length === 2) {
    body = `Your ${rooms[0]} and ${rooms[1]} still need some love today!`;
  } else {
    const last = rooms.pop()!;
    body = `Your ${rooms.join(', ')}, and ${last} still need some love today!`;
  }

  return { heading, body };
}
```

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

```typescript supabase/functions/send-cleaning-reminder/index.ts theme={null}
const batchSize = 2000;
for (let i = 0; i < eligibleUserIds.length; i += batchSize) {
  const batch = eligibleUserIds.slice(i, i + batchSize);

  // One reminder per batch of recipients per hourly cron slot: a retried
  // or duplicated run in the same hour reuses this key and OneSignal
  // will not send it twice.
  const batchKey = await idempotencyKey(
    'upcoming_cleaning',
    utcHourSlot(now),
    [...batch].sort().join(','),
  );

  const onesignalPayload = {
    app_id: ONESIGNAL_APP_ID,
    idempotency_key: batchKey,
    include_aliases: {
      external_id: batch,
    },
    target_channel: 'push',
    ...DELIVERY.upcoming_cleaning,
    headings: { en: 'Cleaning time in 1 hour' },
    contents: {
      en: 'Your cleaning window starts soon. Ready to get things sparkling?',
    },
    url: 'cleaning-rota:///(tabs)/clean',
    data: { type: 'upcoming_cleaning' },
  };
```

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

```typescript src/lib/database.ts theme={null}
const { error } = await supabase.functions.invoke('session-completed', {
  body: {
    householdId,
    roomName: params.roomName,
    tasksCompleted: params.tasksCompleted,
    estimatedMins: params.estimatedMins,
  },
});
```

İ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](#check-who-is-calling) bölümüne bakın.

Ardından hanenin diğer üyelerini bulur ve bu push türünü kapatmış olanları çıkarır.

```typescript supabase/functions/session-completed/index.ts theme={null}
// ── 1. Look up other active household members ──

const { data: members, error: memberErr } = await supabase
  .from('household_members')
  .select('user_id')
  .eq('household_id', householdId)
  .eq('status', 'active')
  .neq('user_id', userId);

    // ...

const { data: profiles, error: profileErr } = await supabase
  .from('profiles')
  .select('id, notifications_enabled, push_cleaning_done')
  .in('id', recipientIds)
  .eq('notifications_enabled', true)
  .eq('push_cleaning_done', true);
```

Hepsine tek bir push gönderir. Gönderenin fasulye avatarı, her platform için farklı bir alan kullanılarak görsel olarak eklenir.

```typescript supabase/functions/session-completed/index.ts theme={null}
const onesignalPayload: Record<string, unknown> = {
  app_id: ONESIGNAL_APP_ID,
  include_aliases: {
    external_id: enabledIds,
  },
  target_channel: 'push',
  ...DELIVERY.session_completed,
  headings: { en: heading },
  contents: { en: body },
  url: 'cleaning-rota:///activity',
  data: {
    type: 'session_completed',
    roomName,
    userName,
    tasksCompleted: String(tasksCompleted),
    // Who cleaned: lets the "Send kudos" button reply to the right person
    ...(isRealUser ? { cleanerId: userId } : {}),
  },
  // "Send kudos" needs a real person to send to
  ...(isRealUser ? { buttons: SESSION_BUTTONS } : {}),
};

// Attach avatar image for rich push notifications
if (avatarImageUrl) {
  onesignalPayload.big_picture = avatarImageUrl;          // Android
  onesignalPayload.ios_attachments = { avatar: avatarImageUrl }; // iOS
}
```

![Fasulye avatarı görselini gösteren genişletilmiş bir push bildirimi](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-rich-push.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=07c38920b20cb73093805ca9961841e3)

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ı](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-kudos.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=83ec608d61e91c74f16bcb65d8757927)

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

```typescript supabase/functions/send-kudos/index.ts theme={null}
const heading = `Kudos from ${senderName}!`;
const body = message;

    // ...

const onesignalPayload: Record<string, unknown> = {
  app_id: ONESIGNAL_APP_ID,
  include_aliases: {
    external_id: [recipientUserId],
  },
  target_channel: 'push',
  ...DELIVERY.kudos,
  headings: { en: heading },
  contents: { en: body },
  url: 'cleaning-rota:///activity',
  data: {
    type: 'kudos',
    senderName,
    roomName: roomName || '',
  },
};
```

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

```sql supabase/migrations/027_join_approved_trigger.sql theme={null}
create trigger trg_notify_join_approved
  after update of status on public.household_members
  for each row
  when (old.status = 'pending' and new.status = 'active')
  execute function public.notify_join_approved();
```

Fonksiyon kendisine söylenene güvenmez. Üyeliği yeniden okur ve yalnızca onay gerçek ve yakın zamanlıysa gönderir.

```typescript supabase/functions/join-approved/index.ts theme={null}
// ── 1. Confirm the membership really was approved, and recently ──

const { data: membership, error: memberErr } = await supabase
  .from('household_members')
  .select('status, joined_at, households(name)')
  .eq('user_id', userId)
  .eq('household_id', householdId)
  .maybeSingle();

if (memberErr) throw memberErr;

if (!membership || membership.status !== 'active' || !membership.joined_at) {
  return jsonResponse({ sent: 0, message: 'No active membership found' });
}

const joinedAt = new Date(membership.joined_at).getTime();
if (Date.now() - joinedAt > RECENT_APPROVAL_MS) {
  return jsonResponse({ sent: 0, message: 'Membership was not approved recently' });
}
```

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

| Fonksiyonlar | Kim çağırabilir | Kontrol |
| - | - | - |
| Zamanlanmış gönderimler ve veritabanı tetikleyicisi | Yalnızca zamanlayıcı | Belirteç service role anahtarı olmalıdır |
| Oturum tamamlandı, kudos | Oturum açmış bir kullanıcı, kendi adına | Gönderen her zaman belirteçten alınır, asla istek gövdesinden alınmaz |

Zamanlanmış fonksiyonlar tek bir satırla başlar:

```typescript supabase/functions/send-daily-digest/index.ts theme={null}
// Only the scheduler (service role) may run this
const denied = requireServiceRole(req);
if (denied) return denied;
```

```typescript supabase/functions/_shared/auth.ts theme={null}
export function isServiceRoleRequest(req: Request): boolean {
  const token = bearerToken(req);
  if (!token) return false;
  if (token === Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')) return true;

  try {
    const part = token.split('.')[1] ?? '';
    const base64 = part.replace(/-/g, '+').replace(/_/g, '/');
    const padded = base64 + '='.repeat((4 - (base64.length % 4)) % 4);
    const claims = JSON.parse(atob(padded));
    return claims?.role === 'service_role';
  } catch {
    return false;
  }
}
```

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

```typescript supabase/functions/send-kudos/index.ts theme={null}
const caller = await authenticateUser(req, supabase);
if (caller instanceof Response) return caller;

// ...

// Sender and recipient must be active members of the same household
const { data: memberships, error: memberErr } = await supabase
  .from('household_members')
  .select('user_id, household_id')
  .in('user_id', [caller.id, recipientUserId])
  .eq('status', 'active');

if (memberErr) throw memberErr;

const callerHouseholds = new Set(
  (memberships ?? []).filter((m) => m.user_id === caller.id).map((m) => m.household_id),
);
const sharesHousehold = (memberships ?? []).some(
  (m) => m.user_id === recipientUserId && callerHouseholds.has(m.household_id),
);

if (!sharesHousehold) {
  return jsonResponse({ error: 'forbidden', message: 'You can only send kudos to members of your household.' }, 403);
}
```

> [card] [Create message API](https://documentation.onesignal.com/reference/create-message.md)
>
> Her kanal için hedefleme, içerik ve zamanlama.

> [card] [Zengin medya](https://documentation.onesignal.com/docs/tr/rich-media.md)
>
> Her platformda push bildirimlerindeki görseller.


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