# Supabase 푸시 알림: 새 가입과 주문마다 휴대폰으로 푸시 받기

> Supabase 데이터베이스에 행이 추가되면 휴대폰으로 푸시 알림을 받아보세요. 코드 없이 Database Webhook으로 새 가입과 주문을 알리고, pg_net과 Postgres 트리거로 상태 변경, 우선순위 수준, 테이블을 여는 버튼까지 설정할 수 있습니다.

*24.10.2026*

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

앱은 Supabase에서 돌아가고, 중요한 순간은 대부분 행(row)으로 찾아옵니다. `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단계를 진행할 수 없습니다. 대신 Lovable Cloud의 SQL 편집기(**Database → Manage → SQL editor**)에서는 `pg_net`과 Vault를 사용할 수 있으니, 거기서는 2단계 트리거를 시도해 보세요.

## 1단계: 코드 없이 Database Webhook 사용하기

Supabase Database Webhook은 테이블의 행이 바뀐 뒤 HTTP 요청을 보냅니다. Pocket Alert 웹훅은 JSON을 받아 푸시 알림으로 바꿔줍니다. 두 가지를 연결하는 데는 몇 분이면 되고 코드는 필요 없습니다.

### Pocket Alert 웹훅 만들기

Pocket Alert 콘솔에서 [Webhooks](/webhooks)를 열고 웹훅을 하나 만드세요.

- **Name:** `Supabase`. 푸시 제목은 항상 `Webhook <name>` 형식이므로, 이 웹훅은 "Webhook Supabase"로 표시됩니다. 여러 개를 만들 계획이라면 `Supabase signups`처럼 더 구체적인 이름을 쓰세요.
- **Message:** 템플릿입니다. 아래에서 설명합니다.

콘솔에 표시되는 URL을 복사하세요. `https://p4a.me/wh/abc123xyz` 같은 형태입니다. 끝에 붙은 슬러그가 유일한 비밀 값이므로, URL 전체를 비밀번호처럼 다뤄야 합니다.

### Supabase 웹훅 만들기

Supabase 대시보드에서 프로젝트를 열고 **Integrations → Database Webhooks**로 이동하세요(예전 가이드에서는 Database → Webhooks라고 부릅니다). 통합 기능이 아직 켜져 있지 않다면 먼저 켜야 합니다. 이 과정에서 웹훅이 사용하는 트리거 함수가 만들어집니다. 그다음 새 웹훅을 만드세요.

1. 이름을 입력합니다. 예: `notify_new_order`
2. 테이블을 고릅니다. 예: `orders`
3. 이벤트를 선택합니다. "새 행" 알림이 목적이라면 **Insert**만 선택하세요.
4. 유형으로 **HTTP Request**를 고르고, 메서드는 `POST`, URL에는 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 웹훅으로 돌아가서, 위 JSON을 가리키는 `%path%` 자리표시자로 메시지를 작성하세요.

