W tym artykule
Dostosowywanie przycisku Akcja
dropdown icon
Odwołania
    Parametry przycisku Akcja
    Żądanie HTTP POST dotyczące przycisku Akcja

Skonfiguruj przycisk Akcja dla 9800 (Unified CM)

list-menuW tym artykule
list-menuOpinia?

Przycisk Akcja to czerwony przycisk znajdujący się w prawym górnym rogu telefonu. Umożliwia użytkownikom szybki dostęp do wyznaczonych usług, takich jak usługi alarmowe lub niestandardowe. Możesz dostosować przycisk, aby inicjować zdarzenia, które pasują do konkretnych przypadków użycia. Informacje na tej stronie dotyczą telefonu stacjonarnego Cisco serii 9800 zarejestrowanego jako Cisco Unified Communications Manager (Unified CM).

Dostosowywanie przycisku Akcja

Niestandardowe opcje przycisku Akcja w telefonie Cisco Desk Phone 9800 Series wymagają obsługi specjalnego oprogramowania układowego PhoneOS. Szczegółowe informacje można znaleźć w poniższej tabeli:

FunkcjaWymagana wersja oprogramowania sprzętowego
Połączenie alarmowePhoneOS 3.0.1 lub nowszy
Usługa niestandardowaPhoneOS 3.2.1 lub nowszy
Wiele wyzwalaczyPhoneOS 3.3.1 lub nowszy
HTTP POSTPhoneOS 3.3.1 lub nowszy
Wiele zdarzeń na jednym wyzwalaczuPhoneOS 3.4.1 lub nowszy
1

Zaloguj się do Cisco Unified Communications Manager — administracja.

2

W razie potrzeby wykonaj jedną z następujących czynności:

  • Aby skonfigurować wszystkie wdrożone telefony, przejdź do System > Enterprise Phone Configuration.
  • Aby skonfigurować telefony współdzielące ten sam profil telefonu, przejdź do Urządzenie > Ustawienia urządzenia> Wspólny profil telefonu.
  • Aby skonfigurować pojedynczy telefon, przejdź do Device > Phone. Następnie znajdź swój telefon i otwórz stronę Konfiguracja telefonu.

Konfiguracja ma strukturę hierarchiczną:

  • Ustawienia poszczególnych urządzeń mają pierwszeństwo przed ustawieniami na poziomie wspólnego profilu telefonu i na poziomie przedsiębiorstwa
  • Wspólne ustawienia profilu telefonu zastępują ustawienia na poziomie przedsiębiorstwa

3

Dostosuj ustawienia przycisku akcji za pomocą następujących parametrów w zależności od przypadków użycia.

