ブログに戻る

Supabase のプッシュ通知:新規登録や注文のたびにスマホへ通知

Supabase のプッシュ通知:新規登録や注文のたびにスマホへ通知

アプリは Supabase 上で動いていて、気にしたいのは行の変化です。auth.users に新しいユーザーが入る、orders に新しい注文が入る、サブスクリプションが canceled に変わる、といったできごとです。こうしたできごとに気づくのは、Table Editor を開いたときです。運がよければ夜に気づき、忙しい日には来週になってしまいます。

Supabase なら、もっと早く知らせられます。どのテーブルも、行が挿入・更新・削除されたときに URL を呼び出せます。その呼び出し先を Pocket Alert に向ければ、できごとのたびにスマホへプッシュ通知が届き、メールアドレスや注文金額も通知文に含められます。

このガイドは、あなた自身、つまり創業者や管理者への通知が対象です。アプリのユーザーにプッシュ通知を送りたい場合は、FCM、APNs、Expo を使う別の仕組みになるので、別の記事をご覧ください。

必要なもの

  • ダッシュボードを開ける Supabase プロジェクト
  • Pocket Alert のアカウントと、iPhone または Android のアプリ。始めるだけなら無料プランで十分です。

Lovable でアプリを作り、自分の Supabase プロジェクトに接続している場合も、以下の内容はそのまま使えます。Lovable Cloud(組み込みのバックエンド)では Supabase ダッシュボードがないため、レベル 1 は使えません。ただし SQL エディター(Database → Manage → SQL editor)では pg_net と Vault を利用できるので、レベル 2 のトリガーを試してみてください。

レベル 1:コード不要の Database Webhook

Supabase の Database Webhook は、テーブルの行が変わったあとに HTTP リクエストを送ります。Pocket Alert の Webhook は JSON を受け取り、プッシュ通知に変換します。両者をつなぐのに数分で済み、コードも不要です。

Pocket Alert 側で Webhook を作成する

Pocket Alert のコンソールで Webhooks を開き、Webhook を作成します。

  • Name: Supabase。プッシュ通知のタイトルは常に Webhook <name> になるので、この場合は「Webhook Supabase」と表示されます。複数作る予定があるなら、Supabase signups のように具体的な名前にしてください。
  • Message: テンプレートです。後ほど説明します。

コンソールに表示された URL をコピーします。URL は https://p4a.me/wh/abc123xyz のような形式です。末尾のスラッグだけが秘密情報なので、URL全体をパスワードと同じように扱ってください。

Supabase 側で Webhook を作成する

Supabase ダッシュボードでプロジェクトを開き、Integrations → Database Webhooks に進みます(古いガイドでは Database → Webhooks と書かれています)。インテグレーションが有効になっていない場合は、先に有効にしてください。Webhook が使うトリガー関数がここで作成されます。そのうえで新しい Webhook を作成します。

  1. 名前を付けます。例:notify_new_order
  2. テーブルを選びます。例:orders
  3. イベントにチェックを入れます。「新規行」の通知だけなら Insert のみにチェックします。
  4. タイプに HTTP Request を選び、メソッドは POST、Pocket Alert の URL を貼り付けます。
  5. Content-Type: application/json のヘッダーはそのまま残します。Pocket Alert は JSON のボディしか受け付けません。

保存すると、orders に行が挿入されるたびに、書き込み後にリクエストが送られるようになります。Supabase はこのリクエストを非同期の pg_net 拡張で送るので、ネットワークが遅くても挿入処理そのものは止まりません。

Supabase が送るデータ

ボディの形式は、どのテーブルでも同じです。

{
  "type": "INSERT",
  "table": "orders",
  "schema": "public",
  "record": { "id": 1042, "email": "[email protected]", "total": 49, "status": "pending" },
  "old_record": null
}

record は、すべての列を含む新しい行です。UPDATE の場合、old_record には変更前の行が入ります。DELETE の場合は record が null になり、old_record だけが入ります。

メッセージのテンプレート

Pocket Alert の Webhook に戻り、%path% のプレースホルダーで上記の JSON の項目を指定してメッセージを書きます。

New %table% row: #%record.id% · %record.email% · $%record.total%

次に注文が入ると、次のように届きます。

Webhook Supabase
New orders row: #1042 · [email protected] · $49

テーブルにある列なら何でも使えます。例:%record.plan%、%record.country%、%record.status%。テンプレートの代わりに * を指定すると JSON 全体が送られます。列名を調べている間は便利です。

同じフォームにはデフォルトの優先度もあります。注文用の Webhook に high を設定すると、iPhone の集中モードでも届きます。履歴だけ残したい忙しいテーブルには low を設定します。Supabase のペイロードには level の項目がないため、優先度は Webhook のデフォルト設定で決まります。

auth.users からの新規登録

Supabase はユーザーを auth.users に保存しています。Database Webhooks のテーブル選択でこのテーブルを選べます。Loops などのインテグレーションも、まさにこの設定を文書化しています。auth スキーマのユーザーテーブルを選び、Insert にチェックを入れて、次のように設定します。

