Konfigurirajte gumb Akcija za 9800 (Unified CM)

Prilagodite gumb Akcija

Prilagođene opcije za gumb Action na Cisco Desk Phone 9800 seriji zahtijevaju određenu podršku za firmver tvrtke PhoneOS. Za detalje pogledajte sljedeću tablicu:

Značajka	Potrebna verzija firmvera
Hitni poziv	PhoneOS 3.0.1 i noviji
Prilagođena usluga	PhoneOS 3.2.1 i noviji
Višestruki okidači	PhoneOS 3.3.1 i noviji
HTTP pošta	PhoneOS 3.3.1 i noviji
Više događaja na jednom okidaču	PhoneOS 3.4.1 i noviji

1	Prijavite se naCisco Unified Communications Manager Administration.
2	Po potrebi napravite jednu od sljedećih radnji: Da biste konfigurirali sve instalirane telefone, idite na Sustav > Konfiguracija poslovnog telefona. Da biste konfigurirali telefone koji dijele isti profil telefona, idite na U ređaj > Postavke uređaja > Zajednički profil telefona. Da biste konfigurirali pojedinačni telefon, idite na Uređ aj > Telefon. Zatim pronađite telefon i otvorite stranicu Konfiguracija telefona. Konfiguracija slijedi hijerarhijsku strukturu: Pojedinačne postavke uređaja imaju prednost nad postavkama na zajedničkom telefonskom profilu i razini poduzeća Uobičajene postavke profila telefona nadjačavaju postavke na razini poduzeća
3	Prilagodite postavke gumba Action sa sljedećim parametrima na temelju slučajeva upotrebe. Postoje tri skupine parametara za gumb Action, od kojih svaka odgovara usluzi s jedinstvenim okidačem. Ako je okidač usluge naveden u više grupa, postav ke u Grupi 1 imaju prednost nad postavkama u grupi 2 i 3, dok Grupa 2 ima prednost nad grupom 3. Hitni pozivi Konfigurirajte sljedeće parametre: Funkcija gumba za akciju: Odaberite Hitni poziv. Odredište usluge gumba ak cije: Unesite telefonski broj ili URI hitne službe. Naziv usluge gumba ak cije (Opcionalno): Navedite naziv usluge povezane s okidačem radnje. Ovo će se ime prikazati u poruci na zaslonu kada korisnik pritisne gumb, što označava koji će događaj biti pokrenut. Ako ime nije navedeno, hitni pozi v koristit će se kao naziv za prikaz. Odgoda biranja: Postavite vremensko razdoblje (u sekundama) kako bi telefon pokrenuo hitni poziv nakon otkrivanja okidača. Zadana vrijednost je 5 sekundi. Ako je postavljen na 0, poziv se upućuje odmah nakon otkrivanja ok idača. Okida č usluge Odaberite okidač s popisa: Jed no priti snite, dugo priti snite ili pritisnite 3 puta. Tihi hitni poziv (opcionalno): Poziv u nuždi prema zadanim postavkama funkcionira kao dvosmjerni poziv, slično ostalim odlaznim pozivima. Kada je omoguć en tihi poziv u nuždi, zvuk je tih na strani pozivatelja kako bi se izbjeglo privla čenje pažnje tijekom pozivanja. Samo primatelj poziva može prekinuti tihi poziv za hitne slučajeve. Tijekom tihog hitnog poziva zaslon telefona 9811 i 9841 će se zamrznuti, dok će zaslon na telefonima 9851, 9861 i 9871 biti isključen. Sve ostale funkcije su nepristupačne. Telefon vraća normalan rad nakon što primatelj završi poziv. Dopusti ti ho preuzimanje poziva u nu ždi (opcionalno): Omogućite ovu značajku ako omogućite korisnicima da pritisnu bilo koju tipku za vraćanje normalnog rada telefona uz održavanje hitnog poziva. Zvuk poziva ostaje tih osim ako korisnik ne poveća glasnoću zvučnika pomoću tipke za glasnoću. Prilagođene usluge Konfigurirajte sljedeće parametre: Funkcija gumba za akciju: Odaberite Prilagođ eno. Odredište usluge gumba ak cije: Unesite URL prilagođene usluge. URL mora početi s `http://`ili `https://`, na primjer, `https://10.11.20.159/path/service.xml`. Naziv usluge gumba ak cije (Opcionalno): Navedite naziv usluge povezane s okidačem. Ovo će se ime prikazati u poruci na zaslonu kada korisnik pritisne gumb, što označava koja će se usluga aktivirati. Kada nije navedeno ime, kao ime prikaza koristit će se prilagođ ena usluga. Prilagođeno polje sadržaja (opcionalno): Ako želite omogućiti telefonu slanje zahtjeva za HTTP Post kada se pritisne gumb Akcija, unesite HTTP podatke kao što su metoda, zaglavlje i sadržaj posta, s maksimalnom duljinom od 1024 znaka. Za primjere skripte POST i sintaksu pogledajte HTTP Post zahtjev za gumb Akcija. Odgoda biranja: Postavite vremensko razdoblje, u sekundama, kako bi telefon pokrenuo događaj nakon otkrivanja okidača. Zadana vrijednost je 5 sekundi. Kada je postavljen na 0, događaj se pokreće odmah nakon otkri vanja okidača. Okida č usluge Odaberite okidač s popisa: Jed no priti snite, dugo priti snite ili pritisnite 3 puta. Službena taj na (opcionalno): Unes ite tajnu provjere autentičnosti, token ili lozinku ako vaša prilagođena usluga zahtijeva prov jeru autentičnosti za pristup njoj. Unesena tajna prikazuje se kao maskirani niz i može se uputiti pomoću makronaredbe `$SS`u Prilagođenom polju sadržaja i odredištu usluge gumba akcije. Višestruki okidači Postavite parametre u svakoj skupini. Pogledajte gore navedene odjel jke Pozivi za hitne slučajeve i Prilagođene usluge. Jedan okidač za više događaja Konfigurirajte sljedeće parametre da biste okidaču dodijelili više događaja: Funkcija gumba za akciju: Odaberite Prilagođ eno. Odredište usluge gumba ak cije: Unesite telefonski broj za pozivanje i URL XML usluge u ovom formatu: `tel:<phonenumber or SIP URI> + <serviceURL>` URL mora početi sa `http://`ili `https://`. Primjer: `tel:1234 + https://10.11.20.159/path/service.xml` Naziv usluge gumba ak cije (Opcionalno): Navedite naziv usluge povezane s okidačem. Ovo će se ime prikazati u poruci na zaslonu kada korisnik pritisne gumb, što označava koja će se usluga aktivirati. Kada nije navedeno ime, kao ime prikaza koristit će se prilagođ ena usluga. Prilagođeno polje sadržaja (opcionalno): Ako želite omogućiti telefonu slanje zahtjeva za HTTP Post kada se pritisne gumb Akcija, unesite HTTP podatke kao što su metoda, zaglavlje i sadržaj posta, s maksimalnom duljinom od 1024 znaka. Za primjere skripte POST i sintaksu pogledajte HTTP Post zahtjev za gumb Akcija. Odgoda biranja: Postavite vremensko razdoblje, u sekundama, kako bi telefon pokrenuo događaj nakon otkrivanja okidača. Zadana vrijednost je 5 sekundi. Kada je postavljen na 0, događaj se pokreće odmah nakon otkri vanja okidača. Okida č usluge Odaberite okidač s popisa: Jed no priti snite, dugo priti snite ili pritisnite 3 puta. Službena taj na (opcionalno): Unes ite tajnu provjere autentičnosti, token ili lozinku ako vaša prilagođena usluga zahtijeva prov jeru autentičnosti za pristup njoj. Unesena tajna prikazuje se kao maskirani niz i može se uputiti pomoću makronaredbe `$SS`u Prilagođenom polju sadržaja i odredištu usluge gumba akcije. Tihi poziv za hit ne slučajeve (opcionalno): Ako ste u odredište usluge uključili telefonski broj ili URI za biranje, omogućavanjem ove značajke će se utišati pozivi za hit ne slučajeve. Prema zadanim postavkama, hitni poziv funkcionira kao dvosmjerni poziv, slično ostalim odlaznim pozivima. Kada je postavljen na omogućeno, zvuk je tih na strani pozivatelja kako bi se izbjeglo privlačenje pažnje tijekom ponovnog poziva. Samo primatelj poziva može prekin uti poziv. Tijekom tihog hitnog poziva zaslon telefona 9811 i 9841 će se zamrznuti, dok će zaslon na telefonima 9851, 9861 i 9871 biti isključen. Sve ostale funkcije su nepristupačne. Telefon vraća normalan rad nakon što primatelj završi poziv. Dopusti ti ho preuzimanje poziva u nu ždi (opcionalno): Omogućite ovu značajku ako omogućite korisnicima da pritisnu bilo koju tipku za vraćanje normalnog rada telefona uz održavanje hitnog poziva. Zvuk poziva ostaje tih osim ako korisnik ne poveća glasnoću zvučnika pomoću tipke za glasnoću. Više informacija o tim parametrima potražite u odjelj ku Parametri za gumb Akcija.
4	Odaberite Spremi.
5	Odaberite Pri mijeni konfiguraciju.

