Konfigurer Handlingsknappen til 9800 (Unified CM)

Tilpas knappen Handling

De brugerdefinerede indstillinger for Handlingsknappen på Cisco Desk Phone 9800-serien kræver specifik PhoneOS-firmwaresupport. Se følgende tabel for detaljer:

Funktion	Nødvendig firmwareversion
Nødopkald	PhoneOS 3.0.1 og nyere
Brugerdefineret service	PhoneOS 3.2.1 og nyere
Flere udløsere	PhoneOS 3.3.1 og nyere
HTTP-indlæg	PhoneOS 3.3.1 og nyere
Flere hændelser på en enkelt trigger	PhoneOS 3.4.1 og nyere

1	Log ind påCisco Unified Communications Manager Administration.
2	Udfør en af følgende handlinger efter behov: Hvis du vil konfigurere alle installerede telefoner, skal du gå til System > Konfiguration af virksomhedstelefoner. Hvis du vil konfigurere telefoner, der deler den samme telefonprofil, skal du gå til Enhed > Enhedsindstillinger > Almindelig telefonprofil. Hvis du vil konfigurere en individuel telefon, skal du gå til Enh ed > Telefon. Find derefter din telefon, og åbn siden Telefonkonfiguration. Konfigurationen følger en hierarkisk struktur: Individuelle enhedsindstillinger har forrang frem for indstillinger i den fælles telefon profil og virksomhedsniveau Almindelige telefonprofilindstillinger tilsidesætter indstillinger på virksomhedsniveau
3	Tilpas indstillingerne for handlingsknappen med følgende parametre baseret på dine brugss ager. Der er tre grupper af parametre for Handlingsknappen, der hver svarer til en tjeneste med en unik trigger. Hvis en tjenesteudløser er angivet i flere grupper, har indstillingerne i gruppe 1 prioritet over indstillingerne i gruppe 2 og 3, mens gruppe 2 har prioritet over gruppe 3. Nødopkald Konfigurer følgende parametre: Handlingsknapfunktion: Vælg Nø dopkald. Handlingsknap Servicedestination: Indtast telefonnummeret eller URI 'en for alarmtjenesten. Tjenestenavn for handling sknap (valgfrit): Angiv et navn til den tjeneste, der er knyttet til handlingsudløseren. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken begivenhed der vil blive indledt. Hvis der ikke er angivet noget navn, bruges nø dopkald som visningsnavn. Opkaldsforsinkelse: Indstil timeout-perioden (i sekunder) for telefonen til at starte et nødopkald, efter at udløseren er registreret. Standardværdien er 5 sekunder. Hvis indstillet til 0, foretages opkaldet straks efter detektering af udløseren. Service Trigger Vælg en udløser fra listen: Enkelt tryk, Lang t tryk eller Tryk 3 gange. Stille nødopkald (valgfrit): Som standard fungerer nødop kaldet som et tovejsopkald, svarende til andre udgående opkald. Når lydløst nødopkald er aktiveret, er lyden lydløs på opkaldssiden for at undgå at tiltrække opmærksomhed under det lange opkald. Kun opkaldsmodtageren kan afslutte det lydløse nødopkald. Under et lydløst nødopkald fryser skærmen på telefon 9811 og 9841, mens skærmen på telefon 9851, 9861 og 9871 slukkes. Alle andre funktioner er utilgængelige. Telefonen gendanner normal drift, når modtageren afslutter opkaldet. Tillad hentning af lydløs nødop kald (valgfrit): Aktiver denne funktion, hvis du tillader brugere at trykke på en vilkårlig tast for at gendanne normal telefondrift, mens nødopkaldet oprethol des. Opkaldslyden forbliver lydløs, medmindre brugeren øger højttalerlydstyrken ved hjælp af lydstyrketasten. Brugerdefinerede tjenester Konfigurer følgende parametre: Handlingsknapfunktion: Vælg Brugerdefineret. Handlingsknap Servicedestination: Indtast URL-adressen til den brugerdefinerede tjeneste. URL'en skal starte med `http://`eller `https://`, for eksempel, `https://10.11.20.159/path/service.xml`. Tjenestenavn for handling sknap (valgfrit): Angiv et navn til den tjeneste, der er knyttet til udløseren. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken tjeneste der udløses. Når der ikke er angivet noget navn, bruges brugerdefineret tjeneste som visningsnavn. F@@ elt for brugerdefineret indhold (valgfrit): Hvis du vil aktivere telefonen til at sende en HTTP-opslagsanmodning, når du trykker på knappen Handling, skal du angive HTTP-dataene såsom metode, overskrift og postindhold med en maksimal længde på 1024 tegn. For POST-scripteksempler og syntaksen, se HTTP-postanmodning om knappen Handling. Opkaldsforsinkelse: Indstil timeout- perioden, i sekunder, for at telefonen skal starte en begivenhed efter at have registreret udløseren. Standardværdien er 5 sekunder. Når den er indstillet til 0, initieres hændelsen umiddelbart efter triggerdetektering. Service Trigger Vælg en udløser fra listen: Enkelt tryk, Lang t tryk eller Tryk 3 gange. Servicehemmelighed (valgfrit): Angiv godkendelseshemmeligheden, tokenet eller adgangskoden, hvis din brugerdefinerede tjeneste kræver godkendelse for at få adgang til den. Den indtastede hemmelighed vises som en maskeret streng og kan henvises til ved hjælp af makroen `$SS`i Bruger defineret indholds felt og Hand lingsknap Service destination. Flere udløsere Indstil parametrene i henholdsvis hver gruppe. Se afsnittene Nødopkald og Brugerdefinerede tjenester ovenfor. En enkelt trigger til flere begivenheder Konfigurer følgende parametre for at tildele flere hændelser til en trigger: Handlingsknapfunktion: Vælg Brugerdefineret. Handlingsknap Tjenestedestination: Indtast det telefonnummer, der skal ringes til, og XML-tjenestens URL i dette format: `tel:<phonenumber or SIP URI> + <serviceURL>` URL'en skal starte med `http://`eller `https://`. Eksempel: `tel:1234 + https://10.11.20.159/path/service.xml` Tjenestenavn for handling sknap (valgfrit): Angiv et navn til den tjeneste, der er knyttet til udløseren. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken tjeneste der udløses. Når der ikke er angivet noget navn, bruges brugerdefineret tjeneste som visningsnavn. F@@ elt for brugerdefineret indhold (valgfrit): Hvis du vil aktivere telefonen til at sende en HTTP-opslagsanmodning, når du trykker på knappen Handling, skal du angive HTTP-dataene såsom metode, overskrift og postindhold med en maksimal længde på 1024 tegn. For POST-scripteksempler og syntaksen, se HTTP-postanmodning om knappen Handling. Opkaldsforsinkelse: Indstil timeout- perioden, i sekunder, for at telefonen skal starte en begivenhed efter at have registreret udløseren. Standardværdien er 5 sekunder. Når den er indstillet til 0, initieres hændelsen umiddelbart efter triggerdetektering. Service Trigger Vælg en udløser fra listen: Enkelt tryk, Lang t tryk eller Tryk 3 gange. Servicehemmelighed (valgfrit): Angiv godkendelseshemmeligheden, tokenet eller adgangskoden, hvis din brugerdefinerede tjeneste kræver godkendelse for at få adgang til den. Den indtastede hemmelighed vises som en maskeret streng og kan henvises til ved hjælp af makroen `$SS`i Bruger defineret indholds felt og Hand lingsknap Service destination. Stille nødopkald (valgfrit): Hvis du har medtaget et telefonnummer eller en opkalds-URI i tjenestedestinationen, vil nødopkald blive lydløse ved aktivering af denne funktion. Som standard fungerer nødopkaldet som et tovejsopkald, svarende til andre udgående opkald. Når den er indstillet til aktiveret, er lyden lydløs på opkaldssiden for at undgå at tiltrække opmærksomhed under det lange opkald. Kun modtageren af opkaldet kan afslutte opkaldet. Under et lydløst nødopkald fryser skærmen på telefon 9811 og 9841, mens skærmen på telefon 9851, 9861 og 9871 slukkes. Alle andre funktioner er utilgængelige. Telefonen gendanner normal drift, når modtageren afslutter opkaldet. Tillad hentning af lydløs nødop kald (valgfrit): Aktiver denne funktion, hvis du tillader brugere at trykke på en vilkårlig tast for at gendanne normal telefondrift, mens nødopkaldet oprethol des. Opkaldslyden forbliver lydløs, medmindre brugeren øger højttalerlydstyrken ved hjælp af lydstyrketasten. Du kan finde flere oplysninger om disse parametre i Parametre for knappen Handling.
4	Vælg Gem.
5	Vælg Anvend konfiguration.

