Сообщения в приложении
На этой странице
Сообщения в приложении — это карточки с объявлениями на панели мобильного приложения. Существует три вида сообщений: сообщение для всего объекта, которое видят все, персональное сообщение, заданное для отдельного человека, и автоматические сообщения, применяемые правилами (например, уведомление об истёкшем членстве). На этой странице описаны все три вида, а также общий для них редактор сообщений.
Три вида сообщений: краткий обзор
| Вид | Аудитория | Где настраивается | Что имеет приоритет |
|---|---|---|---|
| Сообщение для всего объекта | Все на объекте | Settings → App Security & Settings → карточка сообщения для всего объекта | Показывается вместе с любым персональным сообщением |
| Персональное сообщение (вручную) | Один человек | Users → панель пользователя → App message | Сообщение, заданное вручную, никогда не перезаписывается автоматикой |
| Автоматическое сообщение | Все, кто соответствует условию | Settings → Automated Messages | Применяется только там, где не задано сообщение вручную; удаляется само, когда условие перестаёт выполняться |
Редактор сообщений
Все три вида используют один и тот же редактор (на рисунке 1 ниже он показан внутри двух правил автоматических сообщений).
| Поле | Подробности |
|---|---|
| Notification type | Information (нейтральное), Notice (предупреждение) или Urgent. Определяет цвет карточки и метку важности в приложении (INFORMATION / NOTICE / URGENT). |
| Title | До 120 символов, например Pool Closed for Maintenance |
| Message body | До 2000 символов (после 500 символов появляется мягкое предупреждение — карточки на панели лучше делать короткими) |
| Optional link URL | Ссылка http:// / https://; если вы не укажете префикс, https:// добавляется автоматически |
| Link label | Текст кнопки ссылки; по умолчанию More info |
| Schedule | Необязательные дата и время Starts at / Ends at. Оставьте поля пустыми, чтобы не ограничивать срок; сообщение отображается только в пределах этого периода. |
Интерактивный предварительный просмотр показывает "How this will look on the mobile app dashboard." Главный переключатель редактора включает или выключает сообщение без потери его содержимого.
Сообщение для всего объекта
Settings → App Security & Settings, карточка сообщения для всего объекта — "Allows you to configure a notification in the app for everyone at this facility." Используйте её для сообщений о закрытии, периодах технического обслуживания или мероприятиях. Не забудьте нажать Save changes на панели сохранения настроек.
Персональные сообщения
Откройте пользователя в разделе Users и воспользуйтесь разделом App message на его панели. Типичные случаи: напоминание об оплате, личное уведомление, просьба подойти на стойку регистрации. У пользователей с активным сообщением в списке отображается значок Message, цвет которого зависит от важности.
Персональное сообщение, заданное вручную, всегда имеет приоритет — автоматика его не перезапишет.
Автоматические сообщения
Settings → Automated Messages открывает страницу App Messaging Rules, на которой персональные сообщения автоматизируются на основе данных о членстве или текущей видимости дверей. Сообщение, заданное вручную, никогда не перезаписывается, а автоматические сообщения удаляются сами, когда перестают быть актуальными.
Рисунок 1. App Messaging Rules с двумя правилами, использующими тип уведомления Urgent
Как работают правила
- Enable automated messages — главный переключатель: когда он выключен, все правила ниже неактивны (отображаются приглушёнными: "Automated messages are turned off — these rules are inactive.").
- Каждое правило имеет вид: When <Membership status | Person type | Tag | Door visibility> is any of <значения> → показать это сообщение. Правила по тегам учитывают как синхронизированные, так и пользовательские теги (без учёта регистра).
- Door visibility поддерживает значения No doors visible и Has visible doors. Используется итоговый список дверей мобильного приложения: доступные двери, а также будущие двери и двери вне часов доступа считаются видимыми, как и двери, намеренно показанные в заблокированном состоянии или в режиме обслуживания. No doors visible срабатывает только тогда, когда этот список пуст.
- Порядок правил определяет приоритет — срабатывает первое включённое правило, которому соответствует человек; на одного человека приходится одно автоматическое сообщение.
- Когда человек перестаёт соответствовать всем правилам, его автоматическое сообщение удаляется автоматически.
- Текст сообщения поддерживает заполнители {firstName} и {lastName}, например "Hi {firstName}, your membership has expired."
Добавление правила
- Нажмите Add rule или выберите шаблон в Start from a template…:
| Шаблон | Условие | Предзаполненное сообщение (важность) |
|---|---|---|
| No door access | Door visibility: нет видимых дверей | No door access available (Notice) |
| Expired membership | Membership status: expired | Your membership has expired (Notice) |
| Payment overdue | Tag: overdue | Payment overdue (Notice) |
| Account on hold / suspended | Membership status: on hold, suspended | Your account is on hold (Urgent) |
| Welcome (new member) | Tag: new | Welcome! (Information) |
| Trial / prospect | Person type: prospect | Enjoying your trial? (Information) |
| Document / waiver required | Tag: waiver-required | Action required (Notice) |
- Задайте поле When и значения, отредактируйте сообщение и убедитесь, что переключатель Rule enabled включён.
- Нажмите Save changes на панели сохранения настроек.
Что происходит после сохранения
Сохранение запускает фоновую обработку, которая применяет правила ко всем на объекте. Карточка показывает ход выполнения: "Applying to members in the background…", затем "App messages applied · N updated" (или "Background update failed."). Отвязанные пользователи пропускаются при обработке, а в дальнейшем правила также применяются к пользователям при их синхронизации или изменении.
Мобильный API заново оценивает автоматические правила с учётом текущей видимости дверей при каждой загрузке объектов. Поэтому изменения политик, разрешений, режима обслуживания и расписаний влияют на сообщение сразу же: приложение не ждёт следующей фоновой обработки.
Отключение автоматики для одного человека
Если на панели пользователя активно автоматическое сообщение, можно нажать Turn off for this user — автоматическое сообщение будет удалено, и ни одно правило больше не будет отправлять этому человеку сообщения (пока вы не нажмёте там же Re-enable automated messages). Это удобно для исключений, например для участника со спором по оплате, который вы решаете лично.
Что видят участники
Сообщения отображаются в виде карточек в верхней части панели приложения, окрашенных в зависимости от типа, с заголовком, текстом и необязательной кнопкой-ссылкой. Срочные сообщения визуально выделяются. Сообщения носят информационный характер — сами по себе они не блокируют доступ к дверям (для этого используйте переключатель Access enabled или Access Policies).
Связанные страницы
- Users — персональные сообщения, значок Message
- Access Policies — авторизация доступа к дверям по параметрам Who, Where и When
- Безопасность и настройки приложения — карточка сообщения для всего объекта
- Руководство по мобильному приложению