Настройка кнопки действия

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

ФункцияНеобходимая версия микропрограммного обеспечения
Экстренный вызовPhoneOS 3.0.1 и выше
Настраиваемый сервисPhoneOS 3.2.1 и выше
Несколько триггеровPhoneOS 3.3.1 и выше
Запись HTTPPhoneOS 3.3.1 и выше
Несколько событий на одном триггереPhoneOS 3.4.1 и выше
1

Войдите, чтобы Cisco Unified Communications Manager Administration.

2

При необходимости выполните одно из следующих действий:

  • Чтобы настроить все развернутые телефоны, перейдите к разделу Конфигурация телефона> Схв.
  • Чтобы настроить использование для телефонов одного и того же профиля телефона, перейдите в раздел Параметры устройства >Device settings > Common Phone Profile .
  • Чтобы настроить отдельный телефон, перейдите к устройству > Phone. Затем найдите свой телефон и откройте страницу «Конфигурация телефона».

Конфигурация имеет иерархическую структуру:

  • Отдельные параметры устройства имеют приоритет над параметрами общего профиля телефона и уровня предприятия
  • Параметры общего профиля телефона переопределяют параметры уровня предприятия

3

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

Для кнопки "Действие" есть три группы параметров, каждая из которых соответствует службе с уникальным триггером. Если триггер обслуживания указан в нескольких группах, параметры группы 1 берут приоритет над параметрами группы 2 и 3, а группа 2 имеет приоритет над группой 3.

  • Экстренные вызовы

    Настройте следующие параметры:

    • Функция кнопки действия: выбор экстренного вызова.

    • Адресат службы кнопок действия: введите номер телефона или URI экстренных служб.

    • Имя службы кнопок действия (необязательно): укажите имя службы, связанной с триггером действия. Это имя будет отображаться в экранном сообщении, когда пользователь нажимает кнопку, указывая, какое событие будет инициировано. Если имя не указано, в качестве отображаемого имени будет использоваться экстренный вызов .

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

    • Служебный триггер Выберите триггер из списка: однократное нажатие, длительное нажатие или нажатие 3 раза.

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

      Во время бесшумного экстренного вызова экран телефона 9841 застынет, а экран телефонов 9851, 9861 и 9871 будет отключен. Все остальные функции недоступны. Телефон восстанавливает нормальную работу после завершения вызова адресатом.

    • Разрешить бесшумный экстренный вызов (необязательно): включается, если вы разрешаете пользователям нажимать любую клавишу для восстановления нормальной работы телефона при сохранении экстренного вызова. Звук вызова остается без звука, если пользователь не увеличит громкость динамика с помощью клавиши «Громкость».

  • Пользовательские сервисы

    Настройте следующие параметры:

    • Функция кнопки действия: выбор пользовательской.

    • Адресат сервиса кнопок действия: введите URL пользовательского сервиса. URL должен начинаться с http:// или https://, например https://10.11.20.159/path/service.xml.

    • Имя службы кнопок действия (необязательно): укажите имя службы, связанной с триггером. Это имя будет отображаться в экранном сообщении, когда пользователь нажимает кнопку, указывая, какая услуга будет запущена. Если имя не указано, в качестве отображаемого имени будет использоваться пользовательский сервис .

    • Поле пользовательского содержимого (необязательно): чтобы разрешить телефону отправлять запрос на отправку http Post при нажатии кнопки «Действие», введите данные HTTP, такие как метод, заголовок и содержимое записи, длиной не более 1024 символов.

      Примеры сценариев POST и синтаксис см. в разделе «Запрос действий HTTP Post» для кнопки «Действие».

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

    • Служебный триггер Выберите триггер из списка: однократное нажатие, длительное нажатие или нажатие 3 раза.

    • Секрет службы (необязательно): введите секрет, маркер или пароль аутентификации, если ваша пользовательская служба требует аутентификации для доступа к ним. Введенный секрет отображается как замаскированная строка, на который можно ссылаться с помощью макроса $SS в поле пользовательского содержимого и кнопки действия адресата сервиса.

  • Несколько триггеров

    Установите параметры соответственно в каждой группе. См. выше разделы «Экстренные вызовы и пользовательские службы».

  • Один триггер для нескольких событий

    Настройте следующие параметры, чтобы назначить для триггера несколько событий:

    • Функция кнопки действия: выбор пользовательской.

    • Адрес службы кнопок действия: введите номер вызываемого телефона и URL службы XML в таком формате:

      телефон:<фон или URI> SIP + <serviceURL>

      URL должен начинаться с http:// или https://.

      Пример: tel:1234 + https://10.11.20.159/path/service.xml

    • Имя службы кнопок действия (необязательно): укажите имя службы, связанной с триггером. Это имя будет отображаться в экранном сообщении, когда пользователь нажимает кнопку, указывая, какая услуга будет запущена. Если имя не указано, в качестве отображаемого имени будет использоваться пользовательский сервис .

    • Поле пользовательского содержимого (необязательно): чтобы разрешить телефону отправлять запрос на отправку http Post при нажатии кнопки «Действие», введите данные HTTP, такие как метод, заголовок и содержимое записи, длиной не более 1024 символов.

      Примеры сценариев POST и синтаксис см. в разделе «Запрос действий HTTP Post» для кнопки «Действие».

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

    • Служебный триггер Выберите триггер из списка: однократное нажатие, длительное нажатие или нажатие 3 раза.

    • Секрет службы (необязательно): введите секрет, маркер или пароль аутентификации, если ваша пользовательская служба требует аутентификации для доступа к ним. Введенный секрет отображается как замаскированная строка, на который можно ссылаться с помощью макроса $SS в поле пользовательского содержимого и кнопки действия адресата сервиса.

    • Беззвучный экстренный вызов (необязательно): если вы включили в пункт назначения услуги номер телефона или набор URI, включение этой функции приведет к беззвучию экстренных вызовов.

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

      Во время бесшумного экстренного вызова экран телефона 9841 застынет, а экран телефонов 9851, 9861 и 9871 будет отключен. Все остальные функции недоступны. Телефон восстанавливает нормальную работу после завершения вызова адресатом.

    • Разрешить бесшумный экстренный вызов (необязательно): включается, если вы разрешаете пользователям нажимать любую клавишу для восстановления нормальной работы телефона при сохранении экстренного вызова. Звук вызова остается без звука, если пользователь не увеличит громкость динамика с помощью клавиши «Громкость».

