Мини-приложения

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

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

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

1. Гибкость и масштабируемость. Мини-приложения позволяют не ограничивать потенциал бизнеса изначальным функционалом супераппа. Несмотря на всю широту возможностей последнего, его стандартные решения не всегда удовлетворяют специфические потребности каждой управляющей организации или девелопера. Тогда как мини-приложения дают эту гибкость и новые возможности для клиентов без долгой разработки. Поэтому продукт позволяет адаптироваться к различным вызовам индустрии: потребности клиентов, сезонный спрос, стратегия бизнеса, уникальные партнеры, экспериментальные решения.

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

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

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

5. Экономия. Разработать мини-приложение на основе готовых инструментов от Домиленд потребует гораздо меньше времени и средств, чем создавать полноценное решение с нуля.

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

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

Процесс интеграции мини-приложения в суперапп состоит из следующих шагов:

1. Покупка лицензии. Партнер покупает лицензию на размещение мини-приложения в супераппе. При этом сотрудники Домиленд добавляют купленные лицензии в систему.
2. Разработка. Партнер разрабатывает мини-приложение до полностью работоспособного состояния.
3. Тестирование. Партнер локально проверяет мини-приложение на стабильность и корректность работы.
4. Регистрация. Партнер добавляет в CRM информацию о мини-приложении, которая необходима для прохождения модерации.
5. Сборка. Партнер собирает архив с мини-приложением, загружает его в CRM и отправляет на модерацию.
6. Модерация. Мини-приложение проходит модерацию, которую осуществляют сотрудники Домиленд.
7. Публикация. Партнер публикует мини-приложение, которое прошло модерацию.
8. Распространение. Партнер настраивает виджет, через который клиенты смогут открывать мини-приложение в супераппе. Клиенты смогут увидеть виджет, только если приложение опубликовано.

В мини-приложении доступны следующие функциональные возможности:

• Отправить Push-уведомление клиенту. Атрибуты уведомления позволяют разработчику реализовать переход на конкретный экран внутри мини-приложения или скролл до якоря на экране. Описание API
• Получить данные о текущем пользователе. Благодаря этим данным, партнер через мини-приложение может предоставлять клиентам персонализированный контент и функционал в соответствии с их профилем. Описание API
• Провести оплату. Мини-приложение получает информацию о совершенной покупке после завершения оплаты. Партнер может использовать эти данные, чтобы обновить состояние заказа или показать клиенту информацию о покупке. Описание API
• Скачать или загрузить файл. Стандартный функционал веб-приложений, для которого не требуется использовать API.
• Вести переписку с клиентами в чате. Для включения такой возможности нужно обратиться в поддержку Домиленд. Клиенты могут открыть чат из мини-приложения. Все диалоги с клиентами сохраняются в разделе CRM «Чаты». Дополнительно можно настроить функционал чат-бота, который автоматически распределит чаты между сотрудниками в зависимости от темы.

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

1. Частично сохранять информацию о клиенте из системы Домиленд во внешней системе. Это реализуется через экспорт данных или вебхуки (моментальные уведомления о событиях в системе), которые описаны в документации Public API.
2. Когда клиент открывает мини-приложение, партнер получает данные текущего клиента через библиотеку JS SDK.
3. Благодаря тому, что после пунктов 1 и 2 известен номер телефона клиента, партнер через запрос на бэкенде связывает сохраненные данные с текущим клиентом. В этом случае номер телефона используется как уникальный идентификатор клиента в системе.
4. И таким образом в мини-приложение можно передать дополнительные данные. Партнер отображает желаемую информацию в мини-приложении, в зависимости от известных данных клиента.

Ресурсы для интеграции:

• Необходимо использовать UI-кит от Домиленд, чтобы соответствовать фирменному стилю и структуре супераппа от Домиленд. Мини-приложение может не пройти модерацию, если не следует правилам дизайн-системы. Если партнер использует брендированное приложение, рекомендуется скопировать UI-кит в свое пространство Figma и заменить брендовые цвета. В UI-ките находятся инструкция по его использованию, а также набор различных элементов для применения в мини-приложениях: цвета, иконки, типографика, компоненты интерфейса.
• Необходимо использовать библиотеку Mini App SDK, чтобы взаимодействовать с API. Данная библиотека предоставляет разработчикам набор инструментов, которые упрощают интеграцию мини-приложения в суперапп. В том числе: доступ к личным данным клиента, проведение оплат через мини-приложение, перенаправление на экраны супераппа. Примеры мини-приложений, где можно обойтись без использования SDK: виртуальные туры по новостройкам, калькулятор коммунальных платежей, расписание общественного транспорта.
• Доступно техническое описание для разработчиков: взаимодействие через API между мини-приложением и супераппом, примеры кода.
• Чтобы еще больше упростить процесс интеграции, существует Демо-приложение, где показаны возможности интеграции мини-приложения в суперапп.

Требования к процессу интеграции:

• Чтобы получить данные клиента через мини-приложение, нужно использовать токен по стандарту JWT. Этот токен можно сгенерировать в карточке мини-приложения.
• Если на стороне супераппа возникает ошибка при попытке открыть мини-приложение, ее обрабатывает суперапп. Но разработчикам мини-приложения необходимо предусмотреть обработку тех ошибок, которые возникают внутри мини-приложения.

Каждому сотруднику назначена своя роль, и у каждой роли есть свой набор доступов.
Перейдите в настройки роли доступа «Настройки» → «Сотрудники» → вкладка «Роли доступа» → роль доступа (например, разработчик) → вкладка «Доступ» → группа доступов «Управление».
Возможно, для выдачи доступов на работу с мини-приложениями необходимо создать отдельную роль и новый аккаунт для сотрудника (или изменить существующую роль, или выбрать другую роль существующему сотруднику). Подробнее о добавлении и настройке ролей рассказано здесь.

В группе доступов «Управление» переключатель «Мини-приложения» позволяет выдать доступ к одноименному разделу. В рамках этого раздела выдается разрешение «Мини-приложения: редактирование», которое позволяет добавлять мини-приложения, изменять их, публиковать новые версии.

В группе доступов «Чаты» выдаются следующие разрешения:

• «Мини-приложения: просмотр» на просмотр списка чатов по мини-приложениям и их детальных карточек.
• «Мини-приложения: отправка сообщений в чат клиенту» на общение с клиентами в чатах по мини-приложениям.

Дополнительно сотруднику нужно предоставить доступ к объектам, чтобы он мог работать с чатами от жителей этих объектов.

У каждой роли есть свой набор уведомлений, который нужен сотрудникам для работы.
Перейдите в «Настройки» → «Сотрудники» → вкладка «Роли доступа» → роль доступа (например, менеджер) → вкладка «Уведомления».

В секции «Чат мини-приложений» есть несколько галочек, которые отвечают за отправку уведомлений сотрудникам об изменениях в чатах. При клике по уведомлению сотрудник сможет перейти сразу в нужный чат.

• Вас назначили ответственным в чате мини-приложения — уведомление сотруднику о назначении ответственным в одном из чатов.
• Новое сообщение в чате в чате мини-приложения — уведомление о новом сообщении от клиента.

Проставьте необходимые галочки в колонках «Push» и «Email» и нажмите кнопку «Сохранить», чтобы сотрудники с выбранной ролью получали соответствующие уведомления о чатах и не пропустили информацию, которая важна для исполнения обязанностей.

Раздел CRM «Управление» → «Мини-приложения» позволяет добавить собственные мини-приложения в суперапп и управлять ими.

Чтобы добавить новое мини-приложение, нажмите кнопку «Добавить» над их списком. Далее в модальном окне нужно заполнить данные:

• Лицензия — через выпадающий список для выбора доступны лицензии, купленные организацией для размещения мини-приложений;
• Название — только буквы, цифры, дефисы и пробелы. Длина 5−128 символов;
• Категория — на выбор доступны категории: Образ жизни, Еда и напитки, Развлечения, Бизнес, Общение, Путешествия, Транспорт, Недвижимость, Образование, Мероприятия, Инструменты, Оплата услуг, Социальные, Игры, Другое;
• Описание — только буквы, цифры, дефисы и пробелы. Длина 5−500 символов.

