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

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

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

Функция	Требуемая версия прошивки
Экстренный вызов	PhoneOS 3.0.1 и более поздние версии
Индивидуальный сервис	PhoneOS 3.2.1 и более поздние версии
Несколько триггеров	PhoneOS 3.3.1 и более поздние версии
Сообщение по протоколу HTTP	PhoneOS 3.3.1 и более поздние версии
Несколько событий на одном триггере	PhoneOS 3.4.1 и более поздние версии

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

Ссылки

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

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

Таблица 1. Параметры кнопки «Действие»
Параметр	По умолчанию и опции	Описание
Функция кнопки действия 1 ~ 3	По умолчанию: Выключено Опции: выключено, экстренный вызов, настраиваемое	Вы можете настроить кнопку с помощью определенной услуги. Выкл. Если выбрано значение «Выкл.», кнопка «Действие» для отдельной службы на телефоне не будет работать. Экстренный вызов: пользователи могут использовать кнопку «Действие» для экстренного вызова, если она настроена. Настраиваемый: пользователи могут использовать кнопку «Действие» для доступа к специальной службе, если она настроена. Если вы задали поле «Экстренный вызов» или « Настраиваемое», убедитесь, что вы ввели назначение услуги в поле «Пункт назначения услуги Action Button». В противном случае на телефоне появится ошибка конфигурации.
Название службы кнопки «Действие» 1 ~ 3	По умолчанию: пусто	Дополнительно укажите имя сервиса, связанного с кнопкой «Действие». Это имя будет отображаться в экранном сообщении, когда пользователь нажмет кнопку, в котором будет указано, какая служба будет запущена. Если вы не укажете имя, по умолчанию будет использоваться имя «Экстренный вызов», «Бесшумный экстренный вызов» или «Настраиваемое действие», выбранное вами в поле «Функция кнопки действия».
Назначение услуги кнопки «Действие» 1 ~ 3	По умолчанию: пусто	Укажите место назначения услуги в одном из следующих форматов в зависимости от услуги, назначенной кнопке «Действие»: Для служб экстренной помощи введите номер телефона или URI службы экстренной помощи. При настройке кнопки для специальной службы введите URL-адрес службы. URL-адрес должен начинаться с `http://`или `https://`. Например, `https://10.11.20.159/path/service.xml`. Чтобы настроить кнопку на запуск нескольких событий с помощью одного триггера, введите `tel:<phonenumber or SIP URL> + <Service RUL>`. Пример: `tel:1234 + https://10.11.20.159/path/service.xml`. Также поддерживается вызов URI SIP. Введите URI в формате `tel: sip 4567@co.webex.com` Если вы включите кнопку «Действие», не указав действительное назначение услуги, пользователь на телефоне увидит сообщение с запросом на настройку. После того как пользователь закроет это уведомление, значок предупреждения будет сохраняться в заголовке экрана телефона до тех пор, пока кнопка не будет правильно настроена или отключена. Телефонные номера нельзя использовать в качестве пунктов назначения для индивидуальных услуг. Если вы настроите кнопку «Действие» как настраиваемую и введете номер телефона в качестве адресата услуги, на телефоне появится предупреждающее сообщение о том, что кнопка не настроена. Вместо этого вы можете добавить номер телефона в этом формате `tel:<phone number>`, например, `tel:1234`. Если вам не разрешено вводить URL-адрес, включая амперсанд (&), используйте вместо него %26. Например, введите http://1.2.3.4/phone?a=1%26b=2%26c=3 вместо http://1.2.3.4/phone?a=1&b=2&c=3.
Поле «Настраиваемое содержимое» от 1 до 3	По умолчанию: пусто	Этот параметр работает только в том случае, если для функции «Кнопка действия» задано значение «Настраиваемая». Введите данные HTTP, такие как метод, заголовок и содержимое публикации, максимальной длиной 1024 символа. После настройки телефон отправляет запрос HTTP Post при нажатии кнопки «Действие». Если для доступа к сервису требуется аутентификация, обязательно введите секрет аутентификации в поле Service Secret. В данных HTTP используйте макрос в `$SS`качестве ссылки на служебный секрет. Примеры и синтаксис см. в разделе Запрос HTTP Post на кнопку «Действие».
Служебный секрет 1~3	По умолчанию: пусто	Служебный секрет может быть секретом аутентификации, токеном или паролем. Введенный секрет отображается в виде замаскированной строки, на которую можно ссылаться с помощью макроса `$SS`в полях «Настраиваемое содержимое» и « Назначение сервиса Action Button».
Сервисный триггер 1 ~ 3	По умолчанию: однократное нажатие Опции: однократное нажатие, длительное нажатие, нажатие 3 раза	Выберите, как пользователи могут позвонить в службу экстренной помощи или вызвать специальную услугу с помощью кнопки «Действие» на телефоне. Однократное нажатие: нажмите кнопку «Действие», чтобы вызвать соответствующий вызов или услугу. Длительное нажатие: нажмите кнопку «Действие» не менее 2 секунд, чтобы вызвать соответствующий вызов или услугу. Нажмите 3 раза: нажмите кнопку «Действие» три раза с интервалом менее 2 секунд между каждым нажатием, чтобы вызвать соответствующий вызов или услугу. Не повторяйте триггер в нескольких сервисах, так как параметры с более низким приоритетом не будут работать. Порядок приоритетов (от самого высокого до самого низкого) выглядит следующим образом: группа 1, группа 2, группа 3.
Задержка исходящего вызова 1~3	По умолчанию: 5 Опции: 0—30	Задайте период ожидания (в секундах), в течение которого телефон может инициировать экстренный вызов или выполнить произвольное действие после нажатия кнопки «Действие». Установите значение 0, если вы предпочитаете, чтобы телефон звонил или инициировал событие сразу после обнаружения триггера. Для этого нужно нажать кнопку одним, длительным или тройным нажатием.
Бесшумный экстренный вызов 1 ~ 3	По умолчанию: отключено Опции: включено, отключено	Бесшумный экстренный вызов предназначен для незаметной помощи в опасных ситуациях. Это позволяет пользователям обращаться за помощью без шума. Если этот параметр включен, пользователи могут совершать односторонние вызовы с помощью кнопки «Действие». После беззвучного экстренного вызова только другая сторона может завершить вызов. Чтобы не привлекать внимание во время текущего вызова, экран телефонов 9811 и 9841 зависнет, а экран телефонов 9851, 9861 и 9871 будет выключен. Телефон по умолчанию блокирует все функции во время беззвучного экстренного вызова. Чтобы пользователи могли восстановить нормальную работу телефона, сохраняя бесшумный экстренный вызов, включите функцию «Разрешить беззвучный поиск экстренных вызовов». В выключенном состоянии экстренный вызов работает как двусторонний вызов, аналогично другим исходящим вызовам.
Разрешить бесшумный поиск экстренных вызовов	По умолчанию: нет Опции: да, нет	Определяет, могут ли пользователи восстанавливать работоспособность телефона во время экстренного вызова без звука. По умолчанию после вызова экстренной помощи телефон блокирует все функции до тех пор, пока получатель вызова не закончит вызов. Если для этого параметра установлено значение Да, пользователи могут нажать любую клавишу, чтобы восстановить нормальную работу телефона, сохраняя при этом экстренный вызов. Звук вызова остается тихим, если пользователь не увеличит громкость с помощью клавиши громкости.

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

Кнопку «Действие» на настольных телефонах Cisco серии 9800 можно настроить для запуска 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 Communications Manager(UCM) требует процентного кодирования зарезервированных символов в соответствии с RFC 3986.

Таблица 2. Процентное кодирование зарезервированных символов
Символ	Процентная кодировка
&	`%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

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

Cisco AI Assistant

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