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

> Supabase のデータベースに行が追加されると、スマホにプッシュ通知が届きます。新規登録や注文はコード不要の Database Webhook で、ステータス変更は pg_net を使った Postgres トリガーで通知できます。優先度の設定や、テーブルを開くボタンも使えます。

*24.10.2026*

<!-- source: https://pocketalert.app/ja/blog/supabase-push-notifications -->

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

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

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

## 必要なもの

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

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](/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 が送るデータ

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

```json
{
  "type": "INSERT",
  "table": "orders",
  "schema": "public",
  "record": { "id": 1042, "email": "ana@example.com", "total": 49, "status": "pending" },
  "old_record": null
}
```

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

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

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

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

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

> **Webhook Supabase**
> New orders row: #1042 · ana@example.com · $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** にチェックを入れて、次のように設定します。

```text
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 キー](/account/apikeys)を取得し、SQL エディターから Supabase Vault に保存します。キーがファイルに残らないように、マイグレーションとは別に一度だけ実行してください。

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

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

### 関数とトリガー

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

```sql
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` に使います。通知文にはログイン元のプロバイダーを含めています。

```sql
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` を設定します。

```ts
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 時間保持されます。

```sql
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 を作成し、それぞれに名前、テンプレート、優先度を設定します。または別々のアプリケーションに分けて、新規登録と注文がアプリ内の別々のチャンネルに届くようにすることもできます。詳しくは[データベースアラート](/use-cases/database-alerts)と[新規登録アラート](/use-cases/signup-alerts)をご覧ください。

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

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

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