Все поля являются обязательными для заполнения. После указания этих данных подтвердите сохранение изменений кнопкой «Создать», подтвердите согласие с правилами размещения мини-приложений — и новое приложение появится в списке.
Подтверждать согласие необходимо каждый раз при добавлении нового мини-приложения.

Список мини-приложений в этом разделе упорядочен по дате их последнего обновления. Таблица содержит данные: название приложения, статус, категория и дата обновления. Нажав на строку, сотрудник откроет карточку мини-приложения.

Открыв карточку мини-приложения, необходимо продолжить заполнение данных. Там доступны три вкладки: «Основное», «Размещение и обновление», «Чат».

На вкладке «Основное» доступно редактирование или просмотр следующих параметров:

• Статус приложения
• Лицензия — через выпадающий список для выбора доступны лицензии, купленные организацией для размещения мини-приложений. Сотрудники Домиленд добавляют лицензии в систему, когда организация покупает их. Ни одна лицензия не закреплена за «своим» конкретным мини-приложением. Но каждая должна соответствовать только одному из мини-приложений: если она уже выбрана для одного, то будет недоступна для других. Если очистить поле с лицензией, у приложения автоматически устанавливается статус «Неактивно». Названия лицензий отличаются друг от друга номерами, например: dmapp₆, dmapp₇, dmapp₈, и так далее.
• Название приложения
• Категория приложения
• Описание
• Договор оферты — необходимо загрузить оферту на использование мини-приложения. Клиент должен дать согласие с этой офертой, прежде чем сможет использовать мини-приложение. Здесь же есть возможность удалить оферту и заменить на новую.

Перечисленные данные нужны для прохождения модерации у сотрудников Домиленд и не видны клиентам, кроме договора оферты.

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

Когда мини-приложение уже зарегистрировали через CRM, процесс его публикации состоит из следующих шагов:

1. Сотрудникам партнера нужно сделать сборку frontend-части проекта и заархивировать его в .zip формате.
2. В карточке мини-приложения на вкладке «Размещение и обновление» загрузить собранный архив с проектом.
3. Нажимая кнопку «Отправить на модерацию», партнер запросит разрешение интегрировать свое мини-приложение в суперапп.
4. Когда сотрудники Домиленд одобрили мини-приложение, оно примет статус «Готово к публикации» на вкладке «Размещение и обновление» появится кнопка «Опубликовать». Эта кнопка сменит статус мини-приложения на «Активно», после чего партнер сможет настроить виджет с мини-приложением, чтобы клиенты могли использовать его.

Кроме первичного размещения, мини-приложение должно пройти модерацию, если:

• партнер после самой первой проверки повторно изменил оферту на основой вкладке в карточке мини-приложения;
• партнер загрузил новую версию мини-приложения.

На вкладке «Размещение и обновление» можно сгенерировать токен для доступа к библиотеке Mini App SDK. Это возможно после того, как мини-приложение прошло модерацию.
Для этого нужно выбрать любого клиента и его помещение, а затем нажать кнопку «Сгенерировать». Срок действия токена — сутки, либо до следующей генерации токена по тому же клиенту.
Ручная генерация токена необходима лишь в том случае, если разработчики тестируют мини-приложение без виджета, но оно использует упомянутую библиотеку. В этом случае токен, сгенерированный вручную через CRM, можно подставить в запрос на открытие мини-приложения.
Если в мини-приложении не нужны данные о клиенте, вероятно, не требуется и SDK.
Когда мини-приложение доступно клиенту через виджет, токен генерируется при клике на этот виджет и отправляется автоматически, после чего открывается мини-приложение.
Токен уникален для каждого клиента и каждого мини-приложения. Хотя при тестировании будет достаточно и одного токена на приложение.

Сотрудники могут использовать диплинк для перехода в мини-приложение. Это позволит использовать его при коммуникации с клиентами, например: в Email-рассылках, рекламных кампаниях, чатах.
Чтобы скопировать диплинк, нужно в карточке мини-приложения нажать иконку «Поделиться», выбрать нужное приложение из списка и скопировать ссылку.
Подробная информация о всех диплинках находится в другой статье.

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

Виджет мини-приложения можно скрыть в любой момент (кнопка «Сделать черновиком» в списке виджетов) или вернуть обратно (кнопка «Опубликовать» в списке виджетов).

