# Channels

low score

This tab allows you to configure the channels on which the chatbot is available:

  • you can modify the channels already available or add a new channel later.
low score

# Skype for Business

Click on “edit” to access the setting of the channel Skype for Business.
Here you can click on pause ⏸️ if you want that the chatbot appear “offline” on skype; or click on 🔄 restart to start the connector in case of issue.

low score

The following boxes contain the connection information: E-mail, password, Azure ID.

low score

You can also indicate the description of the chatbot which will appear on Skype. For example: HR assistant. In case you decide to modify it, the change will automatically appear on Skype above the chatbot name.

low score

It also possible to consult the event logs of the connector.

low score

# Microsoft Teams

Click here to know how to activate a chatbot on Microsoft Teams.

# Automatic installation


# Authorization


WARNING

It is required to be authorized by an administrator of the chatbot to automatically publish the application 'Chatbots' and the Teams applications of each chatbot. Without this explicit authorization, the installation of the Teams application cannot be automated.

Here are the rights to authorize the installation of the Teams application:

Name Witivio - BotCatalog
ID b4633c92-1b8e-4dbf-86cb-51ec202317c9
Permissions Delegated permissions
Scopes AppCatalog.Read.All, AppCatalog.Submit, TeamsAppInstallation.ReadWriteForUser, offline_access, openid,

In order to publish the application 'Chatbots' in the Teams catalog, Witivio needs the authorization of a Tenant Administrator. Click on the "I authorize you " button to start the authentication process.

autorisation teams

A Microsoft authentication pop-up is displayed. Login with the credentials of a tenant administrator.

autorisation teams

Once the authorization is successfully completed, the status above the "I authorize you " button should change to connected as shown in the following image.

autorisation teams

# Publication


Once connected, you can publish the application automatically from the platform by clicking on the Publish button.

publication application teams

Once published, the Remove button that appears allows you to remove the application from the Teams catalog.

publication application teams

# Manual installation


If you do not have a Tenant administrator account, you can publish the 'Chatbots' application manually in Teams.

# Download

From the 'Catalog Teams' page, download the application package by clicking on the download button as shown in the image below.

download application teams

# Publication

Go to Teams, then click on °°° in the left navigation bar, as shown in the image below.

dropdown teams

A pop-up box appears, then click on More Apps.

dropdown teams

You are now in Teams Catalog. Click on Submit to app catalog as shown in the screen below. Then click on Submit an app.

application personalisé teams

A pop-up opens, select the package you downloaded previously and click on Open.

application pop up personalisé teams

The application will appear with a pending status. Ask an administrator procedure:

  • To accept that the application Chatbots can be published in the Teams catalog.
  • To give you the id of the application in the catalog.

Once the administrator has accepted your application, the status of the application 'Chatbots' will change to Approved.

application approuvé

Then you will find the application in your Teams Catalog.

application approuvé

To complete the publication go back to the Platform Catalog page. Enter the application id provided by the administrator when approving the application 'Chatbots'. Then click on Save app id.

application approuvé

🔴

Without the previous step, the application will not work.

# Administration

As an admin go to the Microsoft Teams admin center from Office 365 portal. Access the Manage apps tab.

catalog

Using the search bar, look for the application 'Chatbots' in the list and click it. You access an information page of the application 'Chatbots'. First, send the App ID to the person who published the app. This user will need it to add it to the Witivio platform.

catalog

Then change the publication status from Submitted to Published.

application approuvé

Then click on publish.

application approuvé

You can also choose whether or not to display your chatbot in the 'Chatbots' application.

publication application teams

Here are the steps to follow to publish the Chatbots application on Teams.

# Webchat

The webchat channel is automatically activated.

low score

🔴

The Webchat window is your chatbot in integration and allows you to test the chatbot before publishing it.

If you modify the profile in the knowledge base, the chatbot takes into account the choice of the new profile in the test.

# Configuration of the Webchat V2 component

<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 The unique ID of your chatbot. The ID is available in the settings menu.
color Primary color in hexa.
avatar URL of your chatbot's image.
title The title of the chat window. Usually the name of the chatbot.
description Description of the chat window. Usually the role of the chatbot.
callout Activate the welcome message. (by default: true)
welcome Enable the display of the welcome message in the chat window. (by default: true)
user Not mandatory. If you are on SharePoint Online, you can use :

