Configurez le bouton Action pour 9800 (Unified CM)

Personnalisez le bouton Action

Les options personnalisées pour le bouton Action des téléphones de bureau Cisco de la gamme 9800 nécessitent une prise en charge spécifique du firmware PhoneOS. Consultez le tableau suivant pour plus de détails :

Fonctionnalité	Version du firmware requise
Appel d'urgence	PhoneOS 3.0.1 et versions ultérieures
Service personnalisé	PhoneOS 3.2.1 et versions ultérieures
Déclencheurs multiples	PhoneOS 3.3.1 et versions ultérieures
Post HTTP	PhoneOS 3.3.1 et versions ultérieures
Plusieurs événements sur un seul déclencheur	PhoneOS 3.4.1 et versions ultérieures

1	Connectez-vous àCisco Unified Communications Manager Administration.
2	Effectuez l'une des actions suivantes selon vos besoins : Pour configurer tous les téléphones déployés, allez dans Système > Configuration téléphonique d'entreprise. Pour configurer les téléphones partageant le même profil téléphonique, allez sur Appareil > Paramètres de l'appareil > Profil téléphonique commun. Pour configurer un téléphone individuel, allez sur Appareil > Téléphone. Ensuite, trouvez votre téléphone et ouvrez la page de configuration du téléphone. La configuration suit une structure hiérarchique : Les paramètres individuels de l'appareil ont priorité sur les paramètres du profil téléphonique courant et au niveau de l'entreprise Les paramètres courants du profil téléphonique l'emportent sur les paramètres au niveau de l'entreprise
3	Personnalisez les paramètres du bouton Action avec les paramètres suivants en fonction de vos cas d'utilisation. Il existe trois groupes de paramètres pour le bouton Action, chacun correspondant à un service doté d'un déclencheur unique. Si un déclencheur de service est spécifié dans plusieurs groupes, les paramètres du groupe 1 ont la priorité sur ceux des groupes 2 et 3, tandis que le groupe 2 a la priorité sur le groupe 3. Appels d'urgence Configurez les paramètres suivants : Fonction du bouton d'action : sélectionnez Appel d'urgence. Destination du service Action Button : entrez le numéro de téléphone ou l'URI du service d'urgence. Nom du service du bouton d'action (facultatif) : indiquez le nom du service associé au déclencheur d'action. Ce nom apparaîtra dans le message à l' écran lorsque l'utilisateur appuiera sur le bouton, pour indiquer quel événement sera lancé. Si aucun nom n'est spécifié, l'appel d'urgence sera utilisé comme nom d'affichage. Délai de numérotation : définissez le délai d'attente (en secondes) pendant lequel le téléphone lance un appel d'urgence une fois le déclencheur détecté. La valeur par défaut est de 5 secondes. S'il est réglé sur 0, l'appel est passé dès qu'il détecte le déclencheur. Déclencheur de service Sélectionnez un déclencheur dans la liste : appui simple, appui long ou appui 3 fois. Appel d'urgence silencieux (facultatif) : Par défaut, l' appel d'urgence fonctionne comme un appel bidirectionnel, comme les autres appels sortants. Lorsque les appels d'urgence silencieux sont activés, le son est silencieux du côté de l'appelant pour ne pas attirer l' attention pendant l'appel en cours. Seul le destinataire de l'appel peut mettre fin à l'appel d'urgence silencieux. Lors d'un appel d'urgence silencieux, l'écran des téléphones 9811 et 9841 se fige, tandis que l'écran des téléphones 9851, 9861 et 9871 s'éteint. Toutes les autres fonctions sont inaccessibles. Le téléphone reprend son fonctionnement normal une fois que le destinataire a mis fin à l'appel. Autoriser la récupération silencieuse des appels d'urgence (facultatif) : activez cette fonction si vous autorisez les utilisateurs à appuyer sur n'importe quelle touche pour rétablir le fonctionnement normal du téléphone tout en maintenant l'appel d'urgence. Le son des appels reste silencieux à moins que l'utilisateur n'augmente le volume du haut-parleur à l'aide de la touche Volume. Services personnalisés Configurez les paramètres suivants : Fonction du bouton d'action : sélectionnez Personnalisé. Destination du service Action Button : entrez l'URL du service personnalisé. L'URL doit commencer par `http://`ou `https://`, par exemple, `https://10.11.20.159/path/service.xml`. Nom du service Action Button (facultatif) : indiquez le nom du service associé au déclencheur. Ce nom apparaîtra dans le message à l'écran lorsque l'utilisateur appuiera sur le bouton, indiquant quel service sera activé. Lorsqu'aucun nom n'est spécifié, le service personnalisé sera utilisé comme nom d'affichage. Champ de contenu personnalisé (facultatif) : si vous souhaitez permettre au téléphone d'envoyer une requête HTTP Post lorsque vous appuyez sur le bouton Action, saisissez les données HTTP telles que la méthode, l'en-tête et le contenu de la publication, avec une longueur maximale de 1 024 caractères. Pour des exemples de scripts POST et la syntaxe, voir Requête HTTP Post pour le bouton Action. Délai de numérotation : définissez le délai d'attente , en secondes, pendant lequel le téléphone déclenche un événement après avoir détecté le déclencheur. La valeur par défaut est de 5 secondes. Lorsqu'il est réglé sur 0, l'événement est déclenché dès qu'il est détecté. Déclencheur de service Sélectionnez un déclencheur dans la liste : appui simple, appui long ou appui 3 fois. Secret de service (facultatif) : entrez le secret d'authentification, le jeton ou le mot de passe si votre service personnalisé nécessite une authentification pour y accéder. Le secret saisi est affiché sous forme de chaîne masquée et peut être référencé à l'aide de la macro `$SS`dans le champ de contenu personnalisé et la destination du service du bouton d'action. Déclencheurs multiples Définissez les paramètres de chaque groupe respectivement. Consultez les sections Appels d'urgence et Services personnalisés ci-dessus. Un seul déclencheur pour plusieurs événements Configurez les paramètres suivants pour attribuer plusieurs événements à un déclencheur : Fonction du bouton d'action : sélectionnez Personnalisé. Destination du service Action Button : entrez le numéro de téléphone à appeler et l'URL du service XML au format suivant : `tel:<phonenumber or SIP URI> + <serviceURL>` L'URL doit commencer par `http://`ou `https://`. Exemple : `tel:1234 + https://10.11.20.159/path/service.xml` Nom du service Action Button (facultatif) : indiquez le nom du service associé au déclencheur. Ce nom apparaîtra dans le message à l'écran lorsque l'utilisateur appuiera sur le bouton, indiquant quel service sera activé. Lorsqu'aucun nom n'est spécifié, le service personnalisé sera utilisé comme nom d'affichage. Champ de contenu personnalisé (facultatif) : si vous souhaitez permettre au téléphone d'envoyer une requête HTTP Post lorsque vous appuyez sur le bouton Action, saisissez les données HTTP telles que la méthode, l'en-tête et le contenu de la publication, avec une longueur maximale de 1 024 caractères. Pour des exemples de scripts POST et la syntaxe, voir Requête HTTP Post pour le bouton Action. Délai de numérotation : définissez le délai d'attente , en secondes, pendant lequel le téléphone déclenche un événement après avoir détecté le déclencheur. La valeur par défaut est de 5 secondes. Lorsqu'il est réglé sur 0, l'événement est déclenché dès qu'il est détecté. Déclencheur de service Sélectionnez un déclencheur dans la liste : appui simple, appui long ou appui 3 fois. Secret de service (facultatif) : entrez le secret d'authentification, le jeton ou le mot de passe si votre service personnalisé nécessite une authentification pour y accéder. Le secret saisi est affiché sous forme de chaîne masquée et peut être référencé à l'aide de la macro `$SS`dans le champ de contenu personnalisé et la destination du service du bouton d'action. Appel d'urgence silencieux (facultatif) : si vous avez inclus un numéro de téléphone ou un URI de numérotation dans la destination du service, l'activation de cette fonctionnalité désactivera les appels d'urgence. Par défaut, l'appel d'urgence fonctionne comme un appel bidirectionnel, comme les autres appels sortants. Lorsqu'il est réglé sur Activé, le son est silencieux du côté de l'appelant pour ne pas attirer l'attention pendant l'appel en cours. Seul le destinataire peut mettre fin à l'appel. Lors d'un appel d'urgence silencieux, l'écran des téléphones 9811 et 9841 se fige, tandis que l'écran des téléphones 9851, 9861 et 9871 s'éteint. Toutes les autres fonctions sont inaccessibles. Le téléphone reprend son fonctionnement normal une fois que le destinataire a mis fin à l'appel. Autoriser la récupération silencieuse des appels d'urgence (facultatif) : activez cette fonction si vous autorisez les utilisateurs à appuyer sur n'importe quelle touche pour rétablir le fonctionnement normal du téléphone tout en maintenant l'appel d'urgence. Le son des appels reste silencieux à moins que l'utilisateur n'augmente le volume du haut-parleur à l'aide de la touche Volume. Pour plus d'informations sur ces paramètres, voir Paramètres du bouton Action.
4	Sélectionnez Enregistrer.
5	Sélectionnez Appliquer la configuration.