Статус мини-приложения отображается в его карточке на вкладке «Основное».
Мини-приложение может быть в следующих состояниях:

• Неактивно — статус при его добавлении в CRM.
• На модерации — при ручной отправке сборки на модерацию, либо при повторном изменении оферты для клиента.
• Готово к публикации — статус после прохождения модерации. Нельзя выбрать в CRM, его устанавливают сотрудники Домиленд.
• Тестируется — виджет с мини-приложением видят только клиенты с ролью «Тестировщик». Сотрудники в карточке клиента CRM могут включить галочку «Тестировщик», чтобы разрешить ему проверять, как обычные пользователи будут видеть функционал.
• Активно — мини-приложение доступно для размещения в виджете.

После первичной или повторной модерации сотрудники могут свободно менять состояние мини-приложения между тремя статусами: «Неактивно», «Активно», Тестируется".
До самой первой модерации есть возможность только загрузить архив со сборкой и отправить мини-приложение на проверку.

Чтобы использовать функционал чата в мини-приложениях, нужно обратиться в поддержку Домиленд для включения такой возможности.

Возможности чата и алгоритм взаимодействия с клиентами зависят от того, включена ли опция «Чат-бот». Ниже на схемах показаны различные сценарии работы чата.

1. Чат-бот выключен. Используются только базовые настройки чата. Приветственный текст и ответственные сотрудники за чат настраиваются в карточке мини-приложения на вкладке «Чат» → «Основное».

2. Чат-бот включен. Настроен хотя бы один тег.
Сообщения чат-бота и теги для выбора клиентом настраиваются в карточке мини-приложения на вкладке «Чат» → «Чат-бот».
Когда клиент выбирает один из тегов, в чате назначается ответственный согласно настройкам этого тега.
Если клиент проигнорировал выбор тега и написал в чат, то ответственным за чат назначается сотрудник, указанный на вкладке «Чат» → «Основное».

В карточке мини-приложения на вкладке «Чат» → «Основное» настраиваются базовые параметры чата, которые используются в следующих сценариях:

• Чат-бот выключен.
• Клиент проигнорировал выбор тега и написал в чат.

Приветственный текст — показывается пользователям, которые еще не общались в чате. Если включен чат-бот, то приветственный текст показывается из вкладки «Чат-бот».

• Заголовок — максимум 30 символов.
• Текст — максимум 100 символов.

Ответственные

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

Важно! Если включен чат-бот, то сотрудники назначаются в зависимости от настроек тегов. Подробнее о настройке чат-бота рассказано здесь.

После внесения изменений в настройки на вкладке «Чат» не забудьте нажать кнопку «Сохранить».

Использование чат-бота помогает оптимизировать работу сотрудников и увеличить их эффективность. Благодаря правилам автоназначения диалоги могут распределяться между сотрудниками. После выбора тега в чате, клиенты сразу попадают к профильным специалистам, что экономит время.

Алгоритм работы чат-бота настраивается в карточке мини-приложения на вкладке «Чат» → «Чат-бот».

Поведение чат-бота для каждого тега настраивается отдельно. Для этого выполните следующие действия:

(1) Включите переключатель «Чат-бот» и нажмите на кнопку «Добавить тег». Откроется окно добавления тега.
(2) Введите текст тега, который будет видеть клиент в чате (до 30 символов).
(3) Введите текст автоответа. Это сообщение увидит клиент после выбора тега. Далее клиент будет переведен на сотрудника, который назначен ответственным за тег.
(4) Настройте первое правило автоназначения:

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

(5) Если необходимо, добавьте еще одно правило: выберите других сотрудников, которые будут вести чаты по другим объектам.

После настройки важно подтвердить свои действия, нажав кнопку «Сохранить» в модальном окне.
Максимум можно добавить десять тегов. Добавленные теги можно редактировать и удалять. Если чат-бот включен и не добавлен хотя бы один тег, то при попытке сохранить изменения появится сообщение об ошибке.

Далее настраивается поведение чат-бота при старте и окончании диалога с клиентом.

Блок «Начало диалога»