New signup: %record.email%

テーブルの選択肢に auth 関連のテーブルが表示されない場合や、ロジックを SQL で管理したい場合は、次のセクションのトリガーを auth.users にも使えます。

レベル 1 の限界

Database Webhook には条件がありません。orders で Update にチェックを入れると、どの列が変わっても通知が届きます。ステータス、配送先住所、バックグラウンドジョブで更新される updated_at など、何でも対象になります。テンプレートでリクエストを減らすことはできず、整形するだけです。忙しいテーブルでは、良くても通知がうるさく、悪くすると無料プランの 1 日 50 件の上限を昼前に使い切ってしまいます。

「注文が支払い済みになったら教えて」や「サブスクリプションが解約されたら教えて」といった用途には、フィルターが必要です。Postgres にはそのための仕組みがすでにあります。

レベル 2:pg_net と WHEN 条件を使うトリガー

Database Webhook は、裏で pg_net を呼び出すトリガーです。トリガーを自分で書くと、2 つのメリットがあります。1 つ目は WHEN 句です。これにより、必要な変更のときだけ Postgres が関数を実行します。2 つ目はリクエストの細かな制御です。タイトル、優先度、ボタンを自由に指定して、Pocket Alert API を直接呼び出せます。

API キーを Vault に保存する

API キーを取得し、SQL エディターから Supabase Vault に保存します。キーがファイルに残らないように、マイグレーションとは別に一度だけ実行してください。

select vault.create_secret('YOUR_POCKETALERT_API_KEY', 'pocketalert_key');

Database → Extensions で pg_net が有効になっているか確認してください。Database Webhooks を使っているプロジェクトなら、すでに有効になっています。

関数とトリガー

次のコードは、注文のステータスが paid に変わったときだけプッシュ通知を送ります。

create or replace function public.notify_order_paid()
returns trigger
language plpgsql
security definer
set search_path = ''
as $$
begin
  perform net.http_post(
    url := 'https://api.pocketalert.app/v1/messages',
    headers := jsonb_build_object(
      'Content-Type', 'application/json',
      'Token', (select decrypted_secret from vault.decrypted_secrets where name = 'pocketalert_key')
    ),
    body := jsonb_build_object(
      'title', 'Order paid: $' || new.total,
      'message', '#' || new.id || ' · ' || coalesce(new.email, 'no email'),
      'level', 'high',
      'actions', jsonb_build_array(jsonb_build_object(
        'type', 'view',
        'label', 'Open orders',
        'value', 'https://supabase.com/dashboard/project/YOUR_PROJECT_REF/editor'
      ))
    )
  );
  return new;
end;
$$;

create trigger on_order_paid
after update of status on public.orders
for each row
when (old.status is distinct from new.status and new.status = 'paid')
execute function public.notify_order_paid();

各部分の役割は次のとおりです。

  • when (...) は、レベル 1 にはなかったフィルターです。ステータスが実際に変わり、新しい値が paid のときだけ Postgres が関数を呼び出します。他の列の更新では何も起きません。
  • security definer によって、関数は Vault を読み取れるようになります。authenticated など、アプリから行を書き込むロールには Vault を読む権限がありません。この指定がないと、更新が権限エラーで失敗します。これは Supabase のドキュメントで紹介されているパターンです。
  • net.http_post はリクエストをキューに入れ、すぐに戻ります。実際の送信はトランザクションのコミット後です。更新がロールバックされた場合、プッシュ通知は送られません。
  • level は通知の強さを決めます。default は通常のできごと、high は集中モードを突破する通知、critical は必ず気づきたい通知に使います。critical は有料機能で、無料プランでは high として配信されます。

他のできごとにも、この関数をコピーして条件を変えて使えます。例:subscriptions での new.status = 'canceled'、大口注文用の挿入トリガーでの new.total > 500、profiles での new.role = 'admin'。

auth.users のトリガーで新規登録を通知する

同じパターンを auth.users に使います。通知文にはログイン元のプロバイダーを含めています。

create or replace function public.notify_new_signup()
returns trigger
language plpgsql
security definer
set search_path = ''
as $$
begin
  perform net.http_post(
    url := 'https://api.pocketalert.app/v1/messages',
    headers := jsonb_build_object(
      'Content-Type', 'application/json',
      'Token', (select decrypted_secret from vault.decrypted_secrets where name = 'pocketalert_key')
    ),
    body := jsonb_build_object(
      'title', 'New signup',
      'message', coalesce(new.email, 'no email') || ' via ' || coalesce(new.raw_app_meta_data ->> 'provider', 'unknown')
    )
  );
  return new;
end;
$$;

create trigger on_auth_user_created_notify
after insert on auth.users
for each row execute function public.notify_new_signup();

Supabase は、auth.users のトリガーが失敗すると新規登録が止まる可能性があると警告しています。coalesce を使うと、値がないときに文字列が壊れません。リクエスト自体は非同期なので、プッシュ通知が遅れたり失敗したりしても新規登録の邪魔にはなりません。とはいえ、本番で使う前に使い捨てのアカウントで一度テストしてください。

