Konfigurer handlingsknappen for 9800 (Unified CM)

Tilpass Handlingsknappen

De tilpassede alternativene for handlingsknappen på Cisco Desk Phone 9800-serien krever spesifikk PhoneOS-firmwarestøtte. Se følgende tabell for detaljer:

Funksjon	Nødvendig fastvareversjon
Nødanrop	PhoneOS 3.0.1 og nyere
Tilpasset service	PhoneOS 3.2.1 og nyere
Flere utløsere	PhoneOS 3.3.1 og nyere
HTTP-innlegg	PhoneOS 3.3.1 og nyere
Flere hendelser på en enkelt trigger	PhoneOS 3.4.1 og nyere

1	Logg inn påCisco Unified Communications Manager Administration.
2	Gjør en av følgende handlinger etter behov: Hvis du vil konfigurere alle distribuerte telefoner, går du til System > Enterprise Phone Configuration. Hvis du vil konfigurere telefoner som deler samme telefonprofil, går du til Enhet > Enhetsinnstillinger > Felles telefonprofil. Hvis du vil konfigurere en individuell telefon, går du til Enh et > Telefon. Finn deretter telefonen din og åpne siden Telefonkonfigurasjon. Konfigurasjonen følger en hierarkisk struktur: Individuelle enhetsinnstillinger har forrang fremfor innstillinger i den vanlige telefon profilen og bedriftsnivået Vanlige telefonprofilinnstillinger overstyrer innstillinger på bedriftsnivå
3	Tilpass innstillingene for handlingsknappen med følgende parametere basert på bruks tilfellene dine. Det er tre grupper av parametere for Handlingsknappen, som hver tilsvarer en tjeneste med en unik trigger. Hvis en tjenesteutløser er spesifisert i flere grupper, har innstillingene i gruppe 1 prioritet over de i gruppe 2 og 3, mens gruppe 2 har prioritet over gruppe 3. Nødanrop Konfigurer følgende parametere: Handlingsknappfunksjon: Velg Nø danrop. Handlingsknapp Tjenestedestinasjon: Skriv inn telefonnummeret eller URI-en til nødetjenesten. Tjenestenavn for handling sknapp (valgfritt): Angi et navn for tjenesten som er knyttet til handlingsutløseren. Dette navnet vises i meldingen på skjermen når brukeren trykker på knappen, som indikerer hvilken hendelse som skal star tes. Hvis det ikke er angitt noe navn, brukes nø danrop som visningsnavn. Oppringingsforsinkelse: Angi tidsavbruddsperioden (i sekunder) for at telefonen skal starte et nødanrop etter at utløseren er oppdaget. Standardverdien er 5 sekunder. Hvis innstilt til 0, blir anropet plassert umiddelbart etter deteksjon av ut løseren. Service Trigger Velg en utløser fra listen: Enkelttrykk, Lang t trykk eller Trykk 3 ganger. Stille nødanrop (valgfritt): Som standard fungerer nødanro pet som en toveissamtale, i likhet med andre utgående samtaler. Når stille nødanrop er aktivert, er lyden stille på innringersiden for å unngå å trekke oppmerksomhet under samtalen. Bare samtalemottakeren kan avslutte det stille nødanropet. Under et stille nødanrop vil skjermen på telefon 9811 og 9841 fryse, mens skjermen på telefon 9851, 9861 og 9871 blir slått av. Alle andre funksjoner er utilgjengelige. Telefonen gjenoppretter normal drift etter at mottakeren avslutter samtalen. Tillat henting av stille nødanrop (valgfritt): Aktiver denne funksjonen hvis du lar brukerne trykke på en hvilken som helst tast for å gjenopprette normal telefondrift mens du opprettholder nødanropet. Samtalelyden forblir stille med mindre brukeren øker høyttaler volumet ved hjelp av volumtasten. Tilpassede tjenester Konfigurer følgende parametere: Handlingsknappfunksjon: Velg Egendefinert. Handlingsknapp Tjenestedestinasjon: Skriv inn URL-adressen til den tilpassede tjenesten. URL-en må starte med `http://`eller `https://`, for eksempel, `https://10.11.20.159/path/service.xml`. Tjenestenavn for handling sknapp (valgfritt): Angi et navn for tjenesten som er knyttet til utløseren. Dette navnet vises i meldingen på skjermen når brukeren trykker på knappen, som indikerer hvilken tjeneste som skal utløses. Når det ikke er angitt noe navn, brukes Egendefinert tjeneste som visningsnavn. Egendefinert innholdsf elt (valgfritt): Hvis du vil aktivere telefonen til å sende en HTTP-innleggsforespørsel når du trykker på Handlingsknappen, angir du HTTP-dataene, for eksempel metode, overskrift og innleggsinnhold, med en maksimal lengde på 1024 tegn. Hvis du vil ha eksempler på POST-skript og syntaks, kan du se HTTP Post-forespørsel for handlingsknappen. Oppringingsforsinkelse: Angi tidsavbrud dsperioden, i sekunder, for at telefonen skal starte en hendelse etter å ha oppdaget utløseren. Standardverdien er 5 sekunder. Når den er satt til 0, initieres hendelsen umiddelbart etter ut løserdeteksjon. Service Trigger Velg en utløser fra listen: Enkelttrykk, Lang t trykk eller Trykk 3 ganger. Tjenestehemmeligh et (valgfritt): Angi godkjenningshemmeligheten, tokenet eller passordet hvis den tilpassede tjenesten krever god kjenning for å få tilgang til den. Den angitte hemmeligheten vises som en maskert streng og kan refereres til ved hjelp av makroen `$SS`i Egendefinert innholdsfelt og Hand ling sknapp Tjeneste destinasjon. Flere utløsere Angi parametrene i hver gruppe henholdsvis. Se seksjonene Nødanrop og Tilpassede tjenester ovenfor. En enkelt utløser for flere hendelser Konfigurer følgende parametere for å tilordne flere hendelser til en utløser: Handlingsknappfunksjon: Velg Egendefinert. Handlingsknapp Tjenestedestinasjon: Skriv inn telefon nummeret du vil ringe og XML-tjenestens URL i dette formatet: `tel:<phonenumber or SIP URI> + <serviceURL>` URL-en må starte med `http://`eller `https://`. Eksempel: `tel:1234 + https://10.11.20.159/path/service.xml` Tjenestenavn for handling sknapp (valgfritt): Angi et navn for tjenesten som er knyttet til utløseren. Dette navnet vises i meldingen på skjermen når brukeren trykker på knappen, som indikerer hvilken tjeneste som skal utløses. Når det ikke er angitt noe navn, brukes Egendefinert tjeneste som visningsnavn. Egendefinert innholdsf elt (valgfritt): Hvis du vil aktivere telefonen til å sende en HTTP-innleggsforespørsel når du trykker på Handlingsknappen, angir du HTTP-dataene, for eksempel metode, overskrift og innleggsinnhold, med en maksimal lengde på 1024 tegn. Hvis du vil ha eksempler på POST-skript og syntaks, kan du se HTTP Post-forespørsel for handlingsknappen. Oppringingsforsinkelse: Angi tidsavbrud dsperioden, i sekunder, for at telefonen skal starte en hendelse etter å ha oppdaget utløseren. Standardverdien er 5 sekunder. Når den er satt til 0, initieres hendelsen umiddelbart etter ut løserdeteksjon. Service Trigger Velg en utløser fra listen: Enkelttrykk, Lang t trykk eller Trykk 3 ganger. Tjenestehemmeligh et (valgfritt): Angi godkjenningshemmeligheten, tokenet eller passordet hvis den tilpassede tjenesten krever god kjenning for å få tilgang til den. Den angitte hemmeligheten vises som en maskert streng og kan refereres til ved hjelp av makroen `$SS`i Egendefinert innholdsfelt og Hand ling sknapp Tjeneste destinasjon. Stille nødanrop (valgfritt): Hvis du har inkludert et telefonnummer eller en oppringings-URI i tjenestens destinasjon, vil nødanrop dempes hvis du aktiverer denne funksjonen. Som standard fungerer nødanropet som en toveissamtale, i likhet med andre utgående samtaler. Når den er satt til aktivert, er lyden stille på innringersiden for å unngå å trekke oppmerksomhet under samtalen. Bare samtalemottakeren kan avslut te samtalen. Under et stille nødanrop vil skjermen på telefon 9811 og 9841 fryse, mens skjermen på telefon 9851, 9861 og 9871 blir slått av. Alle andre funksjoner er utilgjengelige. Telefonen gjenoppretter normal drift etter at mottakeren avslutter samtalen. Tillat henting av stille nødanrop (valgfritt): Aktiver denne funksjonen hvis du lar brukerne trykke på en hvilken som helst tast for å gjenopprette normal telefondrift mens du opprettholder nødanropet. Samtalelyden forblir stille med mindre brukeren øker høyttaler volumet ved hjelp av volumtasten. Hvis du vil ha mer informasjon om disse parametrene, kan du se Parametere for Handlingsk nappen.
4	Velg Lagre.
5	Velg Bruk konfigurasjon.

