Teams
Afin de créer un bot sur Teams qui sera connecté à votre bot dydu, nous allons suivre ces étapes :
Portail Azure : créer une configuration et mettre en place la connexion entre cette configuration et dydu. Les opérations à faire sur cette partie sont les suivantes :
Créer un groupe de ressources
Créer un bot Azure
Configurer les informations d'identification Microsoft
Connecter le groupe de ressources au bot Azure
Menu Canaux du BMS dydu : configurez votre bot dydu, choisissez l'espace de consultation et la langue
Créer une configuration Teams
Téléchargez l'application du bot
Teams: publiez votre configuration
Publiez le bot dans Teams
1 - Portail Azure
Créer un groupe de ressources
Identifiez-vous sur le Portail Azure.
Sélectionnez Groupes de ressources.
Depuis la page Groupes de ressources cliquez sur le bouton Créer
Remplissez les valeurs suivantes :
Abonnement : sélectionnez votre abonnement Azure
Groupe de ressources : saisissez un nouveau nom de groupe de ressources.
Région : choisissez une région Azure
Cliquez sur Vérifier + créer
Cliquez sur Créer. La création d'un groupe de ressources prend quelques secondes.
La liste des groupes de ressources est actualisée.
Ensuite, retournez à la page d'accueil.
Créer un bot Azure
Sélectionnez Bot services
Cliquez sur le bouton Créer
a. Recherchez Azure Bot dans la liste des Bot Services.
b. Cliquez sur Charger plus en bas de la page si Azure Bot ne s'affiche pas sur la première page.
c. Cliquez sur Azure Bot.
d. Cliquez sur Create.
Remplissez les informations requises :
Descripteur du bot : nom de votre bot Teams. Modification possible plus tard via Azure. Le descripteur de bot peut contenir seulement les caractères suivants : a-z, A-Z, 0-9, - et _ , doit commencer par une lettre ou un chiffre, et doit avoir entre 4 et 42 caractères.
Abonnement : choisir Azure CSP
Groupes de ressources : sélectionnez le groupe de ressource que vous avez créé précédemment
Type d'application : sélectionnez "Plusieurs locataires"
Cliquez sur Vérifier + créer.
Patientez quelques secondes. Vous verrez ensuite cette page :
Cliquez sur Create.
Cliquez sur le bouton Accéder à la ressource
Cliquez sur Configuration situé dans le menu de gauche
Les informations d’identification Azure
Vous y trouverez votre Microsoft App ID :
Cliquez sur Gérer pour créer votre Id de secret.
Cliquez sur Nouveau secret client
Remplissez les informations requises :
Description : il s’agit de la description pour le secret client qui va être créé
Date d’expiration :
Cliquez sur le bouton Ajouter
Important : Copiez la valeur du secret client et enregistrez cette valeur car vous ne pourrez plus la revoir par la suite.
Créer un connecteur entre le service Azure et Microsoft Teams
Revenez à la page d'accueil et ouvrez le bot précédemment créé.
Cliquez sur Canaux dans le menu de gauche et Cliquez sur l'icône Microsoft Teams.
Acceptez les Conditions d’utilisations et Cliquez sur Enregistrer
Cliquez sur Configuration dans le menu de gauche pour configurer l'endpoint du connecteur et remplir le champ Point de terminaison de la messagerie et cocher la case Activer le point de terminaison de streaming.
Selon votre type de serveur, le point de terminaison est différent. Si celui-ci est incorrect, votre bot TEAMS sera indisponible.
Si vous êtes sur un serveur:
app1, le point de terminaison à utiliser est : https://sso.cloud.dydu-priv.com/gateway/api/dydubox_connector/teams/messagessandbox, le point de terminaison est : https://experimental.cloud.dydu-priv.com/gateway/api/dydubox_connector/teams/messagesuat, le point de terminaison est : https://staging-sso.dydu-priv.com/gateway/api/dydubox_connector/teams/messages
Exemple pour un serveur saas - app1 :
Cliquez sur Appliquer
Menu Canaux du BMS dydu
Créer une configuration Teams
Connectez vous au BMS.
Cliquez sur Intégration > Canaux.
Cliquez sur "Créer".
Sélectionnez "Microsoft teams"
Donnez-lui un nom, cliquez sur l'icône Équipes pour le sélectionner, puis cliquez sur "Créer".
Choisissez l'espace de consultation et la langue que votre chatbot Teams utilisera.
Cliquez sur "Suivant".
Renseignez le Microsoft App ID ainsi que l'ID de secret que vous avez copiés auparavant depuis MS Azure et remplissez les différents éléments de la présentation de votre bot dans Teams :
Informations du bot
Il s'agit des informations affichées pour votre application bot dans Teams.
Ces champs sont obligatoires.
La description courte ne doit pas dépasser 80 caractères et ne doit pas être répétée dans la description complète.
La description complète ne doit pas dépasser 4000 caractères.
Noms du bot
Il s'agit du nom affiché pour votre application bot au sein de Teams.
Le champ "nom court" est obligatoire et ne doit pas dépasser 30 caractères.
Le champ "nom long" n'est pas obligatoire, vous pouvez l'utiliser si le nom choisi dépasse 30 caractères. Il ne doit pas dépasser 100 caractères.
Avatar du bot
Votre bot dans Teams doit avoir deux icônes :
l'avatar principal du bot et
il doit respecter une dimension de 32*32 pixels et peut-être en couleur
l'icône de l'application (qui apparait dans la barre latéral de Teams)
il doit respecter une dimension de 192 x 192 pixels et doit être transparent
Le format accepté pour ces icônes est PNG.
Nom de l'auteur du bot
C'est le nom du créateur de l'application bot Teams. Il s'agit d'un champ obligatoire qui ne doit pas dépasser 30 caractères.
Liens utiles
Ces urls correspondent :
à vos conditions générales d'utilisation
à votre site web
à votre politique de confidentialité
Ces urls sont obligatoires.
Elles sont affichées dans l'onglet "À propos" au sein de votre application bot :
Téléchargez l'application du bot
Lors de la troisième et dernière étape "Téléchargement" :
cliquez sur le bouton «Télécharger». Enregistrez le ZIP et cliquez sur « Terminer ».
NB : si les champs obligatoires ne sont pas renseignés, vous ne pourrez pas télécharger le ZIP de configuration de votre application bot.
cliquez sur "Terminé"
Teams
Publier votre bot sur Teams
Ouvrez votre Teams.
Cliquez sur Applications dans le coin inférieur gauche de votre écran.
Cliquez sur Gérer vos applications en bas à gauche de votre écran.
Cliquez sur Charger une application en haut de votre écran.
Une modale s'ouvre et vous invite à charger une application. Cliquez sur soumettre une application à votre organisation..
Sélectionnez la configuration ZIP que vous avez enregistrée auparavant.
Votre application est maintenant présente dans la liste des demandes en attentes.
Une fois approuvée par votre administrateur, vous pouvez retrouver votre application dans le catalogue d'applications conçu pour votre organisation. Vous devrez peut-être redémarrer votre Teams pour voir l'application apparaître dans le catalogue. Pour ouvrir le catalogue d'applications de votre organisation, cliquez sur "Conçue pour votre organisation" en haut de la liste dans le menu de gauche.
Cliquez sur l'application que vous avez créée.
Cliquez ensuite sur le bouton "Ajouter".
Vous pouvez démarrer le dialogue avec votre bot.
Fonctionnalités disponibles pour un bot dydu sous Teams
Les tableaux suivants montrent les fonctionnalités prises en charge et non prises en charge pour un bot dydu sous MS Teams.
Supporté = La fonctionnalité est disponible et fonctionne dans le cadre d'un bot dydu sous MS Teams
Non supporté = La fonctionnalité ne peut pas être mise en place pour un bot dydu sous MS Teams
Mise en forme d'une réponse de bot
| Fonctionnalité | Support | Commentaires |
|---|---|---|
"Heading" tag | Supporté | |
Gras | Supporté | |
Italique | Supporté | |
Souligné | Supporté | |
Couleur de texte | Supporté | |
Couleur d'arrière-plan du texte | Supporté | |
Alignement du texte | Supporté | |
Indentation | Supporté | |
Liste ordonnée | Supporté | Les puces ne sont pas affichées mais la hiérarchie de la liste est respectée et affichée |
Liste non ordonnée | Supporté | Les numéros / lettres d'ordonnancement ne sont pas affichés mais la hiérarchie de la liste est respectée et affichée |
Mettre un lien vers une URL externe | Supporté | |
Mettre un lien vers une connaissance (reword) | Supporté | |
Afficher un tableau | Supporté | |
Séparation de bulle de réponse | Supporté | |
Images / Fichier depuis la galerie | Supporté | |
Smiley | Supporté | |
Utiliser des expressions mathématiques | Non supporté | |
Afficher un panneau latéral | Supporté |
Fonctionnalités disponible pour une réponse
| Fonctionnalité | Support | Commentaire |
|---|---|---|
Etapes d'actions (step actions) | Supporté | |
Réponses alternatives | Supporté | |
Utiliser une variable dans une réponse | Supporté | |
Redirection automatique vers une URL externe | Non supporté | |
Redirection automatique vers une connaissance | Supporté | |
Afficher un template | Non supporté | |
Utiliser une GUI action | Non supporté | |
Faire un switch automatique d'espace de consultation | Non supporté | 1 bot Teams = 1 langue, 1 espace de consultation |
Modifier la valeur d'une variable avant action | Supporté | |
Modifier la valeur d'une variable après action | Supporté | |
Demander la satisfaction utilisateur | Non supporté |
Phrases générales
| Fonctionnalité | Support | Commentaire |
|---|---|---|
Réponses aux phrases incomprises | Supporté | |
Trop de phrases incomprises | Supporté | |
Réponse aux phrases trop longues | Non supporté | |
Réponse aux phrases vides | Supporté | |
Cliquer sur les liens | Non supporté | |
Les liens s'ouvrent dans de nouvelles fenêtres | Non supporté | |
Réponse aux connaissances non publiées | Supporté | |
Réponse par défaut quand l'action est vide | Supporté | |
La réponse est disponible dans la langue par défaut | Non supporté | |
La réponse n'est pas définie pour cet espace de consultation | Supporté | |
La réponse est disponible depuis un autre espace de consultation | Non supporté | |
Phrase de recentrage | Supporté | |
Réponse en cas d'erreur interne | Supporté | |
Introduction des reformulations | Supporté | Les rewords s'affichent listés ET dans des boutons. Seuls les boutons sont cliquables. Les boutons contiennent le titre de la connaissance. |
Suggestion générale pour les reformulations | Supporté | Le texte défini dans la suggestion générale doit être le même que le titre de la connaissance vers laquelle cette suggestion générale redirige. |
Types de connaissances
| Fonctionnalité | Support |
|---|---|
Connaissance simple | Supporté |
Arbre de décision | Supporté |
Réponse complémentaire | Supporté |
Ciblage comportemental | Non supporté |
Slot filling | Supporté |
Autre
| Fonctionnalité | Support |
|---|---|
Capturer l'intention utilisateur | Supporté |
Utiliser une conditions de contexte | Supporté |
Metabot | Supporté |
Faire appel à un web service | Supporté |
SAML | Supporté |
Fonctionnalités propres à la chatbox dydu
| Fonctionnalité | Support | Commentaire |
|---|---|---|
Phrase de bienvenue | Supporté | |
Bandeau d'information | Non supporté | |
Top connaissances | Non supporté | |
Autosuggestion | Non supporté | |
Disclaimer RGPD | Non supporté | Géré dans la politique de confidentialité et les CGU de l'application Teams. A définir par le client lors de la configuration de son application bot Teams. |
Onboarding | Non supporté | |
Demande de récupération RGPD | Non supporté | |
Demande de suppression RGPD | Non supporté | |
Permettre à l'utilisateur final de changer de langue | Non supporté | 1 bot Teams = 1 langue, 1 espace de consultation |
Permettre à l'utilisateur final de changer d'espace de consultation | Non supporté | 1 bot Teams = 1 langue, 1 espace de consultation |
Dernière mise à jour
