У цій статті
Налаштуйте кнопку Action
dropdown icon
Посилання
    Параметри для кнопки Action
    HTTP POST запит кнопки Action

Налаштувати кнопку Action для 9800 (Unified CM)

list-menuУ цій статті
list-menuНадіслати відгук?

Кнопка Action — це червона кнопка, розташована у верхньому правому куті телефону. Він дозволяє користувачам швидко отримувати доступ до призначених сервісів, таких як екстрені або кастомні послуги. Ви можете налаштувати кнопку, щоб запускати події, які відповідають вашим конкретним сценаріям. Інформація на цій сторінці стосується Cisco Desk Phone Series 9800, зареєстрованого за номером Cisco Unified Communications Manager (Unified CM).

Налаштуйте кнопку Action

Власні налаштування кнопки Action на Cisco Desk Phone 9800 Series вимагають спеціальної підтримки прошивки PhoneOS. Детальніше дивіться у наступній таблиці:

ФункціяПотрібна версія прошивки
Екстрений викликPhoneOS 3.0.1 та новіші версії
Індивідуальна службаPhoneOS 3.2.1 та новіші версії
Множинні тригериPhoneOS 3.3.1 та пізніші версії
HTTP POSTPhoneOS 3.3.1 та пізніші версії
Кілька подій на одному тригеріPhoneOS 3.4.1 та новіші версії
1

Увійдіть у Cisco Unified Communications Manager Administration.

2

Виконайте одну з наступних дій за потреби:

  • Щоб налаштувати всі розгорнуті телефони, перейдіть до System > Enterprise Phone Configuration.
  • Щоб налаштувати телефони з однаковим профілем, перейдіть у розділ Налаштування > пристрою > Загальний профіль телефону.
  • Щоб налаштувати окремий телефон, перейдіть у розділ Device > Phone. Потім знайдіть свій телефон і відкрийте сторінку конфігурації телефону.

Конфігурація має ієрархічну структуру:

  • Індивідуальні налаштування пристрою мають пріоритет над налаштуваннями у загальному профілі телефону та на корпоративному рівні
  • Загальні налаштування профілю телефону змінюють корпоративні налаштування

3

Налаштуйте налаштування кнопки Action з такими параметрами відповідно до ваших сценаріїв використання.

