Приложение клиента

Внизу экрана в мобильном приложении находится панель навигации, которая позволяет пользователям перемещаться между основными разделами.
На схеме ниже показано, как панель навигации помогает разделить приложение клиента на функциональные зоны:

• Экран «Главная» — акцент на самом важном
• Экран «Дом» — управление квартирой / домом
• Экран «Витрина» — каталог недвижимости
• Экран «Сервисы» — платные функции
• Экран «Профиль» — управление своими данными и настройками

Экраны «Главная» и «Профиль» видны клиенту всегда, хотя их содержание может различаться в зависимости от множества различных условий.
Скриншоты ниже показывают, как включение и отключение продуктов влияет на видимость основных экранов.

1) Включен «Каталог проектов», но отключены продукты из «Сервисов ЖКХ», «Смарт Систем» и продукт «Marketplace»:
Доступны «Главная», «Витрина», «Профиль».

2) Включены «Каталог проектов», любой продукт из «Сервисов ЖКХ» (или «Смарт систем») и продукт «Marketplace»:
Доступны «Главная», «Дом», «Витрина», «Сервисы», «Профиль».

3) Включены «Каталог проектов», любой продукт из «Сервисов ЖКХ» (или «Смарт систем»), но отключен «Marketplace»:
Доступны «Главная», «Витрина», «Дом», «Профиль».

4) Включены только продукты из категории «Сервисы ЖКХ» (или «Смарт системы») и продукт «Marketplace»:
Доступны «Главная», «Дом», «Сервисы», «Профиль».

5) Включены только продукты из категории «Сервисы ЖКХ» или «Смарт системы»:
Доступны «Главная», «Дом», «Профиль».

Когда клиент только установил единое приложение, по умолчанию открывается версия без брендирования. Однако, управляющие организации и девелоперы могут предоставлять диплинки своим клиентам. Например, отправлять ссылки в соцсетях или развешивать объявления с QR-кодами.
Если клиент попадет в приложение по диплинку, бренд может смениться на указанный в диплинке. При этом действует особый алгоритм, чтобы показать правильный бренд без лишних действий со стороны клиента. Кратко, суть в том, что клиент переходит по диплинку на приложение, имеет 15 минут на скачивание и установку, в течение этих 15 минут запускает приложение и видит брендированное оформление.
В том числе, такая логика позволяет неавторизованным клиентам по прямой ссылке открывать витрину недвижимости от девелопера, не устанавливая несколько разных приложений.

Если рассматривать алгоритм по шагам, он заключается в следующем:
1) Когда клиент перешел по диплинку, временно запоминается его IP-адрес и бренд из диплинка. Запись с IP-адресом и брендом хранится 15 минут. Если повторно перейти по тому же диплинку или по ссылке от другого бренда, запись с IP-адресом и брендом перезапишется, также будет храниться 15 минут.

2) Диплинк направляет в магазин приложений, если не установлено приложение Домиленд. Предполагается, что за 15 минут клиент успеет скачать и запустить приложение. Для этого обычно хватает вдвое меньшего времени, даже при низкой скорости интернета.

3) Когда клиент запускает приложение, сверяется его IP-адрес с записями в системе. Если найдено совпадение, автоматически выбирается бренд из того диплинка, который открыли последним. Иконка приложения меняется на брендовую и сохраняются брендовые цвета, чтобы показывать их при будущих запусках приложения.

4) Запись с IP-адресом удаляется по истечении 15 минут, если клиент так и не запустил приложение. Либо удаляется при его запуске, потому что бренд из диплинка сохраняется сразу, после этого запись уже не нужна для проверки. Если он не успел запустить приложение за 15 минут, то увидит оформление по умолчанию — и потребуется снова перейти по диплинку, чтобы открыть конкретный бренд.

5) При последующих запусках сразу откроется бренд, который был сохранен во время первого запуска приложения, после перехода по диплинку. Теперь, даже если перейти по диплинку от другой компании, бренд не изменится автоматически. Если нет сохраненного бренда или приложение установлено без использования диплинка, клиент увидит оформление по умолчанию. Авторизованный клиент в едином приложении может самостоятельно переключиться на другой бренд: на экранах «Мои помещения» или «Покупка недвижимости».

