블로그로 돌아가기

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

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

앱은 Supabase에서 돌아가고, 중요한 순간은 대부분 행(row)으로 찾아옵니다. auth.users에 새 사용자가 생기거나, orders에 새 주문이 들어오거나, 구독이 canceled로 바뀌는 순간이죠. 이런 소식은 Table Editor를 열어야 알게 되는데, 운이 좋으면 저녁이고 바쁜 날에는 다음 주에야 알게 됩니다.

Supabase는 더 빨리 알려줄 수 있습니다. 모든 테이블은 행이 추가, 수정, 삭제될 때 URL을 호출할 수 있어요. 이 호출의 대상을 Pocket Alert로 지정하면, 이벤트마다 휴대폰으로 푸시 알림이 오고 알림 본문에 이메일이나 주문 금액이 함께 표시됩니다.

이 가이드는 창업자나 관리자인 여러분에게 알림을 보내는 방법을 다룹니다. 앱 사용자에게 푸시 알림을 보내려면 FCM, APNs, Expo를 사용해야 하며, 이는 별도의 글에서 다룹니다.

준비물

  • 대시보드에서 열 수 있는 Supabase 프로젝트
  • Pocket Alert 계정과 iPhone 또는 Android 휴대폰에 설치한 앱. 시작하는 데는 무료 플랜으로 충분합니다.

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를 열고 웹훅을 하나 만드세요.

  • 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가 보내는 데이터

본문은 모든 테이블에서 같은 구조입니다.

{
  "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 웹훅으로 돌아가서, 위 JSON을 가리키는 %path% 자리표시자로 메시지를 작성하세요.

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

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

auth.users의 가입 알림

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

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에서 API 키를 발급받고, SQL Editor에서 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', 큰 주문을 위한 insert 트리거에서 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의 패턴은 auth: 'secret' 옵션을 쓰는 withSupabase 래퍼이며, 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=...로 설정합니다. 트레이드오프가 있습니다. 웹훅은 여전히 모든 업데이트에서 실행되고 함수가 나중에 필터링하므로, 변경마다 함수 호출 비용이 발생합니다. 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시간 동안 보관됩니다.
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 웹훅을 따로 만들고, 각각 이름, 템플릿, 수준을 다르게 설정하세요. 또는 애플리케이션을 나눠서 가입 알림과 주문 알림이 앱에서 서로 다른 채널에 도착하게 할 수도 있습니다. 더 많은 활용 예시는 데이터베이스 알림과 가입 알림에서 확인할 수 있습니다.

꼭 Supabase 웹훅을 써야 하나요?

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

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

이 글 공유하기