Istnieją trzy grupy parametrów dla przycisku Akcja, z których każdy odpowiada usłudze z unikalnym wyzwalaczem. Jeśli wyzwalacz usługi jest określony w wielu grupach, ustawienia w grupie 1 mają pierwszeństwo przed ustawieniami w grupach 2 i 3, podczas gdy grupa 2 ma pierwszeństwo przed grupą 3.

  • Połączenia alarmowe

    Skonfiguruj następujące parametry:

    • Funkcja przycisku akcji: Wybierz połączenie alarmowe.

    • Miejsce docelowe usługi za pomocą przycisku akcji: Wprowadź numer telefonu lub URI usługi alarmowej.

    • Nazwa usługi przycisku akcji (opcjonalnie): Określ nazwę usługi skojarzonej z wyzwalaczem akcji. Nazwa ta zostanie wyświetlona w komunikacie na ekranie, gdy użytkownik naciśnie przycisk, wskazując, które zdarzenie zostanie zainicjowane. Jeśli nazwa nie zostanie określona, jako nazwa wyświetlana zostanie użyte połączenie alarmowe .

    • Dial Out Delay (Opóźnienie wybierania): Ustaw limit czasu (w sekundach), po którym telefon ma inicjować połączenie alarmowe po wykryciu wyzwalacza. Wartość domyślna to 5 sekund. Jeśli ustawiona jest wartość 0, połączenie jest nawiązywane natychmiast po wykryciu wyzwalacza.

    • Service Trigger (Wyzwalacz usługi) Wybierz wyzwalacz z listy: pojedyncze naciśnięcie, długie naciśnięcie lub naciśnięcie 3 razy.

    • Ciche połączenie alarmowe (opcjonalnie): Domyślnie połączenie alarmowe działa jako połączenie dwukierunkowe, podobnie jak inne połączenia wychodzące. Gdy ciche połączenie alarmowe jest włączone, dźwięk jest wyciszony po stronie dzwoniącego, aby uniknąć przyciągania uwagi podczas połączenia. Tylko odbiorca połączenia może zakończyć ciche połączenie alarmowe.

      Podczas cichego połączenia alarmowego ekrany telefonów 9811 i 9841 zawieszają się, a ekrany telefonów 9851, 9861 i 9871 są wyłączone. Wszystkie inne funkcje są niedostępne. Telefon przywróci normalne działanie po zakończeniu połączenia przez odbiorcę.

    • Zezwól na ciche odbieranie połączeń alarmowych (opcjonalnie): Włącz tę funkcję, jeśli zezwalasz użytkownikom na naciśnięcie dowolnego w celu przywrócenia normalnego działania telefonu przy zachowaniu połączenia alarmowego. Dźwięk połączenia pozostanie wyciszony, dopóki użytkownik nie zwiększy głośności głośnika za pomocą głośności.

  • Usługi niestandardowe

    Skonfiguruj następujące parametry:

    • Funkcja przycisku akcji: Wybierz opcję Niestandardowe.

    • Przycisk akcji Miejsce docelowe usługi: Wprowadź adres URL usługi niestandardowej. Adres URL musi zaczynać się od ciągu http:// lub https://, na przykład https://10.11.20.159/path/service.xml.

    • Nazwa usługi przycisku akcji (opcjonalnie): Określ nazwę usługi skojarzonej z wyzwalaczem. Nazwa ta zostanie wyświetlona w komunikacie na ekranie, gdy użytkownik naciśnie przycisk, wskazując, która usługa zostanie uruchomiona. Jeśli nazwa nie zostanie określona, jako nazwa wyświetlana zostanie użyta usługa niestandardowa.

    • Pole zawartości niestandardowej (opcjonalnie): Jeśli chcesz, aby telefon wysyłał żądanie HTTP POST po naciśnięciu przycisku Akcja, wprowadź dane HTTP, takie jak metoda, nagłówek i zawartość POST, o maksymalnej długości 1024 znaków.

      Aby zapoznać się z przykładami skryptów POST i składnią, zobacz HTTP POST żądanie przycisku Akcja.

    • Dial Out Delay (Opóźnienie wybierania): ustaw limit czasu (w sekundach), po którym telefon ma zainicjować zdarzenie po wykryciu wyzwalacza. Wartość domyślna to 5 sekund. Po ustawieniu wartości 0 zdarzenie jest inicjowane natychmiast po wykryciu wyzwalacza.

    • Service Trigger (Wyzwalacz usługi) Wybierz wyzwalacz z listy: pojedyncze naciśnięcie, długie naciśnięcie lub naciśnięcie 3 razy.

    • Klucz tajny usługi (opcjonalnie): wprowadź klucz tajny uwierzytelniania, token lub hasło, jeśli dostęp do usługi niestandardowej wymaga uwierzytelnienia. Wprowadzony klucz tajny jest wyświetlany jako zamaskowany ciąg i można się do niego odwoływać za pomocą makra $SS w polu zawartości niestandardowej i miejscu docelowym usługi przycisku akcji.

  • Wiele wyzwalaczy

    Ustaw odpowiednio parametry w każdej grupie. Zobacz sekcje Połączenia alarmowe i Usługi niestandardowe powyżej.

  • Pojedynczy wyzwalacz dla wielu zdarzeń

    Skonfiguruj następujące parametry, aby przypisać wiele zdarzeń do wyzwalacza:

    • Funkcja przycisku akcji: Wybierz opcję Niestandardowe.

    • Przycisk akcji Miejsce docelowe usługi: Wprowadź numer telefonu, z którym chcesz się połączyć, oraz adres URL usługi XML w następującym formacie:

      tel:<phonenumber lub SIP URI> + <serviceURL>

      Adres URL musi zaczynać się od ciągu http:// lub https://.

      Przykład: tel:1234 + https://10.11.20.159/path/service.xml

    • Nazwa usługi przycisku akcji (opcjonalnie): Określ nazwę usługi skojarzonej z wyzwalaczem. Nazwa ta zostanie wyświetlona w komunikacie na ekranie, gdy użytkownik naciśnie przycisk, wskazując, która usługa zostanie uruchomiona. Jeśli nazwa nie zostanie określona, jako nazwa wyświetlana zostanie użyta usługa niestandardowa.

    • Pole zawartości niestandardowej (opcjonalnie): Jeśli chcesz, aby telefon wysyłał żądanie HTTP POST po naciśnięciu przycisku Akcja, wprowadź dane HTTP, takie jak metoda, nagłówek i zawartość POST, o maksymalnej długości 1024 znaków.

      Aby zapoznać się z przykładami skryptów POST i składnią, zobacz HTTP POST żądanie przycisku Akcja.

    • Dial Out Delay (Opóźnienie wybierania): ustaw limit czasu (w sekundach), po którym telefon ma zainicjować zdarzenie po wykryciu wyzwalacza. Wartość domyślna to 5 sekund. Po ustawieniu wartości 0 zdarzenie jest inicjowane natychmiast po wykryciu wyzwalacza.

    • Service Trigger (Wyzwalacz usługi) Wybierz wyzwalacz z listy: pojedyncze naciśnięcie, długie naciśnięcie lub naciśnięcie 3 razy.

    • Klucz tajny usługi (opcjonalnie): wprowadź klucz tajny uwierzytelniania, token lub hasło, jeśli dostęp do usługi niestandardowej wymaga uwierzytelnienia. Wprowadzony klucz tajny jest wyświetlany jako zamaskowany ciąg i można się do niego odwoływać za pomocą makra $SS w polu zawartości niestandardowej i miejscu docelowym usługi przycisku akcji.

    • Ciche połączenie alarmowe (opcjonalnie): Jeśli w miejscu docelowym usługi podano numer telefonu lub wybrano URI, włączenie tej funkcji spowoduje wyciszenie połączeń alarmowych.

      Domyślnie połączenie alarmowe działa jako połączenie dwukierunkowe, podobnie jak inne połączenia wychodzące. Po włączeniu dźwięk jest wyciszony po stronie dzwoniącego, aby uniknąć przyciągania uwagi podczas połączenia. Tylko odbiorca połączenia może je zakończyć.

      Podczas cichego połączenia alarmowego ekrany telefonów 9811 i 9841 zawieszają się, a ekrany telefonów 9851, 9861 i 9871 są wyłączone. Wszystkie inne funkcje są niedostępne. Telefon przywróci normalne działanie po zakończeniu połączenia przez odbiorcę.

    • Zezwól na ciche odbieranie połączeń alarmowych (opcjonalnie): Włącz tę funkcję, jeśli zezwalasz użytkownikom na naciśnięcie dowolnego w celu przywrócenia normalnego działania telefonu przy zachowaniu połączenia alarmowego. Dźwięk połączenia pozostanie wyciszony, dopóki użytkownik nie zwiększy głośności głośnika za pomocą głośności.