Дополнительные сведения об этих параметрах см. в разделе «Параметры кнопки действия».

4

Выберите Сохранить.

5

Выберите Применить конфигурацию.

Ссылки

Параметры для кнопки «Действие»

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

Таблица 1. Параметры для кнопки «Действие»
ПараметрЗначение по умолчанию и параметрыОписание
Функция кнопки действия 1~3

Значение по умолчанию: «Выкл.»

Параметры: Выкл., Экстренный вызов, Настраиваемый

Вы можете настроить эту кнопку для конкретного сервиса.

  • Выкл. При настройке «Выкл.» кнопка действия для единого сервиса на телефоне не будет работать.
  • Экстренный вызов: пользователи могут использовать кнопку «Действие» для инициирования экстренного вызова (если это настроено).
  • Пользовательские: пользователи могут использовать кнопку действий для доступа к пользовательской службе, если это настроено.

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

Название службы кнопок действий 1~3

Значение по умолчанию: пустое

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

Если имя не задано, то по умолчанию будет использоваться экстренный вызов, беззвучный экстренный вызов или пользовательское действие на основе выбора в поле «Функция кнопок действия».

Адресат службы кнопок действий 1~3

Значение по умолчанию: пустое

Укажите адресата службы в одном из следующих форматов на основе сервиса, назначенного кнопке «Действие»:

  • Для экстренных вызовов необходимо ввести номер телефона или URI экстренных служб.

  • При настройке кнопки для пользовательской службы введите URL службы. URL должен начинаться с http:// или https://. Например, https://10.11.20.159/path/service.xml.

  • Чтобы настроить кнопку для инициирования нескольких событий одним триггером, введите номер телефона < или URL-адрес SIP> + <Service RUL>. Пример: tel:1234 + https://10.11.20.159/path/service.xml.

    Также поддерживаются вызовы URI SIP. Введите URI в формате телефон: sip 4567@co.webex.com

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

