# Canaux

Cet onglet permet de paramétrer les canaux sur lesquels le chatbot est disponible: - vous pouvez modifier les canaux déjà présent, choisit lors de la création du nouveau chatbot - ajouter ultérieurement un nouveau canal de diffusion.

canaux

# Skype for Business

Ce paramétrage permet de faire passer le chatbot en mode hor ligne sur Skype (bouton Pause) ou de redémarrer le connecteur sur Skype for Business en cas de problème (bouton Redémarrer).

canaux

Les cadres suivant permettent d'indiquer les informations de connexion (E-mail, mot depasse, ID Azure) ainsi que l’activité et le rôle du chatbot, par exemple : assistante RH. Une fois modifié, le changement apparaîtra automatiquement sur Skype Entreprise en dessus du nom du chatbot.

canaux

# Microsoft Teams

Pour activer un bot sur teams, la démarche est expliquée ici.

Depuis la page d'edition du canal teams, vous pouvez publier ou retirer votre chatbot dans le catalogue teams de manière automatique ou manuel.

catalogue teams
Cliquez sur l'onglet Publication
catalogue teams

# Automatiquement


# Autorisation


Afin d'effectuer la publication de votre chatbot dans le catalogue teams, Witivio a besoin de l'autorisation d'un Administrateur du tenant. Cliquez sur le bouton "je t'autorise" afin de commencer le processus d'authenfication.

autorisation teams

Vous devriez voir apparaitre une fenêtre d'authentification microsoft. Identifiez-vous avec les informations d'un admnistrateur du tenant

autorisation teams

Une fois l'autorisation effectué avec succés. Vous devriez voir l'état au dessus du bouton "je t'autorise" passé à connecté comme sur l'image ci-dessous.

autorisation teams

# Publication


Une fois connecté vous pouvez publier l'application automatiquement depuis la plateforme en cliquant sur le bouton Publier

publication application teams

Une fois la publication effectué vous devriez voir un bouton Retirer apparaître afin de retirer l'application du catalogue Teams.

publication application teams

# Manuellement


Si vous ne possédez pas de compte administrateur du tenant vous pouvez publier votre bot manuellement dans le catalogue Teams.

# Télechargement

Depuis la page d'edition du canal teams, Téléchargez le package de l'application en cliquant sur le bouton télécharger comme l'image ci-dessous.

download application teams

# Publication

Rendez-vous sur Teams, puis cliquez sur Autres applications ajoutés comme encadré dans l'image ci-dessous.

dropdown teams
Une fenêtre s'affiche, cliquez alors sur Autres applications.
dropdown teams
Vous êtes maintenant dans le Catalogue Teams. Cliquez sur Envoyer au catalogue d'application comme l'écran ci-dessous. Puis cliquez sur soumettre une application
application personalisé teams
Une fenêtre s'affiche, sélectionnez le package téléchargé au préalable puis cliquez sur Ouvrir
application pop up personalisé teams
Vous devriez voir apparaître votre application avec un status en attente. Demandez à un administrateur :

  • D'accepter que votre chatbot soit publié dans le catalogue Teams.
  • De vous transmettre l'id de l'application dans le catalogue. Une fois que l'admnistrateur aura accepter votre application, le statut de votre chatbot devrait passer à Approuvé
    application approuvé
    Dès lors vous pourrez retrouver l'application dans votre catalogue Teams
    application approuvé
    Pour finaliser la publication retourner sur la page Catalogue de la plateforme et renseignez l'id de l'application fourni par l'administrateur lorsqu'il a approuvé votre chatbot. Puis cliquez sur Enregistrer l'id de l'application
application approuvé

🔴

Sans l'étape du dessus, l'application ne sera pas fonctionnel.

# Administration

En tant qu'administrateur rendez vous sur le centre d'administration Microsoft Teams depuis le portail office. Accéder à l'onglet Gérer les applications

application approuvé
Grâce à la barre de recherche, retourvez le nom du chatbot dans la liste et cliquez dessus. Vous accédez à une page d'information de votre chatbot. Dans un premier temps transmettez l'id de l'application à la personnes ayant publier l'app. Elle en aura besoin pour le renseigner dans la plateforme Witivio.
application approuvé
Ensuite changer l'état de publication de Envoyé à Publié
application approuvé
Puis cliquez sur publier
application approuvé

Vous pouvez aussi choisir d'afficher ou non votre chatbot dans l'application Chatbots

publication application teams

Pour publier l'application Chatbots sur teams, la démarche est expliquée ici.

# Webchat

Le canal Webchat est activé par défaut.

canaux

🔴

La fenêtre Webchat est votre chatbot en intégration et vous permet de le tester et voir ses comportements, avant la publication de ses connaissances. Lorsque vous modifiez le profil dans la base de connaissances, le chatbot prend en compte le choix du nouveau profil dans le test.

# Configuration du composant webchat V2

