Налаштування кнопки дії для 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	Налаштуйте налаштування кнопки дії за допомогою наступних параметрів на основі ваших випадків використання. Для кнопки Action передбачено три групи параметрів, кожна з яких відповідає службі з унікальним тригером. Якщо тригер служби вказано у кількох групах, налаштування Групи 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 Post під час натискання кнопки Дія, введіть дані HTTP, такі як метод, заголовок та вміст публікації, максимальною довжиною 1024 символів. Приклади сценаріїв POST та синтаксис див. у розділі Запит HTTP Post для кноп ки Дія. Затримка набору номера: Встанов іть період тайм-ауту в секундах, щоб телефон ініціював подію після виявлення тригера. Значення за замовч уванням - 5 секунд. Якщо встановлено значення 0, подія ініціюється одразу після виявлення тригера. Сервісний три гер Виберіть тригер зі списку: Одне натиск ання, Дов ге нати скання або Натискання 3 рази. Службовий секрет (необов'язково): введіть секре т автентифікації, маркер або пароль, якщо ваша спеціальна служба вимагає ав тентифікації для доступу до неї. Введений секрет відображається у вигляді маскованого рядка, і на нього можна посилатися за допомогою макросу `$SS`у розділі Вла сне поле вмісту та пункт призначення служби кнопки дій. Кілька тригерів Встановіть параметри в кожній групі відповідно. Див. Роз діли Екстрені виклики та Спеціальні послуги вище. Один тригер для декількох подій Налаштуйте наступні параметри, щоб призначити кілька подій тригеру: Функція кнопки дії: Виберіть Користувальниць кий. Кнопка дії пункт призначення служби: Введіть номер телефону для дзвінка та URL-адресу служби XML у такому форматі: `tel:<phonenumber or SIP URI> + <serviceURL>` Адреса повинна починатися з `http://`або `https://`. Приклад: `tel:1234 + https://10.11.20.159/path/service.xml` Назва служби кноп ки дій (необов'язково): вкажіть назву служби, пов'язаної з тригером. Це ім'я буде відображатися в екранному повідомленні при натисканні користувачем кнопки, що вказує, яка послуга буде спрацьовувати. Якщо ім'я не вказано, як відоб раж уван е ім'я використовуватиметься спеціальна служба. Поле спеціального вмісту (необов'язково). Якщо ви хочете дозволити телефону надсилати запит HTTP Post під час натискання кнопки Дія, введіть дані HTTP, такі як метод, заголовок та вміст публікації, максимальною довжиною 1024 символів. Приклади сценаріїв POST та синтаксис див. у розділі Запит HTTP Post для кноп ки Дія. Затримка набору номера: Встанов іть період тайм-ауту в секундах, щоб телефон ініціював подію після виявлення тригера. Значення за замовч уванням - 5 секунд. Якщо встановлено значення 0, подія ініціюється одразу після виявлення тригера. Сервісний три гер Виберіть тригер зі списку: Одне натиск ання, Дов ге нати скання або Натискання 3 рази. Службовий секрет (необов'язково): введіть секре т автентифікації, маркер або пароль, якщо ваша спеціальна служба вимагає ав тентифікації для доступу до неї. Введений секрет відображається у вигляді маскованого рядка, і на нього можна посилатися за допомогою макросу `$SS`у розділі Вла сне поле вмісту та пункт призначення служби кнопки дій. Тихий екстрений дзві нок (необов'язково): Якщо ви включили номер телефону або URI набору в пункт призначення служби, увімкнення цієї функції призведе до відключення екстрен их викликів. За замовчуванням екстрений виклик функціонує як двосторонній дзвінок, подібно до інших вихідних дзвінків. Якщо встановлено значення увімкнено, звук тихо на стороні абонента, щоб уникнути привернення уваги під час постійного дзвінка. Завершити дзвінок може тільки одержува ч дзвінка. Під час безшумного екстреного виклику екран на телефоні 9811 і 9841 зависне, тоді як екран на телефоні 9851, 9861 і 9871 буде вимкнений. Всі інші функції недоступні. Телефон відновлює нормальну роботу після того, як одержува ч закінчить дзвінок. Дозволити ти хий пошук екстрених викликів (необов'язково): увімкніть цю функцію, якщо ви дозво ляєте користувачам натиснути будь-яку клавішу, щоб відновити нормальну роботу телефону, зберігаючи екст рений виклик. Звук дзвінка залишається беззвучним, якщо користувач не збільшить гу чність динаміка за допомогою клавіші гучності. Докладніші відомості про ці параметри див. у розділі Параметри кнопки Дія.
4	Виберіть Збере гти.
5	Виберіть За стосувати конфігура цію.

