For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/mobile/notifications.md (or send Accept: text/markdown).
Уведомления и push
Встроенный ящик входящих, предпочтения каналов и конвейер push Expo.
Входящие и предпочтения каналов
Вкладка уведомлений перечисляет уведомления рабочего пространства из GET /api/notifications и помечает их прочитанными через PATCH на id уведомления. «Настройки → Уведомления» редактируют общие предпочтения каналов — emailBilling, emailInvites, inAppProduct — через GET и PATCH на представлении preferences того же маршрута, точно по контракту веб-приложения. Счётчик непрочитанных показывается на домашнем экране.
Регистрация устройства для push
При входе — и снова при каждом переключении рабочего пространства — приложение запрашивает разрешение на уведомления, разрешает id проекта EAS из конфигурации приложения, получает push-токен Expo и отправляет его на POST /api/mobile/push-tokens. Android регистрируется на канале default с высокой важностью.
Регистрация сообщает registered, permission_denied или unavailable и никогда не выбрасывает исключение — вход никогда не блокируется push. Expo Go и симуляторы не могут завершить регистрацию, поэтому реальное покрытие требует сборки разработки. Токен хранится в SecureStore (supastack.push.token), чтобы выход мог отменить его регистрацию до уничтожения сессионной куки.
Серверная доставка и квитанции
GET перечисляет токены участника, POST вставляет или обновляет токен под активным рабочим пространством, а DELETE отзывает его — список и отзыв остаются привязанными к пользователю, чтобы аккаунт без рабочего пространства всё ещё мог почистить за собой. Каждый пользователь хранит не более двадцати токенов устройств; регистрация ещё одного удаляет самый старый.
Каждое внутреннее уведомление рабочего пространства также отправляется push по принципу наилучшего усилия: сервер шлёт в push-API Expo порциями по сто, записывает тикеты ok и немедленно удаляет токены DeviceNotRegistered. Необязательный серверный EXPO_ACCESS_TOKEN добавляет заголовок Bearer к этим вызовам и никогда не логируется. Платформенное расписание сверяет квитанции каждые тридцать минут и выметает устаревшие тикеты — ему нужен тот же драйвер тиков планировщика, что и у остальных платформенных расписаний.
# Optional server-only token for authenticated Expo push sends:
# apps/web/.env.local
EXPO_ACCESS_TOKEN=Нажатия на уведомления открывают маршруты приложения
Отправители прикрепляют веб-путь как data.href. Приложение валидирует его — только абсолютные пути со слэшем, ограниченная длина, без обхода каталогов — и отображает известные пути на нативные маршруты, например /billing на /settings/billing и /dashboard на /home. Нажатие, пришедшее без входа, буферизуется и сбрасывается после завершения входа.
Проверка и устранение неполадок
Тестируйте на сборке разработки: дайте и отклоните разрешение, переключите push в «Настройки → Уведомления» — экран сообщает это устройство как enabled, disabled или denied — и нажмите на уведомление на холодную и на тёплую. Если выключение показывает ошибку, серверная отмена регистрации не удалась, и устройство остаётся зарегистрированным до её успеха.