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

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

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

1	В окне просмотра клиента в Control Hub перейдите в раздел Устройства и выберите свой телефон.
2	Выберите «Все конфигурации».
3	Перейдите в раздел «Телефон» и нажмите кнопку «Действие».
4	Настройте параметры кнопки «Действие» в соответствии со своими вариантами использования. Экстренные вызовы Таможенные услуги Один триггер для нескольких событий Несколько триггеров Дополнительные сведения об этих параметрах см. в разделе Параметры настроек беспроводного телефона Cisco 9821 на Control Hub.
5	Нажмите кнопку Далее.
6	Ознакомьтесь с внесенными изменениями и нажмите «Применить».
7	Нажмите кнопку Закрыть, чтобы закрыть страницу.

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

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

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

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

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

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

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

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

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

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

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

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

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

Установите для сервисного триггера значение MultiTrigger.

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

Перейдите в раздел Service Trigger MultiTrigger и выберите нужный триггер из доступных вариантов: однократное нажатие, длительное нажатие и трехкратное нажатие.

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

Таблица 4. Настройки параметров нескольких триггеров
Параметр	настройки
Функция кнопки «Действие»	Выберите услугу, к которой пользователи телефонов могут получить доступ с помощью триггера.
Пункт назначения услуги «Кнопка действия»	Введите номер телефона или URI услуги.
Название службы кнопки «Действие»	(Необязательно) Укажите имя сервиса, связанного с триггером. Это имя будет отображаться в экранном сообщении, когда пользователь нажмет кнопку, в котором будет указано, какая служба будет запущена. Если имя не указано, в качестве отображаемого имени будет использоваться пользовательский сервис.
Поле настраиваемого содержимого	(Необязательно) Если вы хотите разрешить телефону отправлять запрос HTTP Post при нажатии кнопки « Действие», введите данные HTTP, такие как метод, заголовок и содержимое публикации, максимальной длиной 1024 символа. Примеры сценариев POST и их синтаксис см. в разделе Запрос HTTP Post на кнопку « Действие».
Задержка исходящего вызова	Задайте период ожидания (в секундах), в течение которого телефон может инициировать событие после обнаружения триггера. Значение по умолчанию — 5 секунд. Если установлено значение 0, событие инициируется сразу после обнаружения триггера. На экране задержки отображается таймер обратного отсчета, позволяющий пользователю отменить действие, вызванное кнопкой « Действие». Во время экстренных вызовов и сценариев предоставления специальных услуг беспроводной телефон Cisco 9821 постоянно вибрирует, пока отображается экран задержки. Однако для бесшумных экстренных вызовов или сигналов беспроводной телефон Cisco 9821 не вибрирует.
Бесшумный экстренный вызов	(Необязательно) По умолчанию экстренный вызов функционирует как двусторонний вызов, как и другие исходящие вызовы. Если включен режим «Бесшумный экстренный вызов», звук на стороне вызывающего абонента отключается, чтобы не привлекать внимания во время текущего вызова. Только получатель вызова может завершить бесшумный экстренный вызов. Во время беззвучного экстренного вызова экран беспроводного телефона Cisco 9821 будет выключен. Все остальные функции недоступны. Телефон восстанавливает нормальную работу после завершения вызова получателем .
Разрешите бесшумный поиск экстренных вызовов	(Необязательно) Включите эту функцию, если вы разрешаете пользователям нажимать любую клавишу для восстановления нормальной работы телефона при сохранении экстренного вызова. Звук вызова остается тихим, если пользователь не увеличит громкость динамика с помощью клавиши громкости.

Продолжайте выполнять шаги 2 и 3, чтобы настроить дополнительные триггеры.

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

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

В поле «Настраиваемое содержимое» введите сценарий запроса. Можно указать тип содержимого XML или JSON и включить макросы в запрос.

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

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

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

Следующий пример предназначен для запроса HTTP Post.

--method POST
--header 'Content-Type: application/xml'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>'

Таблица 5. Поддерживаемые макросы
Имя макроса	Расширение макроса
#DEVICENAME#	Имя устройства, отображаемое в вызывающей системе; например, SEPE8BCE4956A29.
$MA	MAC-адрес с использованием шестнадцатеричных цифр в нижнем регистре (000e08aabbcc).
$MCASTADDR	Адрес приложения многоадресного пейджинга.
$PN $PSN	Название продукта; например, WP-9821.
$SN	Строка серийного номера, например FVH29513116.

Макропеременные, поддерживаемые в URL-адресах XML

