Конфигурирайте бутона Action за 9800 (Unified CM)

Персонализирайте бутона Action

Персонализираните опции за бутона Action на Cisco Desk Phone 9800 Series изискват специфична поддръжка на фърмуера на PhoneOS. Вижте следната таблица за подробности:

Функция	Задължителна фърмуер версия
Спешно повикване	PhoneOS 3.0.1 и по-нови версии
Персонализирана служба	PhoneOS 3.2.1 и по-нови версии
Множество тригери	PhoneOS 3.3.1 и по-нови версии
HTTP POST	PhoneOS 3.3.1 и по-нови версии
Множество събития на един тригер	PhoneOS 3.4.1 и по-нови версии

1	Влезте в Cisco Unified Communications Manager Administration.
2	Направете едно от следните действия при нужда: За да конфигурирате всички разположени телефони, отидете в System > Enterprise Phone Configuration. За да конфигурирате телефони с един и същ профил, отидете в Device > Device Settings > Common Phone Profile. За да конфигурирате отделен телефон, отидете в Device > Phone. След това намери телефона си и отвори страницата за конфигурация на телефона. Конфигурацията следва йерархична структура: Индивидуалните настройки на устройството имат предимство пред настройките в общия профил на телефона и на корпоративно ниво Обичайните настройки на профила на телефона превземат корпоративните настройки
3	Персонализирайте настройките на бутона Action със следните параметри според вашите случаи. Има три групи параметри за бутона Действие, всеки от които съответства на услуга с уникален тригер. Ако тригер за услуга е зададен в няколко групи, настройките в Група 1 имат приоритет пред тези в Група 2 и 3, докато Група 2 има приоритет пред Група 3. Спешни обаждания Конфигурирайте следните параметри: Функция на бутона за действие: Изберете спешно повикване. Дестинация за обслужване на бутон за действие: Въведете телефонния номер или URI на спешната служба. Име на услугата за бутон за действие (по желание): Задайте име за услугата, свързана с тригера за действие. Това име ще се покаже в съобщението на екрана, когато потребителят натисне бутона, което показва кое събитие ще бъде инициирано. Ако не е посочено име, спешното обаждане ще се използва като дисплейно име. Забавяне при изходяне на набирането: Задайте таймаут (в секунди), за да инициира телефонът на спешно обаждане след засичане на тригера. Стойността по подразбиране е 5 секунди. Ако е зададено на 0, обаждането се извършва веднага след откриване на тригера. Сервизен тригер Изберете тригер от списъка: Едно натискане, Дълго натискане или Натискане 3 пъти. Тихо спешно обаждане (по желание): По подразбиране спешното обаждане функционира като двупосочно обаждане, подобно на другите изходящи обаждания. Когато безшумното спешно обаждане е активирано, аудиото е безшумно от страна на обаждащия се, за да се избегне привличане на внимание по време на текущото обаждане. Само получателят на обаждането може да прекрати тихото спешно обаждане. По време на безшумен спешен разговор екранът на телефони 9811 и 9841 замръзва, докато екранът на телефони 9851, 9861 и 9871 ще бъде изключен. Всички други функции са недостъпни. Телефонът възстановява нормалната работа след като получателят приключи разговора. Позволете Silent Emergency Call Retrieval (по желание): Активирайте тази функция, ако позволите на потребителите да натискат който и да е клавиш, за да възстановят нормалната работа на телефона, докато поддържат спешното обаждане. Аудиото на разговора остава безшумно, освен ако потребителят не увеличи силата на звука с клавиша Volume клавиш. Персонализирани услуги Конфигурирайте следните параметри: Функция на бутона за действие: Изберете Персонализирано. Бутон за действие Дестинация на услугата: Въведете URL адреса на персонализираната услуга. URL адресът трябва да започва с http:// или https://, например `https://10.11.20.159/path/service.xml` . Име на услугата за бутон за действие (по желание): Задайте име за услугата, свързана с тригера. Това име ще се покаже в съобщението на екрана, когато потребителят натисне бутона, което показва коя услуга ще бъде активирана. Когато не е посочено име, Custom Service ще се използва като показващо име. Персонализирано поле за съдържание (по избор): Ако искате да активирате телефона да изпраща HTTP POST заявка при натискане на бутона Действие, въведете HTTP данни като метод, хедер и POST съдържание, с максимална дължина 1024 знака. За примери за POST скрипт и синтаксиса вижте HTTP POST заявка за бутона Действие. Забавяне при набиране на изхода: Задайте периода на таймаут, в секунди, за да може телефонът да инициира събитие след откриване на тригера. Стойността по подразбиране е 5 секунди. Когато е настроено на 0, събитието се инициира веднага след откриване на тригера. Сервизен тригер Изберете тригер от списъка: Едно натискане, Дълго натискане или Натискане 3 пъти. Service Secret (Optional): Въведете тайната за удостоверяване, токена или паролата, ако вашата персонализирана услуга изисква удостоверяване за достъп. Въведената тайна се показва като маскиран низ и може да бъде реферирана чрез макроса `$SS` в полето за персонализирано съдържание и дестинация на Action Button Service Destination. Множество тригери Задайте параметрите във всяка група съответно. Вижте секциите за спешни обаждания и персонализирани услуги по-горе. Един тригер за множество събития Конфигурирайте следните параметри, за да присвояват множество събития на тригер: Функция на бутона за действие: Изберете Персонализирано. Дестинация на услуга за бутон за действие: Въведете телефонния номер за обаждане и URL адреса XML услуга в този формат: `тел:<телефонен номер или SIP URI> + <serviceURL>` URL адресът трябва да започва с `http://` или `https://`. Пример: `тел:1234 + https://10.11.20.159/path/service.xml` Име на услугата за бутон за действие (по желание): Задайте име за услугата, свързана с тригера. Това име ще се покаже в съобщението на екрана, когато потребителят натисне бутона, което показва коя услуга ще бъде активирана. Когато не е посочено име, Custom Service ще се използва като показващо име. Персонализирано поле за съдържание (по избор): Ако искате да активирате телефона да изпраща HTTP POST заявка при натискане на бутона Действие, въведете HTTP данни като метод, хедер и POST съдържание, с максимална дължина 1024 знака. За примери за POST скрипт и синтаксиса вижте HTTP POST заявка за бутона Действие. Забавяне при набиране на изхода: Задайте периода на таймаут, в секунди, за да може телефонът да инициира събитие след откриване на тригера. Стойността по подразбиране е 5 секунди. Когато е настроено на 0, събитието се инициира веднага след откриване на тригера. Сервизен тригер Изберете тригер от списъка: Едно натискане, Дълго натискане или Натискане 3 пъти. Service Secret (Optional): Въведете тайната за удостоверяване, токена или паролата, ако вашата персонализирана услуга изисква удостоверяване за достъп. Въведената тайна се показва като маскиран низ и може да бъде реферирана чрез макроса `$SS` в полето за персонализирано съдържание и дестинация на Action Button Service Destination. Тихо спешно обаждане (по избор): Ако сте включили телефонен номер или набирате URI в дестинацията на услугата, активирането на тази функция ще заглуши спешните обаждания. По подразбиране спешното обаждане функционира като двупосочно обаждане, подобно на другите изходящи обаждания. Когато е настроено да е включено, аудиото е тихо от страна на обаждащия се, за да се избегне привличане на внимание по време на повикването. Само получателят на обаждането може да прекрати разговора. По време на безшумен спешен разговор екранът на телефони 9811 и 9841 замръзва, докато екранът на телефони 9851, 9861 и 9871 ще бъде изключен. Всички други функции са недостъпни. Телефонът възстановява нормалната работа след като получателят приключи разговора. Позволете Silent Emergency Call Retrieval (по желание): Активирайте тази функция, ако позволите на потребителите да натискат който и да е клавиш, за да възстановят нормалната работа на телефона, докато поддържат спешното обаждане. Аудиото на разговора остава безшумно, освен ако потребителят не увеличи силата на звука с клавиша Volume клавиш. За повече информация относно тези параметри вижте Параметри за бутона Действие.
4	Изберете Запиши.
5	Изберете Прилагане на конфигурацията.