または Edge Function

PL/pgSQL より TypeScript が好みなら、レベル 1 の Database Webhook をそのまま使い、タイプを Supabase Edge Functions に変更して、フォームで提示されるシークレットキーのヘッダーを追加します。関数は同じ {type, table, record, old_record} のペイロードを受け取り、自分で判断します。シークレットキーを使う呼び出しの Supabase のパターンは、withSupabase ラッパーに auth: 'secret' を指定する方法です。さらに、supabase/config.toml で関数の verify_jwt = false を設定します。

import { withSupabase } from "npm:@supabase/server@1";

export default {
  fetch: withSupabase({ auth: "secret" }, async (req) => {
    const { type, record, old_record } = await req.json();
    if (type !== "UPDATE" || record.status === old_record.status) {
      return new Response("skipped");
    }

    await fetch("https://api.pocketalert.app/v1/messages", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Token: Deno.env.get("POCKETALERT_API_KEY")!,
      },
      body: JSON.stringify({
        title: `Order #${record.id}: ${record.status}`,
        message: `${record.email} · $${record.total}`,
        level: record.status === "refunded" ? "high" : "default",
      }),
    });
    return new Response("ok");
  }),
};

キーは supabase secrets set POCKETALERT_API_KEY=... で設定します。このパターンには注意点があります。Webhook は引き続きすべての更新で発火し、関数があとからフィルタリングするため、変更のたびに関数の呼び出し料金が発生します。WHEN 付きのトリガーは、実行前にフィルタリングします。

正直な制約

  • 署名の検証がありません。 Pocket Alert は Webhook リクエストの送信元を確認しません。URL のスラッグが唯一の秘密情報です。これが問題になる場合は、API キーで認証するレベル 2 のトリガーを使ってください。
  • キーが一時的にキューテーブルに残ります。 Supabase によると、pg_net はリクエストが送信されるまで、復号済みのヘッダーを net.http_request_queue に保持します。データベースにログインできるロールなら、そこから読み取れます。
  • pg_net はベストエフォートです。 リクエストはアンロギングテーブルに保存されるため、タイミングが悪いとクラッシュ時に失われることがあります。「知らせてほしい」という用途には十分ですが、請求に関わる用途には向きません。
  • 件数です。 1 時間に数千件の書き込みがあるテーブルにトリガーを付けると、条件を厳しくしない限り、数千件のプッシュ通知が送られます。無料プランは 1 日 50 件までです。

届かないときは

  • Pocket Alert の Webhook 履歴を確認する。 Webhook URL へのリクエストはすべて、ヘッダー、ボディ、生成されたメッセージ、ステータスと一緒にコンソールに記録されます。リクエストが記録されていれば、Supabase は正しく動いていて、問題はテンプレートにあります。記録がなければ、Supabase 側を確認してください。
  • pg_net の受信結果を確認する。 レスポンスは 6 時間保持されます。
select status_code, content, error_msg, created
from net._http_response
order by created desc
limit 10;

401 は Vault の API キーが間違っていることを示します。400 は通常、ボディが有効な JSON ではないか、項目が欠けていることを示します。

  • トリガーの条件を確認する。 条件に一致するはずの更新を手動で実行してみてください。例:update orders set status = 'paid' where id = 1042;。そのあと、net._http_response をもう一度確認します。
  • イベントを確認する。 Insert だけを監視している Webhook は、更新では発火しません。また DELETE の場合、行は old_record に入るため、%record.*% のプレースホルダーは空になります。

FAQ

アプリのユーザーにプッシュ通知を送るのと同じですか?

いいえ。これは Pocket Alert アプリを通じて、自分のスマホにプッシュ通知を送る仕組みです。ユーザーのデバイスへのプッシュ通知は、FCM、APNs、Expo などのサービスを経由し、アプリ側で実装する必要があります。

特定の列だけで Supabase のデータベース Webhook を発火させられますか?

ダッシュボードの Webhook では無理です。行のどの変更でも発火します。レベル 2 で紹介したように、after update of status と WHEN 条件を付けたトリガーを使うと、その列が指定した条件で変わったときだけ発火します。

Supabase の無料プランでも使えますか?

はい。Database Webhooks、トリガー、pg_net、Vault は、通常の Supabase プロジェクトに含まれています。有料プランは必要ありません。

テーブルごとに送り先を分けられますか?

はい。テーブルごとに Pocket Alert の Webhook を作成し、それぞれに名前、テンプレート、優先度を設定します。または別々のアプリケーションに分けて、新規登録と注文がアプリ内の別々のチャンネルに届くようにすることもできます。詳しくはデータベースアラートと新規登録アラートをご覧ください。

Supabase の Webhook を使う必要はありますか?

いいえ。JSON を POST できるものなら何でも、Pocket Alert の Webhook を利用できます。HTTP 呼び出しができるものなら、API も利用できます。

無料アカウントを作成して、テーブルを 1 つ接続してみてください。次の新規登録は、ロック画面に届くはずです。

この記事をシェア