De knop Actie aanpassen

Voor de aangepaste opties voor de knop Actie op de Cisco-bureautelefoon 9800-serie is een specifieke firmware-ondersteuning nodig. Raadpleeg de volgende tabel voor meer informatie:

FunctieVereiste firmwareversie
NoodoproepPhoneOS 3.0.1 en hoger
Aangepaste servicePhoneOS 3.2.1 en hoger
Meerdere triggersPhoneOS 3.3.1 en hoger
HTTP-postPhoneOS 3.3.1 en hoger
Meerdere gebeurtenissen op een enkele triggerPhoneOS 3.4.1 en hoger
1

Meld u aan bij Cisco Unified Communications Manager Administration.

2

Voer indien nodig een van de volgende handelingen uit:

  • Als u alle geïmplementeerde telefoons wilt configureren, gaat u naar Systeem > Enterprise Phone Configuration.
  • Als u telefoons wilt configureren die hetzelfde profiel delen, gaat u naar Apparaat>Device Settings > Common Phone Profile .
  • Als u een afzonderlijke telefoon wilt configureren, gaat u naar Apparaat > Telefoon. Zoek vervolgens uw telefoon en open de pagina Telefoonconfiguratie.

De configuratie volgt een hiërarchische structuur:

  • Afzonderlijke apparaatinstellingen hebben voorrang boven instellingen op het gemeenschappelijke telefoonprofiel- en ondernemingsniveau.
  • Algemene instellingen voor telefoonprofielen hebben voorrang op instellingen op ondernemingsniveau

3

Pas de instellingen van de knop Actie aan met de volgende parameters op basis van uw gebruiksgevallen.