Існує три групи параметрів для кнопки Action, кожна з яких відповідає сервісу з унікальним тригером. Якщо тригер сервісу вказаний у кількох групах, налаштування Групи 1 мають пріоритет над налаштуваннями Групи 2 і 3, а Група 2 — над Групою 3.

  • Екстрені виклики

    Налаштуйте такі параметри:

    • Функція кнопки дії: виберіть екстрений виклик.

    • Кнопка дії Пункт призначення обслуговування: Введіть номер телефону або URI екстреної служби.

    • Ім'я сервісу кнопки дії (необов'язково): Вкажіть ім'я сервісу, пов'язаного з тригером дії. Це ім'я відображається у повідомленні на екрані, коли користувач натискає кнопку, вказуючи, яка подія буде ініційована. Якщо ім'я не вказано, екстрений виклик буде використано як відображену назву.

    • Затримка виходу: Встановіть період тайм-ауту (у секундах) для ініціювання екстреного дзвінка телефоном після виявлення тригера. Значення за замовчуванням: 5 секунд. Якщо встановлено 0, виклик здійснюється одразу після виявлення тригера.

    • Сервісний тригер Виберіть тригер зі списку: Single Press, Long Press або Press 3 Times.

    • Тихий екстрений дзвінок (необов'язковий): за замовчуванням екстрений дзвінок виконується як двосторонній дзвінок, подібно до інших вихідних. Коли увімкнено беззвучний екстрений виклик, аудіо з боку абонента залишається беззвучним, щоб уникнути уваги під час подальшого дзвінка. Лише отримувач дзвінка може завершити безмовний екстрений виклик.

      Під час беззвучного екстреного виклику екран телефонів 9811 і 9841 зависає, а екран телефонів 9851, 9861 і 9871 вимикається. Всі інші функції недоступні. Телефон відновлює нормальну роботу після завершення дзвінка.

    • Дозволити беззвучне отримання екстреного дзвінка (опціонально): Увімкніть цю функцію, якщо ви дозволяєте користувачам натискати будь-яку клавішу для відновлення нормальної роботи телефону при збереженні екстреного дзвінка. Аудіо виклику залишається беззвучним, якщо користувач не збільшує гучність динаміка за допомогою клавіші Volume (гучність).

  • Індивідуальні послуги

    Налаштуйте такі параметри:

    • Функція кнопки дії: Виберіть Custom.

    • Кнопка дії Призначення сервісу: Введіть URL кастомної служби. URL має починатися з http:// або https://, наприклад, https://10.11.20.159/path/service.xml .

    • Ім'я сервісу кнопки дії (необов'язково): Вкажіть ім'я сервісу, пов'язаного з тригером. Це ім'я відображається у повідомленні на екрані, коли користувач натискає кнопку, вказуючи, який сервіс буде активований. Якщо ім'я не вказано, використовується Custom service як відображення.

    • Поле власного контенту (необов'язково): Якщо ви хочете увімкнути телефон надсилати запит HTTP POST при натисканні кнопки Action, введіть HTTP-дані, такі як метод, заголовок і POST вміст, з максимальною довжиною 1024 символи.

      Для прикладів POST скриптів і синтаксису див. HTTP POST запит для кнопки Action.

    • Затримка виходу номера: Встановіть період тайм-ауту у секунди, щоб телефон ініціював подію після виявлення тригера. Значення за замовчуванням: 5 секунд. При встановленні 0 подія ініціюється одразу після виявлення тригера.

    • Сервісний тригер Виберіть тригер зі списку: Single Press, Long Press або Press 3 Times.

    • Секрет сервісу (необов'язковий): Введіть секрет автентифікації, токен або пароль, якщо ваш кастомний сервіс потребує автентифікації для доступу. Введений секрет відображається у вигляді маскованого рядка і може посилатися за допомогою макросу $SS у Custom Content Field та Action Button Service Destination.

  • Множинні тригери

    Встановіть параметри в кожній групі відповідно. Дивіться розділи «Екстрені дзвінки» та «Митні послуги» вище.

  • Один тригер для кількох подій

    Налаштуйте такі параметри для призначення кількох подій тригеру:

    • Функція кнопки дії: Виберіть Custom.

    • Кнопка дії Пункт призначення сервісу: Введіть номер телефону для дзвінка та URL XML сервісу у такому форматі:

      тел:<номер телефону або SIP URI> + <serviceURL>

      URL має починатися з http:// або https://.

      Приклад: tel:1234 + https://10.11.20.159/path/service.xml

    • Ім'я сервісу кнопки дії (необов'язково): Вкажіть ім'я сервісу, пов'язаного з тригером. Це ім'я відображається у повідомленні на екрані, коли користувач натискає кнопку, вказуючи, який сервіс буде активований. Якщо ім'я не вказано, використовується Custom service як відображення.

    • Поле власного контенту (необов'язково): Якщо ви хочете увімкнути телефон надсилати запит HTTP POST при натисканні кнопки Action, введіть HTTP-дані, такі як метод, заголовок і POST вміст, з максимальною довжиною 1024 символи.

      Для прикладів POST скриптів і синтаксису див. HTTP POST запит для кнопки Action.

    • Затримка виходу номера: Встановіть період тайм-ауту у секунди, щоб телефон ініціював подію після виявлення тригера. Значення за замовчуванням: 5 секунд. При встановленні 0 подія ініціюється одразу після виявлення тригера.

    • Сервісний тригер Виберіть тригер зі списку: Single Press, Long Press або Press 3 Times.

    • Секрет сервісу (необов'язковий): Введіть секрет автентифікації, токен або пароль, якщо ваш кастомний сервіс потребує автентифікації для доступу. Введений секрет відображається у вигляді маскованого рядка і може посилатися за допомогою макросу $SS у Custom Content Field та Action Button Service Destination.

    • Тихий екстрений виклик (необов'язково): якщо ви вказали номер телефону або набрали URI у пункті призначення служби, увімкнення цієї функції вимикає екстрені дзвінки.

      За замовчуванням екстрений дзвінок виконується як двосторонній дзвінок, подібно до інших вихідних. Коли увімкнено, аудіо на стороні абонента мовчить, щоб уникнути уваги під час поточного дзвінка. Завершити дзвінок може лише отримувач дзвінка.

      Під час беззвучного екстреного виклику екран телефонів 9811 і 9841 зависає, а екран телефонів 9851, 9861 і 9871 вимикається. Всі інші функції недоступні. Телефон відновлює нормальну роботу після завершення дзвінка.

    • Дозволити беззвучне отримання екстреного дзвінка (опціонально): Увімкніть цю функцію, якщо ви дозволяєте користувачам натискати будь-яку клавішу для відновлення нормальної роботи телефону при збереженні екстреного дзвінка. Аудіо виклику залишається беззвучним, якщо користувач не збільшує гучність динаміка за допомогою клавіші Volume (гучність).

Для отримання додаткової інформації про ці параметри дивіться розділ «Параметри для кнопки дії».

4

Виберіть Зберегти.

5

Виберіть Apply Config (Застосувати конфігурацію).

Посилання

Параметри для кнопки Action

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

Таблиця 1. Параметри для кнопки Action
ПараметрЗа замовчуванням і опціїОпис
Функція кнопки дії 1~3

За замовчуванням: вимкнено

Опції: вимкнено, екстрений виклик, кастомний

Ви можете налаштувати кнопку за допомогою конкретного сервісу.

  • Вимкнено: При встановленні Вимкнено кнопка Action для одного сервісу на телефоні не працює.
  • Екстрений виклик: Користувачі можуть скористатися кнопкою Action для здійснення екстреного виклику, якщо це налаштовано.
  • Custom: Користувачі можуть використовувати кнопку Action для доступу до кастомної служби, якщо вона налаштована.

Коли ви встановлюєте поле на Emergency Call або Custom, переконайтеся, що ви введете пункт призначення сервісу у полі Action Button Service Destination . Або телефон покаже помилку налаштування.

Назва сервісу кнопки дії 1~3

За замовчуванням: пусто

За бажанням вкажіть назву сервісу, пов'язаного з кнопкою Action. Це ім'я відображається у повідомленні на екрані, коли користувач натискає кнопку, вказуючи, який сервіс буде активований.

Якщо ви не вказали ім'я, за замовчуванням буде Екстрений виклик, Тихий екстрений виклик або Кастомна дія залежно від вашого вибору у полі Функція кнопки Дії.

Призначення обслуговування кнопки дії 1~3

За замовчуванням: пусто

Надайте пункт призначення сервісу в одному з наступних форматів на основі сервісу, призначеного кнопці Action:

  • Для екстрених викликів введіть номер телефону або URI екстреної служби.

  • Коли налаштовують кнопку для власного сервісу, введіть URL сервісу. URL має починатися з http:// або https://. Наприклад, https://10.11.20.159/path/service.xml.

  • Щоб налаштувати кнопку для ініціації кількох подій одним тригером, введіть tel:<phonenumber або SIP URL> + <Service RUL>. Приклад: tel:1234 + https://10.11.20.159/path/service.xml.

    Також підтримується виклик SIP URI. Вводьте URI у форматі тел: SIP 4567@co.webex.com

Якщо ви увімкнете кнопку Action без встановлення дійсного призначення сервісу, користувач на телефоні побачить повідомлення з вимогою налаштуватися. Після закриття цього повідомлення іконка попередження залишатиметься в заголовку екрану телефону, доки кнопка не буде правильно налаштована або вимкнена.

Телефонні номери не можуть використовуватися як пункти призначення для індивідуальних послуг. Якщо налаштувати кнопку дії як кастомну і ввести номер телефону як пункт призначення сервісу, на телефоні з'явиться повідомлення-сповіщення, що кнопка не налаштована. Натомість ви можете додати номер телефону у форматі 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

За замовчуванням: пусто

Це налаштування працює лише тоді, коли функція кнопки дій встановлена на Custom.

Введіть HTTP-дані, такі як метод, заголовок і вміст POST, з максимальною довжиною 1024 символи. При налаштуванні телефон надсилає запит HTTP POST при натисканні Дії.

Якщо сервіс потребує автентифікації для доступу, обов'язково введіть секрет автентифікації у поле Service Secret . У даних HTTP використовуйте макрос $SS як посилання на Service Secret.

Для прикладів і синтаксису див. запит HTTP POST для кнопки Action.

Service Secret 1~3

За замовчуванням: пусто

Секрет служби може бути секретом автентифікації, токеном або паролем. Введений секрет відображається у вигляді маскованого рядка і може посилатися за допомогою макросу $SS у Custom Content Field та Action Button Service Destination.

Сервісний тригер 1~3

За замовчуванням: Single Press

Варіанти: Одинарне натискання, Довге натискання, Тричі

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

Одноразове натискання: натисніть кнопку Action, щоб активувати відповідний дзвінок або сервіс.

Довге натискання: натисніть кнопку Action мінімум 2 секунди, щоб активувати відповідний дзвінок або сервіс.

Натисніть 3 рази: Натисніть кнопку Action тричі з інтервалом менше 2 секунд між кожним натисканням, щоб запустити відповідний дзвінок або послугу.

Не повторюйте тригер між кількома сервісами, оскільки параметри з нижчим пріоритетом не працюватимуть. Порядок пріоритетів, від найвищого до найнижчого, такий: Група 1, Група 2, Група 3.

Затримка виходу 1~3

За замовчуванням: 5

Варіанти: 0 - 30

Встановіть період тайм-ауту у секунди, щоб телефон міг ініціювати екстрений виклик або кастомну дію після натискання кнопки Action.

Встановіть його на 0, якщо ви віддаєте перевагу, щоб телефон здійснив дзвінок або ініціював подію одразу після виявлення тригера, як зазначено одним натисканням, довгим або триразовим натисканням кнопки.

Тихий екстрений виклик 1~3

За замовчуванням: "Вимкнено"

Опції: Увімкнено, Вимкнено

Безшумний екстрений виклик призначений для непомітної допомоги у небезпечних ситуаціях. Він дозволяє користувачам звертатися за допомогою без жодного шуму.

  • При увімкненому режимі користувачі можуть здійснювати односторонні дзвінки за допомогою кнопки Action.

    Після безмовного екстреного виклику лише інша сторона може завершити дзвінок. Щоб уникнути привернення уваги під час поточного дзвінка, екран телефонів 9811 і 9841 зависає, а екран телефонів 9851, 9861 і 9871 буде вимкнений. Телефон за замовчуванням блокує всі функції під час тихого екстреного виклику. Щоб користувачі могли відновити нормальну роботу телефону, зберігаючи безмовний екстрений виклик, увімкніть функцію Allow Silent Emergency Call Retrieval .

  • При вимкненні екстрений виклик виконує функцію двостороннього дзвінка, подібно до інших вихідних.

Дозволити безшумне відновлення екстреного виклику

За замовчуванням: No (Ні)

Варіанти: "Так, "Ні"

Контролює, чи можуть користувачі відновити функціональність телефону під час беззвучного екстреного виклику. За замовчуванням, після ініціювання тихого екстреного виклику телефон блокує всі функції до завершення дзвінка отримувача.

Коли цей параметр встановлено на Так, користувачі можуть натиснути будь-яку клавішу, щоб відновити нормальну роботу телефону, зберігаючи екстрений виклик. Аудіо дзвінка залишається беззвучним, якщо користувач не збільшує гучність за допомогою клавіші Гучність.

HTTP POST запит кнопки Action

Кнопка Action на Cisco Desk Phone Series 9800 може бути налаштована для запуску додатків XML через запити HTTP POST.

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

Наступні приклади наведені у XML та JSON:

Приклад #1: XML --method POST --header 'Content-Type: application/XML' --header 'Authorization: Carrier username:$SS' --body '<MetaData><Trigger>True</Trigger><Description>This for 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
$SSService Secret, який відображає замаскований рядок на сторінці конфігурації телефону, наприклад, секрет автентифікації, токен або пароль.
Чи була ця стаття корисною?
Чи була ця стаття корисною?