Personnalisation du bouton Action

Les options personnalisées du bouton Action du téléphone de bureau Cisco 9800 Series nécessitent une prise en charge spécifique du micrologiciel PhoneOS. Reportez-vous au tableau suivant pour plus de détails :

FonctionnalitéVersion du firmware requise
Appel d'urgencePhoneOS 3.0.1 et versions ultérieures
Service personnaliséPhoneOS 3.2.1 et versions ultérieures
Déclencheurs multiplesPhoneOS 3.3.1 et versions ultérieures
Publication HTTPPhoneOS 3.3.1 et versions ultérieures
Plusieurs événements sur un seul déclencheurPhoneOS 3.4.1 et versions ultérieures
1

Connectez-vous à Cisco Unified Communications Manager Administration.

2

Effectuez l’une des actions suivantes selon les besoins :

  • Pour configurer tous les téléphones déployés, accédez à Configuration des téléphones d’entreprise >système.
  • Pour configurer des téléphones partageant le même profil téléphonique, accédez à Périphérique > Paramètres du périphérique> Profil de téléphone commun.
  • Pour configurer un téléphone individuel, accédez à Périphérique > Téléphone. Ensuite, recherchez votre téléphone et ouvrez la page Configuration du téléphone.

La configuration suit une structure hiérarchique :

  • Les paramètres des périphériques individuels sont prioritaires sur les paramètres du profil de téléphone commun et du niveau entreprise
  • Les paramètres de profil de téléphone communs remplacent les paramètres au niveau de l’entreprise

3

Personnalisez les paramètres des boutons 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 avec un déclencheur unique. Si un déclencheur de service est spécifié dans plusieurs groupes, les paramètres du groupe 1 ont priorité sur ceux des groupes 2 et 3, tandis que le groupe 2 a priorité sur le groupe 3.

  • Appels d'urgence

    Configurez les paramètres suivants :

    • Fonction du bouton Action : sélectionnez Appel d’urgence.

    • Destination du service du bouton d’action : saisissez le numéro de téléphone ou le URI du service d’urgence.

    • Nom du service du bouton d’action (facultatif) : indiquez un nom pour le service associé au déclencheur d’action. Ce nom sera affiché dans le message à l’écran lorsque l’utilisateur appuiera sur le bouton, indiquant quel événement sera lancé. Si aucun nom n’est spécifié, l’appel d’urgence servira de nom d’affichage.

    • Délai d’appel sortant : définissez le délai d’expiration (en secondes) dont dispose le téléphone pour passer un appel d’urgence après la détection du déclencheur. La valeur par défaut est de 5 secondes. S’il est réglé sur 0, l’appel est passé immédiatement après la détection du déclencheur.

    • Déclencheur de service Sélectionnez un déclencheur dans la liste : Appui simple, Appui long ou Appuyez 3 fois.

    • Appel d’urgence silencieux (en option) : par défaut, l’appel d’urgence fonctionne comme un appel bidirectionnel, comme les autres appels sortants. Lorsque l’appel d’urgence silencieux est activé, le son reste silencieux du côté de l’appelant pour éviter d’attirer l’attention pendant l’appel entrant. Seul le destinataire de l’appel peut mettre fin à l’appel d’urgence silencieux.

      Pendant un appel d’urgence silencieux, l’écran du téléphone 9841 se fige, tandis que l’écran des téléphones 9851, 9861 et 9871 est désactivé. Toutes les autres fonctions sont inaccessibles. Le téléphone reprend son fonctionnement normal une fois que le destinataire a mis fin à l’appel.

    • Permettre la récupération d’appel d’urgence en silence (en option) : activez cette fonctionnalité 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 de l’appel reste silencieux sauf si l’utilisateur augmente le volume du haut-parleur à l’aide de la touche de volume.

  • Services personnalisés

    Configurez les paramètres suivants :

    • Fonction du bouton d’action : Sélectionnez Personnalisé.

    • Destination du service du bouton Action : saisissez l’URL du service personnalisé. L’URL doit commencer par http:// ou https://, par exemple,,https  ://10.11.20.159/path/service.xml .

    • Bouton Action Nom du service (facultatif) : indiquez un nom pour le service associé au déclencheur. Ce nom s’affiche dans le message affiché à l’écran lorsque l’utilisateur appuie sur le bouton, indiquant le service qui sera déclenché. Lorsqu’aucun nom n’est spécifié, le service personnalisé est utilisé comme nom d’affichage.

    • Champ Contenu personnalisé (facultatif) : si vous souhaitez autoriser le téléphone à envoyer une requête HTTP Post lorsque vous appuyez sur le bouton Action, entrez les données HTTP telles que la méthode, l’en-tête et le contenu Post, avec une longueur maximale de 1 024 caractères.

      Pour obtenir des exemples de script POST et la syntaxe, voir Demande HTTP Post pour le bouton Action.

    • Délai de numérotation : définissez le délai d’expiration, 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 lancé immédiatement après la détection du déclenchement.

    • Déclencheur de service Sélectionnez un déclencheur dans la liste : Appui simple, Appui long ou Appuyez 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 s’affiche sous la forme d’une chaîne masquée et peut être référencé à l’aide de la macro $SS dans le champ Contenu personnalisé et dans Destination du service du bouton d’action.

  • Déclencheurs multiples

    Définissez respectivement les paramètres de chaque groupe. Reportez-vous aux sections Appels d’urgence et Services personnalisés ci-dessus.

  • Un déclencheur unique pour plusieurs événements

    Configurez les paramètres suivants pour affecter plusieurs événements à un déclencheur :

    • Fonction du bouton d’action : Sélectionnez Personnalisé.

    • Destination du service du bouton Action : Entrez le numéro de téléphone à appeler et l’URL du service XML au format suivant :

      tél :<numérophone ou SIP URI> + <URLSERVICE>

      L’URL doit commencer par http:// ou https://.

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

    • Bouton Action Nom du service (facultatif) : indiquez un nom pour le service associé au déclencheur. Ce nom s’affiche dans le message affiché à l’écran lorsque l’utilisateur appuie sur le bouton, indiquant le service qui sera déclenché. Lorsqu’aucun nom n’est spécifié, le service personnalisé est utilisé comme nom d’affichage.

    • Champ Contenu personnalisé (facultatif) : si vous souhaitez autoriser le téléphone à envoyer une requête HTTP Post lorsque vous appuyez sur le bouton Action, entrez les données HTTP telles que la méthode, l’en-tête et le contenu Post, avec une longueur maximale de 1 024 caractères.

      Pour obtenir des exemples de script POST et la syntaxe, voir Demande HTTP Post pour le bouton Action.

    • Délai de numérotation : définissez le délai d’expiration, 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 lancé immédiatement après la détection du déclenchement.

    • Déclencheur de service Sélectionnez un déclencheur dans la liste : Appui simple, Appui long ou Appuyez 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 s’affiche sous la forme d’une chaîne masquée et peut être référencé à l’aide de la macro $SS dans le champ Contenu personnalisé et dans Destination du service du bouton d’action.

    • Appel d’urgence silencieux (en option) : 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 fonction simplifie le silence des appels d’urgence.

      Par défaut, l’appel d’urgence fonctionne comme un appel bidirectionnel, comme les autres appels sortants. Lorsqu’il est activé, le son est silencieux du côté de l’appelant pour éviter d’attirer l’attention pendant l’appel. Seul le destinataire de l’appel peut mettre fin à l’appel.

      Pendant un appel d’urgence silencieux, l’écran du téléphone 9841 se fige, tandis que l’écran des téléphones 9851, 9861 et 9871 est désactivé. Toutes les autres fonctions sont inaccessibles. Le téléphone reprend son fonctionnement normal une fois que le destinataire a mis fin à l’appel.

    • Permettre la récupération d’appel d’urgence en silence (en option) : activez cette fonctionnalité 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 de l’appel reste silencieux sauf si l’utilisateur augmente le volume du haut-parleur à l’aide de la touche de 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 des téléphones d’entreprise, Profil de téléphone commun et Configuration des téléphones individuels.

