Personalizza il pulsante Azione

Le opzioni personalizzate per il pulsante Azione su Cisco Desk Phone serie 9800 richiedono il supporto firmware specifico di PhoneOS. Per informazioni dettagliate, vedere la tabella seguente:

FunzioneVersione firmware richiesta
chiamata di emergenzaPhoneOS 3.0.1 e versioni successive
Servizio personalizzatoPhoneOS 3.2.1 e versioni successive
Trigger multipliPhoneOS 3.3.1 e versioni successive
Posta HTTPPhoneOS 3.3.1 e versioni successive
Più eventi su un singolo triggerPhoneOS 3.4.1 e versioni successive
1

Accedere a Cisco Unified Communications Manager Administration.

2

Effettuare una delle seguenti azioni in base alle esigenze:

  • Per configurare tutti i telefoni distribuiti, andare a Configurazione telefono System >Enterprise.
  • Per configurare i telefoni che condividono lo stesso profilo telefonico, vai a Dispositivo>Impostazioni dispositivo> Profilo telefono comune.
  • Per configurare un singolo telefono, vai a Dispositivo > Telefono. Quindi trova il tuo telefono e apri la pagina Configurazione telefono.

La configurazione segue una struttura gerarchica:

  • Le impostazioni dei singoli dispositivi hanno la precedenza sulle impostazioni del profilo telefonico comune e del livello aziendale
  • Le impostazioni comuni del profilo telefonico sostituiscono le impostazioni a livello aziendale

3

Personalizza le impostazioni del pulsante Azione con i seguenti parametri in base ai tuoi casi d'uso.

