Dostosuj przycisk Akcja

Opcje niestandardowe dla przycisku Akcja w telefonach Cisco Desk Phone serii 9800 wymagają obsługi określonego oprogramowania układowego PhoneOS. Szczegóły znajdziesz w poniższej tabeli:

FunkcjaWymagana wersja oprogramowania sprzętowego
Połączenie alarmowePhoneOS 3.0.1 i nowsze
Usługa niestandardowaPhoneOS 3.2.1 i nowsze
Wiele wyzwalaczyPhoneOS 3.3.1 i nowsze
Post HTTPPhoneOS 3.3.1 i nowsze
Wiele zdarzeń na jednym wyzwalaczuPhoneOS 3.4.1 i nowsze
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 > Konfiguracja telefonu korporacyjnego.
  • Aby skonfigurować telefony współdzielące ten sam profil telefonu, przejdź do sekcji Urządzenie > Ustawienia urządzenia > Wspólny profil telefonu.
  • Aby skonfigurować pojedynczy telefon, przejdź do Urządzenie > Telefon. Następnie znajdź swój telefon i otwórz stronę konfiguracji telefonu.

Konfiguracja ma strukturę hierarchiczną:

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

3

Dostosuj ustawienia przycisku Akcja za pomocą poniższych parametrów na podstawie swojego przypadku użycia.

