Aller au contenu principal

PERSONNALISATION DE TEAMS

Introduction

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

Portail Azure

Créer un groupe de ressources

  1. Identifiez-vous sur le Portail Azure. (https://portal.azure.com/)

  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

  1. Recherchez Azure Bot dans la liste des Bot Services.
    • Cliquez sur Charger plus en bas de la page si Azure Bot ne s'affiche pas sur la première page.
    • Cliquez sur Azure Bot.

  1. Cliquez sur Create.

  1. Remplissez les informations requises :
    • Descripteur du bot : choisissez un nom (vous pourrez le changer par la suite)
    • 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.

Patientez quelques secondes. Vous verrez ensuite cette page :

  1. Cliquez sur Create.

  1. 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 Microsoft App ID

  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 : sélectionnez “24 mois”

  2. Cliquez sur le bouton Ajouter

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

  1. Cliquez sur l'icône Microsoft Teams.

  1. Cliquez sur Enregistrer

  1. Acceptez les Conditions d’utilisations

  1. Vous pouvez fermer la fenêtre après avoir accepté les conditions d'utilisation.

  1. Cliquez sur Configuration dans le menu de gauche et renseignez le endpoint du connecteur. Le endpoint à renseigner et le suivant : https://cloud.dydu-priv.com/gateway/api/dydubox_connector/messages

  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. Donnez-lui un nom, cliquez sur l'icône Équipes pour le sélectionner, puis cliquez sur "Démarrer l'intégration".


  1. Choisissez l'espace de consultation et la langue que votre chatbot Teams utilisera. Si votre chatbot n'a qu'une seule langue et qu'un seul espace, vous n'avez pas besoin de faire de choix.

  2. Cliquez sur "Suivant" pour vous rendre à l'étape "Configuration"

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

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.

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

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

  1. 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 de la réponse

FonctionnalitéSupportCommentaire
"Heading" tagSupporté
GrasSupporté
ItaliqueSupporté
SoulignéSupporté
Couleur de texteSupporté
Couleur d'arrière-plan du texteSupporté
Alignement du texteSupporté
IndentationSupporté
Liste ordonnéeSupportéLes puces ne sont pas affichées mais la hiérarchie de la liste est respectée et affichée
Liste non ordonnéeSupporté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 externeSupporté
Mettre un lien vers une connaissance (reword)Supporté
Afficher un tableauSupporté
Split bubbleSupporté
Images / Fichier depuis la galerieSupporté
SmileySupporté
Utiliser des expressions mathématiquesNon supporté
Afficher un panneau latéralSupporté

Fonctionnalités disponible pour une réponse

FonctionnalitéSupportCommentaire
Etapes d'actions (step actions)Supporté
Réponses alternativesSupporté
Utiliser une variable dans une réponseSupporté
Redirigé automatiquement vers une URL externeNon supporté
Redirigé automatiquement vers une connaissanceSupporté
Afficher un templateNon supporté
Utiliser une GUI actionNon supporté
Faire un switch automatique d'espace de consultationNon supporté1 bot Teams = 1 langue, 1 espace de consultation
Modifier la valeur d'une variable avant actionSupporté
Modifier la valeur d'une variable après actionSupporté
Demander la satisfaction utilisateurNon supporté

Phrases générales

FonctionnalitéSupportCommentaire
Réponses aux phrases incomprisesSupporté
Trop de phrases incomprisesSupporté
Réponse aux phrases trop longuesNon supporté
Réponse aux phrases videsSupporté
Click sur les liensNon supporté
Les liens s'ouvrent dans de nouvelles fenêtresNon supporté
Réponse aux connaissances non publiéesSupporté
Réponse par défaut quand l'action est videSupporté
La réponse est disponible dans la langue par défautNon supporté
La réponse n'est pas définie pour cet espace de consultationSupporté
La réponse est disponible depuis un autre espace de consultationNon supporté
Phrase de recentrageSupporté
Réponse en cas d'erreur interneSupporté
Introduction des reformulationsSupporté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 reformulationsSupporté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 simpleSupporté
Arbre de décisionSupporté
Réponse complémentaireSupporté
Ciblage comportementalNon supporté
Slot fillingSupporté

Autre

FonctionnalitéSupport
Capturer l'intention utilisateurSupporté
Utiliser une conditions de contexteSupporté
MetabotSupporté
Faire appel à un WSSupporté
SAMLSupported

Fonctionnalités propres à la chatbox dydu

FonctionnalitéSupportCommentaire
Welcome sentenceNon supporté
Bandeau d'informationNon supporté
Top ConnaissancesNon supporté
AutosuggestionNon supporté
Disclaimer RGPDNon 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.
OnboardingNon supporté
Demande de récupération RGPDNon supporté
Demande de suppression RGPDNon supporté
Permettre à l'utilisateur final de changer de langueNon supporté1 bot Teams = 1 langue, 1 espace de consultation
Permettre à l'utilisateur final de changer d'espace de consultationNon supporté1 bot Teams = 1 langue, 1 espace de consultation

GDPR Teams

here is the explanation