Уведомления в приложении (push)

Как приложение «Глайдер» присылает уведомления о новых заказах и заявках, как включить, кому что приходит и что нужно подключить владельцу платформы

Что это и зачем

Если вы вошли в приложение «Глайдер» на телефоне, а на сервер пришёл новый заказ, телефон получает уведомление, даже когда приложение закрыто и экран погашен. Нажатие открывает приложение. Так склад узнаёт о заказах сразу, а руководитель — о заявках и запросах упаковщиков.

Какие уведомления бывают

Новые заказы Ozon, Wildberries, Яндекс Маркета (заказы FBS, ожидающие сборки; пачка заказов приходит одним сообщением: «5 новых заказов Ozon»);
новые заявки на приёмку от клиентов фулфилмента;
запросы упаковщиков руководителю («Пропустить», «Товара нет», отмена ярлыка).

Как включить

Установите приложение версии 1.10 или новее и войдите под своим именем.
На вопрос Android «Разрешить уведомления?» нажмите «Разрешить».
В системе откройте «Настройки» → «Push в приложение»: там виден ваш телефон («Телефонов с приложением: 1») и переключатели. Кнопка «Прислать проверочное» отправит уведомление на ваш телефон.

Кому что приходит

Каждый сотрудник выбирает своё в блоке «Мои уведомления в приложении». «Как у роли» возвращает настройку по умолчанию.
Администратор организации в блоке «Кому что приходит» задаёт, что получает каждая роль (администратор, менеджер, склад), может выключить уведомления у конкретного сотрудника или у всей организации сразу. По умолчанию администраторам и менеджерам приходит всё, а складу — только новые заказы.
Клиенту фулфилмента заказы его магазинов приходят в его собственных настройках; сотрудникам фулфилмента — по их ролям.

Что нужно подключить (владельцу платформы)

Уведомления идут через Google Firebase Cloud Messaging. Один раз:

На console.firebase.google.com создайте проект и добавьте в него Android-приложение с названием пакета ru.alavio.wms. Скачайте файл google-services.json — он нужен для сборки приложения.
«Настройки проекта» → «Сервисные аккаунты» → «Создать новый закрытый ключ» — скачается .json-файл ключа.
В системе откройте «Настройки» → «Push в приложение» → «Выбрать файл ключа» и «Сохранить ключ». Ключ хранится на сервере и обратно не показывается.

Обмен данными: сервер отправляет в Firebase только заголовок и текст уведомления («Новый заказ Ozon») и токен телефона; персональных данных клиентов в уведомления не кладётся. Проверка новых заказов идёт каждые 30 секунд.

Частые вопросы

Уведомлений нет. Проверьте по порядку: разрешено ли «Уведомления» для приложения в настройках телефона; виден ли телефон в «Настройки → Push в приложение»; не отключил ли вас руководитель; подключён ли ключ Firebase (иначе вверху страницы написано «Уведомления пока не включены»).
Телефон без сервисов Google (Huawei и др.). Приложение работает как обычно, но push не получает — для таких телефонов используйте звук и экран приложения.
Хочу выключить только для себя. В блоке «Мои уведомления» снимите галочки.
Вышел из приложения. Телефон снимается с уведомлений этого аккаунта сразу, чужие уведомления на нём не появятся.