Preparing Ring content
Preparing Ring content
Preparing Ring content
Ring сообщает участникам о новых возможностях, сообщениях, приглашениях в организации, событиях кошелька, звонках и вызовах в играх. Каждое уведомление хранится один раз и доставляется по каналам, которые разрешил участник: ящик в приложении, push, email или SMS. Участники управляют этими каналами в настройках, включая окно тихих часов, которое теперь действительно отключает push и SMS ночью.
Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Настройка push (сертификат Firebase, VAPID, главный экран iOS) описана на странице Push Notifications (FCM).
Статус (2026-10-26): Тихие часы применяются на сервере. «Отметить все прочитанными» выполняется одним SQL-обновлением и больше не падает по тайм-ауту на больших ящиках. Открытая страница уведомлений применяет живые события ящика на месте вместо показа устаревших строк.
| Раньше | Сейчас |
|---|---|
| Тихие часы сохранялись в настройках, но push всё равно приходили | PUSH и SMS отбрасываются внутри окна, если уведомление не срочное |
| «Отметить все прочитанными» выбирало до 1000 строк и обновляло их по одной | Один массовый UPDATE отмечает все непрочитанные строки и возвращает их количество |
| После отметки всех прочитанными список ещё показывал старые непрочитанные | Лента перезагружается после успеха, а живые события read_all её очищают |
| Клиенты long-poll прерывали каждый пустой опрос через 15 секунд | Тайм-аут long-poll составляет 30 секунд, больше 20-секундного удержания на сервере |
Уведомления возвращают участников. Слишком мало, и возможности остаются без ответа; слишком много в 3 часа ночи, и участники отключают push навсегда. Тихие часы позволяют оставить push включённым и не просыпаться, а срочное переопределение сохраняет работу таких вещей, как оповещение о входящем звонке.
Push в Chrome, Android и на главном экране iOS, одна доставка на устройство.
Сообщения чата, звонки и приглашения в игры создают типизированные уведомления.
AI Matcher уведомляет участников, подходящих под новое объявление.
Подробно: рассылка FCM и Web Push на каждое устройство.
Тот же процесс: REST-маршруты и payload настроек, включая quietHours.
Зависит от: живой рассылки ящика по каналам notifications.
См. также: CALL_INVITE использует канал PUSH.
Ring сообщает участникам о новых возможностях, сообщениях, приглашениях в организации, событиях кошелька, звонках и вызовах в играх. Каждое уведомление хранится один раз и доставляется по каналам, которые разрешил участник: ящик в приложении, push, email или SMS. Участники управляют этими каналами в настройках, включая окно тихих часов, которое теперь действительно отключает push и SMS ночью.
Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Настройка push (сертификат Firebase, VAPID, главный экран iOS) описана на странице Push Notifications (FCM).
Статус (2026-10-26): Тихие часы применяются на сервере. «Отметить все прочитанными» выполняется одним SQL-обновлением и больше не падает по тайм-ауту на больших ящиках. Открытая страница уведомлений применяет живые события ящика на месте вместо показа устаревших строк.
| Раньше | Сейчас |
|---|---|
| Тихие часы сохранялись в настройках, но push всё равно приходили | PUSH и SMS отбрасываются внутри окна, если уведомление не срочное |
| «Отметить все прочитанными» выбирало до 1000 строк и обновляло их по одной | Один массовый UPDATE отмечает все непрочитанные строки и возвращает их количество |
| После отметки всех прочитанными список ещё показывал старые непрочитанные | Лента перезагружается после успеха, а живые события read_all её очищают |
| Клиенты long-poll прерывали каждый пустой опрос через 15 секунд | Тайм-аут long-poll составляет 30 секунд, больше 20-секундного удержания на сервере |
Уведомления возвращают участников. Слишком мало, и возможности остаются без ответа; слишком много в 3 часа ночи, и участники отключают push навсегда. Тихие часы позволяют оставить push включённым и не просыпаться, а срочное переопределение сохраняет работу таких вещей, как оповещение о входящем звонке.
Push в Chrome, Android и на главном экране iOS, одна доставка на устройство.
Сообщения чата, звонки и приглашения в игры создают типизированные уведомления.
AI Matcher уведомляет участников, подходящих под новое объявление.
Подробно: рассылка FCM и Web Push на каждое устройство.
Тот же процесс: REST-маршруты и payload настроек, включая quietHours.
Зависит от: живой рассылки ящика по каналам notifications.
См. также: CALL_INVITE использует канал PUSH.
Ring сообщает участникам о новых возможностях, сообщениях, приглашениях в организации, событиях кошелька, звонках и вызовах в играх. Каждое уведомление хранится один раз и доставляется по каналам, которые разрешил участник: ящик в приложении, push, email или SMS. Участники управляют этими каналами в настройках, включая окно тихих часов, которое теперь действительно отключает push и SMS ночью.
Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Настройка push (сертификат Firebase, VAPID, главный экран iOS) описана на странице Push Notifications (FCM).
Статус (2026-10-26): Тихие часы применяются на сервере. «Отметить все прочитанными» выполняется одним SQL-обновлением и больше не падает по тайм-ауту на больших ящиках. Открытая страница уведомлений применяет живые события ящика на месте вместо показа устаревших строк.
| Раньше | Сейчас |
|---|---|
| Тихие часы сохранялись в настройках, но push всё равно приходили | PUSH и SMS отбрасываются внутри окна, если уведомление не срочное |
| «Отметить все прочитанными» выбирало до 1000 строк и обновляло их по одной | Один массовый UPDATE отмечает все непрочитанные строки и возвращает их количество |
| После отметки всех прочитанными список ещё показывал старые непрочитанные | Лента перезагружается после успеха, а живые события read_all её очищают |
| Клиенты long-poll прерывали каждый пустой опрос через 15 секунд | Тайм-аут long-poll составляет 30 секунд, больше 20-секундного удержания на сервере |
Уведомления возвращают участников. Слишком мало, и возможности остаются без ответа; слишком много в 3 часа ночи, и участники отключают push навсегда. Тихие часы позволяют оставить push включённым и не просыпаться, а срочное переопределение сохраняет работу таких вещей, как оповещение о входящем звонке.
Push в Chrome, Android и на главном экране iOS, одна доставка на устройство.
Сообщения чата, звонки и приглашения в игры создают типизированные уведомления.
AI Matcher уведомляет участников, подходящих под новое объявление.
Подробно: рассылка FCM и Web Push на каждое устройство.
Тот же процесс: REST-маршруты и payload настроек, включая quietHours.
Зависит от: живой рассылки ящика по каналам notifications.
См. также: CALL_INVITE использует канал PUSH.
createNotification в features/notifications/services/notification-service.ts один раз загружает настройки пользователя, затем вызывает determineChannels(requested, preferences, priority) из features/notifications/lib/determine-channels.ts. Доставки строятся из этого списка, поэтому отключённый PUSH никогда не доходит до FCM.
| Шаг | Правило |
|---|---|
| Нет строки настроек | IN_APP всегда, плюс PUSH, если его запросил вызывающий |
| Сохранённые настройки | Учитываются отказы channels.push и inApp |
| Тихие часы | suppressQuietChannels убирает PUSH и SMS, когда isWithinQuietHours равно true, а приоритет не URGENT. IN_APP и EMAIL остаются |
Настройки хранят quietHours: { enabled, startTime, endTime, timezone } со временем в формате HH:mm.
timezone участника (запасной вариант UTC).22:00 до 08:00, означает ночное окно.NORMAL, если вызывающий его не указал. Отправляйте URGENT для всего, что должно прерывать.| Часть | Путь | Поведение |
|---|---|---|
| HTTP отметки всех прочитанными | app/api/notifications/read-all | Вызывает markAllNotificationsAsRead |
| Массовое обновление | notification-service.ts | Один UPDATE notifications ... WHERE data->>'user_id' = $1 AND data->>'read_at' IS NULL через getSharedPgPool, затем публикует количество непрочитанных |
| Живое обновление | features/notifications/lib/apply-inbox-to-feed.ts | Применяет payload туннеля notification, read, read_all и delete к строкам на экране с учётом активного фильтра типа |
| UI списка | features/notifications/components/notification-list.tsx | Использует applyInboxToFeed для живых событий и перезагружает курсорную ленту после отметки всех прочитанными |
Массовое обновление использует сырой SQL на JSONB-таблице notifications, поэтому работает на бэкендах PostgreSQL (k8s-postgres-fcm, supabase-fcm).
notifications:inbox и UI колокольчика. На long polling в стиле Vercel lib/tunnel/config.ts задаёт тайм-аут клиента 30 секунд, потому что /api/tunnel/poll удерживает пустые опросы до 20 секунд.fcm_tokens) плюс RFC Web Push (push_subscriptions). См. Push Notifications (FCM).Нет. Пропускаются только push и SMS. Уведомление всё равно сохраняется, показывается в ящике и отправляется по email, если email включён.
Нет. Используется существующая таблица notifications. Старые клоны на firebase-full не должны полагаться на этот путь.
Проверьте, сохранил ли участник тихие часы с корректной зоной и использовал ли отправитель приоритет URGENT, который по замыслу обходит окно.
См. также: интерактивные оповещения, создающие типизированные уведомления.
createNotification в features/notifications/services/notification-service.ts один раз загружает настройки пользователя, затем вызывает determineChannels(requested, preferences, priority) из features/notifications/lib/determine-channels.ts. Доставки строятся из этого списка, поэтому отключённый PUSH никогда не доходит до FCM.
| Шаг | Правило |
|---|---|
| Нет строки настроек | IN_APP всегда, плюс PUSH, если его запросил вызывающий |
| Сохранённые настройки | Учитываются отказы channels.push и inApp |
| Тихие часы | suppressQuietChannels убирает PUSH и SMS, когда isWithinQuietHours равно true, а приоритет не URGENT. IN_APP и EMAIL остаются |
Настройки хранят quietHours: { enabled, startTime, endTime, timezone } со временем в формате HH:mm.
timezone участника (запасной вариант UTC).22:00 до 08:00, означает ночное окно.NORMAL, если вызывающий его не указал. Отправляйте URGENT для всего, что должно прерывать.| Часть | Путь | Поведение |
|---|---|---|
| HTTP отметки всех прочитанными | app/api/notifications/read-all | Вызывает markAllNotificationsAsRead |
| Массовое обновление | notification-service.ts | Один UPDATE notifications ... WHERE data->>'user_id' = $1 AND data->>'read_at' IS NULL через getSharedPgPool, затем публикует количество непрочитанных |
| Живое обновление | features/notifications/lib/apply-inbox-to-feed.ts | Применяет payload туннеля notification, read, read_all и delete к строкам на экране с учётом активного фильтра типа |
| UI списка | features/notifications/components/notification-list.tsx | Использует applyInboxToFeed для живых событий и перезагружает курсорную ленту после отметки всех прочитанными |
Массовое обновление использует сырой SQL на JSONB-таблице notifications, поэтому работает на бэкендах PostgreSQL (k8s-postgres-fcm, supabase-fcm).
notifications:inbox и UI колокольчика. На long polling в стиле Vercel lib/tunnel/config.ts задаёт тайм-аут клиента 30 секунд, потому что /api/tunnel/poll удерживает пустые опросы до 20 секунд.fcm_tokens) плюс RFC Web Push (push_subscriptions). См. Push Notifications (FCM).Нет. Пропускаются только push и SMS. Уведомление всё равно сохраняется, показывается в ящике и отправляется по email, если email включён.
Нет. Используется существующая таблица notifications. Старые клоны на firebase-full не должны полагаться на этот путь.
Проверьте, сохранил ли участник тихие часы с корректной зоной и использовал ли отправитель приоритет URGENT, который по замыслу обходит окно.
См. также: интерактивные оповещения, создающие типизированные уведомления.
createNotification в features/notifications/services/notification-service.ts один раз загружает настройки пользователя, затем вызывает determineChannels(requested, preferences, priority) из features/notifications/lib/determine-channels.ts. Доставки строятся из этого списка, поэтому отключённый PUSH никогда не доходит до FCM.
| Шаг | Правило |
|---|---|
| Нет строки настроек | IN_APP всегда, плюс PUSH, если его запросил вызывающий |
| Сохранённые настройки | Учитываются отказы channels.push и inApp |
| Тихие часы | suppressQuietChannels убирает PUSH и SMS, когда isWithinQuietHours равно true, а приоритет не URGENT. IN_APP и EMAIL остаются |
Настройки хранят quietHours: { enabled, startTime, endTime, timezone } со временем в формате HH:mm.
timezone участника (запасной вариант UTC).22:00 до 08:00, означает ночное окно.NORMAL, если вызывающий его не указал. Отправляйте URGENT для всего, что должно прерывать.| Часть | Путь | Поведение |
|---|---|---|
| HTTP отметки всех прочитанными | app/api/notifications/read-all | Вызывает markAllNotificationsAsRead |
| Массовое обновление | notification-service.ts | Один UPDATE notifications ... WHERE data->>'user_id' = $1 AND data->>'read_at' IS NULL через getSharedPgPool, затем публикует количество непрочитанных |
| Живое обновление | features/notifications/lib/apply-inbox-to-feed.ts | Применяет payload туннеля notification, read, read_all и delete к строкам на экране с учётом активного фильтра типа |
| UI списка | features/notifications/components/notification-list.tsx | Использует applyInboxToFeed для живых событий и перезагружает курсорную ленту после отметки всех прочитанными |
Массовое обновление использует сырой SQL на JSONB-таблице notifications, поэтому работает на бэкендах PostgreSQL (k8s-postgres-fcm, supabase-fcm).
notifications:inbox и UI колокольчика. На long polling в стиле Vercel lib/tunnel/config.ts задаёт тайм-аут клиента 30 секунд, потому что /api/tunnel/poll удерживает пустые опросы до 20 секунд.fcm_tokens) плюс RFC Web Push (push_subscriptions). См. Push Notifications (FCM).Нет. Пропускаются только push и SMS. Уведомление всё равно сохраняется, показывается в ящике и отправляется по email, если email включён.
Нет. Используется существующая таблица notifications. Старые клоны на firebase-full не должны полагаться на этот путь.
Проверьте, сохранил ли участник тихие часы с корректной зоной и использовал ли отправитель приоритет URGENT, который по замыслу обходит окно.
См. также: интерактивные оповещения, создающие типизированные уведомления.