Anpassa åtgärdsknappen

De anpassade alternativen för knappen Åtgärd på Cisco Desk Phone 9800-serien kräver särskilt stöd för inbyggd programvara i PhoneOS. Mer information finns i följande tabell:

FunktionErforderlig firmwareversion
NödsamtalPhoneOS 3.0.1 och senare
Anpassad tjänstPhoneOS 3.2.1 och senare
Flera utlösarePhoneOS 3.3.1 och senare
HTTP-inläggPhoneOS 3.3.1 och senare
Flera händelser på en enda utlösarePhoneOS 3.4.1 och senare
1

Logga in på Cisco Unified Communications Manager Administration.

2

Gör något av följande efter behov:

  • Om du vill konfigurera alla distribuerade telefoner går du till System > Företagstelefonkonfiguration.
  • Om du vill konfigurera telefoner som delar samma telefonprofil går du till Enhet > Enhetsinställningar > Allmän telefonprofil.
  • Om du vill konfigurera en enskild telefon går du till Enhet > Telefon. Hitta sedan din telefon och öppna sidan Telefonkonfiguration.

Konfigurationen följer en hierarkisk struktur:

  • Enskilda enhetsinställningar har företräde framför inställningar på allmän telefonprofil och företagsnivå
  • Allmänna telefonprofilinställningar åsidosätter inställningar på företagsnivå

3

Anpassa inställningarna för åtgärdsknappen med följande parametrar baserat på dina användningsfall.