{
    'id': _spPageContextInfo.aadUserId,
    'name': _spPageContextInfo.userDisplayName
}
            
            
or
            
{
    'id': _spPageContextInfo.userPrincipalName,
    'name': _spPageContextInfo.userDisplayName
}
            
            
If no configuration is specified, the component generates a unique identifier that is stored in the browser.
refresh Displays a button that refreshes the component (by default: false)
hideSendBox Hide the message entry field and the send button (by default: false)
apiKey Find the api key in the settings of the chatbot
displayMode Determines whether the webchat should be displayed 'open' or 'close' when it is loaded (by default is 'close')
environnement Environment of the Knowledge Base ('production', or 'integration') (by default: 'production')
triggerableDialogId ID of the Triggerable ID to start (optional)
triggerableDialogItemId ID of the Triggerable Item ID to start (optional)
background Background image (by default: square3d) Possible values: (square3d, communication, square, travel)
autocomplete Allows you to display the list of questions in autocompletion mode (by default: false)
autoscroll Allows you to force the auto scroll when a user gets back into the conversation and decides to send a message back into the chat.
buttonDesign.shape Allows you to choose the button's shape, possible values: square, circle, chat (default: circle))
buttonDesign.icon Allows to choose the button icon, possible values: 'bot' will take the avatar of your chatbot, can also take the class of a Font Awesome (for example 'fa fa-quote-right' or 'fas fa-comment') or put a URL to an image (default: fa-comment-dots)
buttonDesign.height Button length, suggested unit: 'px' (by default: '80px')
buttonDesign.width Button width, recommended unit: 'px' (by default: '80px')
buttonDesign.border 6 hexadecimal characters for the border or 'none' for no border (beware the 'chat' shape of the button is considered as a border) (by default: 'ffffff')
buttonDesign.text The text to be displayed next to the chosen icon. Over 25 characters, the text will be cut off.
headerHeight allows to set the header size. Possible values: small, normal (by default: 'normal' if not specified)
position webchat position on the page, 'top', 'middle' or 'bottom' then 'left' or 'right' and optionally followed by a margin of maximum 150px (default: 'bottom right 10px 10px')

# Configuration of the Webchat V1 component compatible with IE11 (obsolete)

# Security of the chatbot

The Webchat allows you to manage the security of the chatbot in a better way. It allows you to know where the webchat is deployed. For governance purposes, it is mandatory to explicitly indicate where the webchat is located, and therefore declare the different sites on which it will be available.

⚠️

Without this explicit definition, the webchat will not upload to your site. This prevents a person from adding webchat without permission.

low score

🔴

The Webchat also appears in the Webchat channel settings tab, so you can test and talk directly to the chatbot in production.

# SharePoint Modern Webpart

You can download the webpart here

In order to add the webpart into your SharePoint Modern, you need to add the sppkg package to the app catalog.

If you do not have an app catalog, a SharePoint Online Admin can create one by following the instructions in this guide: Use the App Catalog to make custom business apps available for your SharePoint Online environment.

# Deploy the package to app catalog

  1. Go to your site's app catalog.
  2. Upload or drag and drop the witivio-webchat.sppkg to the app catalog.
low score

This deploys the client-side solution package. Because this is a full trust client-side solution, SharePoint displays a dialog and asks you to trust the client-side solution to deploy.

low score
  1. Select Deploy.

# Configure the webchat for SharePoint Modern

The webchat is now available from your pages in your SharePoint site.

  1. Edit a page on your SharePoint Site
  2. Click on Add a new WebPart
  3. If you scroll down you will find "Witivio-webchat" webpart
low score
  1. Select it. the component appear, but the webchat is not configured yet.
low score

⚠️

It will not appear until you configure it.

  1. Select the pencil to edit the parameters.

Please refere to the article above to understand the configuration

💡

When adding the webpart to SharePoint the user context is send to the webchat. That means that the upn and the name of the user is send to the bot. Do not forget to review your privacy policies if you want your users to be anonymous.

⚠️

The sharepoint webpart of the webchat has to be added at the top of the page. Otherwise it will only be displayed when scrolling.

# Lumapps

# Beezy

# Powell 365

# SMS

Chat with your chatbot by using text message from your mobile phone.

Click here for more information about the Twiliio configuration.

# Comments