Настройте кнопку «Действие» (Unified CM)

Кнопка «Действие» — это красная кнопка, расположенная в правой части беспроводного телефона Cisco 9821. Она позволяет пользователям быстро получать доступ к назначенным службам, таким как службы экстренной помощи или таможенные службы. Вы можете настроить кнопку так, чтобы она инициировала события, соответствующие вашим конкретным сценариям использования.

Настройте кнопку «Действие»

1	В Cisco Unified Communications Manager Administration поле при необходимости выполните одно из следующих действий: Чтобы настроить все развернутые телефоны, выберите Система > Конфигурация корпоративного телефона. Чтобы настроить телефоны с одним и тем же телефонным профилем, выберите Устройство > Настройки устройства > Общий телефонный профиль. Чтобы настроить отдельный телефон, выберите Устройство > Телефон. Затем найдите свой телефон и откройте страницу «Конфигурация телефона». Конфигурация имеет иерархическую структуру: Индивидуальные настройки устройства имеют приоритет над настройками в общем профиле телефона и на уровне предприятия Общие настройки профиля телефона перевешивают настройки корпоративного уровня
2	Настройте параметры кнопки «Действие» в соответствии со своими вариантами использования. Для кнопки «Действие» существует три группы параметров, каждая из которых соответствует сервису с уникальным триггером. Если сервисный триггер указан в нескольких группах, настройки в группе 1 имеют приоритет над настройками в группах 2 и 3, а в группе 2 — над группой 3. Экстренные вызовы Таможенные услуги Несколько триггеров Один триггер для нескольких событий Дополнительные сведения об этих параметрах см. в разделе Конфигурационные параметры конкретного продукта.
3	Выберите «Сохранить».
4	Выберите «Применить конфигурацию».

Настройки параметров экстренных вызовов

Настройте следующие параметры для экстренных вызовов.

Таблица 1. Настройки параметров экстренных вызовов
Параметр	настройки
Функция кнопки «Действие»	Выберите «Экстренный вызов».
Пункт назначения услуги «Кнопка действия»	Введите номер телефона или URI службы экстренной помощи.
Название службы кнопки «Действие»	(Необязательно) Укажите имя сервиса, связанного с триггером. Это имя будет отображаться в экранном сообщении, когда пользователь нажмет кнопку, в котором будет указано, какая служба будет запущена. Если имя не указано `Emergency call`или `Silent emergency call`будет использоваться в качестве отображаемого имени.
Задержка исходящего вызова	Задайте период ожидания (в секундах), в течение которого телефон может инициировать событие после обнаружения триггера. Значение по умолчанию — 5 секунд. Если установлено значение 0, событие инициируется сразу после обнаружения триггера. На экране задержки отображается таймер обратного отсчета, позволяющий пользователю отменить действие, вызванное кнопкой « Действие». Во время сценариев экстренного вызова беспроводной телефон Cisco 9821 постоянно вибрирует, пока отображается экран задержки. Однако для бесшумных экстренных вызовов или сигналов беспроводной телефон Cisco 9821 не вибрирует.
Сервисный триггер	Выберите триггер из списка: однократное нажатие, длительное нажатие или 3-кратное нажатие.
Бесшумный экстренный вызов	(Необязательно) По умолчанию экстренный вызов функционирует как двусторонний вызов, как и другие исходящие вызовы. Если включен режим «Бесшумный экстренный вызов», звук на стороне вызывающего абонента отключается, чтобы не привлекать внимания во время текущего вызова. Только получатель вызова может завершить бесшумный экстренный вызов. Во время беззвучного экстренного вызова экран беспроводного телефона Cisco 9821 будет выключен. Все остальные функции недоступны. Телефон восстанавливает нормальную работу после завершения вызова получателем .
Разрешите бесшумный поиск экстренных вызовов	(Необязательно) Включите эту функцию, если вы разрешаете пользователям нажимать любую клавишу для восстановления нормальной работы телефона при сохранении экстренного вызова. Звук вызова остается тихим, если пользователь не увеличит громкость динамика с помощью клавиши громкости.

Настройки параметров пользовательских сервисов

Настройте следующие параметры для настраиваемых сервисов.

Таблица 2. Настройки параметров пользовательских сервисов
Параметр	настройки
Функция кнопки «Действие»	Выберите «Настраиваемые».
Пункт назначения услуги «Кнопка действия»	Введите URL-адрес настраиваемого сервиса. URL-адрес должен начинаться `https://`, например, с буквы « `http://`или» `https://10.11.20.159/path/service.xml`.
Название службы кнопки «Действие»	(Необязательно) Укажите имя сервиса, связанного с триггером. Это имя будет отображаться в экранном сообщении, когда пользователь нажмет кнопку, в котором будет указано, какая служба будет запущена. Если имя не указано, в качестве отображаемого имени будет использоваться пользовательский сервис.
Поле настраиваемого содержимого	(Необязательно) Если вы хотите разрешить телефону отправлять запрос HTTP Post при нажатии кнопки « Действие», введите данные HTTP, такие как метод, заголовок и содержимое публикации, максимальной длиной 1024 символа. Примеры сценариев POST и их синтаксис см. в разделе Запрос HTTP Post на кнопку « Действие».
Задержка исходящего вызова	Задайте период ожидания (в секундах), в течение которого телефон может инициировать событие после обнаружения триггера. Значение по умолчанию — 5 секунд. Если установлено значение 0, событие инициируется сразу после обнаружения триггера. На экране задержки отображается таймер обратного отсчета, позволяющий пользователю отменить действие, вызванное кнопкой « Действие». В сценариях использования специальных сервисов беспроводной телефон Cisco 9821 постоянно вибрирует, пока отображается экран задержки.
Сервисный триггер	Выберите триггер из списка: однократное нажатие, длительное нажатие или 3-кратное нажатие.
Служебный секрет	Задайте секретную строку, которая может быть секретом аутентификации, токеном или паролем. Введенный секрет отображается в виде замаскированной строки, на которую можно ссылаться с помощью макроса `$SS`в полях «Настраиваемое содержимое» и « Назначение сервиса Action Button».