Esistono tre gruppi di parametri per il pulsante Azione, ciascuno corrispondente a un servizio con un trigger univoco. Se viene specificato un trigger di servizio in più gruppi, le impostazioni del Gruppo 1 hanno la priorità su quelle del Gruppo 2 e 3, mentre il Gruppo 2 ha la priorità sul Gruppo 3.

  • Chiamate di emergenza

    Configurare i seguenti parametri:

    • Funzione del pulsante di azione: selezionare Chiamata di emergenza.

    • Destinazione servizio pulsante azione: immettere il numero di telefono o il URI del servizio di emergenza.

    • Nome servizio pulsante azione (facoltativo): specificare un nome per il servizio associato al trigger di azione. Questo nome verrà visualizzato nel messaggio sullo schermo quando l'utente preme il pulsante, indicando quale evento verrà avviato. Se non viene specificato alcun nome, verrà utilizzato Chiamata di emergenza come nome visualizzato.

    • Ritardo di chiamata: imposta il periodo di timeout (in secondi) affinché il telefono avvii una chiamata di emergenza dopo il rilevamento del trigger. L'impostazione predefinita è 5 secondi. Se impostato su 0, la chiamata viene effettuata immediatamente dopo aver rilevato il trigger.

    • Trigger di servizio Selezionare un trigger dall'elenco: Pressione singola, Pressione prolungata o Premere 3 volte.

    • Chiamata di emergenza silenziosa (opzionale): per impostazione predefinita, la chiamata di emergenza funziona come una chiamata bidirezionale, simile alle altre chiamate in uscita. Quando la chiamata di emergenza silenziosa è abilitata, l'audio è silenzioso sul lato chiamante per evitare di attirare l'attenzione durante la chiamata in corso. Solo il destinatario della chiamata può terminare la chiamata di emergenza invisibile all'utente.

      Durante una chiamata di emergenza silenziosa, lo schermo del telefono 9841 si bloccherà, mentre lo schermo del telefono 9851, 9861 e 9871 verrà spento. Tutte le altre funzioni sono inaccessibili. Il telefono ripristina il normale funzionamento dopo che il destinatario termina la chiamata.

    • Consenti recupero chiamata di emergenza invisibile all'utente (opzionale): abilitare questa funzione se si consente agli utenti di premere un tasto qualsiasi per ripristinare il normale funzionamento del telefono mantenendo la chiamata di emergenza. L'audio della chiamata rimane silenzioso a meno che l'utente non aumenti il volume dell'altoparlante utilizzando il tasto Volume.

  • Servizi personalizzati

    Configurare i seguenti parametri:

    • Funzione del pulsante di azione: selezionare Personalizzato.

    • Destinazione servizio pulsante azione: immettere l'URL del servizio personalizzato. L'URL deve iniziare con http:// o https://, ad esempio, https://10.11.20.159/path/service.xml .

    • Nome servizio pulsante azione (facoltativo): specificare un nome per il servizio associato al trigger. Questo nome verrà visualizzato nel messaggio sullo schermo quando l'utente preme il pulsante, indicando quale servizio verrà attivato. Se non viene specificato alcun nome, verrà utilizzato il servizio personalizzato come nome visualizzato.

    • Campo contenuto personalizzato (opzionale): se si desidera consentire al telefono di inviare una richiesta HTTP Post quando viene premuto il pulsante Azione, immettere i dati HTTP come metodo, intestazione e contenuto del post, con una lunghezza massima di 1024 caratteri.

      Per esempi di script POST e la sintassi, vedere Richiesta HTTP Post per il pulsante Azione.

    • Ritardo di chiamata: imposta il periodo di timeout, in secondi, affinché il telefono avvii un evento dopo aver rilevato il trigger. L'impostazione predefinita è 5 secondi. Se impostato su 0, l'evento viene avviato immediatamente dopo il rilevamento del trigger.

    • Trigger di servizio Selezionare un trigger dall'elenco: Pressione singola, Pressione prolungata o Premere 3 volte.

    • Segreto di servizio (facoltativo): immettere il segreto, il token o la password di autenticazione se il servizio personalizzato richiede l'autenticazione per accedervi. Il segreto immesso viene visualizzato come stringa mascherata ed è possibile farvi riferimento utilizzando la macro $SS in Campo contenuto personalizzato e Destinazione servizio pulsante azione.

  • Trigger multipli

    Impostare rispettivamente i parametri in ciascun gruppo. Vedi le sezioni Chiamate di emergenza e Servizi personalizzati sopra.

  • Un singolo trigger per più eventi

    Configurare i seguenti parametri per assegnare più eventi a un trigger:

    • Funzione del pulsante di azione: selezionare Personalizzato.

    • Destinazione servizio pulsante azione: immettere il numero di telefono da chiamare e l'URL del servizio XML nel seguente formato:

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

      L'URL deve iniziare con http:// o https://.

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

    • Nome servizio pulsante azione (facoltativo): specificare un nome per il servizio associato al trigger. Questo nome verrà visualizzato nel messaggio sullo schermo quando l'utente preme il pulsante, indicando quale servizio verrà attivato. Se non viene specificato alcun nome, verrà utilizzato il servizio personalizzato come nome visualizzato.

    • Campo contenuto personalizzato (opzionale): se si desidera consentire al telefono di inviare una richiesta HTTP Post quando viene premuto il pulsante Azione, immettere i dati HTTP come metodo, intestazione e contenuto del post, con una lunghezza massima di 1024 caratteri.

      Per esempi di script POST e la sintassi, vedere Richiesta HTTP Post per il pulsante Azione.

    • Ritardo di chiamata: imposta il periodo di timeout, in secondi, affinché il telefono avvii un evento dopo aver rilevato il trigger. L'impostazione predefinita è 5 secondi. Se impostato su 0, l'evento viene avviato immediatamente dopo il rilevamento del trigger.

    • Trigger di servizio Selezionare un trigger dall'elenco: Pressione singola, Pressione prolungata o Premere 3 volte.

    • Segreto di servizio (facoltativo): immettere il segreto, il token o la password di autenticazione se il servizio personalizzato richiede l'autenticazione per accedervi. Il segreto immesso viene visualizzato come stringa mascherata ed è possibile farvi riferimento utilizzando la macro $SS in Campo contenuto personalizzato e Destinazione servizio pulsante azione.

    • Chiamata di emergenza invisibile all'utente (opzionale): se è stato incluso un numero di telefono o un URI di composizione nella destinazione del servizio, l'abilitazione di questa funzione indicherà l'audio delle chiamate di emergenza.

      Per impostazione predefinita, la chiamata di emergenza funziona come una chiamata bidirezionale, simile alle altre chiamate in uscita. Se impostato su abilitato, l'audio è silenzioso sul lato chiamante per evitare di attirare l'attenzione durante la chiamata in corso. Solo il destinatario della chiamata può terminare la chiamata.

      Durante una chiamata di emergenza silenziosa, lo schermo del telefono 9841 si bloccherà, mentre lo schermo del telefono 9851, 9861 e 9871 verrà spento. Tutte le altre funzioni sono inaccessibili. Il telefono ripristina il normale funzionamento dopo che il destinatario termina la chiamata.

    • Consenti recupero chiamata di emergenza invisibile all'utente (opzionale): abilitare questa funzione se si consente agli utenti di premere un tasto qualsiasi per ripristinare il normale funzionamento del telefono mantenendo la chiamata di emergenza. L'audio della chiamata rimane silenzioso a meno che l'utente non aumenti il volume dell'altoparlante utilizzando il tasto Volume.

