Manual:Extension/ChatIntegration: Difference between revisions

Revision as of 09:49, 7 October 2025

ChatIntegration is available from BlueSpice 5.2. This extension has multiple prerequesites before it is available to users in a wiki.

Overview

Users can interact with the wiki directly from their preferred chat client. Currently, the following chat clients are supported:

MS Teams
RocketChat
Slack

If you do not see the BlueSpice chatbots in any of these applications, your wiki has no

Adding your chat client username to the wiki

Before you can interact with the wiki chatbot in your chat client that is connected to your wiki, you need to provide your username for that application in your wiki user profile.

To add your chat client username to your wiki profile:

Click the Profile link in your user menu.
"Profile" link
Click Edit profile data.
Enter the username for any of the available chat clients (might differ from screenshot).
Chat client usernames
Save the page.

MS Teams

Log into your MS Teams account.

To interact with the BlueSpice Chatbot:

Click the BlueSpice Chatbot icon in the app bar.
...

Slack

To interact with the BlueSpice chatbot:

Click the BlueSpice Chatbot icon in the app bar.
...

RocketChat

Configuration manager

An administrator can configure the name of the bot that is shown at the beginning of the chat window in the Config Manager under extension ChatBot.

Technical Reference: ChatIntegration

PDF exclude - start

To submit feedback about this documentation, visit our community forum.

PDF exclude - end

@@ Line 1: / Line 1: @@
-{{BSVersion|bsvFrom=5.2|bsvFeature=ChatBot|info=This extension has multiple prerequesites before it is available to users in a wiki.}}
+{{DISPLAYTITLE:Chat integration (MS Teams, RocketChat, Slack)}}
+{{BSVersion|bsvFrom=5.2|bsvFeature=ChatIntegration|info=This extension has multiple prerequesites before it is available to users in a wiki.}}
-== Starting a conversation ==
+== Overview ==
-If the chatbot is enabled in the wiki,  the interface provides a chat assistant that can answer questions related to your wiki. Click the Chat button at the end of the page to open the chat.
+Users can interact with the wiki directly from their preferred chat client. Currently, the following chat clients are supported:
-[[File:chatbot button.png|alt=Chatbot button|center|thumb|134x134px|Opening the chat window]]
-== The chat window ==
+* MS Teams
-[[File:Chatbot window.png|alt=Introduction page of the BlueSpice user manual with an open chat window.|center|thumb|750x750px|Chatbot window]]The chat window has the following main features:
+* RocketChat
-* '''(1) Buttons to resize or close the chat:'''
+* Slack
-** ''resize chat:'' The size of the chat window has 3 different settings.
-** ''minimize chat:'' The chat window is hidden, but not closed... Clicking on the chat button again restores the current session.
-** ''close chat and delete chat history:''  The chat window is closed and the chat history of the session is deleted.
-* '''(2)  Question with timestamp:''' Once a conversation has been started by sending it from the message prompt area, the question appears with a timestamp in the chat window.
-* Answer to the question with the following elements:
-** '''(3)  the answer text'''
-** '''(4)  resources:''' the page references that were used as a data source
-** '''(5)  buttons to copy the answe'''r to the clipboard or to save it as a wiki page (as a subpage of the current user's user profile page, e.g. <code>User:WikiSysop/Bot/...</code>)
-* '''(6)  Suggested follow-up questions'''
-* '''(7) Message prompt area'''
-== Search integration ==
+If you do not see the BlueSpice chatbots in any of these applications, your wiki has no
-When a user types in a search term and switches to the [[Manual:Extension/BlueSpiceExtendedSearch|search center]], the search results are preceded by a summary from the chatbot.
-== Excluding pages as a data source ==
+== Adding your chat client username to the wiki ==
+Before you can interact with the wiki chatbot in your chat client that is connected to your wiki, you need to provide your username for that application in your wiki user profile.
-'''To exclude a page as a data source for the chatbot:'''
+'''To add your chat client username to your wiki profile:'''
-# '''Click''' the ''Options'' menu  in the visual editor toolbar.[[File:VE page options menu item.png|alt=Options menu of VisualEditor|center|thumb|150x150px|Page options menu]]
+# '''Click''' the ''Profile'' link in your user menu.[[File:User menu profile link.png|alt=Opne user menu with Profile-link highlighted|center|thumb|550x550px|"Profile" link]]
-# '''Click''' ''Advanced settings''.
+# '''Click''' ''Edit profile data''.
-# '''Click''' ''No, do not index'' after the label ''Can be indexed for ChatBot'', users can check this requirement in the visual editor toolbar under Options > Advanced options.
+# '''Enter''' the username for any of the available chat clients (might differ from screenshot).[[File:user profile chat integration usernames.png|alt=User profile data in edit mode|center|thumb|550x550px|Chat client usernames]]
+# '''Save''' the page.
+== MS Teams ==
+Log into your ''MS Teams'' account.
+[[File:bluespice chatbot ms teams.png|alt=Teams chat window for BlueSpice chatbot|center|thumb|550x550px|BlueSpice chatbot in MS Teams]]
+'''To interact with the BlueSpice Chatbot:'''
+# '''Click''' the ''BlueSpice Chatbot'' icon in the app bar.
+# ...
+== Slack ==
+'''To interact with the BlueSpice chatbot:'''
+# '''Click''' the ''BlueSpice Chatbot'' icon in the app bar.
+# ...
+== RocketChat ==
-This adds the behavior switch <code>__NO_RAG_EXPORT__</code> to the page source.
 == Configuration manager ==
 An administrator can configure the name of the bot that is shown at the beginning of the chat window  in the [[Manual:Extension/BlueSpiceConfigManager|Config Manager]] under extension ''ChatBot''.