Посилання

Параметри кнопки «Дія»

Параметри доступні в конфігурації корпоративного телефону, загальному профілі телефону та індивідуальній конфігурації телефону.

Таблиця 1. Параметри для кнопки Action
Параметр	За замовчуванням і параметри	Опис
Функція кнопки дії 1 ~ 3	Типове значення: Вимкнено Параметри: вимкнено, екстрений виклик, користувальницький	Налаштувати кнопку можна за допомогою певної служби. Вимк нено: якщо встановлено значення Вимкнено, кнопка дії для однієї служби на телефоні не працюватиме. Екстрений виклик: Користувачі можуть використовувати кнопку «Дія» для здійснення екстреного виклику, якщо налаштовано. Користуваль ницькі: Користувачі можуть використовувати кнопку Дія для доступу до корист увальницької служби, якщо налаштовано. Коли ви встановите для поля «Екст рений виклик» або «Корист увальницький», переконайтеся, що ви ввели пункт призначення послуги в по лі Кнопка дій пункт призначення служби. Або телефон відобразить помилку конфігурації.
Назва служби кнопки дій 1 ~ 3	За замовчуванням: Порожній	За бажанням вкажіть назву служби, пов'язаної з кнопкою «Дія». Це ім'я буде відображатися в екранному повідомленні при натисканні користувачем кнопки, що вказує, яка послуга буде спрацьовувати. Якщо ви не вкажете ім'я, ім'я за замовчуванням буде «Екстрений виклик», «Тихий екстрений виклик» або «Спеціальна дія» на основі вашого вибору в по лі Функція кноп ки дій.
Кнопка дії Кнопка призначення служби 1 ~ 3	За замовчуванням: Порожній	Надайте пункт призначення послуги в одному з наступних форматів на основі служби, призначеної кнопці Дія: Для служб екстреного виклику введіть номер телефону або URI служби екст реної допомоги. При налаштуванні кнопки для користувальницької служби введіть 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-адресу, включаючи амперсанд (&), використовуйте %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 при натисканні дії. Якщо служба вимагає ау тентифікації для доступу, обов'язково введіть секрет аутентифікації в поле Службовий секрет. У даних HTTP використовуйте макрос `$SS`як посилання на Службу секрету. Приклади та синтаксис див. у розділі Запит 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 Post для кнопки дії

Кнопку дії на Cisco Desk Phone 9800 Series можна налаштувати для запуску XML-додатків за допомогою запитів HTTP Post.

У по лі користувальниць кого вмісту введіть власний скрипт запиту. Ви можете вказати тип вмісту XML або JSON та включити макроси в запит. Наприклад, $SSможе бути додано до скрипту для отримання секрету автентифікації, токен або пароль, наданих у полі Службова секре та.

Наступні приклади наведені в 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#	Назва пристрою, що відображається в системі виклику. Наприклад, СЕП845А3ЕЦ 21288
$SS	Службовий секрет, який представляє маскований рядок на сторінці конфігурації телефону, такий як секрет аутентифікації, маркер або пароль.

Cisco AI Assistant

Дякуємо за відгук.