In dit artikel
De actieknop aanpassen
dropdown icon
Referenties
    Parameters voor de actieknop
    HTTP Post-aanvraag voor de actieknop
Configureer de actieknop voor 9800 (Unified CM)
list-menuIn dit artikel
list-menuFeedback?

De actieknop is de rode knop rechtsboven op de telefoon. Hiermee hebben gebruikers snel toegang tot aangewezen diensten, zoals nooddiensten of douanediensten. U kunt de knop aanpassen om gebeurtenissen te starten die passen bij uw specifieke gebruikssituaties. De informatie op deze pagina is van toepassing op Cisco Desk Phone 9800 Series, geregistreerd onder Cisco Unified Communications Manager (Unified CM).

De actieknop aanpassen

Voor de aangepaste opties voor de actieknop op de Cisco Desk Phone 9800 Series is specifieke firmwareondersteuning voor PhoneOS vereist. Zie de volgende tabel voor meer informatie:

FunctieVereiste firmwareversie
NoodoproepPhoneOS 3.0.1 en hoger
Service op maatPhoneOS 3.2.1 en hoger
Meerdere triggersPhoneOS 3.3.1 en hoger
HTTP-berichtPhoneOS 3.3.1 en hoger
Meerdere gebeurtenissen op één enkele triggerPhoneOS 3.4.1 en hoger
1

Meld u aan bijCisco Unified Communications Manager Administration.

2

Voer indien nodig een van de volgende acties uit:

  • Om alle gebruikte telefoons te configureren, gaat u naar Systeem > Enterprise Phone Configuration.
  • Om telefoons met hetzelfde telefoonprofiel te configureren, gaat u naar Apparaat > Apparaatinstellingen > Algemeen telefoonprofiel.
  • Om een individuele telefoon te configureren, gaat u naar Apparaat > Telefoon. Zoek vervolgens uw telefoon en open de pagina Telefoonconfiguratie.

De configuratie volgt een hiërarchische structuur:

  • Individuele apparaatinstellingen hebben voorrang op instellingen in het algemene telefoonprofiel en op bedrijfsniveau
  • Algemene instellingen voor telefoonprofielen hebben voorrang op instellingen op bedrijfsniveau

3

Pas de instellingen van de actieknop aan met de volgende parameters op basis van uw gebruikssituaties.