Références

Paramètres du bouton Action

Les paramètres sont disponibles dans Configuration téléphonique d'entreprise, Profil téléphonique commun et Configuration téléphonique individuelle.

Tableau 1. Paramètres du bouton Action
Paramètre	Par défaut et options	Description
Fonction du bouton d'action 1~3	Par défaut : Désactivé Options : Désactivé, Appel d'urgence, Personnalisé	Vous pouvez configurer le bouton avec un service en particulier. Désactivé : Lorsqu'il est réglé sur Désactivé, le bouton Action du service unique du téléphone ne fonctionne pas. Appel d'urgence : les utilisateurs peuvent utiliser le bouton Action pour passer un appel d'urgence, s'il est configuré. Personnalisé : les utilisateurs peuvent utiliser le bouton Action pour accéder au service personnalisé, s'il est configuré. Lorsque vous définissez le champ sur Appel d'urgence ou Personnalisé, assurez-vous de saisir la destination du service dans le champ Destination du service du bouton Action. Ou le téléphone affichera une erreur de configuration.
Nom du service Action Button 1~3	Par défaut : vide	Indiquez éventuellement un nom pour le service associé au bouton Action. Ce nom apparaîtra dans le message à l'écran lorsque l'utilisateur appuiera sur le bouton, indiquant quel service sera activé. Si vous ne donnez pas de nom, le nom par défaut sera Appel d'urgence, Appel d'urgence silencieux ou Action personnalisée en fonction de votre sélection dans le champ Fonction du bouton d'action.
Destination du service Action Button 1~3	Par défaut : vide	Indiquez la destination du service dans l'un des formats suivants en fonction du service attribué au bouton Action : Pour les services d'appel d'urgence, entrez un numéro de téléphone ou l'URI du service d'urgence. Lorsque vous configurez le bouton pour un service personnalisé, saisissez l'URL du service. L'URL doit commencer par `http://`ou `https://`. Par exemple, `https://10.11.20.159/path/service.xml`. Pour configurer le bouton afin de lancer plusieurs événements en un seul déclencheur, entrez `tel:<phonenumber or SIP URL> + <Service RUL>`. Exemple : `tel:1234 + https://10.11.20.159/path/service.xml`. Les appels d'URI SIP sont également pris en charge. Entrez l'URI au format `tel: sip 4567@co.webex.com` Si vous activez le bouton Action sans définir de destination de service valide, l'utilisateur du téléphone verra un message l'invitant à effectuer la configuration. Une fois que l' utilisateur aura fermé cette notification, l'icône d'avertissement persistera dans l'en-tête de l'écran du téléphone jusqu'à ce que le bouton soit correctement configuré ou désactivé. Les numéros de téléphone ne peuvent pas être utilisés comme destinations pour les services personnalisés. Si vous configurez le bouton d'action comme personnalisé et que vous saisissez un numéro de téléphone comme destination du service, un message d'alerte s'affichera sur le téléphone indiquant que le bouton n'est pas configuré. À la place, vous pouvez ajouter un numéro de téléphone dans ce format `tel:<phone number>`, par exemple `tel:1234`. Si vous n'êtes pas autorisée à saisir une URL avec une esperluette (&), utilisez %26 en remplacement. Par exemple, saisissez http://1.2.3.4/phone?a=1%26b=2%26c=3 au lieu de http://1.2.3.4/phone?a=1&b=2&c=3.
Champ de contenu personnalisé 1~3	Par défaut : vide	Ce réglage ne fonctionne que lorsque la fonction du bouton d'action est réglée sur Personnalisé. Entrez les données HTTP telles que la méthode, l'en-tête et le contenu de la publication, avec une longueur maximale de 1 024 caractères. Une fois configuré, le téléphone envoie une requête HTTP Post lorsque vous appuyez sur Action. Si le service nécessite une authentification pour y accéder, assurez-vous de saisir le secret d'authentification dans le champ Service Secret. Dans les données HTTP, utilisez la macro `$SS`comme référence à Service Secret. Pour des exemples et la syntaxe, voir Requête HTTP Post pour le bouton Action.
Service Secret 1~3	Par défaut : vide	Un secret de service peut être un secret d'authentification, un jeton ou un mot de passe. Le secret saisi est affiché sous forme de chaîne masquée et peut être référencé à l'aide de la macro `$SS`dans le champ de contenu personnalisé et la destination du service du bouton d'action.
Service Trigger 1~3	Par défaut : pression unique Options : pression unique, pression longue, pression 3 fois	Choisissez comment les utilisateurs peuvent passer un appel d'urgence ou lancer un service personnalisé à l'aide de la touche Action du téléphone. Appui unique : appuyez sur le bouton Action pour déclencher l'appel ou le service associé. Appui long : appuyez sur le bouton Action pendant au moins 2 secondes pour déclencher l'appel ou le service correspondant. Appuyez 3 fois : appuyez trois fois sur le bouton Action, à des intervalles de moins de 2 secondes entre chaque pression pour déclencher l' appel ou le service correspondant. Ne répétez pas un déclencheur sur plusieurs services, car les paramètres les moins prioritaires ne fonctionneront pas. L'ordre de priorité, du plus élevé au plus bas, est le suivant : Groupe 1, Groupe 2, Groupe 3.
Délai d'appel : 1 à 3	Par défaut : 5 Options : 0 à 30	Réglez le délai, en secondes, pendant lequel le téléphone lance un appel d'urgence ou une action personnalisée après avoir appuyé sur le bouton Action. Réglez-le sur 0 si vous préférez que le téléphone passe l'appel ou lance un événement dès qu'il détecte le déclencheur, comme indiqué par une simple pression, une pression longue ou une triple pression sur le bouton.
Appel d'urgence silencieux 1~3	Par défaut : Désactivé Options : Activé, Désactivé	Les appels d'urgence silencieux sont conçus pour fournir une assistance discrète dans des situations dangereuses. Cela permet aux utilisateurs de demander de l'aide sans faire de bruit. Lorsque cette option est activée, les utilisateurs peuvent passer des appels unidirectionnels à l'aide du bouton Action. Une fois l'appel d'urgence silencieux passé, seul l'autre interlocuteur peut y mettre fin. Pour ne pas attirer l'attention pendant l'appel en cours, l'écran des téléphones 9811 et 9841 se figera, tandis que celui des téléphones 9851, 9861 et 9871 sera éteint. Le téléphone verrouille toutes les fonctions lors d'un appel d'urgence silencieux, par défaut. Pour permettre aux utilisateurs de rétablir le fonctionnement normal du téléphone tout en maintenant le silence des appels d'urgence, activez la fonction Autoriser la récupération silencieuse des appels d'urgence. Lorsqu'il est désactivé, l'appel d'urgence fonctionne comme un appel bidirectionnel, comme les autres appels sortants.
Autoriser la récupération silencieuse des appels d'urgence	Par défaut : Non Options : Oui, Non	Contrôle si les utilisateurs peuvent récupérer les fonctionnalités du téléphone pendant un appel d'urgence silencieux. Par défaut, une fois qu'un appel d'urgence silencieux est lancé, le téléphone verrouille toutes les fonctions jusqu'à ce que le destinataire mette fin à l'appel. Lorsque ce paramètre est réglé sur Oui, les utilisateurs peuvent appuyer sur n'importe quelle touche pour rétablir le fonctionnement normal du téléphone tout en maintenant l'appel d'urgence. Le son des appels reste silencieux à moins que l'utilisateur n'augmente le volume à l'aide de la touche Volume.