Телефонные номера не могут использоваться в качестве адресатов для пользовательских служб. Если настроить кнопку действия как пользовательскую и ввести номер телефона в качестве адресата службы, на телефоне будет отображено предупреждающее сообщение, указывающее, что кнопка не настроена. Вместо этого можно добавить номер телефона в формате tel:<> например tel:1234.

Если ввод URL с амперсандом (&) запрещен, используется в качестве замены %26. Например, вместо http://1.2.3.4/phone?a=1&b=2&c=3 введите http://1.2.3.4/phone?a=1%26b=2%26c=3 .

Поле пользовательского содержимого 1~3

Значение по умолчанию: пустое

Эта настройка работает только в том случае, если для функции кнопок действия задано значение Custom (Настраиваемая ).

Введите данные HTTP длиной не более 1024 символов, такие как метод, заголовок и содержимое записи. При настройке телефон отправляет запрос HTTP Post при нажатии кнопки «Действие».

Если сервис требует аутентификации для доступа, обязательно введите секрет аутентификации в поле « Секрет службы». В данных HTTP используйте макрос $SS в качестве ссылки на Service Secret.

Примеры и синтаксис см. в разделе «Запрос http Post» для кнопки «Действие».

Секрет службы 1~3

Значение по умолчанию: пустое

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

Триггер обслуживания 1~3

Значение по умолчанию: однократное нажатие

Варианты: однократное нажатие, длительное нажатие, нажатие 3 раза

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

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

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

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

Не повторяйте триггер для нескольких служб, так как параметры с более низким приоритетом не будут работать. Порядок приоритетов от самых высоких к низшим: группа 1, группа 2, группа 3.

Задержка выхода 1~3

Значение по умолчанию: 5

Параметры: 0 - 30

Задайте период задержки в секундах для телефона, чтобы он инициировал экстренный вызов или пользовательское действие после нажатия кнопки «Действие».

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

Беззвучный экстренный вызов 1~3

Значение по умолчанию: Отключено

Параметры: включено, отключено

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

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

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

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

Разрешить бесшумный экстренный возврат вызова

Значение по умолчанию: Нет

Варианты: «Да», «Нет»

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

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

Запрос HTTP Post для кнопки действия

Кнопка действий на телефонах Cisco Desk Phone серии 9800 может быть настроена для запуска XML приложений с помощью запросов HTTP Post.

В поле «Пользовательское содержимое» введите сценарий пользовательского запроса. В запрос можно указать тип содержимого XML или ГДЕ МОЖНО включить макросы. Например, можно добавить к сценарию $SSдля получения секрета аутентификации, маркера или пароля, указанных в поле «Служебный секрет ».

Ниже приведены примеры в XML и ГДЕ приведены данные в ФОРМАТЕ EXCEL

Пример No 1: XML --метод POST - заголовок 'Тип содержимого: приложение/xml' --заголовок 'Авторизация: Bearer username:$SS' --тело '<MetaData><Trigger>True</Trigger><Припись>This находится для HTTP POST XML</Description></MetaData>' Пример No 2: USB-метод POST --заголовок 'Тип содержимого: приложение/сью' -заголовок 'Авторизация: $SS' --тело '{"события":[{"evtid":"12345",""12345", "параметры": {"триггер": true}, "Описание":"Это относится к HTTP POST ИБЮБ"}]}'

Cisco Unified Communications Manager (UCM) требует кодирования в процентах для зарезервированных символов в соответствии с RFC 3986.

Таблица 2. Кодирование в процентах для зарезервированных символов
ХарактерКодирование в процентах
&%26
'%27
".%22
< %3c
> %3e

Следующий сценарий представляет собой пример использования строк, зашифрованных в процентах.

- метод POST - заголовок %27Content-тип: приложение/xml%27 - тело %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cЗапись%3eВ этом значение означает HTTP POST XML%3c/описание%3e%3c/MetaData%3e%27
Таблица 3. Поддерживаемые макросы
Имя макросаРаскрытие макросов
#DEVICENAME#Имя устройства, отображаемое в системе телефонии. Пример имени: SEP845A3EC21288
$SSСлужебный секрет, который представляет на странице конфигурации телефона замаскированную строку, например пароль аутентификации, маркер или пароль.