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.
# 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.
The following boxes contain the connection information: E-mail, password, Azure ID.
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.
It also possible to consult the event logs of the connector.
# 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").
The webchat channel is automatically activated.
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 :
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.|
# 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.
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
- Go to your site's app catalog.
- Upload or drag and drop the witivio-webchat.sppkg to the app catalog.
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.
- Select Deploy.
# Configure the webchat for SharePoint Modern
The webchat is now available from your pages in your SharePoint site.
- Edit a page on your SharePoint Site
- Click on Add a new WebPart
- If you scroll down you will find "Witivio-webchat" webpart
- Select it. the component appear, but the webchat is not configured yet.
It will not appear until you configure it.
- 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.
Chat with your chatbot by using text message from your mobile phone.
Click here for more information about the Twiliio configuration.