Reference

Parametri gumba Akcija

Parametri su dostupni u konfiguraciji poslovnog telefona, zajedničkom profilu telefona i pojedinačnoj konfiguraciji telefona.

Tablica 1. Parametri gumba Akcija
Parametar	Zadane postavke i opcije	Opis
Funkcija gumba za akciju 1 ~ 3	Zadano: Isključeno Opcije: Isključeno, Hitni poziv, Prilagođeno	Gumb možete konfigurirati s određenom uslugom. Isk ljučeno: Kada je postavljen na Isključeno, gumb Akcija za jednu uslugu na telefonu neće funkcionirati. Hitni pozi v: Korisnici mogu koristiti gumb Akcija za upuć ivanje hitnog poziva, ako je konfiguriran. Prilag ođeno: Korisnici mogu koristiti gumb Akcija za pristup prilagođenoj usluzi, ako je konfiguriran. Kada postavite polje na Hitni pozi v ili Pril agođeno, pobrinite se da unesete odredište usluge u polje Odre dište usluge gumba radnje. Ili će telefon prikazati pogrešku konfiguracije.
Naziv usluge gumba za akciju 1 ~ 3	Zadano: Prazno	Po želji navedite naziv usluge povezane s gumbom Akcija. Ovo će se ime prikazati u poruci na zaslonu kada korisnik pritisne gumb, što označava koja će se usluga aktivirati. Ako ne navedete ime, zadani naziv bit će Hitni poziv, Tihi poziv za hitne slučaj eve ili Prilagođena radnja na temelju vašeg odabira u polju Fun kcija gum ba radnje.
Odredište usluge gumba za akciju 1 ~ 3	Zadano: Prazno	Navedite odredište usluge u jednom od sljedećih formata na temelju usluge dodijeljene gumbu Akcija: Za usluge hitnog poziva unesite telefonski broj ili URI hitne službe. Kada konfigurirate gumb za prilagođenu uslugu, unesite URL usluge. URL mora početi sa `http://`ili `https://`. Na primjer, `https://10.11.20.159/path/service.xml`. Da biste konfigurirali gumb za pokretanje više događaja jednim okidačem, unesite `tel:<phonenumber or SIP URL> + <Service RUL>`. Primjer: `tel:1234 + https://10.11.20.159/path/service.xml`. Podržano je i pozivanje SIP URI-ova. Unesite URI u formatu `tel: sip 4567@co.webex.com` Ako omogućite gumb Akcija bez postavljanja valjanog odredišta usluge, koris nik na telefonu vidjet će poruku u kojoj se traži konfiguracija. Nakon što korisnik zatvori ovu obavijest, ikona upozorenja će ostati u zaglavlju zaslona telefona sve dok gumb nije pravilno konfiguriran ili onemogućen. Telefonski brojevi ne mogu se koristiti kao odredišta za prilagođene usluge. Ako gumb Akcija konfigurirate kao Pril agođeno i unesete telefonski broj kao odredište usluge, na telefonu će se prikazati poruka upozorenja koja pokazuje da gumb nije konfiguriran. Umjesto toga, možete dodati telefonski broj u ovom formatu `tel:<phone number>`, na primjer, `tel:1234`. Ako vam nije dopušteno unositi URL koji uključuje ampersand (&), upotrijebite %26 kao zamjenu. Na primjer, unesite http://1.2.3.4/phone?a=1%26b=2%26c=3 umjesto http://1.2.3.4/phone?a=1&b=2&c=3.
Prilagođeno polje sadržaja 1 ~ 3	Zadano: Prazno	Ova postavka funkcionira samo kada je funkcija gumba za akciju postavljena na Prilag ođeno. Unesite HTTP podatke kao što su metoda, zaglavlje i sadržaj posta, s maksimalnom duljinom od 1024 znaka. Kada je konfiguriran, telefon šalje zahtjev HTTP Post kada se pritisne Akcija. Ako usluga zahtijeva provjeru autentičnosti za pristup, svakako unesite tajnu provjere autentičnosti u polje Službena taj na. U HTTP podacima upotrijebite makronared `$SS`bu kao referencu na Service Secret. Primjere i sintaksu potražite u članku HTTP Post zahtjev za gumb Akcija.
Službena tajna 1 ~ 3	Zadano: Prazno	Službena tajna može biti tajna provjere autentičnosti, token ili lozinka. Unesena tajna prikazuje se kao maskirani niz i može se uputiti pomoću makronaredbe `$SS`u Prilagođenom polju sadržaja i odredištu usluge gumba akcije.
Servisni okidač 1 ~ 3	Zadano: Jedno pritisnite Opcije: Jedno pritisnite, dugo pritisnite, pritisnite 3 puta	Odaberite način na koji korisnici mogu uputiti hitni poziv ili pokrenuti prilagođenu uslugu pomoću gumba Action na telefonu. Jedno pritisk anje: Pritisnite gumb Akcija da biste pokren uli povezani poziv ili uslugu. Dugo priti snite: Pritisnite gumb Akcija dolje najmanje 2 sekunde da biste pokrenuli povezani poziv ili uslugu. Pritisnite 3 puta: Pritisnite gumb Akcija tri puta s intervalima kraćim od 2 sekunde između svakog pritiska da biste pokrenuli povezani poziv ili uslugu. Ne ponavljajte okidač u više usluga jer parametri s nižim prioritetom neće funkcionirati. Redoslijed prioriteta, od najvišeg do najnižeg, je sljedeći: Grupa 1, Grupa 2, Grupa 3.
Odgoda biranja 1 ~ 3	Zadano: 5 Opcije: 0 - 30	Postavite vremensko razdoblje, u sekundama, kako bi telefon pokrenuo hitni poziv ili prilagođenu radnju nakon što pritisnete gumb Akcija. Postavite ga na 0 ako želite da telefon upućuje poziv ili pokrene događaj odmah nakon otkrivanja okidača, kako je navedeno jednim pritiskom, dugim pritiskom ili trostrukim pritiskom na gumb.
Tihi poziv za hitne slučajeve 1 ~ 3	Zadano: Onemogućeno Opcije: Omogućeno, Onemogućeno	Tihi hitni poziv namijenjen je diskretnoj pomoći u opasnim situacijama. Omogućuje korisnicima da potraže pomoć bez stvaranja buke. Kada je omogućeno, korisnici mogu upućivati jednosmjerne pozive pomoću gumba Akcija. Nakon postavljanja tihog hitnog poziva, samo druga strana može prekinuti poziv. Kako biste izbjegli privlačenje pozornosti tijekom tekućeg poziva, zaslon na telefonima 9811 i 9841 će se zamrznuti, dok će zaslon na telefonima 9851, 9861 i 9871 biti isključen. Telefon zaključava sve funkcije tijekom tihog hitnog poziva, prema zadanim postavkama. Da biste omogućili korisnicima da vrate normalan rad telefona uz održavanje tihog hitnog poziva, omogućite značajku Dopusti tihi hitni poziv za hit ne slučajeve. Kada je onemogućen, hitni poziv funkcionira kao dvosmjerni poziv, slično ost alim odlaznim pozivima.
Dopusti tiho preuzimanje poziva u nuždi	Zadano: Ne Opcije: Da, Ne	Kontrolira mogu li korisnici dohvatiti funkciju telefona tijekom tihog hitnog poziva. Prema zadanim postavkama, nakon što se pokrene tihi poziv za hitne slučajeve, telefon zaključava sve funkcije dok primatelj poziva ne završi poziv. Kada je ovaj parametar postavljen na Da, korisnici mogu pritisnuti bilo koju tipku za vraćanje normalnog rada telefona uz održavanje hitnog poziva. Zvuk poziva ostaje tih osim ako korisnik ne poveća glasnoću pomoću tipke za glas noću.

