Links

Teams

Afin de créer un bot sur Teams qui sera connecté à votre bot dydu, nous allons suivre ces étapes :
  1. 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. 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. 3.
    Teams: publiez votre configuration
    • Publiez le bot dans Teams

1 - Portail Azure

Créer un groupe de ressources

  1. 1.
    Identifiez-vous sur le Portail Azure.
  2. 2.
    Sélectionnez Groupes de ressources.
  1. 3.
    Depuis la page Groupes de ressources cliquez sur le bouton Créer
  1. 4.
    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. 5.
    Cliquez sur Vérifier + créer
  1. 6.
    Cliquez sur Créer. La création d'un groupe de ressources prend quelques secondes.
  1. 7.
    La liste des groupes de ressources est actualisée.
  1. 8.
    Ensuite, retournez à la page d'accueil.

Créer un bot Azure

  1. 1.
    Sélectionnez Bot services
  1. 2.
    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. 3.
    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. 4.
    Cliquez sur Vérifier + créer.
  2. 5.
    Patientez quelques secondes. Vous verrez ensuite cette page :
  1. 6.
    Cliquez sur Create.
  2. 7.
    Cliquez sur le bouton Accéder à la ressource
  1. 6.
    Cliquez sur Configuration situé dans le menu de gauche

Les informations d’identification Azure

Vous y trouverez votre Microsoft App ID :
  1. 1.
    Cliquez sur Gérer pour créer votre Id de secret.
  1. 2.
    Cliquez sur Nouveau secret client
  1. 3.
    Remplissez les informations requises :
  • Description : il s’agit de la description pour le secret client qui va être créé
  • Date d’expiration :
  1. 4.
    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. 1.
    Revenez à la page d'accueil et ouvrez le bot précédemment créé.
  1. 2.
    Cliquez sur Canaux dans le menu de gauche et Cliquez sur l'icône Microsoft Teams.
  1. 3.
    Acceptez les Conditions d’utilisations et Cliquez sur Enregistrer
  1. 6.
    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:
Exemple pour un serveur saas - app1 :
  1. 8.
    Cliquez sur Appliquer

Créer une configuration Teams

  1. 1.
    Connectez vous au BMS.
  2. 2.
    Cliquez sur Intégration > Canaux.
  3. 3.
    Cliquez sur "Créer".
  4. 4.
    Sélectionnez "Microsoft teams"
  1. 5.
    Donnez-lui un nom, cliquez sur l'icône Équipes pour le sélectionner, puis cliquez sur "Créer".
  1. 5.
    Choisissez l'espace de consultation et la langue que votre chatbot Teams utilisera.
  1. 5.
    Cliquez sur "Suivant".
  2. 6.
    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" :
  1. 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. 2.
    cliquez sur "Terminé"

Teams

Publier votre bot sur Teams

  1. 1.
    Ouvrez votre Teams.
  2. 2.
    Cliquez sur Applications dans le coin inférieur gauche de votre écran.
  1. 3.
    Cliquez sur Gérer vos applications en bas à gauche de votre écran.
  1. 4.
    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. 5.
    Sélectionnez la configuration ZIP que vous avez enregistrée auparavant.
  2. 6.
    Votre application est maintenant présente dans la liste des demandes en attentes.
  3. 7.
    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. 8.
    Cliquez sur l'application que vous avez créée.
  5. 9.
    Cliquez ensuite sur le bouton "Ajouter".
  1. 5.
    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 2mo ago
Tous droits réservés @ 2023 dydu.