Générer automatiquement le fichier manifeste pour le chargement sur Microsoft Teams

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Générez automatiquement le fichier manifeste et personnalisez la personnalisation de votre Microsoft Teams application afin de pouvoir la rendre Agent virtuel disponible dans votre organisation.

    Avant de commencer

    Rôle requis : virtual_agent_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Un générateur de fichier de manifeste automatisé sur la nouvelle Microsoft Teams interface utilisateur remplit automatiquement l’ID du bot et met à jour les autres paramètres (tels que la personnalisation) en fonction des entrées de vous, l’administrateur. Le générateur de fichier manifeste permet également de télécharger le package du manifeste en un clic.

    • Avant de générer un fichier manifeste, vous devez créer un bot autoconfiguré (ou vous assurer qu’un bot a déjà été créé) dans l’instance ServiceNow . Vous pouvez ensuite générer un package de manifeste pour chaque bot autoconfiguré que vous créez.
    • Après avoir enregistré le formulaire de manifeste, vous pouvez télécharger le package zip du manifeste, qui contient les trois fichiers suivants :
      • manifest.json
      • color.png
      • outline.png
      Vous pouvez modifier le formulaire de manifeste et le télécharger à nouveau autant de fois que vous le souhaitez.
    Remarque :
    Cette fonctionnalité ne s’applique que lorsque vous configurez l’intégration Agent virtuel avec Microsoft Teams. Si vous avez l’intention d’utiliser ServiceNow les options for Microsoft Teams with ITSM ou HR, sélectionnez le lien En savoir plus en regard de Planification pour activer des intégrations ITSM et RH supplémentaires sur la page Configuration du bot. De cette façon, vous pouvez configurer le manifeste dans un module distinct au lieu de continuer à configurer le manifeste ici. Pour plus d’informations, consultez Créer et télécharger le fichier manifeste.

    Procédure

    1. Accédez à la Tout > Interfaces conversationnelles > Paramètres.
    2. Dans Paramètres généraux, dans la section Canaux et routage, sélectionnez Afficher tout.
    3. Sur la page Canaux et intégrations, dans la Microsoft Teams vignette, sélectionnez Gérer.
    4. Dans la section Bot autoconfiguré, sélectionnez l’icône Gérer le boticône Gérer le bot..
      Si vous n’avez pas activé l’extension de message et que vous y accédez pour la première fois, un message d’alerte Activer la nouvelle fonctionnalité s’affiche pour vous informer que la fonctionnalité d’extension de message de votre Microsoft Teams intégration peut maintenant être activée.
    5. Dans l’onglet Configuration , sélectionnez Modifier la configuration et, dans le formulaire, renseignez les champs.
      Tableau 1. Configurer votre bot : manifeste VA Microsoft Teams
      Champ Description
      Nom court Nom d’affichage court de votre application.
      Remarque :
      Assurez-vous que le nom ne dépasse pas 30 caractères.
      Nom complet Nom complet de votre application. Utilisez le nom complet si le nom court de l’application dépasse 30 caractères.
      Remarque :
      Assurez-vous que le nom complet ne dépasse pas 100 caractères.
      ID de l'agent (Client) Identificateur unique Microsoft généré.

      Ce champ est automatiquement lié à l’étape de création du bot et ne peut pas être modifié.
      Description brève Brève description de votre expérience d’application. Utilisez une description brève lorsque l’espace est limité.
      Remarque :
      Assurez-vous que la description brève ne dépasse pas 80 caractères.
      Description complète Description complète de votre application.
      Remarque :
      Assurez-vous que la description complète ne dépasse pas 4 000 caractères.
      Domaines valides Liste des domaines valides pour les sites web dans lesquels votre application prévoit de se charger Microsoft Teams.
      Remarque :
      Actuellement, seul le ServiceNow domaine est pris en charge.
      Version Version spécifique de votre application pour suivre la soumission du manifeste incrémentiel à Microsoft Teams.
      Par exemple, 1.0.0. Utilisez un maximum de 2 chiffres après chaque décimale.
      Remarque :
      Assurez-vous de mettre un nombre plus élevé pour chaque nouvelle version.
      Couleur d'accentuation Couleur à utiliser comme arrière-plan pour vos icônes de contour.
      Remarque :
      La valeur doit être un code couleur HTML valide commençant par un hashtag (#). Par exemple, #293E40.
      Icône de couleur Icône de votre application que vous souhaitez afficher dans la plupart des Microsoft Teams scénarios.
      Vous pouvez sélectionner l’une des options suivantes :
      • Utiliser l’icône par défaut : remplace la couleur de l’icône par l’icône de couleur par défaut.
      • Utiliser l’icône personnalisée : remplace l’icône de couleur par une couleur d’icône de votre choix.
      Remarque :
      Assurez-vous de charger uniquement les fichiers d’image .png ayant moins de 192x192 pixels pour changer la couleur de l’icône.
      Icône de contour Icône affichée dans la barre de l’application lorsque celle-ci est en cours d’utilisation.
      Vous pouvez sélectionner l’une des options suivantes :
      • Utiliser l’icône par défaut : remplace l’icône de contour par l’icône de contour par défaut.
      • Utiliser l’icône personnalisée : remplace l’icône de contour par une icône de votre choix.
      Remarque :
      Assurez-vous de ne charger que les fichiers d’image .png de moins de 32x32 pixels pour modifier l’icône de contour.
      Extension du message Extension de message qui permet aux utilisateurs de rechercher et de partager les résultats via la zone de composition de message du Microsoft Teams client.

      Pour plus d’informations sur chaque champ, consultez la documentation Microsoft Teams.

    6. Sélectionnez Enregistrer.
      Vous êtes redirigé vers la page de configuration du bot où le fichier manifeste est enregistré et prêt à être téléchargé.
      Remarque :

      Vous pouvez également modifier le fichier manifeste en sélectionnant Modifier la configuration sur la page de téléchargement et en téléchargeant le fichier autant de fois que vous le souhaitez. À chaque nouveau manifeste, assurez-vous de saisir un numéro de version plus élevé dans le champ Version afin que le formulaire mis à jour puisse être enregistré avec succès.

    7. Dans la page Configuration du bot, sous Votre package, sélectionnez le bouton Télécharger pour télécharger votre fichier de package.
      Remarque :

      Vous pouvez également modifier le fichier manifeste en sélectionnant Modifier la configuration sur la page de téléchargement et en téléchargeant le fichier autant de fois que vous le souhaitez. Toutefois, à chaque nouveau manifeste, assurez-vous de saisir un numéro de version plus élevé dans le champ Version afin que le formulaire mis à jour soit enregistré avec succès.

    Que faire ensuite

    Charger le fichier de package manifeste pour publier votre bot.