Per ulteriori informazioni su questi parametri, vedere Parametri per il pulsante Azione.

4

Selezionare Salva.

5

Selezionare Applica configurazione.

Referenze

Parametri per il pulsante Azione

I parametri sono disponibili in Configurazione telefono aziendale, Profilo telefono comune e Configurazione telefono singolo.

Tabella 1. Parametri per il pulsante Azione
ParametroPredefinito e opzioniDescrizione
Funzione del pulsante di azione 1 ~ 3

Impostazione predefinita: Off

Opzioni: Disattivato, Chiamata di emergenza, Personalizzato

È possibile configurare il pulsante con un servizio specifico.

  • Disattivato: se impostato su Disattivato, il pulsante Azione per un singolo servizio sul telefono non funzionerà.
  • Chiamata di emergenza: gli utenti possono utilizzare il pulsante Azione per effettuare una chiamata di emergenza, se configurato.
  • Personalizzato: gli utenti possono utilizzare il pulsante Azione per accedere al servizio personalizzato, se configurato.

Quando si imposta il campo su Chiamata di emergenza o Personalizzato, assicurarsi di immettere la destinazione del servizio nel campo Destinazione servizio pulsante azione. In alternativa, il telefono visualizzerà un errore di configurazione.

Nome servizio pulsante azione 1~3

Impostazione predefinita: vuoto

Facoltativamente, specificare un nome per il servizio associato al pulsante Azione. Questo nome verrà visualizzato nel messaggio sullo schermo quando l'utente preme il pulsante, indicando quale servizio verrà attivato.

Se non si specifica un nome, il nome predefinito sarà Chiamata di emergenza, Chiamata di emergenza invisibile all'utente o Azione personalizzata in base alla selezione effettuata nel campo Funzione pulsante azione .

Pulsante di azione Destinazione servizio 1~3

Impostazione predefinita: vuoto

Specificare la destinazione del servizio in uno dei seguenti formati in base al servizio assegnato al pulsante Azione:

  • Per i servizi di chiamata di emergenza, immettere un numero di telefono o l'URI del servizio di emergenza.

  • Quando si configura il pulsante per un servizio personalizzato, immettere l'URL del servizio. L'URL deve iniziare con http:// o https://. Ad esempio, https://10.11.20.159/path/service.xml.

  • Per configurare il pulsante per avviare più eventi con un singolo trigger, immettere tel:<phonenumber o SIP URL> + <RUL servizio>. Esempio: tel:1234 + https://10.11.20.159/path/service.xml.

    È supportata anche la chiamata di URI SIP. Inserisci il URI nel formato di tel: sip 4567@co.webex.com

Se si abilita il pulsante Azione senza impostare una destinazione valida del servizio, l'utente al telefono visualizzerà un messaggio che richiede la configurazione. Dopo che l'utente ha chiuso questa notifica, l'icona di avviso persisterà nell'intestazione dello schermo del telefono fino a quando il pulsante non sarà configurato o disabilitato correttamente.

I numeri di telefono non possono essere utilizzati come destinazioni per servizi personalizzati. Se si configura il pulsante di azione come personalizzato e si immette un numero di telefono come destinazione del servizio, sul telefono verrà visualizzato un messaggio di avviso che indica che il pulsante non è configurato. È invece possibile aggiungere un numero di telefono in questo formato tel:<numero di telefono>, ad esempio tel:1234.

Se non è consentito inserire un URL che includa la e commerciale (&), utilizzare %26 in sostituzione. Ad esempio, immettere http://1.2.3.4/phone?a=1%26b=2%26c=3 anziché http://1.2.3.4/phone?a=1&b=2&c=3.

Campo contenuto personalizzato 1~3

Impostazione predefinita: vuoto

Questa impostazione funziona solo quando la funzione del pulsante di azione è impostata su Personalizzata.

Inserisci i dati HTTP come metodo, intestazione e contenuto del post, con una lunghezza massima di 1024 caratteri. Una volta configurato, il telefono invia una richiesta HTTP Post quando viene premuta l'azione.

Se il servizio richiede l'autenticazione per accedere, assicurarsi di immettere il segreto di autenticazione nel campo Segreto servizio. Nei dati HTTP utilizzare la macro $SS come riferimento al segreto di servizio.

Per esempi e la sintassi, vedere Richiesta HTTP Post per il pulsante Azione.

Segreto di servizio 1~3

Impostazione predefinita: vuoto

Un segreto di servizio può essere un segreto di autenticazione, un token o una password. Il segreto immesso viene visualizzato come stringa mascherata ed è possibile farvi riferimento utilizzando la macro $SS in Campo contenuto personalizzato e Destinazione servizio pulsante azione.