Tableau 1. Paramètres du bouton Action
ParamètreValeur par défaut et optionsDescription
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 spécifique.

  • Désactivé : lorsqu’il est défini sur Désactivé, le bouton Action pour le service unique sur le 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é, veillez à saisir la destination du service dans le champ Destination du service du bouton Action. Ou bien, le téléphone affichera une erreur de configuration.

Nom du service du bouton d’action 1 ~ 3

Valeur par défaut : vide

Vous pouvez également spécifier un nom pour le service associé au bouton Action. Ce nom s’affiche dans le message affiché à l’écran lorsque l’utilisateur appuie sur le bouton, indiquant le service qui sera déclenché.

Si vous ne précisez 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 du bouton d’action 1 ~ 3

Valeur par défaut : vide

Indiquez la destination du service sous l’un des formats suivants en fonction du service affecté au bouton Action :

  • Pour les services d’appel d’urgence, entrez un numéro de téléphone ou le URI de 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 de manière à lancer plusieurs événements avec un seul déclencheur, saisissez tel :<phonenumber ou l’URL SIP> + <RUL de service>. Exemple : tel :1234 + https ://10.11.20.159/path/service.xml.

    L’appel d’URI SIP est également pris en charge. Entrez le 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 voit un message lui demandant de configurer. Une fois que l’utilisateur a fermé cette notification, l’icône d’avertissement est affichée 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 des services personnalisés. Si vous configurez le bouton d’action sur Personnalisé et saisissez un numéro de téléphone en tant que destination du service, un message d’alerte s’affiche 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 au format tel : <numéro de téléphone>, par exemple, tél. 1234.

Si vous n’êtes pas autorisé à saisir une URL avec l’esperluette (&), utilisez %26 en remplacement. Par exemple, entrez 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

Valeur par défaut : vide

Ce paramètre ne fonctionne que lorsque la fonction du bouton Action est définie sur Personnalisé.

