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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 manifeste automatisé sur la nouvelle Microsoft Teams interface utilisateur renseigne automatiquement l’ID du bot et met à jour les autres paramètres (tels que la marque) en fonction des entrées de vous, l’administrateur. Le générateur de fichier manifeste permet également de télécharger le package 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 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 de manifeste et le télécharger à nouveau autant de fois que vous le souhaitez.
    Remarque :
    Cette fonctionnalité est uniquement applicable lorsque vous configurez l’intégration Agent virtuel à Microsoft Teams. Si vous avez l’intention d’utiliser ServiceNow les options for with ITSM ou HR, sélectionnez le lien EnMicrosoft Teams 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 Agent 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 et 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 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 vers Microsoft Teams.
      Par exemple, 1.0.0. Utilisez un maximum de 2 chiffres après chaque décimale.
      Remarque :
      Assurez-vous d’indiquer 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 dièse (#). 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 les options suivantes :
      • Utiliser l’icône par défaut : remet la couleur de l’icône à celle 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 :
      Veillez à ne charger que les fichiers image .png dont la taille est inférieure à 192 x 192 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 : redéfinit 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 :
      Veillez à ne charger que les fichiers image .png dont la taille est inférieure à 32 x 32 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 du 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 supérieur 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 le fichier de votre 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, pour chaque nouveau manifeste, assurez-vous de saisir un numéro de version supérieur 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.