Возможны ситуации:

• Если клиент уже авторизован, выполняется обычный переход по диплинку, при этом не изменяются брендовые цвета и иконка приложения. Предполагается, что авторизованный клиент уже выбрал предпочитаемый бренд, и если захочет, может сам изменить его, поэтому смена бренда не требуется при посещении диплинка.
• Если у бренда нет продуктов девелопера, то клиенту без авторизации сразу предлагается авторизоваться. Если подключены продукты девелопера, доступен ряд возможностей для неавторизованного клиента: главный экран, оплата счетов внешним поставщикам на экране «Дом», витрина недвижимости.
• Есть шанс, что клиент случайно «перехватит» параметры IP и бренд от другого пользователя, тогда приложение откроет неверный бренд. Например, это возможно при использовании публичных сетей, мобильного интернета, VPN-подключения, нескольких устройств в домашней сети Wi-Fi. Вероятность такой ситуации довольно мала, учитывая короктий срок хранения у записей и необходимость совпадения уникальных условий.

При первом запуске приложения пользователь еще не авторизован в нем. Поэтому ему доступна лишь часть возможностей. Число элементов в нижнем меню определяется тем, какие продукты использует партнер.

Стартовый экран приложения для неавторизованных пользователей зависит от наличия у партнера продукта «Каталог проектов». Если продукт используется, то при запуске приложения открывается экран «Витрина», в ином случае «Главная».

Ниже описан функционал приложения, который доступен неавторизованным пользователям.

На экране «Главная» можно просматривать и делиться только публичными новостями и акциями девелопера. Через ленту новостей можно перейти к экрану «Избранное», на котором могут быть списки сравнения, сохраненные предложения недвижимости и поиски.
При попытке открыть экран «Мои помещения», перейти к уведомлениям или сохранить новость в избранное, пользователь будет направлен на экран авторизации.

На экране «Дом» пользователь может посмотреть, какие возможности станут доступны после авторизации в приложении. Список возможностей соответствует подключенным продуктам.
Каждый продукт представлен карточкой и содержит следующую информацию: заголовок с иконкой, краткое описание возможностей, привлекательное изображение интерфейса.
Кнопки «Мои помещения», «Войти в профиль» и колокольчик с уведомлениями открывают экран авторизации.

На экране «Витрина» находится каталог проектов девелопера. Он доступен всем пользователям, независимо от авторизации.

Экран «Сервисы» с платными возможностями доступен только авторизованным клиентам с помещениями, переданными на обслуживание в управляющую организацию.

С экрана «Профиль» можно перейти к информации о приложении. Колокольчик с уведомлениями и кнопка «Войти или зарегистрироваться» открывают экран авторизации.

Клиенты, у которых нет помещений, после авторизации получают дополнительные возможности.

На экране «Дом» пользователи могут оплачивать счета от внешних поставщиков услуг. Например, интернет, телевидение и так далее.
Для этого нужно нажать кнопку «Оплатить счета», найти организацию по названию или ИНН, заполнить требуемые данные и ввести номер карты в платежной форме. Подробнее этот процесс описан в другой статье.

В процессе оплаты клиент может сохранить реквизиты платежа, чтобы сократить путь до оплаты последующих счетов.

После оплаты пользователю на экране «Дом» будут доступны следующие элементы:
(1) Блок с поставщиками, если пользователь во время оплаты сохранил реквизиты платежа. В противном случае блок будет пустым.
(2) Переход к списку всех сохраненных поставщиков.
(3) Переход к поиску нового поставщика и оплата счета.
(4) Просмотр истории платежей. При нажатии на одну из операций можно посмотреть подробную информацию и скачать чек.

Если у девелопера или управляющей компании подключен продукт «Афиша мероприятий», то на экране «Профиль» клиент может:

• Добавлять гостей для участия в мероприятиях
• Просматривать ранее добавленных гостей

Процесс добавления пользователей через приложение описан в другой статье.

Функционал других экранов для пользователя без помещения аналогичен функционалу для неавторизованных пользователей. Единственное отличие — вместо кнопки «Войти в профиль» клиенту будет предложено добавить помещение.

Клиенты могут использовать мини-приложение в мессенджере Telegram от Домиленд. Оно позволяет узнавать о выставленных счетах, оплачивать счета за ЖКУ, просматривать уведомления и историю платежей. Такой вариант использования не требует установки полноценного приложения Домиленд на устройство клиента.

Для доступа к мини-приложению нужно открыть чат с Telegram-ботом t.me/domylandapp_bot — по прямой ссылке или ввести его название в поиске контактов. Далее нажать кнопку «Старт» для запуска бота, он ответит сообщением с кнопкой «Открыть приложение». В дальнейшем можно открывать мини-приложение через кнопку в этом сообщении или через список чатов.

Управляющая компания может переслать сообщение от бота и закрепить его в своем Telegram-канале. Тогда клиенты смогут открывать мини-приложение с помощью кнопки в закрепленном сообщении.

Открыв приложение, клиент может авторизоваться одним из способов:

• По номеру телефона — в этом случае работает вход по паролю.
• Через Telegram — при этом не нужно вводить телефон и пароль. Достаточно того, что номер телефона из Telegram совпадет с номером телефона у клиента в системе Домиленд. Мессенджер верифицирует все номера телефонов при регистрации, что обеспечивает защиту от неправомерного доступа к аккаунту клиента. После нажатия на кнопку «Войти через Telegram» мессенджер запросит доступ к номеру телефона (только в первый раз). Если клиент разрешит доступ, привязанный телефон будет проверен для авторизации.

Если клиент не прикреплен к помещениям в эксплуатации, он может отправить заявку на добавление помещения.
А если в системе не найден клиент с таким номером телефона, он сможет зарегистрироваться.
Мини-приложение в Telegram имеет урезанный функционал, но его интерфейс почти идентичен мобильному приложению Домиленд. Поэтому инструкции актуальны для обеих версий, например: регистрация и заявка на добавление помещения, оплата счета за ЖКУ, история платежей.

Чтобы мини-приложение было в быстром доступе, можно добавить его ярлык на главный экран телефона:

• На Android — в шапке окна Telegram открыть контекстное меню → Создать ярлык
• На iOS — в шапке окна Telegram открыть контекстное меню → Создать ярлык → кнопка с иконкой «Поделиться» → На экран «Домой».

Отзывы пользователей о приложении позволяют выявить ошибки в его работе и учесть пожелания аудитории. Клиенты могут увидеть предложение оставить отзыв о приложении. Триггерами для этого служат следующие события, которые создают положительный опыт для клиента:

• Передача показаний
• Оплата счета с экрана «Счета»
• Оформление постоянного пропуска
• Запись на мероприятие
• Оценка мероприятия на пять звезд
• Открытие четырех новостей в рамках одного сеанса (сеанс длится с момента открытия приложения и до его скрытия / выгрузки из памяти)

После выполнения одного из этих действий в нижней части экрана появится форма с призывом оценить приложение. Это можно сделать с помощью смайлов, которые соответствуют пятибалльной шкале. Дальнейшие действия зависят от того, какую оценку поставит клиент:

• Оценка от одного до четырех баллов. В дополнение к оценке клиент должен оставить комментарий о проблеме или свое пожелание. Этот отзыв после нажатия кнопки «Отправить» будет отправлен в службу поддержки «Домиленд» для обработки.
• Оценка пять баллов. В таком случае оставить комментарий нельзя, а вместо кнопки «Отправить» будет «Оценить в App Store / Google Play». Нажав на нее, клиент перейдет на страницу приложения в магазине, где сможет оставить отзыв.

Клиент повторно увидит предложение оставить отзыв в случаях:

• При следующем успешном событии — если проигнорировал просьбу и скрыл шторку.
• Спустя 180 дней — если поставил пять баллов и перешел по ссылке в магазин приложений.
• Спустя 60 дней — если поставил оценку в шторке, но не перешел в магазин приложений.

На схеме ниже показано, как работает описанная логика для предложений оставить отзыв.

Приложение Домиленд постоянно совершенствуется и обновляется, чтобы обеспечить клиентам и партнерам максимально комфортное и приятное взаимодействие с платформой. Бывают два типа обновлений:

Обязательные обновления — это те, без которых пользователь не сможет использовать приложение. Приложение считается устаревшим в случаях:

• вышло крупное обновление — версия отличается на целое число, например, версии 3.0 и 4.0.
• текущая версия сильно отстает от актуальной — отличается на пять десятых, например, 4.0 и 4.5.

Когда пользователь открывает приложение и требуется обязательное обновление, он видит экран-заглушку, через который можно перейти в магазин приложений. На iOS и Android экран выглядит идентично. Клиент не может скрыть такой экран-заглушку и пользоваться приложением.

Необязательные обновления — это обновления, которые не являются критически важными для работы приложения. Они могут включать в себя исправления ошибок, улучшения производительности или новые функции. Пользователи самостоятельно решают, установить такие обновления или нет.

В Android и iOS по-разному реализованы напоминания о необязательных обновлениях:

• Android. При открытии приложения клиент увидит шторку от Google Play с информацией о новых функциях и улучшениях. Клик по кнопке «Подробнее» направит его на страницу приложения в Google Play. Нажатие на кнопку «Обновить через Google Play» запустит загрузку обновления в фоновом режиме. В это время клиент может пользоваться приложением. По завершении загрузки будет предложено перезапустить приложение. После нажатия кнопки «Перезапустить» обновление установится автоматически. Если пользователь закроет предложение скачать обновление, то в следующий раз оно появится только после выпуска новой версии или при следующем входе в аккаунт.
• iOS. При открытии приложения клиент увидит модальное окно с предложением скачать новую версию. Кнопка «Перейти в App Store» ведет в магазин на страницу приложения. Если пользователь нажмет кнопку «Установлю позже», окно закроется, а в следующий раз появится только после выпуска очередной версии или при следующем входе в аккаунт.

Общая информация
Диплинк (deep-link) — ссылка, ведущая в мобильное приложение. Эта технология позволяет скопировать ссылку на конкретный экран приложения и поделиться ей.
Нажав на полученную ссылку, пользователь попадет в приложение Домиленд. Если приложение не установлено, откроется его страница в магазине приложений для установки.

Клиент может отправить ссылку своим близким — благодаря этому, он становится не только потребителем, но и распространителем информации. Внешний вид у иконок «Поделиться» в мобильном приложении может отличаться для платформ iOS и Android (скриншоты в инструкциях демонстрируют iOS-версию).
Сотрудники тоже могут использовать диплинки — для раскрутки приложения, рекламы отдельных событий, в прямой коммуникации с клиентами, информационных рассылках или с иными целями.

Любой диплинк на приложение Домиленд содержит поддомен с названием учетной записи, которую использует партнер, и домен domyland.app.
Например, https://yourdomain.domyland.app
Если взять в пример услугу: https://yourdomain.domyland.app/services?serviceId=112442
Часть после ссылки на приложение включает путь к целевому экрану и дополнительные параметры.

Ошибка доступа
Если клиент не имеет доступа к содержимому по ссылке, он увидит сообщение об ошибке. Такие случаи возможны, если клиент перешел по диплинку, но его помещение не совпадает с настройками размещения для новости или иного контента в мобильном приложении. Попав на экран с ошибкой доступа, он может вернуться на Главную.
В едином приложение Домиленд возможна ситуация, когда клиент переходит по ссылке в брендинг, где у него нет помещений в эксплуатации — тогда он увидит другое сообщение об ошибке (на картинке справа).