Referanser

Parametere for Handlingsknappen

Parametrene er tilgjengelige i Enterprise Phone Configuration, Common Phone Profile og individuell telefonkonfigurasjon.

Tabell 1. Parametere for Handlingsknappen
Parameter	Standard og alternativer	Beskrivelse
Handlingsknappfunksjon 1 ~ 3	Standard: Av Alternativer: Av, Nødanrop, Egendefinert	Du kan konfigurere knappen med en bestemt tjeneste. Av: Når den er satt til Av, fungerer ikke Handlingsknappen for én tjeneste på telefonen. Nødanrop: Brukere kan bruke Handlingsknappen til å ringe et nødanrop, hvis konfigurert. Egendefinert: Brukere kan bruke Handlingsknappen for å få tilgang til den tilpassede tjenesten, hvis den er konfigurert. Når du angir feltet til Nødanrop eller Egen definert, må du sørge for at du angir tjenestens destinasjon i feltet Handlingsknapp Tjenestedestinasjon. Eller telefonen vil vise en konfigurasjonsfeil.
Handlingsknapp Tjenestenavn 1 ~ 3	Standard: Tom	Angi eventuelt et navn for tjenesten som er knyttet til Handlingsknappen. Dette navnet vises i meldingen på skjermen når brukeren trykker på knappen, som indikerer hvilken tjeneste som skal utløses. Hvis du ikke angir et navn, vil standardnavnet være Nødanrop, Stille nødanrop eller Egendefinert handling basert på valget ditt i Handlingsk nappfunksjon- feltet.
Handlingsknapp Tjenestedestinasjon 1 ~ 3	Standard: Tom	Angi tjenestemålet i ett av følgende formater basert på tjenesten som er tilordnet Handlingsknappen: For nødanropstjenester, skriv inn et telefonnummer eller URI for nødetjenesten. Når du konfigurerer knappen for en tilpasset tjeneste, skriver du inn tjenestens URL. URL-en må starte med `http://`eller `https://`. For eksempel, `https://10.11.20.159/path/service.xml`. Hvis du vil konfigurere knappen til å starte flere hendelser med en enkelt utløser, skriver du inn `tel:<phonenumber or SIP URL> + <Service RUL>`. Eksem pel: `tel:1234 + https://10.11.20.159/path/service.xml`. Å ringe SIP-URIer støttes også. Skriv inn URI i formatet `tel: sip 4567@co.webex.com` Hvis du aktiverer Handlingsknappen uten å angi et gyldig tjenestemål, vil brukeren på telefonen se en melding som ber om konfigurasjon. Etter at brukeren lukker dette varselet, vil advarselsikonet fortsette i over skriften på telefonskjermen til knappen er riktig konfigurert eller deaktivert. Telefonnumre kan ikke brukes som destinasjoner for tilpassede tjenester. Hvis du konfigurerer Handlingsknappen som Egen definert og angir et telefonnummer som tjenestemål, vises en varselmelding på telefonen som indikerer at knappen ikke er konfigurert. I stedet kan du legge til et telefonnummer i dette formatet `tel:<phone number>`, for eksempel `tel:1234`. Hvis du ikke har lov til å skrive inn en URL-adresse med ampersand (&), bruker du %26 som erstatning. Skriv for eksempel inn 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.
Egendefinert innholdsfelt 1 ~ 3	Standard: Tom	Denne innstillingen fungerer bare når Handlingsknapp funksjonen er satt til Egendefinert. Skriv inn HTTP-dataene, for eksempel metode, overskrift og innleggsinnhold, med en maksimal lengde på 1024 tegn. Når den er konfigurert, sender telefonen en HTTP-postforespørsel når handlingen trykkes. Hvis tjenesten krever god kjenning for å få tilgang, må du sørge for å angi godkjenningshemmeligheten i feltet Service Secret. I HTTP-dataene bruker du makroen `$SS`som referanse til Service Secret. For eksempler og syntaks, se HTTP Post-forespørsel for Handlingsk nappen.
Tjenestehemmelighet 1 ~ 3	Standard: Tom	En tjenestehemmelighet kan være en autentiseringshemmelighet, token eller passord. Den angitte hemmeligheten vises som en maskert streng og kan refereres til ved hjelp av makroen `$SS`i Egendefinert innholdsfelt og Hand ling sknapp Tjeneste destinasjon.
Tjenesteutløser 1 ~ 3	Standard: Enkelttrykk Alternativer: Enkelttrykk, Langt trykk, Trykk 3 ganger	Velg hvordan brukere kan ringe et nødanrop eller starte en tilpasset tjeneste ved hjelp av telefon ens Handlingsknapp. Enkelttrykk: Trykk på Handlingsknappen for å utløse den tilknyttede samtalen eller tjenesten. Langt trykk: Trykk Handlingsknappen ned i minst 2 sekunder for å utløse den tilknyttede samtalen eller tjenesten. Trykk 3 ganger: Trykk på Handlingsknappen tre ganger med intervaller på mindre enn 2 sekunder mellom hvert trykk for å utløse den tilknyt tede samtalen eller tjenesten. Ikke gjenta en trigger på tvers av flere tjenester, da parametrene med lavere prioritet ikke vil fungere. Prioritetsrekkefølgen, fra høyeste til laveste, er som følger: Gruppe 1, Gruppe 2, Gruppe 3.
Oppringingsforsinkelse 1 ~ 3	Standard: 5 Alternativer: 0 - 30	Angi tidsavbruddsperioden, i sekunder, for at telefonen skal starte et nødanrop eller en egendefinert handling etter at du har trykket på Handlingsknappen. Sett den til 0 hvis du foretrekker at telefonen skal ringe eller starte en hendelse umiddelbart etter oppdagelse av utløseren, som spesifisert av et enkelt trykk, langt trykk eller trippeltrykk på knappen.
Stille nødanrop 1 ~ 3	Standard: Deaktivert Alternativer: Aktivert, Deaktivert	Stille nødanrop er designet for diskret hjelp i farlige situasjoner. Det gjør det mulig for brukere å søke hjelp uten å lage støy. Når aktivert, kan brukerne ringe enveisanrop med Handlingsknappen. Etter at det stille nødanropet er plassert, er det bare den andre parten som kan avslutte samtalen. For å unngå å trekke oppmerksomhet under den pågående samtalen, vil skjermen på telefon 9811 og 9841 fryse, mens skjermen på telefon 9851, 9861 og 9871 blir slått av. Telefonen låser alle funksjoner under et stille nødanrop, som standard. Hvis du vil tillate brukere å gjenopprette normal telefondrift mens du opprettholder det stille nødanro pet, aktiverer du funksjonen Tillat h enting av stille nødanrop. Når den er deaktivert, fungerer nødanropet som en toveissamtale, i likhet med andre utgående samtaler.
Tillat lyd løs henting av nødanrop	Standard: Nei Alternativer: Ja, Nei	Styrer om brukere kan hente telefonfunksjonalitet under et stille nødanrop. Når et stille nødanrop startes, låser telefonen som standard alle funksjoner til samtalemottakeren avslutter samtalen. Når denne parameteren er satt til Ja, kan brukerne trykke på en hvilken som helst tast for å gjenopprette normal telefondrift mens nødanropet opprettholdes. Sam talelyden forblir stille med mindre brukeren øker volumet ved hjelp av volumta sten.