Настройки параметров нескольких триггеров

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

Один триггер для настройки параметров нескольких событий

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

Таблица 3. Один триггер для настройки параметров нескольких событий
Параметр	настройки
Функция кнопки «Действие»	Выберите «Настраиваемые».
Пункт назначения услуги «Кнопка действия»	Введите номер телефона для звонка и URL-адрес службы XML в следующем формате: `tel:<phonenumber or SIP URI> + <serviceURL>` URL-адрес должен начинаться с `http://`или `https://`. Пример: `tel:1234 + https://10.11.20.159/path/service.xml`
Название службы кнопки «Действие»	(Необязательно) Укажите имя сервиса, связанного с триггером. Это имя будет отображаться в экранном сообщении, когда пользователь нажмет кнопку, в котором будет указано, какая служба будет запущена. Если имя не указано, в качестве отображаемого имени будет использоваться пользовательский сервис.
Поле настраиваемого содержимого	(Необязательно) Если вы хотите разрешить телефону отправлять запрос HTTP Post при нажатии кнопки « Действие», введите данные HTTP, такие как метод, заголовок и содержимое публикации, максимальной длиной 1024 символа. Примеры сценариев POST и их синтаксис см. в разделе Запрос HTTP Post на кнопку « Действие».
Задержка исходящего вызова	Задайте период ожидания (в секундах), в течение которого телефон может инициировать событие после обнаружения триггера. Значение по умолчанию — 5 секунд. Если установлено значение 0, событие инициируется сразу после обнаружения триггера. На экране задержки отображается таймер обратного отсчета, позволяющий пользователю отменить действие, вызванное кнопкой « Действие». Во время экстренных вызовов и сценариев предоставления специальных услуг беспроводной телефон Cisco 9821 постоянно вибрирует, пока отображается экран задержки. Однако для бесшумных экстренных вызовов или сигналов беспроводной телефон Cisco 9821 не вибрирует.
Сервисный триггер	Выберите триггер из списка: однократное нажатие, длительное нажатие или 3-кратное нажатие.
Служебный секрет	Задайте секретную строку, которая может быть секретом аутентификации, токеном или паролем. Введенный секрет отображается в виде замаскированной строки, на которую можно ссылаться с помощью макроса `$SS`в полях «Настраиваемое содержимое» и « Назначение сервиса Action Button».
Бесшумный экстренный вызов	(Необязательно) По умолчанию экстренный вызов функционирует как двусторонний вызов, как и другие исходящие вызовы. Если включен режим «Бесшумный экстренный вызов», звук на стороне вызывающего абонента отключается, чтобы не привлекать внимания во время текущего вызова. Только получатель вызова может завершить бесшумный экстренный вызов. Во время беззвучного экстренного вызова экран беспроводного телефона Cisco 9821 будет выключен. Все остальные функции недоступны. Телефон восстанавливает нормальную работу после завершения вызова получателем .
Разрешите бесшумный поиск экстренных вызовов	(Необязательно) Включите эту функцию, если вы разрешаете пользователям нажимать любую клавишу для восстановления нормальной работы телефона при сохранении экстренного вызова. Звук вызова остается тихим, если пользователь не увеличит громкость динамика с помощью клавиши громкости.

Запрос HTTP Post на кнопку «Действие»

Кнопку «Действие» на беспроводном телефоне Cisco 9821 можно настроить для запуска XML-приложений с помощью запросов HTTP Post.

В поле «Настраиваемое содержимое» введите свой собственный сценарий запроса. Можно указать тип содержимого XML или JSON и включить макросы в запрос. Например, его $SSможно добавить в скрипт для получения секрета аутентификации, токена или пароля, указанных в поле Service Secret.

Следующие примеры представлены в форматах XML и JSON:

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}'

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

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

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

--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27

Таблица 5. Поддерживаемые макросы
Имя макроса	Расширение макроса
#DEVICENAME#	Имя устройства, отображаемое в вызывающей системе. Например, SEP845A3EC21288
$SS	Service Secret, представляющий собой замаскированную строку на странице конфигурации телефона, такую как секрет аутентификации, токен или пароль.

Cisco AI Assistant

Благодарим вас за обратную связь.