Аналогичная логика будет работать с push-уведомлениями. Например, сотрудники могут изменить настройки размещения после рассылки уведомлений.
Диплинки и уведомления автоматически переключают клиента на то помещение, где есть доступ к содержанию. Если контент доступен в нескольких помещениях, происходит переключение на первое из доступных (выбор по ID).

Диплинки на основные экраны и разделы
Раздел CRM-системы «Медиа сервисы» → «Ссылки» содержит список диплинков на основные экраны приложения.
Выпадающий список наверху раздела позволяет выбрать приложение, для которого нужны диплинки.
Каждая строка в таблице содержит название экрана и ссылку на него. Кнопка рядом с диплинком позволяет скопировать его в один клик.

Диплинки для Каталога проектов
Ниже в таблице перечислены диплинки для продукта «Каталог проектов»: проект и лоты в нем.
Если клиент в проекте нажмет кнопку «Назад», это приведет его на экран «Витрина». В остальных перечисленных случаях происходит возврат в проект, для которого открыты лоты.

Диплинки могут включать идентификаторы и другие параметры. Это необходимо, чтобы направить клиента на уникальный экран — например, в карточку проекта или лота. Идентификаторы в диплинках совпадают с идентификаторами, которые сотрудники видят в URL-адресах при работе в CRM-системе.
Иногда это помогает составить диплинк вручную, не обращаясь к интерфейсу CRM.
Показать пример

После таблицы показаны скриншоты с примерами, как скопировать диплинки на указанные экраны:

• В CRM — все кроме лота доступны в разделе «Медиа сервисы» → «Ссылки» → «Проекты». Есть возможность через выпадающий список выбрать несколько проектов, для которых отобразить ссылки в таблице.
• В приложении клиента — в карточке проекта, карточке лота или в списках лотов проекта.

Диплинки для других продуктов
Ниже в таблице перечислены диплинки, которые поддерживаются в категориях продуктов: Сервисы ЖКХ, Коммерческие сервисы, Медиа Сервисы, Daily Сервисы.
Они тоже содержат идентификаторы и дополнительные параметры, которые могут помочь составить диплинк вручную, не обращаясь к интерфейсу CRM.
Показать пример

После таблицы есть скриншоты, где показано, как копировать диплинки в CRM и приложения клиента.

Клиентам могут приходить самые различные уведомления: от информации про одобренный пропуск до оповещения о предстоящем собрании собственников.

Чтобы попасть на экран «Уведомления», нужно в шапке экрана нажать на кнопку с колокольчиком. Рядом с этой кнопкой показан счетчик непрочитанных, если такие есть (когда больше 99, отображается «99+»). Кнопка видна на основных экранах «Главная», «Дом», «Сервисы», «Профиль».

(1) В шапке экрана со списком уведомлений видны три точки, которые открывают контекстное меню с кнопкой «Отметить все как прочитанные».

(2) По умолчанию на экране отображаются сначала непрочитанные уведомления в обратном хронологическом порядке, затем прочитанные. Элемент над ними показывает какая сортировка применена к списку уведомлений. По нажатию на нем доступны варианты: сначала непрочитанные, сначала новые, сначала старые.

(3) Нажатием по уведомлению клиент может открыть его, чтобы полностью прочесть. Некоторые уведомления видны с кнопкой «Перейти» для перехода к целевому экрану. Например, если уведомление о скором начале мероприятия, то кнопка отправит на экран этого мероприятия.
Некоторые оповещения ведут сразу к цели: в том числе, клик на Push-уведомлении о новости или опросе сразу откроет эту новость или опрос.

Настройки уведомлений находятся на экране «Профиль» → «Ваши данные» → «Уведомления». Здесь клиенты могут выбрать, какие типы push-уведомлений приходят от приложения. По умолчанию включены все уведомления.
Сотрудники в CRM могут посмотреть, какие уведомления включены у клиента в приложении.

Важно! Настройки в приложении не будут работать, если на устройстве отключены уведомления в системных настройках приложения.

На главном экране мобильного приложения клиент видит ленту событий с новостями, опросами и акциями от партнера.