Demande de publication HTTP pour le bouton Action

Le bouton Action des téléphones de bureau Cisco de la gamme 9800 peut être configuré pour déclencher des applications XML via des requêtes HTTP Post.

Dans le champ de contenu personnalisé, saisissez votre script de demande personnalisé. Vous pouvez spécifier le type de contenu XML ou JSON et inclure des macros dans la demande. Par exemple, il $SSpeut être ajouté au script pour récupérer le secret d'authentification, le jeton ou le mot de passe fournis dans le champ Service Secret.

Les exemples suivants sont en XML et 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) exige un encodage en pourcentage pour les caractères réservés conformément à la RFC 3986.

Tableau 2. Codage en pourcentage pour les caractères réservés
Personnage	Codage en pourcentage
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

Le script suivant est un exemple utilisant des chaînes codées en pourcentage.

--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

Tableau 3. Macros prises en charge
Nom de la macro	Expansion macroéconomique
#DEVICENAME#	Le nom de l'appareil affiché dans le système d'appel. Par exemple, SEP845A3EC21288
$SS	Service Secret qui présente une chaîne masquée sur la page de configuration du téléphone, telle qu'un secret d'authentification, un jeton ou un mot de passe.

Cisco AI Assistant

Merci pour votre commentaire.

Personnalisez le bouton Action

Références

Paramètres du bouton Action

Demande de publication HTTP pour le bouton Action

Petite entreprise

Enterprise

Périphériques

Solutions pour le

Ressources

Société