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). Если интеграция ещё не включена, сначала включите её: она создаёт функцию-триггер, которую используют вебхуки. Затем создайте новый вебхук:
- Задайте имя, например
notify_new_order. - Выберите таблицу, например
orders. - Отметьте события. Для уведомлений о новых строках отметьте только Insert.
- Выберите HTTP Request как тип, метод
POSTи вставьте URL Pocket Alert. - Оставьте заголовок
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.
Создайте бесплатный аккаунт, направьте на него одну таблицу, и следующая регистрация появится у вас на экране блокировки.