(1) Когда клиент посчитал событие важным для себя, он может добавить его в избранное из карточки или прямо из ленты. Кнопка сохранения в избранное выглядит как иконка закладки. Когда событие добавлено в избранное, иконка в этой кнопке залита цветом. Чтобы убрать событие из избранного, нужно повторно нажать по кнопке.
Похожий функционал существует в продукте «Каталог проектов»: там есть возможность сохранить лот Витрины, сохранить набор фильтров, сравнить лоты.

(2) У заголовка ленты находится кнопка для перехода к избранным событиям.
Аналогичная точка входа находится на экране «Витрина».

(3) «Избранное» разделено по вкладкам. Они позволяют сузить диапазон поиска и ускорить путь клиента до интересного ему события или недвижимости.

• Новости
• Опросы
• Предложения — сохраненные лоты в Витрине
• Поиски — сохраненные наборы фильтров в Витрине
• Сравнение — сравнение лотов в Витрине

В приложении есть разделы, где клиенты могут оплачивать различные услуги и сервисы. Например, счета ЖКУ, абонементы на машиноместа, платные мероприятия. Хотя процесс оплаты в большинстве разделов схож, имеются исключения.
В некоторых разделах можно произвести оплату только с помощью карты, в то время как в других доступна также система быстрых платежей. В таблице ниже перечислены сервисы и доступные способы оплаты для них.

Как правило, экран оплаты открывается после нажатия кнопки «Оплатить». В зависимости от раздела приложения название этой кнопки может отличаться.

Экран оплаты включает в себя следующие поля и блоки:

• «Сумма» — общая стоимость сервисов или услуг, которые оплачивает клиент.
• «E-mail» — по умолчанию в поле указан E-mail из профиля жителя. Поле зависит от опции «Отправлять чеки на Email» в настройках юрлица.
• Способы оплаты — система быстрых платежей (СБП) или банковская карта. В зависимости от выбранного способа, процесс оплаты имеет отличия. Подробные инструкции для каждого способа представлены ниже.

Чтобы выполнить оплату с помощью банковской карты, нужно выполнить следующие действия:

(1) Выбрать одну из ранее сохраненных банковских карт или вариант «Новая карта». Кнопка с иконкой корзины позволяет удалить сохраненную карту из приложения.
(2) Сохранить способ оплаты, если необходимо. Тогда эта карта будет автоматически выбираться при последующих платежах.
(3) Нажать кнопку «Оплатить» для перехода к следующему шагу. Далее откроется экран платежной системы «Твои платежи».
(4) Если для оплаты выбрана новая карта, нужно указать ее номер, срок действия, CVV-код и имя владельца. Клиент подтверждает оплату кнопкой «Оплатить».
Если на первом шаге была выбрана ранее сохраненная карта, то оплата пройдет без ввода ее данных.

После обработки платежа клиент будет перенаправлен обратно в приложение. Там он увидит подтверждение успешной транзакции, либо сообщение о сбое во время оплаты.

Чтобы выполнить оплату через систему быстрых платежей, нужно выполнить следующие действия:

(1) Выбрать СБП в качестве способа оплаты. При смене способа меняется сумма комиссии, которая добавляется к итоговой сумме. Комиссия обычно ниже при оплате через СБП.
(2) Сохранить способ оплаты, если необходимо. Тогда СБП будет автоматически выбираться при последующих платежах.
(3) Нажать кнопку «Оплатить» для перехода к следующему шагу.

(4) В браузере откроется страница платежной системы. Выбрать банк, через который нужно провести оплату. Для удобства на странице есть поле поиска. Клик по банку откроет приложение, где нужно подтвердить оплату.
(5) Если перенаправление в банковское приложение не сработало, нужно попробовать принудительно открыть экран выбора банка с помощью кнопки «Выбрать банк».

После завершения оплаты пользователь может вернуться в приложение Домиленд, где ему будет показано подтверждение успешной транзакции (1). Если произошёл сбой в процессе оплаты, клиент увидит сообщение об этом (2).