Entrez les données HTTP telles que la méthode, l’en-tête et le contenu de publication, avec une longueur maximale de 1024 caractères. Lorsqu’il est configuré, le téléphone envoie une requête HTTP Post lorsque l’on appuie sur l’action.

Si le service requiert une authentification pour y accéder, veillez à saisir le secret d’authentification dans le champ Secret de service. Dans les données HTTP, utilisez la macro $SS comme référence au secret de service.

Pour obtenir des exemples et la syntaxe, voir Demande HTTP Post pour le bouton Action.

Secret de service 1 ~ 3

Valeur par défaut : vide

Un secret de service peut être un secret d’authentification, un jeton ou un mot de passe. Le secret saisi s’affiche sous la forme d’une chaîne masquée et peut être référencé à l’aide de la macro $SS dans le champ Contenu personnalisé et dans Destination du service du bouton d’action.

Déclencheur de service 1 ~ 3

Valeur par défaut : Appuyez sur une seule pression

Options : Appuyez seul, appuyez longuement, appuyez 3 fois

Choisissez la manière dont les utilisateurs peuvent passer un appel d’urgence ou lancer un service personnalisé à l’aide du bouton Action du téléphone.

Appuyez une fois 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 associé.

Appuyez 3 fois : Appuyez trois fois sur le bouton Action à des intervalles inférieurs à 2 secondes entre chaque pression pour déclencher l’appel ou le service associé.

Ne répétez pas un trigger sur plusieurs services, car les paramètres de priorité inférieure ne fonctionneront pas. L’ordre de priorité, de la plus élevée à la plus basse, est le suivant : Groupe 1, Groupe 2, Groupe 3.

Délai de numérotation 1 ~ 3

Par défaut : 5

Options : 0 - 30

Définissez le délai d’expiration, en secondes, pendant lequel le téléphone peut lancer un appel d’urgence ou une action personnalisée lorsque vous appuyez sur le bouton Action.

Réglez-la sur 0 si vous préférez que le téléphone passe l’appel ou lance un événement dès la détection du déclencheur, comme indiqué par un simple appui, un appui long ou trois pressions sur le bouton.

Appel d’urgence silencieux 1 ~ 3

Valeur par défaut : Désactivé

Options : Activée, Désactivée

L’appel d’urgence silencieux est conçu pour une assistance discrète dans des situations dangereuses. Il 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é, seule l’autre partie peut y mettre fin. Pour éviter d’attirer l’attention pendant l’appel en cours, l’écran du téléphone 9841 se fige tandis que l’écran du téléphone 9851, 9861 et 9871 est désactivé. Par défaut, le téléphone verrouille toutes les fonctions pendant un appel d’urgence silencieux. Pour permettre aux utilisateurs de rétablir le fonctionnement normal du téléphone tout en maintenant l’appel d’urgence silencieux, activez la fonctionnalité Permettre la récupération d’appel d’urgence en mode silencieux.

  • Lorsqu’il est désactivé, l’appel d’urgence fonctionne comme un appel bidirectionnel, comme les autres appels sortants.

Permettre la récupération silencieuse des appels d’urgence

Paramètre par défaut : non

Options : Oui, Non

Indique si les utilisateurs peuvent récupérer la fonctionnalité du téléphone pendant un appel d’urgence silencieux. Par défaut, lorsqu’un appel d’urgence silencieux est lancé, le téléphone verrouille toutes les fonctions jusqu’à ce que le destinataire de l’appel mette fin à l’appel.

Lorsque ce paramètre est défini 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 de l’appel reste silencieux sauf si l’utilisateur augmente le volume à l’aide de la touche Volume.

Demande HTTP Post pour le bouton Action

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

Dans Champ 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, $SSpeuvent être ajoutés au script pour récupérer le secret d’authentification, le jeton ou le mot de passe fourni dans le champ Secret de service.

Les exemples suivants sont dans XML et JSON :

Exemple #1 : XML --méthode POST --header 'Content-Type : application/xml' --header 'Authorization : Bearer username :$SS' --body '<MetaData><Trigger>True</Trigger><Description>Ceci est pour HTTP POST XML</Description></MetaData>' Exemple #2 : JSON --method POST --header 'Content-Type : application/json' --header 'Authorization : $SS' --body '{"events » :[{"evtid » :"12345 », « parameters » : {"trigger » : true}, « Description » :"Ceci est pour HTTP POST JSON"}]}'

Cisco Unified Communications Manager (UCM) exige un codage en pourcentage pour les caractères réservés conformément à la norme RFC 3986.

Tableau 2. Pourcentage d’encodage des caractères réservés
PersonnagePourcentage de codage
&%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%3eCeci est pour HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
Tableau 3. Macros prises en charge
Nom de la macroExpansion de macro
#DEVICENAME#Le nom du périphérique affiché dans le système appelant. Par exemple, SEP845A3EC21288
$SSSecret de service qui présente une chaîne masquée dans la page de configuration du téléphone, telle que secret d’authentification, jeton ou mot de passe.