Configura il pulsante Azione per 9800 (Unified CM)

Personalizza il pulsante Azione

Le opzioni personalizzate per il pulsante Azione sul telefono da tavolo Cisco serie 9800 richiedono un supporto specifico per il firmware di PhoneOS. Vedere la seguente tabella per i dettagli:

Caratteristica	Versione del firmware richiesta
Chiamata di emergenza	PhoneOS 3.0.1 e versioni successive
Servizio personalizzato	PhoneOS 3.2.1 e versioni successive
Trigger multipli	PhoneOS 3.3.1 e versioni successive
Messaggio HTTP	PhoneOS 3.3.1 e versioni successive
Più eventi su un unico trigger	PhoneOS 3.4.1 e versioni successive

1	Effettui il login aCisco Unified Communications Manager Administration.
2	Se necessario, esegua una delle seguenti azioni: Per configurare tutti i telefoni distribuiti, vada su Sistema > Enterprise Phone Configuration. Per configurare i telefoni che condividono lo stesso profilo telefonico, vada su Dispositivo > Impostazioni del dispositivo > Profilo telefonico comune. Per configurare un singolo telefono, vada su Dispositivo > Telefono. Quindi trovi il suo telefono e apra la pagina di configurazione del 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 di livello aziendale
3	Personalizzi le impostazioni del pulsante Azione con i seguenti parametri in base ai suoi casi d'uso. Esistono tre gruppi di parametri per il pulsante Azione, ciascuno corrispondente a un servizio con un trigger univoco. Se un trigger di servizio è specificato 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 Configura i seguenti parametri: Funzione del pulsante di azione: Seleziona Chiamata di emergenza. Destinazione del servizio Action Button: Inserisca il numero di telefono o l'URI del servizio di emergenza. Nome servizio Action Button (opzionale): Specifica un nome per il servizio associato all'action trigger. 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à utilizzata la chiamata di emergenza come nome visualizzato. Ritardo chiamata in uscita: imposta il periodo di timeout (in secondi) entro il quale il telefono avvia una chiamata di emergenza dopo il rilevamento del trigger. Il valore predefinito è 5 secondi. Se impostato su 0, la chiamata viene effettuata immediatamente dopo aver rilevato il trigger. Service Trigger Seleziona un trigger dall'elenco: pressione singola, pressione prolungata o pressione 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 del chiamante per evitare di attirare l'attenzione durante la chiamata in corso. Solo il destinatario della chiamata può terminare la chiamata di emergenza silenziosa. Durante una chiamata di emergenza silenziosa, lo schermo del telefono 9811 e 9841 si blocca, mentre lo schermo del telefono 9851, 9861 e 9871 sarà spento. Tutte le altre funzioni sono inaccessibili. Il telefono ripristina il normale funzionamento dopo che il destinatario ha terminato la chiamata. Consenti il recupero silenzioso delle chiamate di emergenza (opzionale): abiliti questa funzione se 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 Configura i seguenti parametri: Funzione del pulsante di azione: Seleziona Personalizzato. Destinazione del servizio Action Button: Inserisca 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 Action Button (opzionale): Specifica 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. Quando non viene specificato alcun nome, verrà utilizzato il servizio personalizzato come nome visualizzato. Campo contenuto personalizzato (opzionale): Se desidera consentire al telefono di inviare una richiesta HTTP Post quando si preme il pulsante Azione, inserisca 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 chiamata in uscita: imposta il periodo di timeout, in secondi, entro il quale il telefono avvia un evento dopo aver rilevato il trigger. Il valore predefinito è 5 secondi. Se impostato su 0, l'evento viene avviato immediatamente dopo il rilevamento del trigger. Service Trigger Seleziona un trigger dall'elenco: pressione singola, pressione prolungata o pressione 3 volte. Segreto di servizio (opzionale): Inserisca il segreto di autenticazione, il token o la password se il suo servizio personalizzato richiede l'autenticazione per accedervi. Il segreto inserito viene visualizzato come stringa mascherata e può essere referenziato utilizzando la macro `$SS`in Custom Content Field e Action Button Service Destination. Trigger multipli Imposta i parametri in ciascun gruppo rispettivamente. Consulti le sezioni Chiamate di emergenza e Servizi personalizzati sopra. Un singolo trigger per più eventi Configura i seguenti parametri per assegnare più eventi a un trigger: Funzione del pulsante di azione: Seleziona Personalizzato. Destinazione del servizio Action Button: Inserisca il numero di telefono da chiamare e l'URL del servizio XML in questo formato: `tel:<phonenumber or SIP URI> + <serviceURL>` L'URL deve iniziare con `http://`o `https://`. Esempio: `tel:1234 + https://10.11.20.159/path/service.xml` Nome servizio Action Button (opzionale): Specifica 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. Quando non viene specificato alcun nome, verrà utilizzato il servizio personalizzato come nome visualizzato. Campo contenuto personalizzato (opzionale): Se desidera consentire al telefono di inviare una richiesta HTTP Post quando si preme il pulsante Azione, inserisca 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 chiamata in uscita: imposta il periodo di timeout, in secondi, entro il quale il telefono avvia un evento dopo aver rilevato il trigger. Il valore predefinito è 5 secondi. Se impostato su 0, l'evento viene avviato immediatamente dopo il rilevamento del trigger. Service Trigger Seleziona un trigger dall'elenco: pressione singola, pressione prolungata o pressione 3 volte. Segreto di servizio (opzionale): Inserisca il segreto di autenticazione, il token o la password se il suo servizio personalizzato richiede l'autenticazione per accedervi. Il segreto inserito viene visualizzato come stringa mascherata e può essere referenziato utilizzando la macro `$SS`in Custom Content Field e Action Button Service Destination. Chiamata di emergenza silenziosa (opzionale): Se ha incluso un numero di telefono o un URI di composizione nella destinazione del servizio, l'attivazione di questa funzione silenzierà le 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 del 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 9811 e 9841 si blocca, mentre lo schermo del telefono 9851, 9861 e 9871 sarà spento. Tutte le altre funzioni sono inaccessibili. Il telefono ripristina il normale funzionamento dopo che il destinatario ha terminato la chiamata. Consenti il recupero silenzioso delle chiamate di emergenza (opzionale): abiliti questa funzione se 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	Seleziona Salva.
5	Seleziona Applica configurazione.

