Teams

Afin de créer un bot sur Teams qui sera connecté à votre bot dydu, nous allons suivre ces étapes :

1. 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

2. 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

3. Teams: publiez votre configuration

   • Publiez le bot dans Teams

1 - Portail Azure

Créer un groupe de ressources

1. Identifiez-vous sur le Portail Azure.

2. Sélectionnez Groupes de ressources.

1. Depuis la page Groupes de ressources cliquez sur le bouton Créer

1. 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

1. Cliquez sur Vérifier + créer

1. Cliquez sur Créer. La création d'un groupe de ressources prend quelques secondes.

1. La liste des groupes de ressources est actualisée.

1. Ensuite, retournez à la page d'accueil.

Créer un bot Azure​

1. Sélectionnez Bot services

1. 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.

1. 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"

1. Cliquez sur Vérifier + créer.

2. Patientez quelques secondes. Vous verrez ensuite cette page :

1. Cliquez sur Create.

2. Cliquez sur le bouton Accéder à la ressource

1. Cliquez sur Configuration situé dans le menu de gauche

Les informations d’identification Azure​

Vous y trouverez votre Microsoft App ID :

1. Cliquez sur Gérer pour créer votre clientSecret (Valeur du client secret).

1. Cliquez sur Nouveau secret client

1. Remplissez les informations requises :

• Description : il s’agit de la description pour le secret client qui va être créé

• Date d’expiration :

1. 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​

1. Revenez à la page d'accueil et ouvrez le bot précédemment créé.

1. Cliquez sur Canaux dans le menu de gauche et Cliquez sur l'icône Microsoft Teams.

1. Acceptez les Conditions d’utilisations et Cliquez sur Enregistrer

1. 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. Vous pouvez trouver le point de terminaison dans la première page de configuration de Teams sur Canaux.

Exemple pour un serveur saas - app1 :

1. Cliquez sur Appliquer

Menu Canaux du BMS dydu

Créer une configuration Teams​

1. Connectez vous au BMS.

2. Cliquez sur Intégration > Canaux.

3. Cliquez sur "Créer".

4. Sélectionnez "Microsoft teams"

1. Donnez-lui un nom, cliquez sur l'icône Équipes pour le sélectionner, puis cliquez sur "Créer".

1. Choisissez l'espace de consultation et la langue que votre chatbot Teams utilisera.

1. Cliquez sur "Suivant".

2. Renseignez le Microsoft App ID ainsi que le clientSecret (Valeur du client 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.

Options

• Activer le déclenchement de connaissance sur avis négatifs

Déclenchement d'une connaissance en cas d'une ou plusieurs incompréhensions

• Afficher la welcome technique dans la conversation

Permet d'afficher la #teamswelcome# qui doit être configurée dans le BMS et qui va se déclencher en début de conversation

Téléchargez l'application du bot​

Lors de la troisième et dernière étape "Téléchargement" :

1. 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.

1. cliquez sur "Terminé"

Teams

Publier votre bot sur Teams​

1. Ouvrez votre Teams.

2. Cliquez sur Applications dans le coin inférieur gauche de votre écran.

1. Cliquez sur Gérer vos applications en bas à gauche de votre écran.

1. 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..

1. Sélectionnez la configuration ZIP que vous avez enregistrée auparavant.

2. Votre application est maintenant présente dans la liste des demandes en attentes.

3. 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.

4. Cliquez sur l'application que vous avez créée.

5. Cliquez ensuite sur le bouton "Ajouter".

1. 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