Referencer

Parametre for Handlingsknappen

Parametrene er tilgængelige i Enterprise Phone Configuration, Common Phone Profile og individuel telefonkonfiguration.

Tabel 1. Parametre for Handlingsknappen
Parameter	Standard og indstillinger	Beskrivelse
Handlingsknapfunktion 1 ~ 3	Standard: Fra Valgmuligheder: Fra, Nødopkald, Brugerdefineret	Du kan konfigurere knappen med en bestemt tjeneste. Fra: Når den er indstillet til Fra, fungerer Handlingsknappen for en enkelt tjeneste på telefonen ikke. Nødopkald: Brugere kan bruge Handlingsknappen til at foretage et nødopkald, hvis konfigureret. Brugerdefineret: Brugere kan bruge knappen Handling til at få adgang til den brugerdefinerede tjeneste, hvis den er konfigureret. Når du indstiller feltet til Nødopkald eller Bruger defineret, skal du sørge for, at du angiver tjeneste destinationen i feltet Handlingsknap Servicedestination. Eller telefonen viser en konfigurationsfejl.
Handlingsknap Tjenestenavn 1 ~ 3	Standard: Tom	Angiv eventuelt et navn til den tjeneste, der er knyttet til knappen Handling. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken tjeneste der udløses. Hvis du ikke angiver et navn, vil standardnavnet være Nødopkald, Lydløs nødopkald eller Brugerdefineret handling baseret på dit valg i feltet Handlingsknapfunktion.
Handlingsknap Servicedestination 1 ~ 3	Standard: Tom	Angiv tjenestedestinationen i et af følgende formater baseret på den tjeneste, der er tildelt knappen Handling: For nødopkaldstjenester skal du indtaste et telefonnummer eller alarmtjenst ens URI. Når du konfigurerer knappen til en brugerdefineret tjeneste, skal du indtaste tjenestens URL. URL'en skal starte med `http://`eller `https://`. For eksempel, `https://10.11.20.159/path/service.xml`. Hvis du vil konfigurere knappen til at starte flere hændelser med en enkelt udløser, skal du indtaste `tel:<phonenumber or SIP URL> + <Service RUL>`. Eksem pel: `tel:1234 + https://10.11.20.159/path/service.xml`. Opkald til SIP URI'er understøttes også. Indtast URI i formatet `tel: sip 4567@co.webex.com` Hvis du aktiverer knappen Handling uden at angive en gyldig servicedestination, vil brugeren på telefonen se en meddelelse, der beder om konfiguration. Når brugeren lukker denne meddelelse, fortsætter advarselsikonet i overskriften på telefon skærmen, indtil knappen er korrekt konfigureret eller deaktiveret. Telefonnumre kan ikke bruges som destinationer for brugerdefinerede tjenester. Hvis du konfigurerer Handlingsknappen som Brugerdefineret og angiver et telefonnummer som tjenestedestination, vises der en advarselsmeddelelse på telefonen, der angiver, at knappen ikke er konfigureret. I stedet kan du tilføje et telefonnummer i dette format `tel:<phone number>`, for eksempel `tel:1234`. Hvis du ikke har tilladelse til at indtaste en webadresse med ampersand (&), skal du bruge %26 som erstatning. Indtast f.eks. http://1.2.3.4/phone?a=1%26b=2%26c=3 i stedet for http://1.2.3.4/phone?a=1&b=2&c=3.
Brugerdefineret indholdsfelt 1 ~ 3	Standard: Tom	Denne indstilling fungerer kun, når Handlingsknap funktionen er indstillet til Bruger defineret. Indtast HTTP-data såsom metode, overskrift og postindhold med en maksimal længde på 1024 tegn. Når den er konfigureret, sender telefonen en HTTP-postanmodning, når der trykkes på Handlingen. Hvis tjenesten kræver godkendelse for at få adgang, skal du sørge for at indtaste godkendelseshemmeligheden i feltet Service Secret. I HTTP-dataene skal du bruge makroen `$SS`som reference til Service Secret. For eksempler og syntaks, se HTTP Post anmodning om knappen Handling.
Tjenestehemmelighed 1 ~ 3	Standard: Tom	En servicehemmelighed kan være en godkendelseshemmelighed, token eller adgangskode. Den indtastede hemmelighed vises som en maskeret streng og kan henvises til ved hjælp af makroen `$SS`i Bruger defineret indholds felt og Hand lingsknap Service destination.
Servicetrigger 1 ~ 3	Standard: Enkelt tryk Valgmuligheder: Enkelt tryk, Langt tryk, Tryk 3 gange	Vælg, hvordan brugerne kan foretage et nødopkald eller starte en brugerdefineret tjeneste ved hjælp af telefon ens Handlingsknap. Enkelt tryk: Tryk på Handlingsknappen for at udløse det tilknyttede opkald eller service. Langt tryk: Tryk på Handlingsknappen ned i mindst 2 sekunder for at udløse det tilknyttede opkald eller service. Tryk 3 gange: Tryk på Handlingsknappen tre gange med intervaller på mindre end 2 sekunder mellem hvert tryk for at udløse det tilknyt tede opkald eller service. Gentag ikke en trigger på tværs af flere tjenester, da parametrene med lavere prioritet ikke fungerer. Prioritetsrækkefølgen, fra højeste til laveste, er som følger: Gruppe 1, Gruppe 2, Gruppe 3.
Opkaldsforsinkelse 1 ~ 3	Standard: 5 Valgmuligheder: 0 - 30	Indstil timeout-perioden, i sekunder, for telefonen til at starte et nødopkald eller en brugerdefineret handling, efter at der er trykket på Handlingsknappen. Indstil det til 0, hvis du foretrækker, at telefonen foretager opkaldet eller starter en begivenhed straks efter detektering af udløseren, som angivet ved et enkelt tryk, langt tryk eller tredobbelt tryk på knappen.
Lydløs nødopkald 1 ~ 3	Standard: Deaktiveret Indstillinger: Aktiveret, Deaktiveret	Lydløs nødopkald er designet til diskret hjælp i farlige situationer. Det giver brugerne mulighed for at søge hjælp uden at lave nogen støj. Når aktiveret, kan brugerne foretage envejsopkald med Handlingsknappen. Når det lydløse nødopkald er placeret, er det kun den anden part, der kan afslutte op kaldet. For at undgå at henlede opmærksomheden under det igangværende opkald fryser skærmen på telefon 9811 og 9841, mens skærmen på telefon 9851, 9861 og 9871 slukkes. Telefonen låser som standard alle funktioner under et lydløst nødopkald. For at give brugerne mulighed for at gendanne normal telefondrift, samtidig med at det lydløse nødop kald opretholdes, skal du aktivere funktionen Tillad hentning af lydløse nø dopkald. Når det er deaktiveret, fungerer nødopkaldet som et tovejsopkald, svarende til andre udgående opkald.
Tillad lyd løs hentning af nødopkald	Standard: Nej Valgmuligheder: Ja, Nej	Styrer, om brugerne kan hente telefonfunktioner under et lydløst nødopkald. Når et lydløst nødopkald er startet, låser telefonen som standard alle funktioner, indtil opkaldsmodtageren afslutter opkaldet. Når denne parameter er indstillet til Ja, kan brugerne trykke på en vilkårlig tast for at gendanne normal telefondrift, mens nødopkaldet opretholdes. Opkald slyden forbliver lydløs, medmindre brugeren øger lydstyrken ved hjælp af lydstyrket asten.