Er zijn drie groepen parameters voor de actieknop, die elk overeenkomen met een service met een unieke trigger. Als een servicetrigger in meerdere groepen is gespecificeerd, hebben de instellingen in groep 1 voorrang op die in groep 2 en 3, terwijl groep 2 voorrang heeft op groep 3.

  • Noodoproepen

    Configureer de volgende parameters:

    • Functie van de actieknop: Selecteer een noodoproep.

    • Bestemming van de actieknop voor de service: Voer het telefoonnummer of de URI van de hulpdienst in.

    • Servicenaam van de actieknop (optioneel): Geef een naam op voor de service die is gekoppeld aan de actietrigger. Deze naam wordt weergegeven in het bericht op het scherm wanneer de gebruiker op de knop drukt, om aan te geven welke gebeurtenis zal worden gestart. Als er geen naam is opgegeven, wordt de noodoproep gebruikt als weergavenaam.

    • Uitstelvertraging: Stel de time-outperiode in (in seconden) voor de telefoon om een noodoproep te starten nadat de trigger is gedetecteerd. De standaardwaarde is 5 seconden. Indien ingesteld op 0, wordt de oproep onmiddellijk geplaatst nadat de trigger is gedetecteerd.

    • Servicetrigger Selecteer een trigger uit de lijst: één keer indrukken, lang indrukken of drie keer indrukken.

    • Stille noodoproep (optioneel): De noodoproep werkt standaard als een tweerichtingsgesprek, vergelijkbaar met andere uitgaande gesprekken. Als een stille noodoproep is ingeschakeld, is het geluid aan de kant van de beller stil om te voorkomen dat de aandacht wordt getrokken tijdens het lopende gesprek. Alleen de ontvanger van het gesprek kan de stille noodoproep beëindigen.

      Tijdens een stille noodoproep zal het scherm van de telefoons 9811 en 9841 vastlopen, terwijl het scherm van de telefoons 9851, 9861 en 9871 wordt uitgeschakeld. Alle andere functies zijn niet toegankelijk. De telefoon werkt weer normaal nadat de ontvanger het gesprek heeft beëindigd.

    • Silent Emergency Call Retrieval toestaan (optioneel): Schakel deze functie in als u gebruikers toestaat om op een willekeurige toets te drukken om de normale werking van de telefoon te herstellen terwijl de noodoproep wordt gehandhaafd. Het geluid van het gesprek blijft stil, tenzij de gebruiker het luidsprekervolume verhoogt met de volumetoets.

  • Diensten op maat

    Configureer de volgende parameters:

    • Functie van de actieknop: Selecteer Aangepast.

    • Actieknop Servicebestemming: Voer de URL van de aangepaste service in. De URL moet beginnen met http://of https://, https://10.11.20.159/path/service.xmlbijvoorbeeld

    • Servicenaam van de actieknop (optioneel): Geef een naam op voor de service die aan de trigger is gekoppeld. Deze naam wordt weergegeven in het bericht op het scherm wanneer de gebruiker op de knop drukt, om aan te geven welke service wordt geactiveerd. Als er geen naam is opgegeven, wordt de Custom Service gebruikt als weergavenaam.

    • Veld voor aangepaste inhoud (optioneel): Als u de telefoon in staat wilt stellen een HTTP Post-verzoek te verzenden wanneer u op de actieknop drukt, voert u de HTTP-gegevens in, zoals methode, koptekst en berichtinhoud, met een maximale lengte van 1024 tekens.

      Voor voorbeelden van POST-scripts en de syntaxis, zie HTTP Post-aanvraag voor de actieknop.

    • Uitstelvertraging: Stel de time-outperiode in, in seconden, voor de telefoon om een gebeurtenis te starten nadat de trigger is gedetecteerd. De standaardwaarde is 5 seconden. Wanneer de waarde op 0 is ingesteld, wordt de gebeurtenis onmiddellijk na de detectie van de trigger gestart.

    • Servicetrigger Selecteer een trigger uit de lijst: één keer indrukken, lang indrukken of drie keer indrukken.

    • Servicegeheim (optioneel): Voer het authenticatiegeheim, token of wachtwoord in als uw aangepaste service authenticatie vereist om toegang te krijgen. Het ingevoerde geheim wordt weergegeven als een gemaskeerde tekenreeks en er kan naar worden verwezen met de macro $SSin Custom Content Field en Action Button Service Destination.

  • Meerdere triggers

    Stel de parameters in elke groep respectievelijk in. Zie de secties Noodoproepen en Douanediensten hierboven.

  • Eén enkele trigger voor meerdere gebeurtenissen

    Configureer de volgende parameters om meerdere gebeurtenissen toe te wijzen aan een trigger:

    • Functie van de actieknop: Selecteer Aangepast.

    • Bestemming van de Action Button Service: Voer het telefoonnummer in dat u wilt bellen en de URL van de XML-service in dit formaat:

      tel:<phonenumber or SIP URI> + <serviceURL>

      De URL moet beginnen met http://of https://.

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

    • Servicenaam van de actieknop (optioneel): Geef een naam op voor de service die aan de trigger is gekoppeld. Deze naam wordt weergegeven in het bericht op het scherm wanneer de gebruiker op de knop drukt, om aan te geven welke service wordt geactiveerd. Als er geen naam is opgegeven, wordt de Custom Service gebruikt als weergavenaam.

    • Veld voor aangepaste inhoud (optioneel): Als u de telefoon in staat wilt stellen een HTTP Post-verzoek te verzenden wanneer u op de actieknop drukt, voert u de HTTP-gegevens in, zoals methode, koptekst en berichtinhoud, met een maximale lengte van 1024 tekens.

      Voor voorbeelden van POST-scripts en de syntaxis, zie HTTP Post-aanvraag voor de actieknop.

    • Uitstelvertraging: Stel de time-outperiode in, in seconden, voor de telefoon om een gebeurtenis te starten nadat de trigger is gedetecteerd. De standaardwaarde is 5 seconden. Wanneer de waarde op 0 is ingesteld, wordt de gebeurtenis onmiddellijk na de detectie van de trigger gestart.

    • Servicetrigger Selecteer een trigger uit de lijst: één keer indrukken, lang indrukken of drie keer indrukken.

    • Servicegeheim (optioneel): Voer het authenticatiegeheim, token of wachtwoord in als uw aangepaste service authenticatie vereist om toegang te krijgen. Het ingevoerde geheim wordt weergegeven als een gemaskeerde tekenreeks en er kan naar worden verwezen met de macro $SSin Custom Content Field en Action Button Service Destination.

    • Stille noodoproep (optioneel): Als u op de bestemming van de dienst een telefoonnummer of een URI hebt ingevoerd, worden noodoproepen gedempt als u deze functie inschakelt.

      De noodoproep werkt standaard als een tweerichtingsgesprek, vergelijkbaar met andere uitgaande gesprekken. Als deze optie is ingeschakeld, is het geluid aan de kant van de beller stil om te voorkomen dat de aandacht wordt getrokken tijdens het lopende gesprek. Alleen de ontvanger van het gesprek kan het gesprek beëindigen.

      Tijdens een stille noodoproep zal het scherm van de telefoons 9811 en 9841 vastlopen, terwijl het scherm van de telefoons 9851, 9861 en 9871 wordt uitgeschakeld. Alle andere functies zijn niet toegankelijk. De telefoon werkt weer normaal nadat de ontvanger het gesprek heeft beëindigd.

    • Silent Emergency Call Retrieval toestaan (optioneel): Schakel deze functie in als u gebruikers toestaat om op een willekeurige toets te drukken om de normale werking van de telefoon te herstellen terwijl de noodoproep wordt gehandhaafd. Het geluid van het gesprek blijft stil, tenzij de gebruiker het luidsprekervolume verhoogt met de volumetoets.

