¶ Общий flow
Мобильное приложение “РосДомофон” (в том числе и брендированные версии) предоставляет пользователям возможность оставить заявку на подключение услуг (“Умный домофон”, “Видеонаблюдение” и т.п.).
В зависимости от настроек системы пользователя можно провести разными путями. Ниже описаны возможные варианты.
¶ С точки зрения пользователя
-
Пользователь вводит свой адрес с точностью до квартиры.
-
Система определяет подъезд пользователя по номеру квартиры.
-
По подъезду система проверяет наличие услуг. Тут два варианта:
-
Услуги еще не настроены.
-
Абоненту сообщается о том, что пока адрес не подключен к системе РосДомофон.
-
Заявка тем ни менее принимается в общий список.
-
-
Услуги уже настроены (а значит известна обслуживающая компания).
-
В этот момент дополнительно проверяется, а нет ли уже в этой квартире, на которую пользователь оставляется заявку, другого уже подключенного владельца. Тут два варианта:
-
Квартира занята. В этом случае заявка абонента принимается и автоматически перенаправляется владельцу на подтверждение в виде push-уведомления.
- Владелец либо подтвердит заявки и тем самым поделится доступом, либо отклонит.
-
Квартира свободна. Тогда запускается дальнейший цикл приема заявки:
-
Абоненту сообщается имя компании, которая предоставляет услуги.
-
По умолчанию это имя юридического лица. Например, ООО “Дом-ИТ”.
-
Это имя можно заменить на название бренда. Например, РомДомофон.
-
-
Далее, в зависимости от настроек этой компании возможен один из следующих шагов (они взаимоисключающие):
-
По умолчанию (когда не указаны никакие дополнительные настройки). Просто выводится диалог подтверждения адреса, после чего процесс оформления заявки завершается.
-
Оферта. Перед отправкой заявки пользователю предлагается согласиться с офертой (оферта - ссылка на внешний сайт).
-
Оферта+Логин. Перед отправкой заявки пользователю предлагается согласиться с офертой (оферта - ссылка на внешний сайт) и ввести логин от личного кабинета компании (если он уже является абонентом компании, предоставляющей услуги; например, по услуге “интернет”). Логин можно оставить пустым.
-
WebView. После отправки заявки тут же внутри приложения РосДомофон открывается личный кабинет компании (web-страница, адаптированная под mobile) и в один клик подключаются услуги. Таким образом пользователь получает мгновенный доступ к услугам, без каких либо ожиданий и ручной работы сотрудников компании. Ниже подробнее описаны детали. Этот вариант самый удобный для пользователей!
-
-
-
-
-
-
Для пользователя на этом процесс оформления заявки завершается, он возвращается на главное окно и ожидает подключения (об этом ему напоминает соответствующий баннер).
-
После подключения услуги пользователю приходит push-уведомление о подключении и в приложении появляется соответствующий функционал (камера, ключ, история вызовов и т.п.).
¶ С точки зрения компании
¶ В личном кабинете
Все заявки доступны в Личному Кабинете РосДомофон.
Заявки имеют следующие статусы:
-
Новые. Они в свою очередь разделяются на два класса:
-
Мои. Т.е. заявки на адреса моей компании. Отображаются в закладке “Новые”. Такие заявки видны только моей компании. Такие заявки можно:
-
Взять в обработку.
-
Подключить.
-
Отклонить.
-
-
Свободные. Т.е. заявки на адреса, где еще нет услуг от РосДомофон. Отображаются в закладке “Не обслуживаются никем”. Такие заявки видны всем партнерам РосДомофон. Такие заявки можно будет обработать только после подключения услуг на эти адреса.
-
-
В обработке. Это новые заявки, явно взятые в работу. Этот статус удобно использовать, когда цикл коммуникации с клиентом может растянутся на некоторое время. Тогда удобно разделять новые заявки и те, которые уже в работе. Такие заявки можно:
-
Подключить.
-
Отклонить.
-
-
Ожидание ответа владельца. В случаях, когда заявка попадает на уже занятую квартиру, система автоматически перенаправляет запрос на доступ владельцу квартиры (в виде push-уведомления). Отображаются в закладке “Подтверждаются владельцем”. По истечении 1 недели такие заявки можно:
-
Делегировать.
-
Отклонить.
-
-
Завершенные. Конечный статус заявки. Тут важна резолюция, с которой заявка была обработана. Резолюции три:
-
Делегировано.
-
Подключено.
-
Отклонено.
-
Обратного хода заявки не имеют. Например, если по заявке было выполнено подключение и позже абонент отказался от услуги и отключился, заявка останется в статусе “Подключено”.
¶ Автоматизация
При наличии у компании своей учетной системы имеет смысл реализовать интеграцию, чтобы автоматизировать процесс обработки заявок. Для этого РосДомофон предлагает следующие инструменты:
-
API + Kafka. Можно в реальном времени через брокер сообщений Kafka получать заявки и программно их обрабатывать. Логика следующая:
-
Заявка содержит номер телефона, адрес, логин от личного кабинета и признак согласия с офертой.
-
Если эти поля позволяют однозначно идентифицировать абонента, то услугу следует подключить тут же, автоматически. Иначе - ручная обработка заявки.
-
Технические детали:
-
-
WebView. В предыдущем варианте часть заявок нужно обрабатывать вручную. Если же реализовать вариант с WebView, то подключение заявки выполняется полностью автоматически! Логика следующая:
-
Заявка содержит номер телефона, адрес.
-
Если эти поля позволяют однозначно идентифицировать абонента, то необходимо сразу открыть web-страницу с его личным кабинетом компании-партнера. Без дополнительного запроса логина и пароля.
-
Иначе (если номера телефона и адреса нет в системе и идентифицировать абонента не удалось), то
-
Если он уже является клиентом, попросить его ввести логин (без пароля, если номер телефона уже подтвержден и с паролем, если телефон регистрации отличается) и впустить в личный кабинет.
-
Иначе предложить пройти регистрацию, как новый абонент, введя паспортные данные.
-
-
В личном кабинете следует сразу открыть страницу подключения услуги, где указан оферта и кнопка “подключить”.
-
После подключения услуги WebView следует закрыть и вернуть управление приложению РосДомофон.
-
¶ Конфигурация
Чтобы организовать вышеописанные сценарии - необходимо корректно настроить систему. В данный момент все вышеописанные настройки задаются через обращение в техническую поддержку РосДомофон.
Еще раз коротко перечень доступных настроек:
-
Имя бренда (brand_name) - возможность заменить имя юридического лица на имя бренда, который, как правило, лучше знаком пользователям.
-
URL оферты (autosign_offer) - адрес, где размещена оферта.
-
Признак запроса логина (autosign_require_contract) - если нужно вывести поле ввода для логина от личного кабинета.
-
Настройки WebView
-
URL личного кабинета (MAIN_URL) - адрес веб-страницы, которая откроется в приложении внутри WebView.
-
URL успеха (SUCCESS_URL) - адрес, на который страница сделает переадресацию в случае успешного подключения услуги.
-
URL отказа (FAILED_URL) - адрес, на который страница сделает переадресацию в случае ошибки.
-
¶ WebView
Пользователь вводит свой адрес, и ждет, пока с ним свяжется компания-партнер и произведет подключение услуги. Это долгий и ручной процесс, который часто требует от пользователя посещения офиса и подписания документов.
Большинство пользователей приложения “РосДомофон” уже являются клиентами компаний-партнеров. Нужно предоставить таким пользователям возможность автоматического подключения услуги, чтобы они начали пользоваться полным набором функций приложения сразу после оформления заявки. А для новых клиентов - ускорить процесс подключения.
Для решения этой задачи РосДомофон предлагает возможность интеграции с личным кабинетом на сайте компании-партнера через WebView (web-страница внутри приложения “РосДомофон”), встроенное в процесс оформления заявки пользователем.
¶ Техническая реализация
¶ Flow мобильного приложения
Общий flow описан выше, тут же указаны технические детали реализации варианта WebView:
-
Приложение создает заявку на подключение в системе РосДомофон (как обычно без WebView) до перехода на WebView.
-
Это гарантирует, что заявка не потеряется, даже если работа в WebView не будет завершена штатно;
-
В этот момент для заявки генерируется уникальный идентификатор (signUpUid), который далее будет передан в WebView;
-
-
В приложении открывается WebView и в нем открывается страница MAIN_URL, указанная в конфигурации. Уникальный идентификатор заявки, полученный на предыдущем шаге, отправляется в query-параметре:
- MAIN_URL?signUpUid=<токен заявки>
-
После завершения работы WebView в мобильном приложении отображается сообщение со статусом (либо ошибка, либо успех) в зависимости от исхода работы внутри WebView. Завершение работы осуществляется посредствам перехода на заранее оговоренные страницы, которые указаны в конфигурации.
¶ Flow web-страницы компании партнера
Контент web-страницы и логику работы компания-партнер определяет самостоятельно.
Важно, что это должна быть веб-страница, адаптированная для просмотра на мобильных устройствах.
Например, типичный сценарий обычно выглядит так:
-
При открытии страницы автоматически определяется, является ли текущий абонент уже действующим клиентом компании.
-
Если да, то открывается сразу его личный кабинет, без какой-либо авторизации (либо, можно уточнить, например, только логин). И уже там есть кнопка подключения услуги.
-
Если нет, то открывается страница ввода паспортных данных для оформления договора и создания логина в личный кабинет. В этом случае возможно тестовое ограниченное подключение услуги, до момента верификации введенных данных. Тут абоненту сообщаются его дальнейшие действия.
-
После подключения услуги web-страница закрывается и абонент возвращается в мобильное приложение.
Какие для реализации этой логики РосДомофон предоставляет инструменты:
-
Параметр signUpUid, переданный в параметре запроса, является временным сгенерированным идентификатором заявки.
-
По этому идентификатору можно обратиться в API РосДомофон для получения всей информации о заявке (API получение заявки по UID):
-
Номер телефона
-
Адрес с точностью до квартиры
-
Признак наличия физической трубки
-
-
После оформления заявки в системе партнера нужно не забыть подключить услугу и в системе РосДомофон, чтобы абонент тут же в мобильном приложении увидел услугу. Для этого следует воспользоваться существующим API и типовыми сценариями использования API.
-
Для завершения работы WebView необходимо перейти на заранее согласованную страницу. Варианта два:
-
SUCCESS_URL - в случае успешной обработки заявки. Значение задается в конфигурации WebView.
-
FAILED_URL - в случае какой-либо ошибки, либо отказа абонента. Значение задается в конфигурации WebView.
-
Важно понимать, что signUpUid введен из соображений безопасности:
-
Его время жизни ограничено.
-
При таком подходе публично не передаются данные о заявке.
-
Данные о заявке получаются только через авторизацию в API РосДомофон.