HTTP Post anmodning om handlingsknappen

Handlingsknappen på Cisco Desk Phone 9800-serien kan konfigureres til at udløse XML-applikationer via HTTP Post-anmodninger.

Angiv dit brugerdefinerede anmodningsscript i Brugerdefineret indholdsfelt. Du kan angive enten XML- eller JSON-indholdstype og inkludere makroer i anmodningen. $SSKan f.eks. føjes til scriptet for at hente godkendelseshemmeligheden, tokenet eller adgangskoden, der er angivet i feltet Servicehemmelighed.

Følgende eksempler er i XML og JSON:

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) kræver procentkodning for de reserverede tegn i overensstemmelse med RFC 3986.

Tabel 2. Procentkodning for reserverede tegn
Karakter	Procentkodning
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

Følgende script er et eksempel ved hjælp af procentkodede strenge.

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

Tabel 3. Understøttede makroer
Makronavn	Makroudvidelse
#DEVICENAME#	Enhedsnavnet, der vises i opkaldssystemet. For eksempel SEP845A3EC21288
$SS	Service Secret, der præsenterer en maskeret streng på telefonens konfigurationsside, såsom godkendelseshemmelighed, token, eller adgangskode.

Cisco AI Assistant

Tak for din feedback.

Tilpas knappen Handling

Referencer

Parametre for Handlingsknappen

HTTP Post anmodning om handlingsknappen

Små virksomheder

Virksomhed

Enheder

Løsninger til

Ressourcer

Virksomhed