Aby uzyskać więcej informacji o tych parametrach, zobacz Parametry przycisku Akcja.

4

Kliknij przycisk Zapisz.

5

Kliknij przycisk Apply Config (Zastosuj konfigurację).

Odwołania

Parametry przycisku Akcja

Parametry są dostępne w opcjach Enterprise Phone Configuration (Konfiguracja telefonu przedsiębiorstwa), Common Phone Profile (Wspólny profil telefonu) i Individual Phone Configuration (Indywidualna konfiguracja telefonu).

Tabela 1. Parametry przycisku Akcja
ParametrWartości domyślne i opcjeOpis
Funkcja przycisku akcji 1 ~ 3

Wartość domyślna: Wył.

Opcje: Wył., Połączenie alarmowe, Niestandardowe

Przycisk można skonfigurować z określoną usługą.

  • Wyłączone: Po ustawieniu opcji Wyłączone przycisk Akcja dla pojedynczej usługi w telefonie nie będzie działać.
  • Połączenie alarmowe: Użytkownicy mogą użyć przycisku Akcja, aby nawiązać połączenie alarmowe, jeśli zostało skonfigurowane.
  • Niestandardowe: Użytkownicy mogą użyć przycisku Akcja, aby uzyskać dostęp do usługi niestandardowej, jeśli została skonfigurowana.

Po ustawieniu pola na Połączenie alarmowe lub Niestandardowe upewnij się, że w polu Przycisk akcji miejsce docelowe usługi zostało wprowadzone. Lub telefon wyświetli błąd konfiguracji.

Nazwa usługi przycisku akcji 1~3

Wartość domyślna: puste

Opcjonalnie określ nazwę usługi skojarzonej z przyciskiem Akcja. Nazwa ta zostanie wyświetlona w komunikacie na ekranie, gdy użytkownik naciśnie przycisk, wskazując, która usługa zostanie uruchomiona.