• Сотрудник — ответственный, от имени которого будет отправляться приветственное сообщение клиенту в чате.
• Приветственный текст — первое сообщение, которое отправляется клиенту при входе в чат.
• Призыв выбрать тему — сообщение, которое подталкивает клиента выбрать один из настроенных тегов.

В момент выбора тега клиент может написать произвольное сообщение в чат. В таком случае ответственный сотрудник будет назначен из вкладки «Чат» → «Основное».

Блок «Завершение»

• Если вопрос решен — сообщение для клиента, когда сотрудник завершает диалог кнопкой «Вопрос решен».
• Если пользователь не ответил — сообщение для клиента, когда сотрудник завершает диалог кнопкой «Пользователь не ответил».

Тексты сообщений всегда можно отредактировать по своему усмотрению. Для каждого поля установлен лимит в 255 символов.

Повторный запуск — время, в течении которого чат-бот будет ожидать ответа пользователя. Если клиент не ответил в течении этого времени, диалог будет завершен автоматически. При следующем входе в чат диалог начнется заново. Пример работы с интервалом в 10 минут показан на схеме под скриншотом.

В разделе «Чаты» на вкладке «Все» хранятся все чаты с клиентами по мини-приложениям, а также чаты по подпискам. Каждая строка в списке соответствует чату с конкретным клиентом. В одном чате будут видны все сообщения клиента, даже если он обращался несколько раз.
Доступен текстовый поиск по номеру чата и ФИО клиента. Список чатов можно отфильтровать с помощью кнопки «Фильтры»: по объектам, дате создания и обновления, ответственному, клиенту, продукту и т. д. Колонки в таблице можно скрыть, чтобы оставить только ключевую информацию.

Кнопка «Экспорт» (в виде зеленой иконки, показана на скриншоте ниже) на текущей вкладке позволяет сохранить таблицу с чатами в файл Excel. Фильтры помогут исключить ненужные чаты из списка и экспортировать только необходимое для отчета.

Чаты, в которых есть новые сообщения от клиентов помечаются желтым цветом. Если в таблице с чатами включена колонка «Метки», то в ней отображается количество непрочитанных сообщений.

На вкладку «Новые» попадают чаты, в которых есть непрочитанные сообщения от клиента. Настройка колонок, фильтрация данных и поиск работают так же, как на вкладке «Все».

Если нажать на строку с чатом, откроется его карточка с подробной информацией и элементами для управления этим диалогом. Карточка чата поделена на несколько блоков:

Информация — базовая информация по чату.

• Создано — дата и время создания чата.
• Обновлено — дата и время последнего изменения в карточке чата.
• Канал коммуникации — операционная система клиента (iOS или Android).

Клиент — блок с данными клиента, который написал в чат. При клике по ФИО откроется карточка клиента.

В блоке «Управление» сотрудники могут менять ключевую информацию диалога, если потребуется. После этого нужно нажать кнопку «Сохранить».

• Подразделение и ответственный — отдел и сотрудник, на которого назначен диалог.
• Комментарий — полезное пояснение для коллег. Комментарий видят только сотрудники.

Переписка с клиентом — блок, в котором сотрудники общаются с клиентом.

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

(1) Голосовой ввод текста — возможность продиктовать сообщение, вместо того чтобы набирать его на клавиатуре. Достаточно просто нажать кнопку микрофона и проговорить сообщение. Убедитесь, что к устройству подключен микрофон, и для CRM Domyland в браузере выдано разрешение на использование микрофона.
(2) Прикрепление картинки и прочих файлов — в одно сообщение можно добавить только один файл, размером до 40мб. Нажмите кнопку прикрепления файла, выберите изображение или документ для загрузки со своего устройства.

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

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

Полный список переходов, которые можно прикрепить в чате по мини-приложению:

• Сервисы управляющей компании — список бесплатных услуг от УО (доступен через виджет «Оставить заявку»).
• Детальная карточка собственной услуги — услуга управляющей компании или платная услуга маркетплейса.
• Детальная карточка услуги партнера — партнерская услуга маркетплейса.
• Список категорий Маркетплейс — экран «Все категории», который помогает искать платные услуги по группам (открывается с экрана «Сервисы»).
• Категория услуг — одна из категорий маркетплейса.
• Афиша мероприятий — экран каталога мероприятий.
• Детальная карточка мероприятия — экран одного из мероприятий, где клиент сможет записаться на него.
• Категория мероприятий — одна из категории мероприятий.
• Клуб привилегий — экран с бонусами и скидками от партнерских компаний.
• Доска объявлений — экран с объявлениями от других жителей, с возможностью разместить свое.
• Аренда машиномест — экран с абонементами клиента и возможностью арендовать машиноместо.
• Сервисы — экран с платными услугами и доступом к другим коммерческим возможностям.
• Счета — экран с выставленными счетами за ЖКУ, платные услуги, билеты на мероприятия.

Доступность переходов определяется тем, какие продукты использует партнер, и настройками размещения определенных услуг. Если для клиента недоступна одна из услуг, то прикрепить переход к ней не получится.

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

В отправленных сообщениях отображается статус доставки: одна галочка — отправлено, две галочки — прочитано.
Рядом с кнопкой «Отправить» находится кнопка «Завершить диалог», которая открывает действия: «Вопрос решен» и «Пользователь не ответил». В обоих случаях клиенту отправляется сообщение о завершении диалога от имени ответственного сотрудника. Текст сообщений настраивается в карточке мини-приложения на вкладке «Чат» → «Чат-бот».

Чтобы клиент мог перейти к мини-приложению, партнер может через CRM добавить виджет с ним на экраны «Главная», «Дом», «Витрина» и «Сервисы» в супераппе.

Клиент видит модальное окно с возможностью посмотреть и принять оферту, когда впервые открывает мини-приложение или после изменения оферты.
Если пользователь ее отклоняет, он вернется обратно на предыдущий экран. Факт принятия оферты сохраняется в системе. В дальнейшем суперапп проверяет согласие с актуальной версией оферты при повторных переходах в мини-приложение.

Если мини-приложение доступно для клиентов девелопера, оно видно авторизованным и не авторизованным пользователям. При попытке открыть мини-приложение неавторизованным пользователем происходит переход на экран авторизации, а после авторизации происходит возврат к мини-приложению.

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

На скриншоте ниже: слева — пример виджета с мини-приложением, в середине — модальное окно, в котором клиент подтверждает согласие с офертой на использование мини-приложения; справа — пример экрана в демо-версии мини-приложения от Домиленд.
Благодаря следованию дизайн-системе от Домиленд и использованию тех же компонентов, партнеры могут сделать незаметной разницу между супераппом и мини-приложением.

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

В чате есть возможность отправлять текстовые сообщения, прикреплять медиафайлы и документы размером до 40 мб.
Долгое нажатие на сообщении откроет окно с действиями: клиент может скопировать сообщение, редактировать, удалить. Редактирование и удаление своего сообщения доступно пользователю в первый час после отправки, если сотрудник еще не прочитал его.

Когда клиент получает новое сообщение, ему приходит push-уведомление. При клике на него откроется чат в мини-приложении.

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

(1) С картинкой и аннотацией из настроек виджета — сервисы управляющей компании, клуб привилегий, доска объявлений, аренда машиномест, афиша мероприятий.
(2) С картинкой и аннотацией из карточки услуги или мероприятия — детальная карточка собственной, партнерской услуги и мероприятия.
(3) Без аннотации, но с картинкой из настроек категории маркетплейса — категория платных услуг.
(4) Без картинки и аннотации — счета, сервисы, список категорий Маркетплейс, категория мероприятий.

С включенным чат-ботом и настроенными тегами будет действовать следующая логика:

1. Когда клиент открывает чат, он видит сообщение с приветствием.
2. Ниже отображается призыв выбрать тему обращения и список доступных тегов.
3. Когда происходит переключение на ответственного за тег сотрудника, клиент видит текст об этом.
4. Когда сотрудник закрывает диалог кнопкой «Вопрос решен», клиент видит текст об этом.
5. Если клиент не отвечал длительное время, то сотрудник может завершить диалог кнопкой «Пользователь не ответил». Клиент в чате увидит текст завершения диалога.

Сценарии взаимодействия клиента с чатом подробно показаны на схемах.