Referenze

Parametri per il pulsante Azione

I parametri sono disponibili in Enterprise Phone Configuration, Common Phone Profile e Configurazione individuale del telefono.

Tabella 1. Parametri per il pulsante Azione
Parametro	Impostazioni predefinite e opzioni	Descrizione
Funzione del pulsante d'azione 1~3	Impostazione predefinita: disattivata Opzioni: Disattivata, Chiamata di emergenza, Personalizzata	Può configurare il pulsante con un servizio specifico. Off: se impostato su Off, 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 imposta il campo su Chiamata di emergenza o Personalizzato, si assicuri di inserire la destinazione del servizio nel campo Action Button Service Destination. Oppure, il telefono mostrerà un errore di configurazione.
Nome del servizio Action Button 1~3	Predefinito: vuoto	Facoltativamente, specifichi 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 specifica un nome, il nome predefinito sarà Chiamata di emergenza, Chiamata di emergenza silenziosa o Azione personalizzata in base alla sua selezione nel campo Funzione del pulsante di azione.
Action Button Service Destination 1~3	Predefinito: vuoto	Fornisca la destinazione del servizio in uno dei seguenti formati in base al servizio assegnato al pulsante Azione: Per i servizi di chiamata di emergenza, inserisca un numero di telefono o l'URI del servizio di emergenza. Quando configura il pulsante per un servizio personalizzato, inserisca 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 solo trigger, inserisca `tel:<phonenumber or SIP URL> + <Service RUL>`. Esempio: `tel:1234 + https://10.11.20.159/path/service.xml`. È supportata anche la chiamata agli URI SIP. Inserisca l'URI nel formato `tel: sip 4567@co.webex.com` Se abilita il pulsante Azione senza impostare una destinazione del servizio valida, l'utente al telefono vedrà un messaggio che richiede la configurazione. Dopo che l' utente ha chiuso questa notifica, l'icona di avviso rimarrà 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 configura il pulsante di azione come personalizzato e inserisce un numero di telefono come destinazione del servizio, sul telefono verrà visualizzato un messaggio di avviso che indica che il pulsante non è configurato. Può invece aggiungere un numero di telefono in questo formato `tel:<phone number>`, ad esempio `tel:1234`. Se non Le è consentito inserire un URL che includa la e commerciale (&), usi %26 come sostituto. Ad esempio, inserisca http://1.2.3.4/phone?a=1%26b=2%26c=3 invece di http://1.2.3.4/phone?a=1&b=2&c=3.
Campo di contenuto personalizzato 1~3	Predefinito: vuoto	Questa impostazione funziona solo quando la funzione del pulsante di azione è impostata su Personalizzata. Inserisca i dati HTTP come metodo, intestazione e contenuto del post, con una lunghezza massima di 1024 caratteri. Se configurato, il telefono invia una richiesta HTTP Post quando si preme il pulsante Action. Se il servizio richiede l'autenticazione per l'accesso, si assicuri di inserire il segreto di autenticazione nel campo Segreto del servizio. Nei dati HTTP, usi la macro `$SS`come riferimento a Service Secret. Per esempi e sintassi, vedere Richiesta HTTP Post per il pulsante Azione.
Segreto di servizio 1~3	Predefinito: vuoto	Un segreto di servizio può essere un segreto di autenticazione, un token o una password. Il segreto inserito viene visualizzato come stringa mascherata e può essere referenziato utilizzando la macro `$SS`in Custom Content Field e Action Button Service Destination.
Trigger di servizio 1~3	Impostazione predefinita: pressione singola Opzioni: Pressione singola, Pressione prolungata, Premere 3 volte	Scegli in che modo gli utenti possono effettuare una chiamata di emergenza o avviare un servizio personalizzato utilizzando il pulsante Azione del telefono. Pressione singola: prema il pulsante Azione per attivare la chiamata o il servizio associato. Pressione prolungata: prema il pulsante Azione verso il basso per almeno 2 secondi per attivare la chiamata o il servizio associato. Premere 3 volte: prema il pulsante Azione tre volte con intervalli inferiori a 2 secondi tra una pressione e l'altra per attivare la chiamata o il servizio associato. Non ripeta un trigger su più servizi, poiché i parametri con priorità più bassa non funzioneranno. L'ordine di priorità, dal più alto al più basso, è il seguente: Gruppo 1, Gruppo 2, Gruppo 3.
Ritardo di chiamata in uscita 1~3	Predefinito: 5 Opzioni: 0-30	Imposta il periodo di timeout, in secondi, per il telefono per avviare una chiamata di emergenza o un'azione personalizzata dopo la pressione del pulsante Azione. Lo imposti su 0 se preferisce che il telefono effettui la chiamata o avvii un evento immediatamente dopo aver rilevato il trigger, come specificato premendo una volta, a lungo o premendo tre volte il pulsante.
Chiamata di emergenza silenziosa 1~3	Predefinito: disabilitato Opzioni: Abilitato, Disabilitato	La chiamata di emergenza silenziosa è progettata per un'assistenza discreta in situazioni pericolose. Consente agli utenti di chiedere aiuto senza fare rumore. Se abilitato, 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 9811 e 9841 si bloccherà, mentre lo schermo del telefono 9851, 9861 e 9871 sarà spento. Il telefono blocca tutte le funzioni durante una chiamata di emergenza silenziosa, per impostazione predefinita. Per consentire agli utenti di ripristinare il normale funzionamento del telefono mantenendo la chiamata di emergenza silenziosa, abiliti la funzione Consenti il recupero silenzioso delle chiamate di emergenza. Se disattivata, la chiamata di emergenza funziona come una chiamata bidirezionale, simile alle altre chiamate in uscita.
Consentire il recupero silenzioso delle chiamate di emergenza	Predefinito: 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 finché il destinatario della chiamata non termina la chiamata. Quando questo parametro è impostato su Sì, gli utenti possono premere qualsiasi tasto 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 sul telefono da tavolo Cisco serie 9800 può essere configurato per attivare le applicazioni XML tramite richieste HTTP Post.

Nel campo Contenuto personalizzato, inserisca lo script di richiesta personalizzato. Può specificare il tipo di contenuto XML o JSON e includere macro nella richiesta. Ad esempio, $SSpuò essere aggiunto allo script per recuperare il segreto di autenticazione, il token o la password forniti nel campo Service Secret.

I seguenti esempi sono in XML e 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) richiede una codifica percentuale per i caratteri riservati in conformità con RFC 3986.

Tabella 2. Codifica percentuale per i caratteri riservati
Personaggio	Codifica percentuale
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

Il seguente script è un esempio che utilizza 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 macro	Espansione macro
#DEVICENAME#	Il nome del dispositivo visualizzato nel sistema di chiamata. Ad esempio, SEP845A3EC21288
$SS	Segreto di servizio che presenta una stringa mascherata nella pagina di configurazione del telefono, ad esempio segreto di autenticazione, token o password.

Cisco AI Assistant

Grazie per il feedback.

Personalizza il pulsante Azione

Referenze

Parametri per il pulsante Azione

Richiesta HTTP Post per il pulsante Azione

Small Business

Aziendale

Dispositivi

Soluzioni per

Risorse

Società