Reference:ChatIntegration: Difference between revisions

Revision as of 13:09, 7 August 2026

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

Features

Setting up an MS Teams Bot

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

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).
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.
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
Start bluespice/chat with the proper TEAMS_ settings (Esp. "App-ID" and "Client-Secret")
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.
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.

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

Composer requirements

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

PDF exclude - start

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

PDF exclude - end

@@ Line 8: / Line 8: @@
 |category=Communication
 |bsvFrom=5.2
-|active=Yes
+|features=== Setting up an MS Teams Bot ==
-|license=GPL v3 only
+To create a MS Teams chat, the following steps are required:
+# Make the <code>TEAMS_WEB_PORT</code> (<code>8090</code> by default) of <code>bluespice/chat</code> available to the public internet with a valid SSL certificate. To achieve this, it might be necessary to set up a proxy (e.g. <code><nowiki>https://msteams.wiki.company.com</nowiki></code> → <code><nowiki>http://internalwikiserver:8090</nowiki></code>).
+# Create an "[https://portal.azure.com/#view/Microsoft_Azure_Marketplace/MarketplaceOffersBlade/searchQuery/azure%20bot/searchInitiatedFrom/plusNewBladeSearchContext/selectedMenuItemId/home/source~/%7B%22referrer%22%3A%22PlusNew.ReactView%22%2C%22controlName%22%3A%22Suggestions%22%2C%22controlType%22%3A%22SearchTermTyped%22%7D Azure Bot]" in the Azure Portal. A valid Azure Subscription, Application (ID is required) and Resource Group is required.
+## Set the public message endpoint  to <code>/api/messages</code>. E.g.<code><nowiki>https://msteams.wiki.company.com/api/messages</nowiki></code>.
+## Enable the "MS Teams" channel.
+# Create a Client Secret in the [https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade registered apps list]. This must be done in the "Credentials" area: <code><nowiki>https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/~/Credentials/appId/</nowiki><APP-ID>/isMSAApp~/false</code>
+# Start <code>bluespice/chat</code> with the proper <code>TEAMS_</code> settings (Esp. "App-ID" and "Client-Secret")
+# Create an  "MS Teams App".
+## Set the proper "App-ID" in the <code>[https://gitlab.hallowelt.com/BlueSpice/webservice-chat/-/blob/5ba9cac79c97c85c6818efd07659333c00ce8072/doc/ms-teams/manifest.json#L39 manifest.json]</code> and use the <code>[https://gitlab.hallowelt.com/BlueSpice/webservice-chat/-/blob/master/doc/ms-teams/createZip.sh?ref_type=heads createZIP.sh]</code> to forge the final app.
+# Install the "MS Teams App" through the [https://admin.teams.microsoft.com/policies/manage-apps MS Teams Admin Portal].
+## Make sure to confirm the required permissions.
+## 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
 }}
 {{wcagCheck}}