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

# Download the Teams package


When you configure or want to modify the configuration of your chatbot Teams, you can download a zip file containing:

  • A JSON file
  • 2 photos (96x96 Px, 20x20 Px).

This file describes the information provided in the application.

You can add this package in Teams. Choose a team and a channel in Microsoft Teams, choose + to add an application (Click on "Other application").

# 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

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.

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

# Configuration of the 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.

# SMS

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

Click here for more information about the Twiliio configuration.

# Comments