Voor meer informatie over deze parameters, zie Parameters voor de actieknop.

4

Selecteer Opslaan.

5

Selecteer Apply Config.

Referenties

Parameters voor de actieknop

De parameters zijn beschikbaar in Enterprise Phone Configuration, Common Phone Profile en individuele telefoonconfiguratie.

Tabel 1. Parameters voor de actieknop
ParameterStandaardinstellingen en optiesBeschrijving
Functie van de actieknop 1~3

Standaard: Uit

Opties: Uit, Noodoproep, Aangepast

U kunt de knop configureren met een specifieke service.

  • Uit: Als u deze optie op Uit zet, werkt de actieknop voor een enkele service op de telefoon niet.
  • Noodoproep: Gebruikers kunnen de actieknop gebruiken om een noodoproep te plaatsen, indien geconfigureerd.
  • Aangepast: Gebruikers kunnen de actieknop gebruiken om toegang te krijgen tot de aangepaste service, indien geconfigureerd.

Wanneer u het veld instelt op Noodoproep of Aangepast, zorg er dan voor dat u de servicebestemming invoert in het veld Actieknop Servicebestemming. Of er verschijnt een configuratiefout op de telefoon.

Servicenaam van de actieknop 1~3

Standaard: Leeg

Geef optioneel een naam op voor de service die is gekoppeld aan de actieknop. Deze naam wordt weergegeven in het bericht op het scherm wanneer de gebruiker op de knop drukt, om aan te geven welke service wordt geactiveerd.