Jeśli nazwa nie zostanie określona, nazwą domyślną będzie Połączenie alarmowe, Ciche połączenie alarmowe lub Czynność niestandardowa w zależności od wyboru dokonanego w polu Funkcja przycisku akcji.

Przycisk akcji Miejsce docelowe usługi 1~3

Wartość domyślna: puste

Podaj miejsce docelowe usługi w jednym z następujących formatów na podstawie usługi przypisanej do przycisku Akcja:

  • W przypadku usług połączeń alarmowych wprowadź numer telefonu lub URI usługi alarmowe.

  • Podczas konfigurowania przycisku dla usługi niestandardowej wprowadź adres URL usługi. Adres URL musi zaczynać się od ciągu http:// lub https://. Na przykład https://10.11.20.159/path/service.xml.

  • Aby skonfigurować przycisk do inicjowania wielu zdarzeń za pomocą jednego wyzwalacza, wprowadź tel:<phonenumber lub SIP URL> + <Service RUL>. Przykład: tel:1234 + https://10.11.20.159/path/service.xml.

    Obsługiwane jest również wywoływanie identyfikatorów URI SIP. Wprowadź URI w formacie tel.: SIP 4567@co.webex.com

Jeśli włączysz przycisk Akcja bez ustawienia prawidłowego miejsca docelowego usługi, użytkownik telefonu zobaczy komunikat z monitem o konfigurację. Gdy użytkownik zamknie to powiadomienie, ikona ostrzeżenia pozostanie w nagłówku ekranu telefonu, dopóki przycisk nie zostanie poprawnie skonfigurowany lub wyłączony.

Numery telefonów nie mogą być używane jako miejsca docelowe dla usług niestandardowych. Jeśli przycisk akcji zostanie skonfigurowany jako niestandardowy i wprowadzony numer telefonu jako miejsce docelowe usługi, na telefonie zostanie wyświetlony komunikat ostrzegawczy informujący, że przycisk nie jest skonfigurowany. Zamiast tego można dodać numer telefonu w następującym formacie tel:<numer telefonu>, na przykład tel:1234.

Jeśli nie możesz wprowadzić adresu URL zawierającego znak ampersand (&), użyj %26 jako zamiennika. Na przykład wpisz http://1.2.3.4/phone?a=1%26b=2%26c=3 zamiast http://1.2.3.4/phone?a=1&b=2&c=3.

Pole zawartości niestandardowej 1~3

Wartość domyślna: puste

To ustawienie działa tylko wtedy, gdy funkcja przycisku akcji jest ustawiona na Niestandardowe.

Wprowadź dane HTTP, takie jak metoda, nagłówek i zawartość POST, o maksymalnej długości 1024 znaków. Po skonfigurowaniu telefon wysyła żądanie HTTP POST po naciśnięciu przycisku Akcja.

Jeśli dostęp do usługi wymaga uwierzytelnienia, upewnij się, że wpisano klucz tajny uwierzytelniania w polu Klucz tajny usługi. W danych HTTP użyj makra $SS jako odwołania do klucza tajnego usługi.

Aby zapoznać się z przykładami i składnią, zobacz HTTP POST żądanie dotyczące przycisku Akcja.

Klucz tajny usługi 1 ~ 3

Wartość domyślna: puste

Klucz tajny usługi może być kluczem tajnym uwierzytelniania, tokenem lub hasłem. Wprowadzony klucz tajny jest wyświetlany jako zamaskowany ciąg i można się do niego odwoływać za pomocą makra $SS w polu zawartości niestandardowej i miejscu docelowym usługi przycisku akcji.

Wyzwalacz usługi 1 ~ 3

Wartość domyślna: Pojedyncze naciśnięcie

Opcje: Pojedyncze naciśnięcie, długie naciśnięcie, naciśnij 3 razy

Wybierz, w jaki sposób użytkownicy mogą nawiązać połączenie alarmowe lub zainicjować usługę niestandardową za pomocą przycisku akcji telefonu.

Pojedyncze naciśnięcie: Naciśnij przycisk Akcja, aby wyzwolić powiązane połączenie lub usługę.

Długie naciśnięcie: naciśnij przycisk akcji przez co najmniej 2 sekundy, aby wyzwolić powiązane połączenie lub usługę.

Naciśnij 3 razy: naciśnij przycisk akcji trzy razy w odstępach krótszych niż 2 sekundy między kolejnymi naciśnięciami, aby wyzwolić powiązane połączenie lub usługę.

Nie powtarzaj wyzwalacza w wielu usługach, ponieważ parametry o niższym priorytecie nie będą działać. Kolejność priorytetów, od najwyższej do najniższej, jest następująca: Grupa 1, Grupa 2, Grupa 3.