<script>
        window.webChatSettings = {
            botId: '[BOTID]',
            color: '[COLOR]',
            background: 'square3d',
            avatar: '[URL]',
            title: '[TITLE]',
            description:"[DESCRIPTION]",
            height: '650px',
            callout: true,
            welcome: true,
            width:'400px',
            apiKey: '[API KEY]',
            displayMode:'close',
            branding: false,
            autoscroll: false,
            autocomplete:false,
            hideSendBox:false,
            refresh: false,
        };
        !function () { function t() { var t = e.createElement("script"); t.type = "text/javascript", t.async = !0, t.src = "https://webchat.witivio.com/v2/init.js", t.onload = function () { witivioWebChat.load(window.webChatSettings) }; var n = e.getElementsByTagName("script")[0]; n.parentNode.insertBefore(t, n) } var e = document, n = window; n.attachEvent ? n.attachEvent("onload", t) : n.addEventListener("load", t, !1) }();
</script>
botId L'identifiant unique de votre chatbot. L'identifiant est disponible dans le menu paramètres .
color Couleur primaire en hexa. Il s'agit de le couleur du bandeau et de la bulle de la webchat.
avatar URL de l'image de votre chatbot.
title Le titre de la fenêtre de discussion. Généralement le nom du chatbot.
description Description de la fenêtre de discussion. Généralement le role du chatbot.
callout Activer le message de bienvenue (par défaut: true). Il s'agit du message de base d'invitation à la conversation (dernier message de base) à personnaliser depuis l'onglet Connaissances > Messages.
welcome Activer l'affichage du message de bienvenue dans la fenêtre de discussion. (par défaut : true). Il s'agit du message de "Bonjour" à personnaliser depuis l'onglet Connaissances > Messages.
user Non obligatoire. Si vous êtes dans SharePoint Online, vous pouvez utiliser :

{
    'id': _spPageContextInfo.aadUserId,
    'name': _spPageContextInfo.userDisplayName
}
            
            
or
            