Препратки

Параметри за бутона Action

Параметрите са налични в Enterprise Phone Configuration, Common Phone Profile и индивидуална конфигурация на телефона.

Таблица 1. Параметри за бутона Action
Parameter	По подразбиране и опции	Описание
Функция на бутона за действие 1~3	По подразбиране: Изкл. Опции: Изключено, Спешно обаждане, Персонализирано	Можеш да конфигурираш бутона с конкретна услуга. Изключено: Когато е настроено на Изключено, бутонът Action за единична услуга на телефона не работи. Спешно обаждане: Потребителите могат да използват бутона Действие, за да осъществят спешно обаждане, ако е конфигурирано. Custom: Потребителите могат да използват бутона Action, за да достъпят персонализираната услуга, ако е конфигурирана. Когато зададете полето на Emergency Call или Custom, уверете се, че въвеждате дестинацията на услугата в полето Action Button Service Destination . Или телефонът ще покаже грешка в конфигурацията.
Име на услуга за бутон за действие 1~3	По подразбиране: празно	По желание да се посочи име за услугата, свързана с бутона Действие. Това име ще се покаже в съобщението на екрана, когато потребителят натисне бутона, което показва коя услуга ще бъде активирана. Ако не посочите име, по подразбиране името ще бъде Спешно обаждане, Тихо спешно обаждане или Персонализирано действие според избора ви в полето Action Button Function .
Дестинация за обслужване на бутон за действие 1~3	По подразбиране: празно	Предайте дестинацията на услугата в един от следните формати, базирани на услугата, назначена на бутона Действие: За спешни повиквания въведете телефонен номер или URI на спешна служба. Когато конфигурирате бутона за персонализирана услуга, въведете URL адреса на услугата. URL адресът трябва да започва с `http://` или `https://`. Например, `https://10.11.20.159/path/service.xml`. За да конфигурирате бутона да инициира множество събития с един тригер, въведете `tel:<phonenumber или SIP URL> + <Service RUL`>. Пример: `тел:1234 + https://10.11.20.159/path/service.xml`. Поддържа се и повикване на SIP URI. Влиза URI във формата `на тел: SIP 4567@co.webex.com` Ако активирате бутона Action без да зададете валидна дестинация на услугата, потребителят на телефона ще види съобщение за конфигурация. След като потребителят затвори това известие, иконата за предупреждение остава в заглавието на екрана на телефона, докато бутонът не бъде правилно конфигуриран или деактивиран. Телефонните номера не могат да се използват като дестинации за персонализирани услуги. Ако конфигурирате бутона за действие като Custom и въведете телефонен номер като дестинация на услугата, на телефона ще се появи известие, което показва, че бутонът не е конфигуриран. Вместо това можете да добавите телефонен номер в този формат `тел:<телефонен номер>` например `тел: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	По подразбиране: празно	Тази настройка работи само когато функцията на бутона за действие е настроена на Custom. Въведете HTTP данни като метод, хедър и POST съдържание, с максимална дължина 1024 знака. Когато е конфигуриран, телефонът изпраща HTTP POST заявка при натискане на действието. Ако услугата изисква удостоверяване за достъп, уверете се, че сте въвели тайната на автентикацията в полето Service Secret . В HTTP данните използвайте макроса `$SS` като препратка към Service Secret. За примери и синтаксиса вижте HTTP POST заявка за бутона Действие.
Service Secret 1~3	По подразбиране: празно	Тайната на услугата може да бъде тайна за автентикация, токен или парола. Въведената тайна се показва като маскиран низ и може да бъде реферирана чрез макроса `$SS` в полето за персонализирано съдържание и дестинация на Action Button Service Destination.
Тригер за обслужване 1~3	По подразбиране: Single Press Опции: Единично натискане, Дълго натискане, Натискане 3 пъти	Изберете как потребителите могат да осъществят спешно обаждане или да стартират персонализирана услуга чрез бутона Action на телефона. Едно натискане: Натиснете бутона Действие, за да задействате свързаното обаждане или услуга. Дълго натискане: Натиснете бутона Action поне за 2 секунди, за да задействате свързаното обаждане или услуга. Натиснете 3 пъти: Натиснете бутона Действие три пъти с интервали по-малко от 2 секунди между всяко натискане, за да задействате съответния разговор или услуга. Не повтаряйте тригер между няколко услуги, тъй като параметрите с по-нисък приоритет няма да работят. Приоритетният ред, от най-висок към най-нисък, е следният: Група 1, Група 2, Група 3.
Забавяне при излизане 1~3	По подразбиране: 5 Опции: 0 - 30	Задайте периода за тайм-аут в секунди, за да може телефонът да инициира спешно обаждане или персонализирано действие след натискане на бутона Действие. Настройте го на 0, ако предпочитате телефонът да осъществи обаждане или да инициира събитие веднага след засичане на тригера, както е посочено с едно натискане, дълго или тройно натискане на бутона.
Тихо спешно обаждане 1~3	По подразбиране: Деактивирано Опции: Активирано, Изключено	Безшумното спешно повикване е предназначено за дискретна помощ в опасни ситуации. Тя позволява на потребителите да търсят помощ без да издават шум. Когато са активирани, потребителите могат да осъществяват еднопосочни обаждания с бутона Действие. След като безмълвното спешно обаждане бъде отправено, само другата страна може да прекрати разговора. За да се избегне привличане на внимание по време на текущото обаждане, екранът на телефон 9811 и 9841 ще замръзне, докато екранът на телефон 9851, 9861 и 9871 ще бъде изключен. Телефонът заключва всички функции по време на тихо спешно обаждане, по подразбиране. За да позволите на потребителите да възстановят нормалната работа на телефона, като същевременно поддържат тихото спешно обаждане, активирайте функцията Allow Silent Emergency Call Retrieval . Когато е изключен, спешното обаждане функционира като двупосочно обаждане, подобно на другите изходящи обаждания.
Позволете безшумно извличане на спешни обаждания	По подразбиране: Не Опции: Да, Не	Контролира дали потребителите могат да възстановят функционалността на телефона по време на тихо спешно обаждане. По подразбиране, след като се инициира тихо спешно обаждане, телефонът заключва всички функции, докато получателят на обаждането прекрати разговора. Когато този параметър е зададен на Да, потребителите могат да натиснат всеки клавиш, за да възстановят нормалната работа на телефона, като същевременно поддържат спешното обаждане. Аудиото на разговора остава безшумно, освен ако потребителят не увеличи силата на звука с клавиша Volume клавиш.

HTTP POST заявка за бутона Действие

Бутонът Action на Cisco Desk Phone 9800 Series може да бъде конфигуриран да задейства XML приложения чрез HTTP POST заявки.

В полето за персонализирано съдържание въведете вашия персонализиран скрипт за заявка. Можете да зададете XML или JSON тип съдържание и да включите макроси в заявката. Например, $SSможе да бъде добавен към скрипта, за да се получи тайната за автентикация, токена или паролата, предоставена в полето Service Secret .

Следните примери са в XML и JSON:

Пример #1: XML --метод POST --header 'Content-Type: application/XML' --header 'Authorization: Bearer username:$SS' --body '<MetaData><Trigger>True</Trigger><Description>This е за HTTP POST XML</Description></MetaData>' Пример #2: JSON --method POST --header 'Content-Type: application/json' --header 'Authorization: $SS' --body '{"events": [{"evtid":"12345", "parameters": {"trigger":true}, "Description":"Това е за 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%3eТова е за HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27

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

Cisco AI Assistant

Благодарим за обратната връзка.

Конфигурирайте бутона Action за 9800 (Unified CM)

Персонализирайте бутона Action

Препратки

Параметри за бутона Action

HTTP POST заявка за бутона Действие

Малък бизнес

Предприятие

Устройства

Решения за

Ресурси

Фирма