Ajouter un bot conversationnel à une page
Notes
- Depuis octobre 2022, les portails Power Apps ont été remplacés par Power Pages.
- À compter du 26 février 2024, le studio de portails Power Apps hérité sera mis hors service. Utilisez plutôt le Power Pages studio de conception pour modifier vos sites web. Plus d’informations : Le studio de portails Power Apps sera mis hors service
- Cette rubrique s’applique aux capacités héritées. Pour obtenir les dernières informations, consultez la documentation de Microsoft Power Pages.
Les portails Power Apps vous permettent d’ajouter un bot conversationnel Power Virtual Agents pour répondre aux questions postées par un visiteur sur la page de votre portail. Un bot conversationnel (bot) configuré avec différents sujets et phrases de déclenchement peut répondre automatiquement aux questions posées par un visiteur dans une conversation instantanée.
Notes
La possibilité d’ajouter un chatbot à l’aide du nouveau studio design Power Pages n’est pas prise en charge. Veuillez consulter Procédure : intégrer un chatbot sur une page web pour savoir comment intégrer un chatbot sur un site Power Pages.
Conditions préalables
Avant de pouvoir ajouter un bot Power Virtual Agents à un portail Power Apps, vous devez d’abord créer un bot. Si vous n’avez pas encore de bot disponible ou qui correspond à vos besoins, vous aurez la possibilité dans les portails d’aller sur Power Virtual Agents pour en créer. Pour apprendre à créer un bot, rendez-vous sur Créer et supprimer des bots Power Virtual Agents.
Important
Cette fonctionnalité nécessite les versions suivantes pour le package de portail de démarrage et l’hôte de portail :
- Version hôte du portail 9.3.4.x ou plus tard.
- Package Portail de démarrage version 9.2.2103.x ou plus tard. Plus d’information : Considérations supplémentaires
Ajouter un composant de bot conversationnel
Une fois que vous avez créé un bot conversationnel, vous pouvez ajouter ce composant à une page de portail en procédant comme suit :
Accédez à Power Apps.
Cliquez sur Applications dans le volet de gauche.
Sélectionnez votre portail.
Sélectionnez Modifier pour ouvrir le studio des portails.
Dans le volet de gauche, sélectionnez Composants.
Sélectionnez un composant de Bot conversationnel.
Sélectionnez votre bot.
Notes
Si vous n’avez pas encore de bot créé ou si vous souhaitez créer un bot à utiliser dans les portails, sélectionnez Power Virtual Agents. Après avoir créé votre bot, sélectionnez Configuration de synchronisation à l’intérieur du Studio des portails pour refléter les changements de bot.
Sélectionnez si le bot apparaît sur toutes les pages de votre portail ou sur des pages spécifiques.
Si vous sélectionnez Pages spécifiques, utilisez Gérer les bots dans les pages pour contrôler les pages pouvant utiliser ce bot.
Vous pouvez ajouter d’autres bots de votre environnement sur différentes pages d’un portail. Par exemple, un bot qui répond aux questions liées au lieu de travail peut être ajouté à une page RH. Ou un bot qui répond aux requêtes de base sur la paie peut être ajouté à une page Finance. Cependant, vous ne pouvez pas faire en sorte qu’une page utilise plus d’un bot.
Configuration avancée
Le composant de bot conversationnel est rendu à l’aide d’un modèle web appelé Power Virtual Agents.
Vous pouvez modifier les valeurs des paramètres suivants dans la fonction "window.PvaEmbeddedWebChat.renderWebChat()".
| Numéro | Paramètre | active |
|---|---|---|
| 1 | width | Utilise la variable "chatWidth". Pour modifier, mettez à jour la largeur en pixels : let chatWidth = "320px"; |
| 2 | hauteur | Utilise la variable "chatHeight". Pour modifier, mettez à jour la hauteur en pixels : let chatHeight = "480px"; |
| 3 | headerText | Titre du bot. Par défaut, cela utilise le nom du bot. Pour modifier, ajoutez le paramètre "headerText" avec la valeur de l’en-tête du bot : "headerText": 'Contoso chatbot'; |
| 4 : fontColor 5 : backgroundColor |
webChatHeaderStyleOptions | Détermine le style d’en-tête du composant de bot conversationnel, comme la couleur de la police et de l’arrière-plan. Pour modifier, mettez à jour le paramètre « webChatHeaderStyleOptions » avec les valeurs des propriétés « fontColor » et « backgroundColor » : "webChatHeaderStyleOptions": {"fontColor":'black',"backgroundColor":'white'} |
| 6 : backgroundColor 7 : bubbleBackgroundcolor 8 : bubbleTextColor 9 : bubbleFromUserBackground 10 : bubbleFromUserTextColor |
webChatCanvasStyleOptions | Détermine le style de canevas de conversation pour le composant de bot conversationnel, tel que l’arrière-plan et les arrière-plans de la bulle du bot conversationnel et l’utilisateur. Pour modifier, mettez à jour les paramètres « webChatCanvasStyleOptions » avec les valeurs pour les propriétés « backgroundColor », « bubbleBackgroundcolor », « bubbleTextColor », « bubbleFromUserBackground » et « bubbleFromUserTextColor » : "webChatCanvasStyleOptions": {"backgroundColor": "#123FFF","bubbleBackground":"#2340F0","bubbleTextColor": "#323130","bubbleFromUserBackground": "#412644","bubbleFromUserTextColor": "#F345FF"} |
| 11 : backgroundColor 12 : iconColor |
webChatWidgetStyleOptions | Détermine le style du composant ChatWidget, tel que la couleur de l’icône et de l’arrière-plan. Pour modifier, mettez à jour le paramètre « webChatWidgetStyleOptions » avec les valeurs pour les propriétés « backgroundColor » et « iconColor » :"webChatWidgetStyleOptions": {"backgroundColor": "#486744","iconColor": "#DF234F"} |
Après avoir modifié le modèle web, assurez-vous de sélectionner Configuration de synchronisation pour mettre à jour la configuration et refléter les changements.
Notes
Toute modification du modèle Web Power Virtual Agents autre que les paramètres expliqués ci-dessus ne sont pas pris en charge.
Considérations supplémentaires
Tenez compte des points suivants lorsque vous utilisez un bot conversationnel Power Virtual Agents à l’intérieur des portails :
Version du modèle de portail
Cette fonctionnalité nécessite la version du package de portail de démarrage 9.2.2103.x ou ultérieure. Si votre modèle de portail n’est pas mis à niveau pour ajouter la prise en charge du composant bot conversationnel, vous verrez le message suivant lorsque vous essayez d’ajouter le composant :
"Mise à niveau du portail Obligatoire : Une mise à niveau est obligatoire pour utiliser cette fonctionnalité sur votre portail. Si vous mettez à niveau le portail, assurez-vous de synchroniser la configuration pour actualiser votre session Studio du portail actuelle avec de nouveaux packages de portail."
Lorsque ce message s’affiche, mettez à niveau votre package de portail. Pour plus d’informations, voir Mise à jour de la solution de portails.
Notes
La mise à niveau du package de portail de démarrage activera tous les portails supplémentaires dans votre environnement avec la possibilité d’utiliser le composant de bot conversationnel. Plus d’information : Mises à jour du package du portail de démarrage
Suppression de la solution
Cette fonctionnalité est livrée avec un solution de portail appelée MicrosoftPortalBot avec le Nom d’affichage Portails Dynamics 365 – Bot. Votre portail cessera de fonctionner si vous supprimez cette solution et n’effectuez pas l’action suivante.
Si vous supprimez la solution MicrosoftPortalBot, vous devez redémarrer votre portail pour vous assurer qu’il fonctionne correctement.
Pour redémarrer votre portail :
Ouvrez le Centre d’administration de Power Platform du portail.
Dans le volet gauche, sélectionnez Actions du portail.
Sélectionner Redémarrer pour redémarrer le portail.
Important
Le redémarrage du portail le rendra indisponible pendant plusieurs minutes et les utilisateurs ne pourront pas accéder à l’URL du portail pendant ce temps.
Sélectionner Redémarrer pour confirmer le redémarrage du portail.
Voir aussi
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).