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

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éSupportCommentaires

"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éSupportCommentaire

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éSupportCommentaire

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éSupportCommentaire

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

Tous droits réservés @ 2023 dydu.