Opóźnienie połączenia 1~3

Wartość domyślna: 5

Opcje: 0 - 30

Ustaw limit czasu (w sekundach), po którym telefon ma zainicjować połączenie alarmowe lub akcję niestandardową po naciśnięciu przycisku Akcja.

Ustaw ją na 0, jeśli wolisz, aby telefon nawiązał połączenie lub zainicjował zdarzenie natychmiast po wykryciu wyzwalacza, zgodnie z pojedynczym naciśnięciem, długim naciśnięciem lub potrójnym naciśnięciem przycisku.

Ciche połączenie alarmowe 1 ~ 3

Wartość domyślna: Wyłączone

Opcje: Włączone, Wyłączone

Ciche połączenie alarmowe jest przeznaczone do dyskretnej pomocy w niebezpiecznych sytuacjach. Umożliwia użytkownikom szukanie pomocy bez hałasu.

  • Po włączeniu tej opcji użytkownicy mogą nawiązywać połączenia jednokierunkowe za pomocą przycisku Akcja.

    Po nawiązaniu cichego połączenia alarmowego tylko druga strona może zakończyć połączenie. Aby uniknąć zwracania uwagi podczas trwającego połączenia, ekrany telefonów 9811 i 9841 zawieszają się, a ekrany telefonów 9851, 9861 i 9871 są wyłączone. Telefon domyślnie blokuje wszystkie funkcje podczas cichego połączenia alarmowego. Aby umożliwić użytkownikom przywrócenie normalnego działania telefonu przy zachowaniu cichego połączenia alarmowego, włącz funkcję Zezwól na odbieranie cichych połączeń alarmowych.

  • Po wyłączeniu połączenie alarmowe działa jako połączenie dwukierunkowe, podobnie jak inne połączenia wychodzące.

Zezwól na odbieranie cichych połączeń alarmowych

Domyślne: Nie

Dostępne opcje: Tak, Nie

Określa, czy użytkownicy mogą odzyskać funkcje telefonu podczas cichego połączenia alarmowego. Domyślnie po zainicjowaniu cichego połączenia alarmowego telefon blokuje wszystkie funkcje, dopóki odbiorca połączenia nie zakończy połączenia.

Gdy ten parametr jest ustawiony na Tak, użytkownicy mogą nacisnąć dowolny, aby przywrócić normalne działanie telefonu przy zachowaniu połączenia alarmowego. Dźwięk połączenia pozostaje wyciszony, dopóki użytkownik nie zwiększy głośności za pomocą głośności.

Żądanie HTTP POST dotyczące przycisku Akcja

Przycisk Akcja w telefonie biurkowym Cisco serii 9800 można skonfigurować tak, aby wyzwalał aplikacje XML za pomocą żądań HTTP POST.

W polu Zawartość niestandardowa wprowadź dostosowany skrypt żądania. Można określić typ zawartości XML lub JSON i dołączyć makra do żądania. Na przykład do skryptu można dodać $SSw celu pobrania klucza tajnego, tokenu lub hasła uwierzytelnienia podanego w polu Tajne hasło usługi.

Poniższe przykłady znajdują się w XML i JSON:

Przykład #1: XML --metoda POST --header 'Content-Type: application/XML' --header 'Autoryzacja: nazwa użytkownika okaziciela:$SS' --body '<MetaData><Trigger>True</Trigger><Description>Dotyczy HTTP POST XML</Description></MetaData>' Przykład #2: JSON --metoda POST --header 'Content-Type: application/json' --header 'Autoryzacja: $SS' --body '{"zdarzenia": [{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' 

Cisco Unified Communications Manager (UCM) wymaga kodowania procentowego dla zastrzeżonych znaków zgodnie z RFC 3986.

Tabela 2. Kodowanie procentowe dla zastrzeżonych znaków
ZnakKodowanie procentowe
&%26
'%27
"%22
< %3c
> %3e

Poniższy skrypt jest przykładem użycia ciągów zakodowanych procentowo.

--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
Tabela 3. Obsługiwane makra
Nazwa makraRozwijanie w makro
#DEVICENAME#Nazwa urządzenia wyświetlana w systemie wywołującym. Na przykład SEP845A3EC21288
$SSKlucz tajny usługi, który przedstawia na stronie konfiguracji telefonu zamaskowany ciąg, taki jak klucz tajny uwierzytelniania, token lub hasło.
Czy ten artykuł był pomocny?
Czy ten artykuł był pomocny?