Last edited 2 days ago
by Redaktion

Chat integration (MS Teams, RocketChat, Slack)


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 chatbot in any of these applications, your wiki does not have the chat integration available yet.

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:

  1. Click the Profile link in your user menu.
    Opne user menu with Profile-link highlighted
    "Profile" link
  2. Click Edit profile data.
  3. Enter the username for any of the available chat clients (might differ from screenshot).
    User profile data in edit mode
    Chat client usernames
  4. Save the page.

Once your username is available in the wiki, you can switch to your communication client and communicate with the wiki bot user.

Locating your Slack username

Slack usually only shows your display name on the interface. To find your actual Slack username:

  1. Click the "three dots"-menu in your user profile.
  2. Click Account settings.
    Finding your Slack username
  3. Scroll to the end of the Account settings page where you should see your username.

MS Teams

Log into your MS Teams account.

Teams chat window for BlueSpice chatbot
BlueSpice chatbot in MS Teams

To interact with the BlueSpice Chatbot:

  1. Click the BlueSpice Chatbot icon in the app bar.
  2. Type any prompt related to the content in your BlueSpice wiki in the corresponding field.

Slack

To interact with the BlueSpice chatbot:

  1. Click the BlueSpice Chatbot icon in the app bar.
  2. Type any prompt related to the content in your BlueSpice wiki in the corresponding field.

RocketChat

Share a page via chat (MS Teams)

The wiki can be configured to show a Share via chat link in the page tools. Clicking this link opens the MS Teams chat window with a chat message that includes a link to the current page. Which chat is opened from this link has to be configured on the server. There is no GUI for this configuration available.

Activated link with open MS Teams chat share window.
"Share via" chat link
Notice: The share-via-chat function is currently only available for MS Teams.


Notifications

You can set your notifications preferences to send notifications to a chat channel.

  1. Go to Special:Enhanced_Preferences.
  2. Select the menu item Notifications.
  3. Create or edit a subscription set.
  4. Select the chat clients you want to receive notifications from.
Frequency of notifications If you don't receive the expected notifications, make sure to check your setting for frequency of notifications. By default, it is set to "daily".


Configuration

The following configurations can be made directly in the configuration manager:

Communication

A wiki administrator needs to add the service provider license in the section Communication for extension ChatIntegration.

Skinning

  • Show "share via chat" action: Activates the share link in the page tools.



PDF exclude - start

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

PDF exclude - end