Als u geen naam opgeeft, is de standaardnaam Noodoproep, Stille noodoproep of Aangepaste actie op basis van uw selectie in het veld Actieknopfunctie.

Actieknop Service Bestemming 1~3

Standaard: Leeg

Geef de bestemming van de service op in een van de volgende formaten op basis van de service die is toegewezen aan de actieknop:

  • Voer voor noodoproepdiensten een telefoonnummer of de URI van de hulpdienst in.

  • Wanneer u de knop configureert voor een service op maat, voert u de URL van de service in. De URL moet beginnen met http://of https://. Bijvoorbeeld https://10.11.20.159/path/service.xml.

  • Om de knop te configureren om meerdere gebeurtenissen te initiëren met één enkele trigger, voert u in tel:<phonenumber or SIP URL> + <Service RUL>. Voorbeeld: tel:1234 + https://10.11.20.159/path/service.xml.

    Het aanroepen van SIP-URI's wordt ook ondersteund. Voer de URI in het formaat van tel: sip 4567@co.webex.com

Als u de actieknop inschakelt zonder een geldige servicebestemming in te stellen, krijgt de gebruiker aan de telefoon een bericht waarin om configuratie wordt gevraagd. Nadat de gebruiker deze melding heeft gesloten, blijft het waarschuwingspictogram in de kop van het telefoonscherm staan totdat de knop correct is geconfigureerd of uitgeschakeld.

Telefoonnummers kunnen niet worden gebruikt als bestemming voor aangepaste diensten. Als u de actieknop op Aangepast configureert en een telefoonnummer invoert als bestemming voor de service, verschijnt er een waarschuwingsbericht op de telefoon waarin staat dat de knop niet is geconfigureerd. In plaats daarvan kunt u bijvoorbeeld een telefoonnummer in dit formaat tel:<phone number>toevoegen tel:1234.

Als u geen URL met een ampersand (&) mag invoeren, gebruik dan %26 als vervanging. Voer bijvoorbeeld http://1.2.3.4/phone?a=1%26b=2%26c=3 in plaats van http://1.2.3.4/phone?a=1&b=2&c=3 in.

Veld voor aangepaste inhoud 1~3

Standaard: Leeg

Deze instelling werkt alleen als de actieknopfunctie is ingesteld op Aangepast.

Voer de HTTP-gegevens in, zoals methode, koptekst en berichtinhoud, met een maximale lengte van 1024 tekens. Indien geconfigureerd, stuurt de telefoon een HTTP Post-verzoek wanneer op de actie wordt gedrukt.

Als de service authenticatie vereist om toegang te krijgen, zorg er dan voor dat u het authenticatiegeheim invoert in het veld Servicegeheim. Gebruik in de HTTP-gegevens de macro $SSals verwijzing naar Service Secret.

Voor voorbeelden en de syntaxis, zie HTTP Post-aanvraag voor de actieknop.

Geheim van de dienst 1~3

Standaard: Leeg

Een servicegeheim kan een authenticatiegeheim, token of wachtwoord zijn. Het ingevoerde geheim wordt weergegeven als een gemaskeerde tekenreeks en er kan naar worden verwezen met de macro $SSin Custom Content Field en Action Button Service Destination.

Servicetrigger 1~3

Standaard: Eén druk op de knop

Opties: Eén druk op de knop, lang indrukken, drie keer indrukken

Kies hoe gebruikers een noodoproep kunnen plaatsen of een service op maat kunnen starten met behulp van de actieknop van de telefoon.

Eén druk op de knop: Druk op de actieknop om het bijbehorende gesprek of de bijbehorende service te activeren.

Lang indrukken: Houd de actieknop minstens 2 seconden ingedrukt om het bijbehorende gesprek of de bijbehorende service te activeren.

Drie keer indrukken: Druk drie keer op de actieknop met tussenpozen van minder dan twee seconden tussen elke druk om het bijbehorende gesprek of de bijbehorende service te activeren.