Istnieją trzy grupy parametrów przycisku Akcja, z których każda odpowiada usłudze z unikalnym wyzwalaczem. Jeżeli wyzwalacz usługi jest określony w wielu grupach, ustawienia w Grupie 1 mają pierwszeństwo przed ustawieniami w Grupach 2 i 3, a Grupa 2 ma pierwszeństwo przed Grupą 3.

  • Połączenia alarmowe

    Skonfiguruj następujące parametry:

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

    • Przycisk akcji Miejsce docelowe usługi: Wprowadź numer telefonu lub kod URI służb ratunkowych.

    • Nazwa usługi przycisku akcji (Opcjonalnie): Podaj nazwę usługi powiązanej z wyzwalaczem akcji. Ta nazwa będzie wyświetlana w komunikacie na ekranie, gdy użytkownik naciśnie przycisk, wskazując, które zdarzenie zostanie zainicjowane. Jeżeli nie określono żadnej nazwy, jako nazwa wyświetlana zostanie użyta nazwa Połączenie alarmowe .

    • Opóźnienie wybierania numeru: Ustaw limit czasu (w sekundach), po którym telefon rozpocznie połączenie alarmowe po wykryciu wyzwalacza. Wartość domyślna to 5 sekund. Jeżeli ustawione na 0, połączenie zostanie nawiązane natychmiast po wykryciu wyzwalacza.

    • Wyzwalacz serwisowy Wybierz wyzwalacz z listy: Pojedyncze naciśnięcie, Długie naciśnięcie lub Naciśnięcie 3 razy.

    • Ciche połączenie alarmowe (opcjonalne): Domyślnie połączenie alarmowe działa jako połączenie dwukierunkowe, podobnie jak inne połączenia wychodzące. Po włączeniu cichego połączenia alarmowego dźwięk po stronie dzwoniącego jest wyciszony, aby nie zwracać uwagi podczas trwającego połączenia. Tylko odbiorca połączenia może zakończyć ciche połączenie alarmowe.

      Podczas cichego połączenia alarmowego ekran telefonu 9841 zostanie zatrzymany, a ekrany telefonów 9851, 9861 i 9871 zostaną wyłączone. Wszystkie pozostałe funkcje są niedostępne. Telefon powraca do normalnej pracy po zakończeniu połączenia przez rozmówcę.

    • Zezwalaj na ciche odbieranie połączeń alarmowych (Opcjonalnie): Włącz tę funkcję, jeśli chcesz, aby użytkownicy mogli nacisnąć dowolny klawisz w celu przywrócenia normalnego działania telefonu, utrzymując jednocześnie połączenie alarmowe. Dźwięk połączenia pozostaje wyciszony, dopóki użytkownik nie zwiększy głośności głośnika za pomocą przycisku głośności.

  • Usługi niestandardowe

    Skonfiguruj następujące parametry:

    • Funkcja przycisku akcji: Wybierz Niestandardowe.

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

    • Nazwa usługi przycisku akcji (Opcjonalnie): Podaj nazwę usługi powiązanej z wyzwalaczem. Ta nazwa będzie wyświetlana w komunikacie na ekranie, gdy użytkownik naciśnie przycisk, wskazując, która usługa zostanie uruchomiona. Jeśli nie określono żadnej nazwy, jako nazwa wyświetlana zostanie użyta nazwa Usługa niestandardowa .

    • Pole zawartości niestandardowej (opcjonalne): 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ść posta, o maksymalnej długości 1024 znaków.

      Przykłady skryptów POST i ich składnię znajdziesz w Żądaniu HTTP POST dla przycisku Akcja.

    • Opóźnienie wybierania numeru: Ustaw limit czasu (w sekundach), po którym telefon zainicjuje zdarzenie po wykryciu wyzwalacza. Wartość domyślna to 5 sekund. W przypadku ustawienia wartości 0 zdarzenie zostanie zainicjowane natychmiast po wykryciu wyzwalacza.

    • Wyzwalacz serwisowy Wybierz wyzwalacz z listy: Pojedyncze naciśnięcie, Długie naciśnięcie lub Naciśnięcie 3 razy.

    • Tajny klucz uwierzytelniania (opcjonalnie): wprowadź tajny klucz uwierzytelniania, token lub hasło, jeśli Twoja niestandardowa usługa wymaga uwierzytelnienia w celu uzyskania dostępu do niej. Wprowadzony sekret jest wyświetlany jako zamaskowany ciąg znaków i można się do niego odwołać za pomocą makra $SS W Pole niestandardowej zawartości I Przycisk akcji Miejsce docelowe usługi .

  • Wiele wyzwalaczy

    Ustaw parametry odpowiednio 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 : Wybierać Zwyczaj .

    • Przycisk akcji Miejsce docelowe usługi : Wprowadź numer telefonu, pod który chcesz zadzwonić, oraz adres URL usługi XML w następującym formacie:

      tel:<numer telefonu lub SIP URI> + <serviceURL>

      Adres URL musi zaczynać się od http:// Lub https:// .

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

    • Nazwa usługi przycisku akcji (Opcjonalnie): Podaj nazwę usługi powiązanej 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 umożliwić telefonowi wysyłanie żądania HTTP Post po naciśnięciu przycisku Akcja, wprowadź dane HTTP, takie jak metoda, nagłówek i treść postu, o maksymalnej długości 1024 znaków.

      Aby zapoznać się z przykładami skryptów POST i składnią, zobacz Żądanie HTTP Post dla 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 URI wybierania numeru, 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 ekran telefonu 9841 zawiesi się, a ekran telefonów 9851, 9861 i 9871 zostanie wyłączony. 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 połączeń alarmowych wprowadź numer telefonu lub URI pogotowia ratunkowego.

  • 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 adres URL SIP> + <RUL usługi>. Przykład: tel:1234 + https://10.11.20.159/path/service.xml.

    Obsługiwane jest również wywoływanie adresów SIP URI. 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 treść postu, 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 Żądanie HTTP Post dla 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, ekran telefonu 9841 zawiesi się, a ekran telefonów 9851, 9861 i 9871 zostanie wyłączony. 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 dla przycisku Akcja

Przycisk Akcja w telefonie Cisco Desk Phone z serii 9800 można skonfigurować tak, aby wyzwalał XML aplikacje 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 przedstawiono w XML i JSON:

Przykład #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>' Przykład #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) wymaga kodowania procentowego dla zastrzeżonych znaków zgodnie ze specyfikacją RFC 3986.

Tabela 2. Kodowanie procentowe dla zastrzeżonych znaków
ZnakKodowanie procentowe
i%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.