Назад в блог

Supabase push-уведомления: push на телефон для каждой новой регистрации или заказа

Supabase push-уведомления: push на телефон для каждой новой регистрации или заказа

Ваше приложение работает на Supabase, а важные события происходят в строках: новый пользователь в auth.users, новый заказ в orders, подписка, которая переходит в canceled. Вы узнаёте о них, когда открываете Table Editor, а это в лучшем случае вечером, а в загруженный день — на следующей неделе.

Supabase может сообщить раньше. Каждая таблица умеет вызывать URL, когда строка добавлена, изменена или удалена. Направьте этот вызов в Pocket Alert, и каждое событие превратится в push-уведомление на телефоне с email или суммой заказа в тексте.

Это руководство о том, как уведомлять вас, основателя или администратора. Если вы хотите отправлять push-уведомления пользователям своего приложения, для этого нужны 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 без кода

Database Webhooks в Supabase отправляют HTTP-запрос после того, как строка в таблице изменилась. Вебхуки Pocket Alert принимают JSON и превращают его в push-уведомление. Соединить их можно за несколько минут и без кода.

Создайте вебхук в Pocket Alert

Откройте Webhooks в консоли Pocket Alert и создайте новый:

  • Name: Supabase. Заголовок push-уведомления всегда имеет вид 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.
  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 и напишите сообщение с плейсхолдерами %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 целиком. Это удобно, пока вы выясняете названия столбцов.

У этой формы есть уровень по умолчанию. Задайте high для вебхука по заказам, чтобы уведомления проходили через Фокусирование на iPhone, или low для загруженной таблицы, которую нужно только видеть в истории. В полезной нагрузке Supabase нет поля level, поэтому решает значение по умолчанию у вебхука.

Регистрации из auth.users

Supabase хранит пользователей в auth.users, и выбор таблиц в Database Webhooks позволяет выбрать эту таблицу: интеграции, например Loops, описывают именно такую настройку. Выберите таблицу пользователей в схеме auth, отметьте **Insert» и используйте:

New signup: %record.email%

Если таблицы auth не появляются в списке выбора или вы предпочитаете держать логику в SQL, триггер из следующего раздела тоже работает с auth.users.

Где заканчивается Уровень 1

У Database Webhook нет условий. Отметьте Update для orders, и вы будете получать push-уведомление каждый раз, когда меняется любой столбец: статус, адрес доставки, updated_at, который обновил фоновый процесс. Шаблон не может пропустить запрос, он только форматирует его. На загруженной таблице это в лучшем случае шум, а в худшем — бесплатный тариф с его 50 сообщениями в день закончится ещё до обеда.

Если нужно «сообщить, когда заказ оплачен» или «сообщить, когда подписка отменена», требуется фильтр, а в Postgres он уже есть.

Уровень 2: триггер с pg_net и условием WHEN

Database Webhook — это триггер, который вызывает pg_net за вас. Если написать триггер самостоятельно, вы получаете две вещи: условие WHEN, чтобы Postgres срабатывал только на нужные изменения, и полный контроль над запросом, так что можно обращаться напрямую к API Pocket Alert со своим заголовком, уровнем и кнопками.

Сохраните API-ключ в Vault

Получите API-ключ в разделе API Keys и сохраните его в Supabase Vault через SQL Editor. Выполните это один раз, вне ваших миграций, чтобы ключ никогда не попал в файл:

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

Убедитесь, что pg_net включён в Database → Extensions. В проектах с Database Webhooks он уже включён.

Функция и триггер

Этот код отправляет push-уведомление только тогда, когда статус заказа меняется на 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. Postgres не вызывает функцию, пока статус действительно не изменился и новое значение не равно paid. Изменения других столбцов ничего не стоят.
  • security definer позволяет функции читать Vault. Роли, которые записывают строки из вашего приложения, например authenticated, этого не могут, и без этой опции их обновления завершались бы ошибкой прав доступа. Это шаблон из документации Supabase.
  • net.http_post ставит запрос в очередь и сразу возвращает управление; отправка происходит после коммита транзакции. Если обновление откатится, push-уведомление не уйдёт.
  • level определяет, насколько громко придёт уведомление: default для обычных событий, high чтобы пройти через Фокусирование, critical для тех, что должны вас разбудить. Critical — платная функция; на бесплатном тарифе он доставляется как high.

