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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 fichiers 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 marque) en fonction de votre entrée, en tant qu’administrateur. Le générateur de fichiers manifestes permet également de télécharger le package de manifeste en un clic.

    • Avant de générer un fichier manifeste, vous devez créer un bot autoconfiguré (ou vous assurer qu’il 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 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 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 ServiceNowMicrosoft Teams des options avec ITSM ou RH, sélectionnez le lien En savoir plus à côté 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 séparé 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 acheminement, 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 l’agentIcône Gérer l’agent..
      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 une nouvelle fonctionnalité s’affiche qui vous informe que la fonctionnalité d’extension de message de votre Microsoft Teams intégration peut désormais être activée.
    5. Dans l’onglet Configuration , sélectionnez Modifier la configuration et renseignez les champs du formulaire.
      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 généré unique Microsoft .

      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 courte 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 que votre application prévoit de charger dans Microsoft Teams.
      Remarque :
      Actuellement, seul le ServiceNow domaine est pris en charge.
      Version Version spécifique de votre application pour suivre la soumission incrémentielle du manifeste à 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 une balise de hachage (#). Par exemple, #293E40.
      Icône de couleur Icône de votre application que vous souhaitez voir apparaître dans la plupart Microsoft Teams des scénarios.
      Vous pouvez sélectionner les options suivantes :
      • Utiliser l’icône par défaut : remplace la couleur de l’icône par défaut.
      • Utiliser une icône personnalisée : Modifie l’icône de couleur avec une couleur d’icône de votre choix.
      Remarque :
      Assurez-vous de charger uniquement les fichiers image .png qui ont moins de 192x192 pixels pour modifier la couleur de l’icône.
      Icône de contour Icône affichée sur la barre de l’application lorsque l’application est en cours d’utilisation.
      Vous pouvez sélectionner les 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 une icône personnalisée : remplace l’icône de contour par une icône de votre choix.
      Remarque :
      Assurez-vous de charger uniquement les fichiers 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.

      Si vous prévoyez d’utiliser ce bot pour Microsoft Copilot, assurez-vous d’activer l’extension du message. Now Assist Conversation avec Microsoft Copilot l’affichage de l’extension de message activée pour votre application.

      En activant l’extension de message pour une application ou un bot, vous verrez la même application ou le même bot dans la zone d’extension du message pendant que votre conversation avec le Now Assist .Microsoft Copilot

      Pour en savoir plus 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. Sur la page de 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, veillez à saisir un numéro de version plus élevé dans le champ Version afin d’enregistrer le formulaire mis à jour.

    Que faire ensuite

    Chargez le fichier du package de manifeste pour publier votre bot.