Det finns tre grupper av parametrar för åtgärdsknappen, som var och en motsvarar en tjänst med en unik utlösare. Om en tjänstutlösare anges i flera grupper har inställningarna i Grupp 1 företräde framför inställningarna i Grupp 2 och 3, medan Grupp 2 har prioritet framför Grupp 3.

  • Nödsamtal

    Konfigurera följande parametrar:

    • Åtgärdsknappsfunktion: Välj Nödsamtal.

    • Mål för tjänsten med åtgärdsknapp: Ange telefonnummer eller URI för räddningstjänsten.

    • Åtgärdsknapp Tjänstnamn (valfritt): Ange ett namn för tjänsten som är kopplad till åtgärdsutlösaren. Det här namnet visas i meddelandet på skärmen när användaren trycker på knappen, vilket indikerar vilken händelse som kommer att initieras. Om inget namn anges används nödsamtal som visningsnamn.

    • Fördröjning vid uppringning: Ställ in timeout-perioden (i sekunder) för telefonen att initiera ett nödsamtal efter att avtryckaren har identifierats. Standardvärdet är 5 sekunder. Om värdet är 0 rings samtalet omedelbart när avtryckaren identifieras.

    • Tjänstutlösare Välj en utlösare i listan: Enkel tryckning, Långt tryck eller Tryck 3 gånger.

    • Tyst nödsamtal (valfritt): Som standard fungerar nödsamtalet som ett tvåvägssamtal, på samma sätt som andra utgående samtal. När tyst nödsamtal är aktiverat är ljudet tyst på uppringarsidan för att undvika att dra till sig uppmärksamhet under samtalet. Det är bara samtalsmottagaren som kan avsluta det tysta nödsamtalet.

      Under ett tyst nödsamtal fryser skärmen på telefon 9841 medan skärmen på telefon 9851, 9861 och 9871 stängs av. Alla andra funktioner är otillgängliga. Telefonen återgår till normal funktion när mottagaren avslutar samtalet.

    • Tillåt hämtning av tysta nödsamtal (valfritt): Aktivera den här funktionen om du tillåter användare att trycka på valfri knapp för att återställa normal telefonfunktion samtidigt som nödsamtalet upprätthålls. Samtalsljudet förblir tyst om inte användaren höjer högtalarvolymen med volymknappen.

  • Anpassade tjänster

    Konfigurera följande parametrar:

    • Åtgärd knappfunktion: Välj Anpassad.

    • Åtgärdsknapp Tjänstmål: Ange URL:en till den anpassade tjänsten. URL:en måste börja med http:// eller https://, till exempel https://10.11.20.159/path/service.xml.

    • Åtgärdsknapp Tjänstnamn (valfritt): Ange ett namn för den tjänst som är kopplad till utlösaren. Det här namnet visas i meddelandet på skärmen när användaren trycker på knappen, vilket indikerar vilken tjänst som kommer att utlösas. Om inget namn anges används den anpassade tjänsten som visningsnamn.

    • Anpassat innehållsfält (valfritt): Om du vill att telefonen ska kunna skicka en HTTP-postbegäran när du trycker på knappen Åtgärd anger du HTTP-data som metod, rubrik och inläggsinnehåll, med en maximal längd på 1024 tecken.

      Exempel på POST-skript och syntaxen finns i HTTP Post-begäran för knappen Åtgärd.

    • Fördröjning vid uppringning: Ställ in timeoutperioden, i sekunder, för telefonen att initiera en händelse efter att utlösaren har upptäckts. Standardvärdet är 5 sekunder. När värdet är 0 initieras händelsen omedelbart vid identifiering av utlösaren.

    • Tjänstutlösare Välj en utlösare i listan: Enkel tryckning, Långt tryck eller Tryck 3 gånger.

    • Tjänsthemlighet (valfritt): Ange autentiseringshemlighet, token eller lösenord om din anpassade tjänst kräver autentisering för att komma åt den. Den angivna hemligheten visas som en maskerad sträng och kan refereras med makrot $SS i fältet Anpassat innehåll och Tjänstmål för åtgärdsknappen.

  • Flera utlösare

    Ställ in parametrarna i respektive grupp. Se avsnitten Nödsamtal och Anpassade tjänster ovan.

  • En enda utlösare för flera händelser

    Konfigurera följande parametrar för att tilldela flera händelser till en utlösare:

    • Åtgärd knappfunktion: Välj Anpassad.

    • Tjänstmål för åtgärdsknapp: Ange telefonnumret att ringa och XML-tjänstens URL i följande format:

      tel:<telefonnummer eller SIP-URI> + <serviceURL>

      URL:en måste börja med http:// eller https://.

      Exempel: tel:1234 + https://10.11.20.159/path/service.xml

    • Åtgärdsknapp Tjänstnamn (valfritt): Ange ett namn för den tjänst som är kopplad till utlösaren. Det här namnet visas i meddelandet på skärmen när användaren trycker på knappen, vilket indikerar vilken tjänst som kommer att utlösas. Om inget namn anges används den anpassade tjänsten som visningsnamn.

    • Anpassat innehållsfält (valfritt): Om du vill att telefonen ska kunna skicka en HTTP-postbegäran när du trycker på knappen Åtgärd anger du HTTP-data som metod, rubrik och inläggsinnehåll, med en maximal längd på 1024 tecken.

      Exempel på POST-skript och syntaxen finns i HTTP Post-begäran för knappen Åtgärd.

    • Fördröjning vid uppringning: Ställ in timeoutperioden, i sekunder, för telefonen att initiera en händelse efter att utlösaren har upptäckts. Standardvärdet är 5 sekunder. När värdet är 0 initieras händelsen omedelbart vid identifiering av utlösaren.

    • Tjänstutlösare Välj en utlösare i listan: Enkel tryckning, Långt tryck eller Tryck 3 gånger.

    • Tjänsthemlighet (valfritt): Ange autentiseringshemlighet, token eller lösenord om din anpassade tjänst kräver autentisering för att komma åt den. Den angivna hemligheten visas som en maskerad sträng och kan refereras med makrot $SS i fältet Anpassat innehåll och Tjänstmål för åtgärdsknappen.

    • Tyst nödsamtal (valfritt): Om du har angett ett telefonnummer eller ringt URI i tjänstdestinationen kommer tysta nödsamtal om du aktiverar den här funktionen.

      Som standard fungerar nödsamtal som ett tvåvägssamtal, på samma sätt som andra utgående samtal. När inställningen är aktiverad är ljudet tyst på uppringarsidan för att undvika att dra till sig uppmärksamhet under samtalet. Endast samtalsmottagaren kan avsluta samtalet.

      Under ett tyst nödsamtal fryser skärmen på telefon 9841 medan skärmen på telefon 9851, 9861 och 9871 stängs av. Alla andra funktioner är otillgängliga. Telefonen återgår till normal funktion när mottagaren avslutar samtalet.

    • Tillåt hämtning av tysta nödsamtal (valfritt): Aktivera den här funktionen om du tillåter användare att trycka på valfri knapp för att återställa normal telefonfunktion samtidigt som nödsamtalet upprätthålls. Samtalsljudet förblir tyst om inte användaren höjer högtalarvolymen med volymknappen.

Mer information om dessa parametrar finns i Parametrar för åtgärdsknappen.

4

Välj Spara.

5

Välj Använd konfig.

Referenser

Parametrar för knappen Åtgärd

Parametrarna är tillgängliga i Företagstelefonkonfiguration, Allmän telefonprofil och Individuell telefonkonfiguration.