HTTP Post-forespørsel for handlingsknappen

Handlingsknappen på Cisco Desk Phone 9800-serien kan konfigureres til å utløse XML-applikasjoner gjennom HTTP Post-forespørsler.

I Egen definert innholdsfelt skriver du inn det tilpassede forespørselsskriptet. Du kan angi enten XML- eller JSON-innholdstype og inkludere makroer i forespørselen. For eksempel $SSkan legges til skriptet for å hente autentiseringshemmeligheten, tokenet eller passordet som er oppgitt i Tjenestehemmelse- feltet.

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) krever prosentkoding for de reserverte tegn ene i samsvar med RFC 3986.

Tabell 2. Prosentkoding for reserverte tegn
Karakter	Prosent koding
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

Følgende skript er et eksempel ved bruk av prosentkodede strenger.

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

Tabell 3. Støttede makroer
Makronavn	Makroutvidelse
#DEVICENAME#	Enhetsnavnet som vises i anropssystemet. For eksempel SEP845A3EC21288
$SS	Service Secret som presenterer en maskert streng på telefonkonfigurasjonssiden, for eksempel autentiseringshemmelighet, token, eller passord.

Cisco AI Assistant

Takk for tilbakemeldingen.

Tilpass Handlingsknappen

Referanser

Parametere for Handlingsknappen

HTTP Post-forespørsel for handlingsknappen

Liten bedrift

Bedrift

Enheter

Løsninger for

Ressurser

Firma