Перейти к основному содержимому

Возможности супервизора в приложении 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 не может прослушивать звонки.
  • Сигнал оповещения (слышат ли оператор и абонент короткий сигнал, когда подключается супервизор) — это настройка компании в разделе Очереди, а не настройка приложения.