Налаштуйте кнопку дії

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

ФункціяНеобхідна версія прошивки
Екстрений викликPhoneOS 3.0.1 і вище
Митне обслуговуванняPhoneOS 3.2.1 і новіші версії
Кілька тригерівPhoneOS 3.3.1 і новіші версії
Повідомлення HTTPPhoneOS 3.3.1 і новіші версії
Кілька подій на одному тригеріPhoneOS 3.4.1 і новіші версії
1

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

2

За потреби виконайте одну з наведених нижче дій:

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

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

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

3

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

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

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

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

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

    • Адресат служби кнопки дії: введіть номер телефону або URI служби екстреної допомоги.

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

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

    • Сервісний тригер Виберіть тригер зі списку: Одиночне натискання, Тривале натискання або Натисніть 3 рази.

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

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

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

  • Послуги на замовлення

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

    • Функція кнопки дії: виберіть Custom (Спеціальний).

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

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

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

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

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

    • Сервісний тригер Виберіть тригер зі списку: Одиночне натискання, Тривале натискання або Натисніть 3 рази.

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

  • Кілька тригерів

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

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

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

    • Функція кнопки дії: виберіть Custom (Спеціальний).

    • Адресат служби кнопки дії: введіть номер телефону для дзвінка та URL-адресу служби XML у цьому форматі:

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

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

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

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

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

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

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

    • Сервісний тригер Виберіть тригер зі списку: Одиночне натискання, Тривале натискання або Натисніть 3 рази.

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

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

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

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

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

Щоб дізнатися більше про ці параметри, перегляньте статтю Параметри кнопки «Дія».

4

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

5

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

Посилання

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

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

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

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

Опції: Вимк., Екстрений виклик, Користувацький

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

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

Якщо ви встановили поле « Екстрений виклик » або «Користувацький», переконайтеся, що ви ввели місце призначення послуги в поле «Пункт призначення послуги». Або на телефоні з'явиться повідомлення про помилку конфігурації.

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

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

За бажанням можна вказати ім'я служби, пов'язаної з кнопкою «Дія». Це ім'я буде відображатися в екранному повідомленні при натисканні користувача на кнопку, вказуючи, яка послуга буде спрацьована.

Якщо ви не вкажете ім'я, за замовчуванням використовуватиметься ім'я «Екстрений виклик», «Беззвучний екстрений виклик» або «Настроювана дія» залежно від вашого вибору в полі «Функція кнопки дії».

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

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

Надайте місце призначення служби в одному з наведених нижче форматів залежно від послуги, призначеної кнопці дії.

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

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

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

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

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

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

Якщо сервіс вимагає автентифікації для доступу, обов'язково введіть секрет автентифікації в поле 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

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

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

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

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

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

  • Якщо цей параметр вимкнено, екстрений дзвінок функціонує як двосторонній, подібно до інших вихідних дзвінків.

Дозволити безшумний пошук екстрених викликів

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

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

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

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

HTTP Post запит на кнопку «Дія»

Кнопка дії на Cisco Desk Phone серії 9800 може бути налаштована на запуск додатків 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 is 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
> %3е

Наступний скрипт є прикладом використання рядків, закодованих у відсотках.

--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, який представляє замаскований рядок на сторінці конфігурації телефону, наприклад секрет автентифікації, токен або пароль.