Trigger di servizio 1 ~ 3

Valore predefinito: Pressione singola

Opzioni: Pressione singola, Pressione prolungata, Pressa 3 volte

Scegli come gli utenti possono effettuare una chiamata di emergenza o avviare un servizio personalizzato utilizzando il pulsante Azione del telefono.

Pressione singola: premere il pulsante Azione per attivare la chiamata o il servizio associato.

Pressione prolungata: premere il pulsante Azione verso il basso per almeno 2 secondi per attivare la chiamata o il servizio associato.

Premere 3 volte: premere il pulsante Azione tre volte con intervalli inferiori a 2 secondi tra ogni pressione per attivare la chiamata o il servizio associato.

Non ripetere un trigger su più servizi, poiché i parametri con priorità inferiore non funzioneranno. L'ordine di priorità, dal più alto al più basso, è il seguente: Gruppo 1, Gruppo 2, Gruppo 3.

Ritardo chiamata in uscita 1~3

Impostazione predefinita: 5

Opzioni: 0 - 30

Impostare il periodo di timeout, in secondi, affinché il telefono avvii una chiamata di emergenza o un'azione personalizzata dopo aver premuto il pulsante Azione.

Impostalo su 0 se preferisci che il telefono effettui la chiamata o avvii un evento immediatamente dopo aver rilevato il trigger, come specificato da una singola pressione, pressione prolungata o tripla pressione sul pulsante.

Chiamata di emergenza silenziosa 1 ~ 3

Impostazione predefinita: Disabled

Opzioni: Abilitato, Disabilitato

La chiamata di emergenza silenziosa è progettata per un'assistenza discreta in situazioni pericolose. Consente agli utenti di cercare aiuto senza fare rumore.

  • Se questa opzione è abilitata, gli utenti possono effettuare chiamate unidirezionali con il pulsante Azione.

    Dopo aver effettuato la chiamata di emergenza silenziosa, solo l'altra parte può terminare la chiamata. Per evitare di attirare l'attenzione durante la chiamata in corso, lo schermo del telefono 9841 si bloccherà, mentre lo schermo del telefono 9851, 9861 e 9871 verrà spento. Per impostazione predefinita, il telefono blocca tutte le funzioni durante una chiamata di emergenza silenziosa. Per consentire agli utenti di ripristinare il normale funzionamento del telefono mantenendo la chiamata di emergenza silenziosa, abilitare la funzione Consenti recupero chiamate di emergenza invisibile all'utente .

  • Se disabilitata, la chiamata di emergenza funziona come una chiamata bidirezionale, simile alle altre chiamate in uscita.

Consenti recupero delle chiamate di emergenza invisibile all'utente

Impostazione predefinita: No

Opzioni: Sì, No

Controlla se gli utenti possono recuperare la funzionalità del telefono durante una chiamata di emergenza silenziosa. Per impostazione predefinita, una volta avviata una chiamata di emergenza silenziosa, il telefono blocca tutte le funzioni fino a quando il destinatario della chiamata non termina la chiamata.

Quando questo parametro è impostato su Sì, gli utenti possono premere un tasto qualsiasi per ripristinare il normale funzionamento del telefono mantenendo la chiamata di emergenza. L'audio della chiamata rimane silenzioso a meno che l'utente non aumenti il volume utilizzando il tasto Volume.

Richiesta HTTP Post per il pulsante Azione

Il pulsante Azione su Cisco Desk Phone serie 9800 può essere configurato per attivare applicazioni XML tramite richieste HTTP Post.

In Campo contenuto personalizzato, inserisci lo script di richiesta personalizzato. È possibile specificare il tipo di contenuto XML o JSON e includere macro nella richiesta. Ad esempio, è possibile aggiungere $SSallo script per recuperare il segreto, il token o la password di autenticazione forniti nel campo Segreto servizio.

I seguenti esempi sono in XML e JSON:

Esempio #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>' Esempio #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) richiede la codifica percentuale per i caratteri riservati in conformità con RFC 3986.

Tabella 2. Percentuale di codifica per i caratteri riservati
CarattereCodifica percentuale
&%26
'%27
"%22
< %3c
> %3e

Lo script seguente è un esempio di utilizzo di stringhe con codifica percentuale.

--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
Tabella 3. Macro supportate
Nome macroEspansione macro
#DEVICENAME#Il nome del dispositivo visualizzato nel sistema chiamante. Ad esempio, SEP845A3EC21288
$SSSegreto di servizio che presenta una stringa mascherata nella pagina di configurazione del telefono, ad esempio segreto di autenticazione, token o password.