Tabell 1. Parametrar för knappen Åtgärd
ParameterStandard och alternativBeskrivning
Åtgärd knappfunktion 1 ~ 3

Standard: Av

Alternativ: Av, Nödsamtal, Anpassad

Du kan konfigurera knappen med en specifik tjänst.

  • Av: När du är inställd på Av kommer åtgärdsknappen för enstaka tjänster på telefonen inte att fungera.
  • Nödsamtal: Användare kan använda åtgärdsknappen för att ringa ett nödsamtal, om det har konfigurerats.
  • Anpassad: Användare kan använda åtgärdsknappen för att komma åt den anpassade tjänsten, om den har konfigurerats.

När du ställer in fältet på Nödsamtal eller Anpassad , se till att du anger tjänstedestinationeni fältet Åtgärdsknapp Tjänstdestination . Eller så visar telefonen ett konfigurationsfel.

Åtgärdsknapp Tjänstnamn 1 ~ 3

Standard: tomt

Du kan också ange ett namn på tjänsten som är kopplad till knappen Åtgärd. Det här namnet visas i meddelandet på skärmen när användaren trycker på knappen, vilket indikerar vilken tjänst som kommer att utlösas.

Om du inte anger ett namn blir standardnamnet Nödsamtal, Tyst nödsamtal eller Anpassad åtgärd baserat på ditt val i fältet Åtgärdsknappsfunktion .

Åtgärdsknapp Tjänstedestination 1 ~ 3

Standard: tomt

Ange tjänstmålet i något av följande format baserat på den tjänst som tilldelats åtgärdsknappen:

  • För nödsamtalstjänster anger du ett telefonnummer eller URI för räddningstjänsten.

  • När du konfigurerar knappen för en anpassad tjänst anger du tjänstens URL. URL:en måste börja med http:// eller https://. Till exempel https://10.11.20.159/path/service.xml.

  • Om du vill konfigurera knappen så att flera händelser initieras med en enda utlösare anger du tel:<telefonnummer eller SIP-URL> + <Service RUL>. Exempel: tel:1234 + https://10.11.20.159/path/service.xml.

    Anrop av SIP-URI:er stöds också. Ange URI i formatet tel: sip 4567@co.webex.com

Om du aktiverar knappen Åtgärd utan att ange ett giltigt mål för tjänsten visas ett meddelande som uppmanar användaren att konfigurera tjänsten. När användaren har stängt det här meddelandet finns varningsikonen kvar i rubriken på telefonskärmen tills knappen är korrekt konfigurerad eller inaktiverad.

Telefonnummer kan inte användas som destinationer för anpassade tjänster. Om du konfigurerar åtgärdsknappen som anpassad och anger ett telefonnummer som mål för tjänsten visas ett varningsmeddelande på telefonen om att knappen inte är konfigurerad. I stället kan du lägga till ett telefonnummer i följande format : tel:<telefonnummer> , till exempel tel:1234.

Om du inte får ange en URL-adress med et-tecken (&), använd %26 som ersättning. Ange till exempel http://1.2.3.4/phone?a=1 %26b=2 %26c=3 i stället förhttp://1.2.3.4/phone?a=1&b=2&c=3.

Anpassat innehållsfält 1~3

Standard: tomt

Den här inställningen fungerar bara när knappen Åtgärd är inställd på Anpassad.

Ange HTTP-data som metod, rubrik och inläggsinnehåll, med en maximal längd på 1024 tecken. När den har konfigurerats skickar telefonen en HTTP Post-begäran när du trycker på Åtgärd.

Om tjänsten kräver autentisering för åtkomst måste du ange autentiseringshemligheten i fältet Tjänsthemlighet . I HTTP-data använder du makrot $SS som referens till Tjänsthemlighet.

Exempel och syntax finns i HTTP Post-begäran för knappen Åtgärd.

Service Secret 1 ~ 3

Standard: tomt

En tjänsthemlighet kan vara en autentiseringshemlighet, token eller ett lösenord. Den angivna hemligheten visas som en maskerad sträng och kan refereras med makrot $SS i fältet Anpassat innehåll och Tjänstmål för åtgärdsknappen.

Service Trigger 1 ~ 3

Standard: Ett tryck

Alternativ: Enkel tryckning, Långt tryck, Tryck 3 gånger

Välj hur användare kan ringa ett nödsamtal eller starta en anpassad tjänst med hjälp av telefonens åtgärdsknapp.

Ett tryck: Tryck på åtgärdsknappen för att utlösa det associerade samtalet eller tjänsten.