{
    'id': _spPageContextInfo.userPrincipalName,
    'name': _spPageContextInfo.userDisplayName
}
            
            
Si auncune configuration n'est spécifiée, le composant génère un identifiant unique qui est enregistré dans le navigateur.
refresh Affiche un bouton qui réactualise le composant (par défaut : false)
hideSendBox Permet de masquer le champ de saisie du message et le bouton envoyer (par défaut : false)
apiKey L'api key qui se trouve dans les paramètres du chatbot
displayMode Détermine si la webchat doit s'afficher ouverte 'open' ou fermée 'close' lors du chargement de celle-ci (par défaut 'close')
environnement Environnement de la base de connaissance ('production', ou 'intégration') (par défaut : 'production')
triggerableDialogId Identifiant du Triggerable ID à démarrer (facultatif)
triggerableDialogItemId Identifiant du Triggerable Item ID à démarrer (facultatif)
background Image de fond. Par défaut: square3d (= losanges en guise d'image de fond de la webchat). Valeurs possibles: (square3d, communication, square, travel). Ajouter la valeur 'none' si vous ne souhaitez pas personnaliser l'image de fond de votre webchat.
autocomplete Permet d'afficher la liste des questions en mode autocompletion (par défaut: false)
autoscroll Permet de forcer l'autoscroll lorsqu'un utilisateur remonte dans la conversation et décide de renvoyer un message dans le chat.
buttonDesign.shape Permet de choisir la forme du bouton, valeurs possibles: square, circle, chat (par défaut: circle)
buttonDesign.icon Permet de choisir l'icône du bouton, valeurs possibles: 'bot' prendra l'avatar de votre chatbot, peut également prendre la classe d'une Font Awesome (par exemple 'fa fa-quote-right' ou 'fas fa-comment') ou mettre une URL vers une image (par défaut: fa-comment-dots)
buttonDesign.height Longueur du bouton, unité conseillée: 'px' (par défaut: '80px')
buttonDesign.width Largeur du bouton, unité conseillée: 'px' (par défaut: '80px')
buttonDesign.border 6 caractères hexadécimaux pour la bordure ou 'none' pour aucune bordure (attention la forme 'chat' du bouton est considéré comme une bordure) (par défaut: 'ffffff')
buttonDesign.text Le texte à afficher à coté de l'icone choisi. Au dela de 25 caractère, le texte sera coupé.
headerHeight permet de régler la taille du header. valeurs possible : small, normal (par défaut: 'normal' si non spécifié)
position position de la webchat sur la page,'top', 'middle' ou 'bottom' puis 'left' ou 'right' suivie optionnellement d'une marge de maximum 150px (par défaut: 'bottom right 10px 10px')

# Configuration du composant Webchat V1 compatible avec IE11 (obsolete)

# Sécurité du chatbot

La webchat géré également la sécurité du chatbot d'une meilleure façon. Elle permet de savoir où est déployée la webchat. A des fins de gouvernance, il est obligatoire d'indiquer explicitement où se trouve la webchat, et donc de déclarer les différents sites sur lesquels elle sera disponible.

⚠️

Sans cette définition explicite, la webchat ne chargera pas sur votre site. Cela permet d'éviter qu'un individu ajoute la webchat sans que cela soit autorisé.

canaux

💡

La fenêtre Webchat s'affiche également dans le canal de diffusion Webchat (onglet "Paramètres"), afin de vous permettre de tester et parler directement au chatbot en production.

# Personnalisation de la webchat

Accédez à l'onglet Personnalisation si vous souhaitez personnaliser la webchat depuis la plateforme Witivio.

webchat

Cliquez sur le bouton PRE-VISUALISER pour avoir une preview de votre webchat personnalisée.

🔴

Lorsque vous souhaitez afficher cette configuration personnalissée, il suffit de supprimer la personnalisation déjà existante dans le script JS et ne laisser que ces informations : 	
  • Bot Id (Paramètres > Paramètres > Bot)
  • Api KEY (Paramètres > Paramètres > Clef)

Lorsqu'il s'agit de votre première configuration, une fois la personnalisation terminée, cliquer sur SAUVEGARDER en haut à droite. Accédez au code JS de votre page et ajoutez les deux valeurs Bot Id et Api key.

Si vous souhaitez obtenir le code JS de votre configuration, cliquer sur COPIER LA CONFIGURATION en haut à droite. Celle-ci sera copiée dans votre presse-papier.

# Webpart SharePoint Modern

Vous pouvez télécharger la webpart ici

Pour ajouter le composant WebPart dans votre SharePoint Modern, vous devez ajouter le package sppkg au catalogue des applications.

Si vous ne disposez pas d'un catalogue d'applications, un administrateur en ligne SharePoint peut en créer un en suivant les instructions de ce guide: Utilisez le catalogue des applications pour rendre les applications professionnelles personnalisées disponibles pour votre environnement SharePoint Online..

# Déployer le package dans le catalogue d'applications

  1. Accédez au catalogue d'applications de votre site.

  2. Téléchargez ou faites glisser witivio-webchat.sppkg dans le catalogue des applications. canaux

Cela déploie le package de solution côté client. S'agissant d'une solution côté client totalement fiable, SharePoint affiche une boîte de dialogue et vous invite à faire confiance au déploiement de la solution côté client.

low score
  1. Sélectionner Deployer.

# Configurer la webchat

La webchat est maintenant disponible à partir de vos pages sur votre site SharePoint.

  1. Modifier une page sur votre site SharePoint
  2. Cliquez sur Ajouter un nouveau composant WebPart
  3. Si vous faites défiler l'écran vers le bas, vous trouverez la Webpart "Witivio-webchat"
canaux
  1. Sélectionnez la. Le composant apparaît, mais la discussion en ligne n'est pas encore configurée.
canaux

⚠️

Il n'apparaîtra pas tant que vous ne l'avez pas configuré.

  1. Sélectionnez le crayon pour éditer les paramètres. Veuillez vous référer à l'article ci-dessus pour comprendre la configuration.

💡

Lors de l'ajout de la Webpart à SharePoint, le contexte utilisateur est envoyé via la webchat. Cela signifie que l'utilisateur et le nom de l'utilisateur sont envoyés au bot. N'oubliez pas de consulter vos politiques de confidentialité si vous souhaitez que vos utilisateurs soient anonymes.

⚠️

La Webpart SharePoint de la webchat doit être ajoutée en haut de la page. Sinon, elle ne sera affichée que lors du scroll.

# Outlook

La plateforme Witivio permet d'ajouter un chatbot sur Outlook sous forme de webchat.

Voici les étapes à suivre pour intégrer votre assistant virtuel à votre Outlook :

  • Dans un premier accédez à la plateforme Witiovio puis à l'onglet Paramètres > Canaux
  • Cliquez sur le bouton + AJOUTER UN CANAL et choisissez Outlook

  • Une URL est generée. Cliquez sur le bouton COPIER L'URL.

canaloutlook
  • Cliquez sur le bouton SUIVANT. Le canal Outlook est prêt à être ajouté!
  • Connectez-vous à Outlook. Accédez à l'onglet Accueil au niveau de la barre de navigation supérieure, puis sélectionnez la commande Téléchargez des compléments
canaloutlook
  • Une nouvelle fenetre s'affiche. Dans le menu de gauche, cliquez sur Mes compléments
canaloutlook
  • En bas de la page, cliquez sur la commande + Ajouter un complément personnalisé et choisir à partir d'une URL.
canaloutlook
  • Collez ici l'URL generée depuis la plateforme Witivio.

  • Cliquez ensuite sur Ok > Installer

canaloutlook

Une fois ajouté, retrouvez votre complément personnalisé au niveau de la barre de navigation supérieure. Sélectionnez-le, une fenêtre s'ouvre à droite de la page. Échangez ainsi avec votre chatbot depuis Outlook.

# Lumapps

# Beezy

# Powell 365

# SMS

Conversez avec votre chatbot par sms depuis votre téléphone portable.

Cliquez ici pour en savoir plus sur la configuration Twiliio.

# Commentaires