HTTP Post zahtjev za gumb Akcija

Gumb Action na Cisco Desk Phone 9800 Series može se konfigurirati za pokretanje XML aplikacija putem HTTP Post zahtjeva.

U polje Prilagođeni sadržaj unesite prilagođenu skriptu zahtjeva. Možete odrediti XML ili JSON vrstu sadržaja i uključiti makronaredbe u zahtjev. Na primjer, $SSmože se dodati u skriptu za preuzimanje tajne provjere autentičnosti, tokena ili lozinke navedenih u polju Službena taj na.

Sljedeći primjeri su u XML-u i JSON-u:

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) zahtijeva postotak kodiranja rezerviranih znakova u skladu s RFC 3986.

Tablica 2. Postotak kodiranja za rezervirane znakove
Karakter	Postotak kodiranja
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

Sljedeća skripta je primjer korištenja postotno kodiranih nizova.

--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

Tablica 3. Podržane makronaredbe
Naziv makro	Makro proširenje
#DEVICENAME#	Naziv uređaja prikazan u sustavu poziva. Na primjer, SEP845A3EC21288
$SS	Službena tajna koja prikazuje maskirani niz na stranici za konfiguraciju telefona, poput tajne provjere autentičnosti, tokena ili lozinke.

Cisco AI Assistant

Hvala na povratnim informacijama.

Prilagodite gumb Akcija

Reference

Parametri gumba Akcija

HTTP Post zahtjev za gumb Akcija

Malo poslovanje

Poduzeće

Uređaji

Rješenja za

Resursi

Tvrtka