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

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

Персонализираните опции за бутона Action на Cisco Desk Phone 9800 Series изискват специфична поддръжка на фърмуера на 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. Спешни повиквания Конфигурирайте следните параметри: Ф@@ ункция на бутона за действие: Изберете спешно повик ване. Дестина@@ ция за обслужване на бутона за действие: Въведете телефон ния номер или URI на спешната служба. Име на услу@@ гата за бутон за действие (по избор): Посочете име на услугата, свързана с тригера на действието. Това име ще се покаже в екранното съобщение, когато потребителят натисне бутона, което показва кое събитие ще бъде инициирано. Ако не е посочено име, като показано име ще се използва спешно пови кване. Забавяне на набирането: Задайте периода на изтичане (в секунди), за да може телефонът да започне спешно повикване след откриване на спусъка. Стойността по подразбиране е 5 секунди. Ако е зададено на 0, повикването се извършва веднага след откриване на спу съка. Сервизен тригер Изберете тригер от списъка: Еднократно натиск ане, продълж ително нат искане или натискане 3 пъти. Безшумно спешно пови кване (по избор): По подразбиране спешното повикване функционира като двупосочно повикване, подобно на други изходящи повиквания. Когато е активирано безшумно спешно повикване, звукът е безшумен от страната на повикващия, за да се избегне привличането на вниманието по време на повикването. Само получателят на повикването може да прекрати безшумното спешно повикване. По време на безшумно спешно повикване екранът на телефони 9811 и 9841 ще замръзне, докато екранът на телефони 9851, 9861 и 9871 ще бъде изключен. Всички останали функции са недостъпни. Телефонът възстановява нормалната работа, след като получател ят прекрати разговора. Разрешаване на безшумно извличане на спешни пови квания (по избор): Активирайте тази функция, ако позволите на потребителите да натискат който и да е клавиш, за да възстановят нормалната работа на телефона, като същевременно поддържат спешното повикване Аудиото на повикването остава безшумно, освен ако потребителят не увеличи силата на звука с помощта на клавиша за сила на звука. Персонализирани услуги Конфигурирайте следните параметри: Ф@@ ункция на бутона за действие: Изберете Пер сонализи рано. Дестинация на услугата за бутон за действие: Въведете URL адреса на персонализираната услуга. URL адресът трябва да започва с `http://`или `https://`, например, `https://10.11.20.159/path/service.xml`. Име на услу@@ гата на бутона за действие (по избор): Посочете име на услугата, свързана със спусъка. Това име ще се покаже в екранното съобщение, когато потребителят натисне бутона, което показва коя услуга ще бъде задействана. Когато не е посочено име, персон ализираната услуга ще се използва като показвано име. Поле за персонализирано съдържание (по избор): Ако искате да активирате телефона да изпраща заявка за HTTP пост при натискане на бутона Действие, въведете HTTP данни като метод, заглавка и съдържание на публикация, с максимална дължина 1024 знака. За примери за POST скриптове и синтаксиса виж те HTTP Post заявка за бутона Действие. Забавяне на набирането: Задайте пери ода на изтичане в секунди, за да може телефонът да инициира събитие след откриване на спусъка. Стойността по подразбиране е 5 секунди. Когато е зададено на 0, събитието се инициира веднага след откриването на спусъка. Сервизен тригер Изберете тригер от списъка: Еднократно натиск ане, продълж ително нат искане или натискане 3 пъти. Сервиз на тай на (по избор): Въведете тайната за удостоверяване, токен или парола, ако вашата персонализирана услуга изисква удостоверяване, за да получите достъп до нея. Въведената тайна се показва като маскиран низ и може да се препраща с помощта на макроса `$SS`в полето за персонализирано съдържание и дестинация за обслуж ване на бутона за действие. Множество тригери Задайте параметрите във всяка група съответно. Вижте разделите Спешни повиквания и Персонализирани услуги по-горе. Един тригер за множество събития Конфигурирайте следните параметри, за да зададете множество събития на тригер: Ф@@ ункция на бутона за действие: Изберете Пер сонализи рано. Дестинация за обслужване на бутона за действие: Въведете телефонния номер, за да се обадите, и URL адреса на услугата XML в този формат: `tel:<phonenumber or SIP URI> + <serviceURL>` URL адресът трябва да започва с `http://`или `https://`. Пример: `tel:1234 + https://10.11.20.159/path/service.xml` Име на услу@@ гата на бутона за действие (по избор): Посочете име на услугата, свързана със спусъка. Това име ще се покаже в екранното съобщение, когато потребителят натисне бутона, което показва коя услуга ще бъде задействана. Когато не е посочено име, персон ализираната услуга ще се използва като показвано име. Поле за персонализирано съдържание (по избор): Ако искате да активирате телефона да изпраща заявка за HTTP пост при натискане на бутона Действие, въведете HTTP данни като метод, заглавка и съдържание на публикация, с максимална дължина 1024 знака. За примери за POST скриптове и синтаксиса виж те HTTP Post заявка за бутона Действие. Забавяне на набирането: Задайте пери ода на изтичане в секунди, за да може телефонът да инициира събитие след откриване на спусъка. Стойността по подразбиране е 5 секунди. Когато е зададено на 0, събитието се инициира веднага след откриването на спусъка. Сервизен тригер Изберете тригер от списъка: Еднократно натиск ане, продълж ително нат искане или натискане 3 пъти. Сервиз на тай на (по избор): Въведете тайната за удостоверяване, токен или парола, ако вашата персонализирана услуга изисква удостоверяване, за да получите достъп до нея. Въведената тайна се показва като маскиран низ и може да се препраща с помощта на макроса `$SS`в полето за персонализирано съдържание и дестинация за обслуж ване на бутона за действие. Безшумно спешно пови кване (по избор): Ако сте включили телефонен номер или URI за набиране в дестинацията за обслужване, активирането на тази функция ще заглуши спешните повиквания. По подразбиране спешното повикване функционира като двупосочно повикване, подобно на други из ходящи повиквания. Когато е настроено на активирано, звукът е безшумен от страната на повикващия, за да избегне привличането на вниманието по време на провеждането на повикване. Само получателят на повикването може да прекрати разговора. По време на безшумно спешно повикване екранът на телефони 9811 и 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`. За да конфигурирате бутона за иницииране на множество събития с един тригер, въведете `tel:<phonenumber or SIP URL> + <Service RUL>`. Прим ер: `tel:1234 + https://10.11.20.159/path/service.xml`. Извикването на SIP URI също се поддържа. Въведете URI във формат на `tel: sip 4567@co.webex.com` Ако активирате бутона Действие, без да задавате валидна дестинация на услу гата, потребителят на телефона ще види съобщение, подканващо за конфигуриране. След като потребителят затвори това известие, иконата за предупреждение ще продължи в заглавката на екрана на телефона, докато бутонът не бъде правилно конфигуриран или деактивиран. Телефонните номера не могат да се използват като дестинации за персонализирани услуги. Ако конфигурирате бутона за действие като персон ализи ран и въведете телефонен номер като дестинация на услугата, на телефона ще се покаже предупредително съобщение, показващо, че бутонът не е конфигуриран. Вместо това можете да добавите телефонен номер в този формат `tel:<phone number>`, например `tel:1234`. Ако нямате право да въвеждате URL адрес, включващ ampersand (&), използвай% 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`като препратка към Service Secret. За примери и синтаксиса вижте HTTP Post заявка за бу тона Действие.
Сервизна тайна 1 ~ 3	По подразбиране: Празно	Сервизната тайна може да бъде тайна за удостоверяване, токен или парола. Въведената тайна се показва като маскиран низ и може да се препраща с помощта на макроса `$SS`в полето за персонализирано съдържание и дестинация за обслуж ване на бутона за действие.
Сервизен тригер 1 ~ 3	По подразбиране: Едно натискане Опции: Еднократно натискане, Дълго натискане, Натиснете 3 пъти	Изберете как потребителите могат да направят спешно повикване или да инициират персонализирана услуга с помощта на бутона за действие на телефона. Еднократно натискане: Натиснете бутона Действие, за да задействате свързаното повикване или услуга. Дълго натискане: Натиснете бутона за действие надолу за поне 2 секунди, за да задействате свързаното повикване или услуга. Натиснете 3 пъти: Натиснете бутона за действие три пъти с интервали по-малко от 2 секунди между всяко натискане, за да задействате свързаното повикване или услуга. Не повтаряйте спусъка в множество услуги, тъй като параметрите с по-нисък приоритет няма да функционират. Редът на приоритетите, от най-висок до най-нисък, е следният: Група 1, Група 2, Група 3.
Забавяне на набирането 1 ~ 3	По подразбиране: 5 Опции: 0 - 30	Задайте периода на изтичане в секунди, за да може телефонът да инициира спешно повикване или персонализирано действие след натискане на бутона Действие. Задайте го на 0, ако предпочитате телефонът да осъществи повикването или да инициира събитие веднага след откриване на спусъка, както е посочено с едно натискане, дълго натискане или тройно натискане на бутона.
Безшумно спешно повикване 1 ~ 3	По подразбиране: Деактивирано Опции: Активирано, Деактивирано	Безшумното спешно повикване е предназначено за дискретна помощ в опасни ситуации. Тя дава възможност на потребителите да потърсят помощ, без да вдигат шум. Когато е активирано, потребителите могат да извършват еднопосочни повиквания с бутона Действие. След като бъде направено безшумното спешно повикване, само другата страна може да прекрати повикването. За да избегнете привличането на вниманието по време на текущото обаждане, екранът на телефони 9811 и 9841 ще замръзне, докато екран ът на телефони 9851, 9861 и 9871 ще бъде изключен. Телефонът заключва всички функции по време на безшумно спешно повикване по подразбиране. За да позволите на потребителите да възстановят нормалната работа на телефона, като същевременно поддържат безшумното спешно повикване, активирайте функцията Разрешаване на безшумно извличане на спешни повик вания. Когато е деактивирано, спешното повикване функционира като двупосочно повикване, подобно на други изходящи повиквания.
Разрешаване на безшумно изтегляне на спешни повиквания	По подразбиране: Не Опции: Да, Не	Контролира дали потребителите могат да изтеглят функционалността на телефона по време на безшумно спешно повикване. По подразбиране, след като бъде инициирано безшумно спешно повикване, телефонът за ключва всички функции, докато получателят на повикването приключи повикването. Когато този параметър е зададен на Да, потребителите могат да натиснат всеки клавиш, за да възстановят нормалната работа на телефона, като същевременно поддържат спешното повикване. Аудиото на повикването остава безшумно, освен ако потребителят не увеличи силата на звука с помощта на клавиша за сила на звука.

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

Бутонът за действие на Cisco Desk Phone 9800 Series може да бъде конфигуриран да задейства 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

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

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

Референции

Параметри за бутона Действие

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

Малък бизнес

Предприятие

Устройства

Решения за

Ресурси

Фирма