メインコンテンツへスキップ
このページは、1つの実在アプリを最初から最後まで追うサンプルアプリ:OneSignalの完全な統合の一部です。アプリはClean Beansという共同生活の家のための掃除当番表アプリで、Expo(React Native)とSupabaseバックエンドで構築されています。 Clean Beansの通知のほとんどはバックエンドから送信されます。スケジュールや、ほかの人の行動に応じて送られるからです。いずれも同じエンドポイントCreate messageを呼び出し、External IDで送信先を指定します。
Clean Beansのプッシュ通知

Clean Beansが送信するプッシュの例。

タイムゾーンを考慮したスケジュール送信 \

ユーザーは毎日のリマインダーを受け取る時刻を選びます。Clean Beansはユーザーごとにジョブをスケジュールしません。1時間ごとに1つのジョブを実行し、「今がその時刻に当たるのは誰か」を判定します。
1

データベースのスケジュールが1時間ごとに関数を呼び出す

pg_cronがSupabase Edge FunctionにHTTPリクエストを送ります。必要なサービスキーはSupabase Vaultから読み取るため、SQLに現れることはありません。
2

関数がローカル時刻の一致するユーザーを見つける

そのリマインダーをオンにしている全員を読み込み、現在時刻を各ユーザーのタイムゾーンに変換し、選択した時刻が今であるユーザーを残します。
3

伝える内容があるか確認する

期限のタスクがないユーザーにはプッシュを送りません。
4

ユーザーごとにOneSignalを1回呼び出す

各プッシュの内容は異なるため、それぞれ個別のリクエストになります。
スケジュール:
supabase/migrations/006_cron_daily_digest.sql
タイムゾーンの照合:
supabase/functions/send-daily-digest/index.ts
送信:
supabase/functions/send-daily-digest/index.ts
...DELIVERY.daily_digest、idempotency_key、バッジのフィールドについては信頼性が高く適切に動作するプッシュで説明しています。data.typeフィールドにより、アプリはプッシュがタップされたときにどの画面を開くかを判断します。ディープリンクと通知のクリックを参照してください。 タイトルと本文はタスクから組み立てるため、プッシュの内容が具体的になります。
supabase/functions/send-daily-digest/index.ts

期限切れリマインダー:2回目の、異なる後押し \

期限切れリマインダーは同じパターンを2点だけ変えて再利用します。ユーザーのダイジェスト時刻の6時間後に送信され、期限を厳密に過ぎたタスクだけを数えます。
supabase/functions/send-overdue-reminders/index.ts
このジョブは毎時30分に実行されるため、毎時0分のダイジェストのジョブと重なることはありません。文面も変えています。1回目を繰り返すだけの2回目のリマインダーは見過ごされやすいからです。
supabase/functions/send-overdue-reminders/index.ts

掃除リマインダー:多数のユーザーに1回のリクエスト \

掃除リマインダーは全員に同じ内容を伝えるため、1人ずつリクエストする必要はありません。関数は対象となるすべてのユーザーIDを集め、バッチで送信します。
supabase/functions/send-cleaning-reminder/index.ts
内容が異なる場合は1人につき1回リクエストします。内容が同じ場合は多数のユーザーに1回のリクエストで送ります。リクエストが少ないほど失敗する箇所が減り、レート制限にも収まりやすくなります。

セッション完了:アプリからトリガーされるプッシュ \

誰かが掃除セッションを終えると、世帯のほかのメンバーに通知されます。アプリはAPIキーを持ってはいけないため、このプッシュを自分で送信できません。代わりにバックエンド関数を呼び出し、その関数がプッシュを送信します。
src/lib/database.ts
リクエストには何を掃除したかは含まれますが、誰が掃除したかは含まれません。関数はサインイントークンから呼び出し元を特定し、世帯のアクティブなメンバーであることを確認し、プロフィールから名前とアバターを取得します。呼び出し元を確認するを参照してください。 次に、世帯のほかのメンバーを探し、この種類のプッシュをオフにしている人を除外します。
supabase/functions/session-completed/index.ts
全員に1つのプッシュを送信します。送信者の豆のアバターは画像として添付し、プラットフォームごとに異なるフィールドを使います。
supabase/functions/session-completed/index.ts
豆のアバター画像を表示する展開されたプッシュ通知

送信者のアバターを表示するために展開したセッション完了のプッシュ。

Kudos:ある人から別の人へ \

Kudosも同じ仕組みで、受信者が1人だけです。アクティビティ画面でメンバーが同居人のセッションのSend Kudosをタップしてメッセージを選ぶと、アプリがsend-kudos関数を呼び出します。
定型メッセージが並ぶkudosのボトムシート

同居人の掃除セッションに送るkudosのメッセージを選ぶ。

supabase/functions/send-kudos/index.ts

参加承認:データベースからトリガーされるプッシュ \

世帯への参加をリクエストした人は、管理者の承認を待ちます。承認されると、そのメンバーシップ行がpendingからactiveに変わります。この変更に対するデータベーストリガーが関数を呼び出し、関数が参加できたことを本人に伝えます。 トリガーをデータベースに置くことで、どのような方法で承認されてもプッシュが送信され、アプリ側にはコードが必要ありません。
supabase/migrations/027_join_approved_trigger.sql
関数は受け取った内容をそのまま信用しません。メンバーシップを読み直し、承認が本物で最近のものである場合にのみ送信します。
supabase/functions/join-approved/index.ts
リクエストに応じてメッセージを送信する関数は、他人が呼び出そうとする可能性があります。この関数のように、送信前に自分のデータベースで事実を確認し、検証していない呼び出し元からメッセージの内容や受信者を受け付けないでください。

呼び出し元を確認する \

Supabaseはedge functionへのリクエストに有効なトークンが含まれていることを検証しますが、サインイン中のユーザーのトークンもスケジューラーのトークンと同じく有効です。追加の確認がなければ、どのユーザーでも全員分のデイリーダイジェストをトリガーしたり、他人の名前でプッシュを送信したりできてしまいます。そのため、各関数は誰に呼び出しを許可するかを自ら判断します。 スケジュールされた関数は、次の1行から始まります。
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
ロールの確認は、Supabaseがすでにトークンの署名を検証していることを前提としています。これらの関数は、デフォルトどおりJWT検証を有効にしてデプロイしてください。--no-verify-jwtでデプロイしてはいけません。
アプリから呼び出される関数は、トークンから送信者を特定し、その送信者が受信者に送信してよいかを確認します。Kudosは送信者と同じ世帯の人にしか送れず、プッシュに表示される名前は送信者のプロフィールから読み取ります。
supabase/functions/send-kudos/index.ts

Create message API

すべてのチャネルのターゲティング、コンテンツ、スケジュール。

リッチメディア

各プラットフォームでのプッシュ通知の画像。