В URL-адресах XML можно использовать макропеременные. Поддерживаются следующие макропеременные:

Идентификатор пользователя — от UID1, от UID2 до UIDn
Отображаемое имя — отображаемое имя 1, DISPLAYNAME2 для отображения имени
Идентификатор авторизации — AUTHID1, от AUTHID2 до AuthIDN
Прокси-сервер — прокси1, прокси-2 — прокси-сервер ProxyN
MAC-адрес с использованием шестнадцатеричных цифр в нижнем регистре — MA
Название продукта — PN
Номер серии продукта — PSN
Серийный номер — серийный номер

Таблица 6. Поддерживаемые макросы
Имя макроса	Расширение макроса
$	Форма $$ расширяется до одного символа $.
От A до P	Заменены параметрами общего назначения от GPP_A до GPP_P.
От SA до SD	Заменены параметрами специального назначения GPP_SA через GPP_SD. Эти параметры содержат ключи или пароли, используемые при инициализации. $SA — $SD распознаются в качестве аргументов опционального квалификатора повторной синхронизации URL-адресов --key.
MA	MAC-адрес с использованием шестнадцатеричных цифр в нижнем регистре (000e08aabbcc).
MAU	MAC-адрес с использованием шестнадцатеричных цифр в верхнем регистре (000E08AABBCC).
MAC	MAC-адрес с использованием шестнадцатеричных цифр в нижнем регистре с двоеточием для разделения пар шестнадцатеричных цифр (00:08:08:aa:bb:cc).
PN	Название продукта; например, беспроводной телефон Cisco 9821.
PSN	Серийный номер продукта, например 9821.
SN	Строка серийного номера, например FVH29513116.
CCERT	Состояние сертификата клиента SSL: установлен или не установлен.
IP	IP-адрес телефона в локальной подсети; например, 192.168.1.100.
EXTIP	Внешний IP-адрес телефона, показанный в Интернете; например, 66.43.16.52.
SWVER	Строка версии программного обеспечения. Например, PHONEOS-9821.5-0-1-0004-19.
HWVER	Строка версии оборудования. Например, 2.0.1
PRVST	Состояние обеспечения (числовая строка): -1 = явный запрос на повторную синхронизацию 0 = повторная синхронизация при включении питания 1 = периодическая повторная синхронизация 2 = повторная синхронизация не удалась, повторите попытку
UPGST	Состояние обновления (числовая строка): 1 = первая попытка обновления 2 = обновление не удалось, повторите попытку
UPGERR	Сообщение о результатах (ERR) предыдущей попытки обновления; например, http_get не удался.
PRVTMR	Количество секунд с момента последней попытки повторной синхронизации.
UPGTMR	Количество секунд с момента последней попытки обновления.
REGTMR1	Количество секунд с момента потери регистрации в строке 1 на сервере SIP.
REGTMR2	Количество секунд с тех пор, как линия 2 потеряла регистрацию на SIP-сервере.
UPGCOND	Устаревшее имя макроса.
SCHEME	Схема доступа к файлам (TFTP, HTTP или HTTPS), полученная после анализа URL-адреса повторной синхронизации или обновления.
SERV	Запросите имя хоста целевого сервера, полученное после анализа URL-адреса, повторной синхронизации или обновления.
SERVIP	Запросите IP-адрес целевого сервера, полученный после анализа URL-адреса повторной синхронизации или обновления, возможно, после поиска в DNS.
PORT	Запросите целевой порт UDP/TCP, полученный после анализа URL-адреса, повторной синхронизации или обновления.
PATH	Запросите путь к целевому файлу, полученный после анализа URL-адреса, повторной синхронизации или обновления.
ERR	Сообщение о результате повторной синхронизации или попытки обновления. Полезно только при генерации сообщений системного журнала результатов. В случае попыток обновления это значение сохраняется в переменной UPGERR.
UIDn	Содержимое конфигурационного параметра Line n UserId.
ISCUST	Если единица измерения настроена, значение = 1, в противном случае 0. Состояние настройки можно посмотреть на странице «Информация о веб-интерфейсе».
INCOMINGNAME	Имя, связанное с первым подключенным, звонящим или входящим звонком.
REMOTENUMBER	Номер телефона первого подключенного, звонящего или входящего вызова. Если вызовов несколько, предоставляются данные, связанные с первым обнаруженным вызовом.
DisplayName	Содержимое параметра конфигурации «Отображаемое имя строки N».
AuthIDN	Содержимое конфигурационного параметра Line N auth ID.

Cisco AI Assistant

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