Скопируйте функцию для других событий и измените условие: new.status = 'canceled' для subscriptions, new.total > 500 в триггере на вставку для крупных заказов, new.role = 'admin' для profiles.

Регистрации через триггер на 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 не дают отсутствующему значению сломать строку, а сам запрос асинхронный, так что медленное или неудачное push-уведомление не мешает регистрации. Тем не менее проверьте один раз на тестовом аккаунте, прежде чем на это полагаться.

Или Edge Function

Если вам удобнее TypeScript, чем PL/pgSQL, оставьте Database Webhook из Уровня 1, выберите для него тип **Supabase Edge Functions» и добавьте заголовок с секретным ключом, который предлагает форма. Функция получает ту же полезную нагрузку {type, table, record, old_record} и решает сама. Шаблон Supabase для вызовов с секретным ключом — это обёртка withSupabase с auth: 'secret', плюс verify_jwt = false для функции в supabase/config.toml:

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. Если это важно, используйте триггер из Уровня 2, который аутентифицируется вашим API-ключом.
  • Ключ ненадолго попадает в таблицу очереди. Supabase отмечает, что pg_net хранит расшифрованный заголовок в net.http_request_queue, пока запрос не отправлен, и любая роль, которая может войти в базу данных, может прочитать его там.
  • pg_net работает по принципу «максимум усилий». Запросы хранятся в нежурналируемых таблицах, поэтому сбой в неподходящий момент может потерять один запрос. Для «сообщи мне об этом» это нормально, для биллинга — нет.
  • Объём. Триггер на таблице, в которую пишут тысячи раз в час, отправит тысячи push-уведомлений, если условие не точное. Бесплатный тариф допускает 50 сообщений в день.

Если ничего не приходит

  • Проверьте историю вебхука Pocket Alert. Каждый запрос к URL вебхука записывается в консоли вместе с заголовками, телом, отрендеренным сообщением и статусом. Если запрос там есть, Supabase свою часть сделал, и проблема в шаблоне. Если его нет, смотрите в Supabase.
  • Проверьте, что вернул pg_net. Ответы хранятся шесть часов:
select status_code, content, error_msg, created
from net._http_response
order by created desc
limit 10;

Ошибка 401 означает, что API-ключ в Vault неверный; 400 обычно значит, что тело не является корректным JSON или не хватает поля.

  • Проверьте условие триггера. Вручную выполните обновление, которое должно подойти, например update orders set status = 'paid' where id = 1042;, и снова посмотрите net._http_response.
  • Проверьте событие. Вебхук, который слушает только Insert, не сработает на обновления, а при DELETE плейсхолдеры %record.*% пусты, потому что строка находится в old_record.

FAQ

Это то же самое, что отправка push-уведомлений пользователям моего приложения?

Нет. Это отправка push-уведомлений на ваш телефон через приложение Pocket Alert. Push-уведомления на устройства ваших пользователей идут через FCM, APNs или сервис вроде Expo, и это ваше приложение должно интегрировать самостоятельно.

Можно ли получать database webhooks Supabase только для одного столбца?

Не через вебхук из панели: он срабатывает на любое изменение строки. Триггер с after update of status и условием WHEN, как в Уровне 2, срабатывает только тогда, когда этот столбец меняется так, как вы описали.

Работает ли это на бесплатном тарифе Supabase?

Database Webhooks, триггеры, pg_net и Vault входят в обычный проект Supabase, поэтому ничему здесь не нужен платный тариф Supabase.

Можно ли направлять разные таблицы в разные места?

Да. Создайте отдельный вебхук Pocket Alert для каждой таблицы, у каждого свой name, шаблон и уровень, или разложите их по разным приложениям, чтобы регистрации и заказы попадали в разные каналы. Больше идей в разделах уведомления о базе данных и уведомления о регистрациях.

Обязательно использовать вебхук Supabase?

Нет. Любой инструмент, который может отправить POST с JSON, может использовать вебхук Pocket Alert, а любой, кто может сделать HTTP-вызов, может работать с API.

Создайте бесплатный аккаунт, направьте на него одну таблицу, и следующая регистрация появится у вас на экране блокировки.

Поделиться статьёй