De knop Actie bevat drie groepen parameters die elk overeenkomen met een service met een unieke trigger. Als een service-trigger is opgegeven in meerdere groepen, hebben de instellingen in Groep 1 prioriteit boven de instellingen in Groep 2 en 3, terwijl Groep 2 prioriteit heeft boven Groep 3.

  • Noodoproepen

    Configureer de volgende parameters:

    • Actietoets functie: Selecteer Noodoproep.

    • Bestemming bewerkingstoetsservice: voer het telefoonnummer of de URI van de nooddiensten in.

    • Naam servicebewerkingsknop (optioneel): Geef een naam op voor de service die is gekoppeld aan de actie-trigger. Deze naam wordt weergegeven in het bericht op het scherm als de gebruiker op de knop drukt en aangeeft welke gebeurtenis wordt gestart. Als er geen naam wordt opgegeven, wordt een noodoproep als weergavenaam gebruikt.

    • Vertraging kies uit: stel de time-outperiode (in seconden) in waarin de telefoon een noodoproep moet plaatsen nadat de trigger is gedetecteerd. De standaardwaarde is 5 seconden. Als dit is ingesteld op 0, wordt het gesprek gestart meteen nadat de trigger is gedetecteerd.

    • Service-trigger Selecteer een trigger uit de lijst: Eén druk, Lang indrukken of 3 keer opdrukken.

    • Stil noodgesprek (optioneel): het noodgesprek werkt standaard als tweerichtingsgesprek, net als andere uitgaande oproepen. Als stil noodgesprek is ingeschakeld, is het geluid aan de kant van de beller stil zodat geen aandacht wordt getrokken tijdens het inschakelen. Alleen de ontvanger van het gesprek kan de stille noodoproep beëindigen.

      Tijdens een stil noodgesprek wordt het scherm van de telefoon 9841 onderbroken, terwijl het scherm op de telefoon 9851, 9861 en 9871 wordt uitgeschakeld. Alle andere functies zijn niet toegankelijk. De normale werking wordt hersteld nadat de ontvanger het gesprek heeft beëindigd.

    • Ophalen stil noodoproepen toestaan (optioneel): schakel deze functie in als u gebruikers toestaat op een toets te drukken om de normale werking van de telefoon te herstellen terwijl u het noodoproep onderhoudt. De audio van het gesprek blijft stil, tenzij de gebruiker het luidsprekervolume verhoogt met de volumetoets.

  • Aangepaste services

    Configureer de volgende parameters:

    • Functie bewerkingsknop: Selecteer Aangepast.

    • Bestemming servicebewerkingsknop: voer de URL van de aangepaste service in. De URL moet beginnen met http:// or https://, bijvoorbeeld https://10.11.20.159/path/service.xml.

    • Naam servicebewerkingsknop (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 wordt opgegeven, wordt de Aangepaste service gebruikt als weergavenaam.

    • Aangepast inhoudsveld (optioneel): als u wilt inschakelen dat de telefoon een HTTP-verzoek om post verzendt als de knop Actie is ingedrukt, geeft u de HTTP-gegevens op zoals methode, koptekst en berichtinhoud, met een maximale lengte van 1024 tekens.

      Zie HTTP-verzoek voor de knop Actie voor voorbeelden van scripts en de syntaxis van een POST-script.

    • Vertraging kies uit: stel de time-outperiode in seconden in waarin de telefoon een gebeurtenis kan starten nadat de trigger is gedetecteerd. De standaardwaarde is 5 seconden. Wanneer de gebeurtenis is ingesteld op 0, wordt de gebeurtenis meteen na de triggerdetectie gestart.

    • Service-trigger Selecteer een trigger uit de lijst: Eén druk, Lang indrukken of 3 keer opdrukken.

    • Servicegeheim (optioneel): voer het verificatiegeheim, het token of het wachtwoord in als voor uw aangepaste service verificatie vereist is. Het ingevoerde geheim wordt weergegeven als een gemaskerde tekenreeks en kan worden verwezen met de macro $SS in het veld Aangepaste inhoud en Servicebestemming bewerkingsknop.

  • Meerdere triggers

    Stel de parameters voor elke groep respectievelijk in. Zie de bovenstaande gedeelten Noodoproepen en Aangepaste services.

  • Eén trigger voor meerdere gebeurtenissen

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

    • Functie bewerkingsknop: Selecteer Aangepast.

    • Bestemming servicebewerkingstoets: voer het telefoonnummer dat u wilt bellen en de XML service-URL in de volgende notatie in:

      tel:<telefoonnummer of SIP-URI> + <serviceurL>

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

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

    • Naam servicebewerkingsknop (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 wordt opgegeven, wordt de Aangepaste service gebruikt als weergavenaam.

    • Aangepast inhoudsveld (optioneel): als u wilt inschakelen dat de telefoon een HTTP-verzoek om post verzendt als de knop Actie is ingedrukt, geeft u de HTTP-gegevens op zoals methode, koptekst en berichtinhoud, met een maximale lengte van 1024 tekens.

      Zie HTTP-verzoek voor de knop Actie voor voorbeelden van scripts en de syntaxis van een POST-script.

    • Vertraging kies uit: stel de time-outperiode in seconden in waarin de telefoon een gebeurtenis kan starten nadat de trigger is gedetecteerd. De standaardwaarde is 5 seconden. Wanneer de gebeurtenis is ingesteld op 0, wordt de gebeurtenis meteen na de triggerdetectie gestart.

    • Service-trigger Selecteer een trigger uit de lijst: Eén druk, Lang indrukken of 3 keer opdrukken.

    • Servicegeheim (optioneel): voer het verificatiegeheim, het token of het wachtwoord in als voor uw aangepaste service verificatie vereist is. Het ingevoerde geheim wordt weergegeven als een gemaskerde tekenreeks en kan worden verwezen met de macro $SS in het veld Aangepaste inhoud en Servicebestemming bewerkingsknop.

    • Stil noodgesprek (optioneel): als u een telefoonnummer of belfunctie URI hebt opgenomen in de servicebestemming, blijven noodoproepen stil wanneer u deze functie inschakelt.

      Het noodgesprek werkt standaard als tweerichtingsgesprek, net als andere uitgaande gesprekken. Indien ingeschakeld, is het geluid op de kant van de beller stil zodat niet de aandacht wordt getrokken tijdens het inschakelen. Alleen de ontvanger van het gesprek kan het gesprek beëindigen.

      Tijdens een stil noodgesprek wordt het scherm van de telefoon 9841 onderbroken, terwijl het scherm op de telefoon 9851, 9861 en 9871 wordt uitgeschakeld. Alle andere functies zijn niet toegankelijk. De normale werking wordt hersteld nadat de ontvanger het gesprek heeft beëindigd.

    • Ophalen stil noodoproepen toestaan (optioneel): schakel deze functie in als u gebruikers toestaat op een toets te drukken om de normale werking van de telefoon te herstellen terwijl u het noodoproep onderhoudt. De audio van het gesprek blijft stil, tenzij de gebruiker het luidsprekervolume verhoogt met de volumetoets.

Zie Parameters voor de knop Actie voor meer informatie over deze parameters.

4

Selecteer Opslaan.

5

Selecteer Config toepassen.

Verwijzingen

Parameters voor de knop Actie

De parameters zijn beschikbaar in Enterprise-telefoonconfiguratie, Gemeenschappelijk telefoonprofiel en individuele telefoonconfiguratie.

Tabel 1. Parameters voor de knop Actie
ParameterStandaard en optiesBeschrijving
Actietoets, functie 1~3

Standaard: Uit

Opties: Uit, Noodoproep, Aangepast

U kunt de knop configureren voor een specifieke service.

  • Uit: wanneer de optie Is uitgeschakeld, werkt de knop Actie voor één service op de telefoon niet.
  • Noodoproep: gebruikers kunnen, indien geconfigureerd, de knop Actie gebruiken om een noodoproep te plaatsen.
  • Aangepast: gebruikers kunnen, indien geconfigureerd, de knop Actie gebruiken om de aangepaste service te openen.

Wanneer u het veld instelt op Noodoproep of Aangepast, moet u de servicebestemming opgeven in het veld Bestemming servicebewerking. Of er wordt een configuratiefout weergegeven.

Servicenaam bewerkingstoets 1~3

Standaard: leeg

Geef optioneel een naam op voor de service die is gekoppeld aan de knop Actie. 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, Stil noodoproep of Aangepaste actie op basis van uw selectie in het veld Functie knop actie.

Bewerkingstoets servicebestemming 1~3

Standaard: leeg

Geef de servicebestemming op in een van de volgende indelingen op basis van de service die is toegewezen aan de knop Actie:

  • Geef voor de noodoproepdiensten een telefoonnummer op of het URI van de alarmdiensten.

  • Wanneer u de knop voor een aangepaste service configureert, geeft u de service-URL op. De URL moet beginnen met http:// of https://. Bijvoorbeeld https://10.11.20.159/path/service.xml.

  • Als u de knop wilt configureren om meerdere gebeurtenissen met een enkele trigger te starten, voert u tel:<telefoonnummer of SIP URL> + <Service RUL> in. Bijvoorbeeld: tel:1234 + https://10.11.20.159/path/service.xml.

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

Als u de knop Actie inschakelt zonder een geldige servicebestemming in te stellen, ziet de gebruiker op de telefoon een bericht waarin wordt gevraagd of een configuratie moet worden uitgevoerd. Zodra de gebruiker deze melding heeft gesloten, blijft het waarschuwingspictogram bestaan in de koptekst van het telefoonscherm totdat de knop correct is geconfigureerd of is uitgeschakeld.

Telefoonnummers kunnen niet worden gebruikt als bestemmingen voor aangepaste services. Als u de knop Actie als Aangepast configureert en een telefoonnummer invoert als servicebestemming, zal op de telefoon een waarschuwingsbericht verschijnen dat de knop niet is geconfigureerd. In plaats daarvan kunt u een telefoonnummer toevoegen met de volgende indeling tel:<telefoonnummer> bijvoorbeeld tel:1234.

Als het niet is toegestaan om een URL met inbegrip van ampersand (&) in te voeren, gebruikt u %26 als vervanging. Geef bijvoorbeeldhttp://1.2.3.4/phone?a=1%26b=2%26c=3 op in plaats van http://1.2.3.4/phone?a=1&b=2&c=3.

Veld Aangepaste inhoud 1~3

Standaard: leeg

Deze instelling werkt alleen wanneer de functie van de knop Actie is ingesteld op Aangepast.

Voer de HTTP-gegevens in zoals methode, koptekst en berichtinhoud, met een maximumlengte van 1024 tekens. Indien geconfigureerd, verzendt de telefoon een HTTP-verzoek om berichten wanneer de bewerking wordt ingedrukt.

Als voor de service verificatie vereist is voor toegang, moet u het verificatiegeheim invoeren in het veld Servicegeheim . Gebruik in de HTTP-gegevens de macro $SS als een verwijzing naar Service Secret.

Zie HTTP-verzoek voor de knop Actie voor voorbeelden en de syntaxis.

Servicegeheim 1~3

Standaard: leeg

Een servicegeheim kan een verificatiegeheim, token of wachtwoord zijn. Het ingevoerde geheim wordt weergegeven als een gemaskerde tekenreeks en kan worden verwezen met de macro $SS in het veld Aangepaste inhoud en Servicebestemming bewerkingsknop.

Service-trigger 1~3

Standaardwaarde: Eén toets

Opties: Enkele druk, Lange druk, 3 keer indrukken

Bepaal hoe gebruikers een noodoproep kunnen plaatsen of een aangepaste service kunnen starten met de knop Actie van de telefoon.

Eén druk: druk op de knop Actie om het gekoppelde gesprek of de service te activeren.

Lang indrukken: druk de knop Actie gedurende ten minste 2 seconden in om het gekoppelde gesprek of de service te activeren.

3 keer drukken: druk drie keer op de knop Actie, met intervallen van minder dan 2 seconden tussen elke druk om het gekoppelde gesprek of de service te activeren.

Herhaal een trigger niet voor meerdere services, omdat de parameters met een lagere prioriteit niet werken. De prioriteitsvolgorde, van hoogste naar laagste, is als volgt: Groep 1, Groep 2, Groep 3.

Kiesvertraging 1~3

Standaard: 5

Opties: 0 - 30

Stel de time-outperiode in seconden in dat de telefoon een noodoproep of een aangepaste actie moet starten nadat u op de knop Actie hebt gedrukt.

Stel de waarde in op 0 als u wilt dat de telefoon het gesprek start of een gebeurtenis start nadat de trekker is gedetecteerd, zoals aangegeven met één druk, lang indrukken of drie keer drukken op de knop.

Stil noodgesprek 1~3

Standaard: Uitgeschakeld

Opties: Ingeschakeld, Uitgeschakeld

Stil noodgesprek is bedoeld om discreet hulp te bieden in gevaarlijke situaties. Het stelt de gebruiker in staat om hulp te zoeken zonder geluid te maken.

  • Wanneer deze optie is ingeschakeld, kunnen gebruikers eenrichtingsgesprek voeren met de knop Actie.

    Nadat de stille noodoproep is geplaatst, kan alleen de andere partij de oproep beëindigen. Om niet de aandacht te trekken tijdens het lopende gesprek, wordt het scherm op de telefoon 9841 onderbroken, terwijl het scherm op telefoon 9851, 9861 en 9871 wordt uitgeschakeld. De telefoon vergrendelt standaard alle functies tijdens een stille noodoproep. Als u wilt dat gebruikers de normale werking van de telefoon kunnen herstellen met behoud van het stille noodgesprek, schakelt u de functie Voor het toestaan van het ophalen van stille noodoproepen in.

  • Wanneer de functie is uitgeschakeld, werkt een noodoproep als tweerichtingsgesprek, net als andere uitgaande gesprekken.

Ophalen stille noodoproepen toestaan

Standaard: Nee

Opties: Ja, Nee

Hiermee bepaalt u of gebruikers de telefoonfunctionaliteit kunnen ophalen tijdens een stil noodgesprek. Standaard worden zodra een stille noodoproep is gestart, alle functies vergrendeld totdat de ontvanger de oproep 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 ze het noodgesprek onderhouden. De audio van het gesprek blijft stil, tenzij de gebruiker het volume verhoogt met de volumetoets.

HTTP-verzoek voor de knop Actie

De knop Actie op de Cisco-bureautelefoon 9800 serie kan worden geconfigureerd om XML-toepassingen te activeren via HTTP-postverzoeken.

Voer in het veld Aangepaste inhoud uw aangepaste verzoekscript in. U kunt XML- of JSON-inhoudstype opgeven en macro's in het verzoek opnemen. U kunt bijvoorbeeld $SSaan het script toevoegen om het verificatiegeheim, het wachtwoord of het wachtwoord op te halen dat wordt verstrekt in het veld Servicegeheim .

De volgende voorbeelden zijn opgenomen in XML en JSON:

Voorbeeld #1: XML --methode POST --header 'Inhoud-Type: toepassing/xml' --header 'Autorisatie: drager gebruikersnaam:$SS' --body '<MetaData><Trigger>True</Trigger><Beschrijving>Dit voor HTTP POST XML</Description></metaData>' Voorbeeld #2: JSON --methode 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 procentuele codering voor de gereserveerde tekens in overeenstemming met RFC 3986.

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

Het volgende script is een voorbeeld van procentuele tekenreeksen.

--methode POST --header %27Inhoud-Type: application/xml%27 --body %27%3cMetaData%3e%3cTrigger%3eTrue%203c/Trigger%3e%3cDescriptie%3eDit is voor HTTP POST XML%3c/Beschrijving%3e%3c/MetaData%3e%27
Tabel 3. Ondersteunde macro's
MacronaamUitbreiding van macro
#DEVICENAME#De apparaatnaam die wordt weergegeven in het telefoonsysteem. Bijvoorbeeld SEP845A3EC21288
$SSService Secret, waarbij op de pagina voor telefoonconfiguratie een gemaskerde tekenreeks wordt weergegeven, zoals het verificatiegeheim, het token of het wachtwoord.