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

> Получайте push-уведомление на телефон, когда новая строка появляется в базе данных Supabase. Database Webhook без кода для новых регистраций и заказов, затем триггер Postgres с pg_net для изменений статуса, уровней важности и кнопки, которая открывает таблицу.

*24.10.2026*

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

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

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

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

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

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

Откройте [Webhooks](/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

Тело запроса имеет одинаковую структуру для всех таблиц:

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

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

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

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

```text
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](/account/apikeys) и сохраните его в Supabase Vault через SQL Editor. Выполните это один раз, вне ваших миграций, чтобы ключ никогда не попал в файл:

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

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

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

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

```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` не дают отсутствующему значению сломать строку, а сам запрос асинхронный, так что медленное или неудачное 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`:

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

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

- **Проверьте историю вебхука Pocket Alert.** Каждый запрос к URL вебхука записывается в консоли вместе с заголовками, телом, отрендеренным сообщением и статусом. Если запрос там есть, Supabase свою часть сделал, и проблема в шаблоне. Если его нет, смотрите в Supabase.
- **Проверьте, что вернул pg_net.** Ответы хранятся шесть часов:

```sql
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, шаблон и уровень, или разложите их по разным приложениям, чтобы регистрации и заказы попадали в разные каналы. Больше идей в разделах [уведомления о базе данных](/use-cases/database-alerts) и [уведомления о регистрациях](/use-cases/signup-alerts).

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

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

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