Herhaal een trigger niet voor meerdere services, omdat de parameters met een lagere prioriteit niet werken. De volgorde van prioriteit, van hoog naar laag, is als volgt: groep 1, groep 2, groep 3.

Uitbelvertraging 1~3

Standaard: 5

Opties: 0 - 30

Stel de time-outperiode in, in seconden, voor de telefoon om een noodoproep of een aangepaste actie te starten nadat op de actieknop is gedrukt.

Zet de waarde op 0 als u wilt dat de telefoon onmiddellijk na het detecteren van de trigger een oproep plaatst of een gebeurtenis start, zoals aangegeven door een enkele druk op de knop, lang indrukken of driemaal indrukken van de knop.

Stille noodoproep 1~3

Standaard: Uitgeschakeld

Opties: Ingeschakeld, Uitgeschakeld

De stille noodoproep is bedoeld voor discrete hulp in gevaarlijke situaties. Het stelt gebruikers in staat om hulp te zoeken zonder lawaai te maken.

  • Indien ingeschakeld, kunnen gebruikers eenrichtingsgesprekken voeren met de actieknop.

    Nadat de stille noodoproep is geplaatst, kan alleen de andere partij het gesprek beëindigen. Om tijdens het lopende gesprek niet de aandacht te trekken, zal het scherm van de telefoons 9811 en 9841 vastlopen, terwijl het scherm van de telefoons 9851, 9861 en 9871 wordt uitgeschakeld. De telefoon vergrendelt standaard alle functies tijdens een stille noodoproep. Schakel de functie Allow Silent Emergency Call Retrieval in om gebruikers in staat te stellen de normale werking van de telefoon te herstellen met behoud van de stille noodoproep.

  • Indien uitgeschakeld, functioneert de noodoproep als een tweerichtingsgesprek, vergelijkbaar met andere uitgaande gesprekken.

Silent Emergency Call Retrieval toestaan

Standaard: Nee

Opties: Ja, Nee

Bepaalt of gebruikers de telefoonfunctionaliteit kunnen ophalen tijdens een stille noodoproep. Zodra een stille noodoproep is gestart, worden alle functies standaard vergrendeld totdat de ontvanger van het gesprek het gesprek beëindigt.

Als deze parameter is ingesteld op Ja, kunnen gebruikers op een willekeurige toets drukken om de normale werking van de telefoon te herstellen terwijl de noodoproep wordt gehandhaafd. Het geluid van het gesprek blijft stil, tenzij de gebruiker het volume verhoogt met de volumetoets.

HTTP Post-aanvraag voor de actieknop

De actieknop op de Cisco Desk Phone 9800 Series kan worden geconfigureerd om XML-toepassingen te activeren via HTTP Post-aanvragen.

Voer in het veld Aangepaste inhoud uw aangepaste aanvraagscript in. U kunt een XML- of JSON-inhoudstype opgeven en macro's in de aanvraag opnemen. $SSKan bijvoorbeeld aan het script worden toegevoegd om het authenticatiegeheim, token of wachtwoord op te halen dat is opgegeven in het veld Servicegeheim.

De volgende voorbeelden zijn in XML en 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) vereist een procentuele codering voor de gereserveerde tekens in overeenstemming met RFC 3986.

Tabel 2. Procentuele codering voor gereserveerde tekens
KarakterProcentuele codering
&%26
'%27
"%22
< %3c
> %3e

Het volgende script is een voorbeeld waarbij in percentages gecodeerde tekenreeksen worden gebruikt.

--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. Ondersteunde macro's
Macro-naamMacro-uitbreiding
#DEVICENAME#De naam van het apparaat die wordt weergegeven in het oproepsysteem. Bijvoorbeeld SEP845A3EC21288
$SSServicegeheim, dat een gemaskeerde tekenreeks weergeeft op de configuratiepagina van de telefoon, zoals een authenticatiegeheim, token of wachtwoord.
Vond u dit artikel nuttig?
Vond u dit artikel nuttig?