Возможности супервизора в приложении MonoPhone
Отдельные сотрудники могут вести супервизию из приложения MonoPhone на телефоне, планшете или компьютере (macOS и Windows), не открывая веб-консоль. Раздел Супервизор показывается в приложении только тому, у кого через роль есть хотя бы одно право супервизора. Остальные его не видят, а сервер проверяет то же право при каждом запросе из этого раздела, поэтому скрытие экрана никогда не бывает единственной защитой.
Что предлагает раздел «Супервизор»
| В приложении | Что делает | Необходимое право |
|---|---|---|
| Очереди | Очереди под вашим наблюдением с ожидающими абонентами, каждый оператор и его состояние (доступен, на звонке, на паузе, постобработка, не в очередях). Вход оператора в его очереди и выход из них, пауза и возобновление работы оператора. Прослушивание, подсказка или вмешательство в отвеченный звонок очереди: сначала звонит ваш телефон, и вы слышите разговор, когда ответите. | queues:monitor для отдела очереди |
| Табло | Ожидающие абоненты, самое долгое ожидание, операторы в очередях и уровень сервиса (SLA) за день по каждой очереди под вашим наблюдением; цвет показывает, насколько очередь близка к цели. | queues:monitor (для уровня сервиса также нужно reports:read) |
| Активные звонки | Активные звонки компании или отдела: кто разговаривает и как долго. Завершение или перевод одного из участников зависшего звонка. Экстренные звонки отображаются в списке, но ими никогда не управляют. | calls:control для отдела одного из участников звонка |
| Общие ящики | Диалоги каналов общих ящиков, к которым у вас есть доступ (SMS, WhatsApp, Telegram, онлайн-чат): те, которые никто ещё не взял. «Ответить» открывает диалог, Назначить передаёт его сотруднику, Закрыть отправляет его в архив. | messaging:write; сервер ограничивает по отделу канала |
| Общая голосовая почта | Общие ящики (голосовая почта очередей и групп вызова), которые вы можете читать, с самыми новыми сообщениями и пометкой, ожидает каждое из них или обрабатывается. Участник ящика может взять сообщение или вернуть его. Прослушивание остаётся на вкладке «Голосовая почта» приложения. | voicemail:read (чтобы взять и вернуть сообщение, нужно быть участником ящика) |
| Предупреждения | Транк недоступен, кампания автодозвона завершена, кампания автодозвона остановлена по времени окончания: за последние 7 дней и число за последние 24 часа. | trunks:read для предупреждений о транках, queues:read для предупреждений о кампаниях (на уровне компании); вы видите только те виды, права на которые у вас есть |
| Записи разговоров | Записи звонков команды, сначала новые, и поиск по сказанному (расшифровкам). Запись воспроизводится по короткоживущей подписанной ссылке. Каждый поиск попадает в аудит (transcript.search, но не сами слова), и каждое воспроизведение тоже (recording.downloaded, с указанием, кто запросил). Запись под юридическим удержанием помечается. | recordings:read для отдела одного из участников звонка |
| Управление командой | Изменение статуса коллеги (доступен, не беспокоить, отошёл и т. д., у каждого свои правила переадресации) и принудительное включение или выключение рабочего режима расписания на один час либо возврат к его недельному графику. | Для статуса нужно users:write для отдела этого человека; для переопределения нужно calls:control для отдела расписания. Раздел, которым вы не можете пользоваться, скрыт. |
| Сегодня | Отчёты с одного взгляда: предложенные, отвеченные и потерянные звонки за сегодня, доля отвеченных, среднее ожидание и время разговора, уровень сервиса, по строке на каждую очередь. | reports:read (для уровня сервиса оно тоже нужно) |
| Кампании | Ход голосовых кампаний (автодозвон) и кампаний с сообщениями в реальном времени: статус, индикатор выполнения, сколько завершено и (для сообщений) сколько с ошибкой. При наличии права управления: Запустить, Приостановить, Возобновить и Остановить (перед остановкой запрашивается подтверждение, и отменить её нельзя). Без этого права вкладка только для просмотра. | Голос: просмотр queues:read, управление queues:write. Сообщения: просмотр messaging:read, управление messaging:write. |
| Обратные звонки | Обратные звонки, которые попросили абоненты. Отклоните ожидающий или одобрите неудавшийся, чтобы его попробовали снова (действуют те же правила защиты от телефонного мошенничества, что и для собственных попыток движка). | queues:write для отдела очереди |
Раздел открывается для того, у кого есть право хотя бы для одной вкладки (queues:monitor, calls:control, messaging:write, voicemail:read, recordings:read, reports:read, queues:read, queues:write, messaging:read, users:write или trunks:read), и показывает только те вкладки, права на которые есть. У обычной роли «Пользователь» таких прав нет, поэтому она раздел не видит. Тот, у кого есть только calls:control, видит Активные звонки (и вкладки, которые открывают его другие права); при одном queues:monitor — Очереди и Табло. На телефоне разделы находятся в панели внизу, на планшете или в окне компьютера — в боковой панели.
Всё, что делает приложение, — те же действия, что и в веб-консоли, и они записываются в журнал аудита так же (supervisor.* для супервизии очередей, call.control_* для активных звонков), в том числе когда сервер их отклоняет.
Охват: вся компания или один отдел
Оба права можно выдать для всей компании или для выбранных отделов. Супервизор отдела продаж видит очереди отдела продаж и звонки, в которых есть участник из этого отдела, и действует только с ними, и ни с чем больше. На звонок или очередь вне этого охвата сервер отвечает так, как будто их не существует. Вход оператора в очереди и выход из них меняет все очереди этого оператора, поэтому для этого нужно право для каждой из них.
Предустановленные роли
В каждой компании есть четыре предустановленные роли. Это обычные пользовательские роли: меняйте их права, переименовывайте или удаляйте на странице «Роли», как любую созданную вами роль. Если в компании уже есть роль с таким же ключом, она сохраняет свою роль.
| Роль | Для кого | Включает |
|---|---|---|
| Супервизор очередей | Тот, кто следит за очередями в реальном времени | Справочник и контакты, users:read, extensions:read, queues:read, queues:monitor, calls:control, call_history:read, reports:read |
| Руководитель группы | Руководитель группы | Всё, что есть у супервизора очередей, а также recordings:read, voicemail:read, call_notes:read_team, messaging:read и messaging:write |
| Супервизор кампаний | Тот, кто следит за исходящими кампаниями | Справочник и контакты, queues:read, call_history:read, reports:read (без прослушивания и управления звонками) |
| Менеджер только для чтения | Менеджер, который смотрит, но ничего не меняет | Права на чтение для пользователей, отделов, ролей, внутренних номеров, устройств, очередей, групп вызова, истории, записей, голосовой почты, отчётов, обмена сообщениями, факса, сценариев вызовов, транков, планов набора и настроек. Без прав на запись, без queues:monitor, без calls:control |
Назначайте их на странице пользователя (Пользователи, откройте пользователя, Назначить роль) для всей компании или для одного отдела. Действует то же правило, что и для любой роли: вы можете выдавать только те права, которые есть у вас самих.
Предупреждения по ролям
Сервер замечает транк, который перестал отвечать (после того как был доступен), кампанию автодозвона, у которой закончились контакты, и кампанию автодозвона, остановленную по времени окончания. Он сохраняет предупреждение для вкладки Предупреждения и отправляет push-уведомление на устройства тех, у кого есть право этого вида на уровне всей компании (роль, выданная только для одного отдела, не получает предупреждений уровня компании). В push сообщается только о том, что что-то произошло, без подробностей: что именно, показывает вкладка «Предупреждения». Предупреждения хранятся 30 дней. Для одобрения обратных звонков нужно queues:write; ни у одной из четырёх предустановленных ролей его нет (оно также позволяет менять настройки очереди): выдайте его через пользовательскую роль или роль «Администратор отдела» либо «Менеджер». Предупреждения о квоте или лицензии и о уровне сервиса очереди в этот выпуск не входят.
У кого есть раздел «Супервизор»
- На странице Пользователи есть столбец Функции приложения: Супервизор для каждого, у кого через роль есть право супервизора (наведите курсор, чтобы увидеть роли, которые его дают), Нет для остальных. В столбце перечислены люди, которых позволяет видеть ваш собственный охват
users:read. - На странице Роли есть такой же столбец для ролей: он показывает, какие роли открывают раздел «Супервизор».
GET /app-features/usersвозвращает тот же список для интеграций.
Виджеты и часы
Тот, кто может вести супервизию, может поместить виджет Супервизор на домашний экран (iPhone, iPad и Android) или экран блокировки (iPhone), а также получить комплекцию и обзор Supervisor на Apple Watch, плитку и комплекцию на часах Wear OS. Они показывают только числа: ожидающие абоненты и самое долгое ожидание, активные звонки, работающие кампании и предупреждения за последние 24 часа. Нажатие открывает соответствующую вкладку раздела «Супервизор».
- Те же права, что и в приложении. Раздел появляется, только если у человека есть право для соответствующей вкладки. Без каких-либо прав супервизора виджет сообщает, что функции недоступны, и не показывает чисел; часы ничего не показывают.
- Как они обновляются. Виджет сам запрашивает сервер (
GET /me/supervisor-summary) каждые 15 минут на iOS и примерно каждые 30 минут на Android (реже эти системы не позволяют), а приложение отправляет свежие числа при каждом запуске и при изменении своих прав. Часы получают числа с телефона (Wear OS) или сами запрашивают сервер (Apple Watch). Когда роль отозвана, числа исчезают при следующем обновлении. - Токен виджета. Виджет использует существующий короткоживущий токен виджета (семь дней, хранится в связке ключей iOS или Keystore Android, никогда не в обычном файле, отзывается при выходе). Его принимают сводка, переключатель собственного статуса пользователя и его собственный отзыв, и больше ничего, а сервер по-прежнему применяет роли пользователя при каждом запросе. Каждое использование попадает в аудит (
auth.widget_token_used). - Языки. Тексты берутся из языка приложения (девять локалей), в светлом или тёмном оформлении устройства.
Изменения применяются сразу
Когда вы назначаете кому-то роль, отзываете её или меняете права роли, которая у него есть, сервер сразу уведомляет приложение этого человека, и приложение заново читает свои права. Раздел «Супервизор» появляется, а вкладка исчезает почти мгновенно: выходить из системы или перезапускать приложение не нужно. Приложение также заново читает свои права при каждом переподключении к серверу. Действие, которое человек пытается выполнить сразу после потери права, сервер отклоняет (403, MPBX-RBAC-FORBIDDEN), точно так же, как в консоли. Идущее прослушивание, подсказка или вмешательство завершается, когда супервизор теряет queues:monitor для этой очереди.
Пока приложение не прочитало свои права (например, при запуске без соединения), раздел «Супервизор» остаётся скрытым, а не угадывается. Телефон, настроенный по QR-коду или ссылке, не имеет сеанса API и не показывает этот раздел.
Ограничения
- Прослушивание, подсказка и вмешательство работают для отвеченных звонков очередей. Звонок, не относящийся к очереди, отклоняется с кодом
MPBX-SUP-NOT-QUEUE-CALL. - Для супервизии нужен вошедший в систему пользователь. Ключ API не может прослушивать звонки.
- Сигнал оповещения (слышат ли оператор и абонент короткий сигнал, когда подключается супервизор) — это настройка компании в разделе Очереди, а не настройка приложения.