```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 전체가 전송되는데, 열 이름을 파악하는 동안 유용합니다.

같은 폼에는 **기본 수준**도 있습니다. 주문 웹훅에 `high`를 설정하면 iPhone의 집중 모드를 뚫고 알림이 오고, 자주 바뀌지만 기록으로만 남기고 싶은 테이블에는 `low`를 설정할 수 있습니다. Supabase 페이로드에는 `level` 필드가 없으므로, 수준은 웹훅의 기본값으로 정해집니다.

### auth.users의 가입 알림

Supabase는 사용자를 `auth.users`에 저장하며, Database Webhooks의 테이블 선택기에서 이 테이블을 고를 수 있습니다. Loops 같은 통합 기능 문서에도 이 설정이 나와 있습니다. `auth` 스키마의 사용자 테이블을 고르고 **Insert**를 선택한 뒤 다음을 입력하세요.

```text
New signup: %record.email%
```

인증 테이블이 선택기에 보이지 않거나, 로직을 SQL에 두고 싶다면 다음 섹션의 트리거도 `auth.users`에 그대로 적용할 수 있습니다.

## 1단계의 한계

Database Webhook에는 조건이 없습니다. `orders`에서 **Update**를 선택하면 어떤 열이든 바뀔 때마다 푸시가 옵니다. 상태, 배송지, 백그라운드 작업이 건드린 `updated_at`까지 모두 해당됩니다. 템플릿은 요청을 거르지 못하고 형식만 바꿀 뿐입니다. 바쁜 테이블에서는 잡음이 되고, 심하면 점심 전에 무료 플랜의 하루 메시지 50개를 다 써버립니다.

"주문이 결제 완료되면 알려줘"나 "구독이 취소되면 알려줘"처럼 조건이 필요하다면 필터가 있어야 하는데, Postgres에는 이미 그 기능이 있습니다.

## 2단계: pg_net과 WHEN 조건이 있는 트리거

Database Webhook은 사실상 `pg_net`을 대신 호출하는 트리거입니다. 트리거를 직접 작성하면 두 가지를 얻을 수 있습니다. 하나는 `WHEN` 절입니다. 원하는 변경에서만 Postgres가 실행되도록 할 수 있죠. 다른 하나는 요청에 대한 완전한 제어입니다. 제목, 수준, 버튼을 직접 정해서 Pocket Alert API를 바로 호출할 수 있습니다.

### Vault에 API 키 저장하기

[API Keys](/account/apikeys)에서 API 키를 발급받고, SQL Editor에서 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'`, 큰 주문을 위한 insert 트리거에서 `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의 패턴은 `auth: 'secret'` 옵션을 쓰는 `withSupabase` 래퍼이며, `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=...`로 설정합니다. 트레이드오프가 있습니다. 웹훅은 여전히 모든 업데이트에서 실행되고 함수가 나중에 필터링하므로, 변경마다 함수 호출 비용이 발생합니다. `WHEN` 트리거는 아무것도 실행되기 전에 필터링합니다.

## 솔직한 한계

- **서명 검증이 없습니다.** Pocket Alert은 웹훅 요청이 어디에서 왔는지 확인하지 않습니다. URL 슬러그가 곧 비밀 값입니다. 이 점이 중요하다면 API 키로 인증하는 2단계 트리거를 쓰세요.
- **키가 대기열 테이블에 잠시 남습니다.** Supabase에 따르면 `pg_net`은 요청이 나갈 때까지 복호화된 헤더를 `net.http_request_queue`에 보관합니다. 데이터베이스에 로그인할 수 있는 역할이라면 누구나 그 내용을 볼 수 있습니다.
- **pg_net은 최선 노력(best effort) 방식입니다.** 요청은 unlogged 테이블에 저장되므로, 잘못된 순간에 서버가 중단되면 요청이 유실될 수 있습니다. "이런 일이 있었다고 알려줘" 같은 용도에는 괜찮지만, 결제 관련 용도에는 적합하지 않습니다.
- **볼륨 문제가 있습니다.** 시간당 수천 건이 기록되는 테이블에 트리거를 걸면, 조건을 아주 좁게 잡지 않는 한 수천 건의 푸시가 나갑니다. 무료 플랜은 하루 50개 메시지까지 허용합니다.

## 알림이 오지 않을 때

- **Pocket Alert 웹훅 기록을 확인하세요.** 웹훅 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만 감시하는 웹훅은 업데이트에 반응하지 않습니다. `DELETE`의 경우에는 행이 `old_record`에 있으므로 `%record.*%` 자리표시자가 비어 있습니다.

## 자주 묻는 질문

### 앱 사용자에게 푸시 알림을 보내는 것과 같은 건가요?

아닙니다. 이 방법은 Pocket Alert 앱을 통해 여러분의 휴대폰으로 푸시를 보냅니다. 사용자 기기로 보내는 푸시는 FCM, APNs 또는 Expo 같은 서비스를 거쳐야 하며, 앱에서 직접 연동해야 합니다.

### Supabase 데이터베이스 웹훅을 특정 열에만 반응하도록 만들 수 있나요?

대시보드 웹훅으로는 어렵습니다. 행의 어떤 변경에도 실행되기 때문입니다. 2단계처럼 `after update of status`와 `WHEN` 조건을 쓴 트리거를 사용하면, 원하는 방식으로 해당 열이 바뀔 때만 실행됩니다.

### Supabase 무료 플랜에서도 되나요?

Database Webhooks, 트리거, `pg_net`, Vault는 모두 일반 Supabase 프로젝트에 포함된 기능이므로 유료 플랜이 필요하지 않습니다.

### 테이블마다 다른 곳으로 보낼 수 있나요?

네. 테이블마다 Pocket Alert 웹훅을 따로 만들고, 각각 이름, 템플릿, 수준을 다르게 설정하세요. 또는 애플리케이션을 나눠서 가입 알림과 주문 알림이 앱에서 서로 다른 채널에 도착하게 할 수도 있습니다. 더 많은 활용 예시는 [데이터베이스 알림](/use-cases/database-alerts)과 [가입 알림](/use-cases/signup-alerts)에서 확인할 수 있습니다.

### 꼭 Supabase 웹훅을 써야 하나요?

아닙니다. JSON을 POST할 수 있는 시스템이라면 어디서든 [Pocket Alert 웹훅](/tools/webhook)을 사용할 수 있고, HTTP 호출이 가능하다면 API를 사용할 수 있습니다.

[무료 계정을 만들고](/signup) 테이블 하나를 연결해 보세요. 다음 가입이 발생하면 잠금 화면에서 알림을 확인할 수 있습니다.