Långt tryck: Tryck nedåt på åtgärdsknappen i minst 2 sekunder för att utlösa det associerade samtalet eller tjänsten.

Tryck 3 gånger: Tryck på åtgärdsknappen tre gånger med intervall på mindre än 2 sekunder mellan varje tryck för att utlösa tillhörande samtal eller tjänst.

Upprepa inte en utlösare över flera tjänster, eftersom parametrarna med lägre prioritet inte fungerar. Prioritetsordningen, från högsta till lägsta, är följande: Grupp 1, Grupp 2, Grupp 3.

Uppringningsfördröjning 1 ~ 3

Standard: 5

Alternativ: 0 - 30

Ange tidsgränsen i sekunder för telefonen att initiera ett nödsamtal eller en anpassad åtgärd efter att knappen Åtgärd har tryckts in.

Ställ in den på 0 om du föredrar att telefonen ringer samtalet eller initierar en händelse omedelbart efter att utlösaren har upptäckts, vilket anges med en enda tryckning, ett långt tryck eller en trippeltryckning på knappen.

Tyst nödsamtal 1 ~ 3

Standardvärde: Inaktiverad

Alternativ: Aktiverad, Inaktiverad

Tyst nödsamtal är utformat för diskret hjälp i farliga situationer. Det gör det möjligt för användare att söka hjälp utan att göra något ljud.

  • När funktionen är aktiverad kan användare ringa enkelriktade samtal med åtgärdsknappen.

    När det tysta nödsamtalet har ringts kan endast den andra parten avsluta samtalet. För att undvika att dra till sig uppmärksamhet under det pågående samtalet fryser skärmen på telefon 9841, medan skärmen på telefon 9851, 9861 och 9871 stängs av. Telefonen låser som standard alla funktioner under ett tyst nödsamtal. Om du vill tillåta användare att återställa normal telefonfunktion samtidigt som det tysta nödsamtalet bibehålls aktiverar du funktionen Tillåt hämtning av tysta nödsamtal .

  • När nödsamtalet är inaktiverat fungerar det som ett tvåvägssamtal, ungefär som andra utgående samtal.

Tillåt hämtning av tysta nödsamtal

Standard: Nej

Alternativ: Ja, Nej

Styr om användare kan hämta telefonfunktioner under ett tyst nödsamtal. När ett tyst nödsamtal har initierats låser telefonen som standard alla funktioner tills samtalsmottagaren avslutar samtalet.

När den här parametern är inställd på Ja kan användare trycka på valfri knapp för att återställa normal telefonfunktion samtidigt som nödsamtalet bibehålls. Samtalsljudet förblir tyst om inte användaren höjer volymen med volymknappen.

HTTP-postbegäran för åtgärdsknappen

Åtgärdsknappen på Cisco Desk Phone 9800-serien kan konfigureras för att utlösa XML-program via HTTP Post-begäranden.

I fältet Anpassat innehåll anger du ditt anpassade förfrågningsskript. Du kan ange antingen XML- eller JSON-innehållstyp och inkludera makron i begäran. Till exempel kan $SS läggas till i skriptet för att hämta autentiseringshemligheten, token eller lösenordet som anges i fältet Tjänsthemlighet .

Följande exempel finns i XML och JSON:

Exempel #1: XML --method POST --header 'Content-Type: application/xml' --header 'Authorization: Bearer username:$SS' --body '<MetaData><Trigger>True</Trigger><Description>Detta är för HTTP POST XML</Description></MetaData>' Exempel #2: JSON --method POST --header 'Content-Type: application/json' --header 'Authorization: $SS' --body '{"events":[{"evtid":"12345",  "parameters": {"trigger":true}, "Description":"Detta är för HTTP POST JSON"}]}'

Cisco Unified Communications Manager (UCM) kräver procentkodning för de reserverade tecknen i enlighet med RFC 3986.

Tabell 2. Procentkodning för reserverade tecken
KaraktärProcentkodning
&%26
'%27
"%22
< %3c
> %3e

Följande skript är ett exempel som använder procentkodade strängar.

--method POST --header %27Content-Type: application/xml%27 --body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eDetta är för HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
Tabell 3. Makron som stöds
MakronamnMakroexpandering
#DEVICENAME#Enhetsnamnet som visas i uppringningssystemet. Till exempel SEP845A3EC21288
$SSTjänsthemlighet som visar en maskerad sträng på telefonkonfigurationssidan, till exempel autentiseringshemlighet, token eller lösenord.