Reference:ChatIntegration

all extensions

Overview
Description:	⧼ext-chatintegration-desc⧽
State:	stable	Dependency:	BlueSpice
Developer:	HalloWelt	License:	GPL-3.0-only
Type:	BlueSpice	Category:	Communication
Edition:	BlueSpice pro, BlueSpice farm, BlueSpice cloud	Version:	5.2+
View user help page

Technical Information

Technical details for BlueSpice cloud can differ in some cases.

Requirements

• MediaWiki: 1.43.0

• NotifyMe: 2.0.0
• UserProfile: 1.0.0

Integrates into

• BlueSpiceVisualEditorConnector

• ChatIntegration

• ContentDroplets

Special pages

Configuration

Name	Value
ChatIntegrationBridge	array ( 'url' => '', 'token' => '', )
GoogleMeetUrl	'https://meet.google.com'
MSTeamsUrl	'https://teams.microsoft.com/l/'
MatrixUrl	'https://app.element.io/#/room'
RocketChatUrl	''
SidebarShareMsTeams	false
SlackUrl	'https://company.enterprise.slack.com/archives'
ZoomUrl	'https://zoom.us/j'

Hooks

• BeforePageDisplay
• BlueSpiceDiscoveryTemplateDataProviderAfterInit
• GetPreferences
• MWStakeGenericTagHandlerInitTags
• NotifyMeRegisterChannel
• SetupAfterCache
• SidebarBeforeOutput
• UserProfileBeforeSetProfileData
• UserProfileGetProfileData

Composer requirements

all-packages	mwstake/mediawiki-component-generictaghandler mwstake/mediawiki-component-token-authenticator

Setting up an MS Teams Bot

To create a MS Teams chat, the following steps are required:

1. Make the TEAMS_WEB_PORT (8090 by default) of bluespice/chat available to the public internet with a valid SSL certificate. To achieve this, it might be necessary to set up a proxy (e.g. https://msteams.wiki.company.com → http://internalwikiserver:8090).
2. Create an "Azure Bot" in the Azure Portal. A valid Azure Subscription, Application (ID is required) and Resource Group is required.
   1. Set the public message endpoint to /api/messages. E.g.https://msteams.wiki.company.com/api/messages.
   2. Enable the "MS Teams" channel.
3. Create a Client Secret in the registered apps list. This must be done in the "Credentials" area: https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/~/Credentials/appId/<APP-ID>/isMSAApp~/false
4. Start bluespice/chat with the proper TEAMS_ settings (Esp. "App-ID" and "Client-Secret")
5. Create an "MS Teams App".
   1. Set the proper "App-ID" in the manifest.json and use the createZIP.sh to forge the final app.
6. Install the "MS Teams App" through the MS Teams Admin Portal.
   1. Make sure to confirm the required permissions.
   2. Make sure to allow users to enable it.

See also the original documentation at https://github.com/hubot-friends/hubot-ms-teams/blob/v3.0.0/README.md#going-live-set-up-instructions

PDF exclude - start

---

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

PDF exclude - end