Microsoft Teams
Bubble Chat lässt sich als Bot direkt in Microsoft Teams einbinden. Mitarbeitende können den Chatbot über den gewohnten Teams-Workspace nutzen, ohne einen separaten Kanal oder eine zusätzliche App öffnen zu müssen.
Was die Integration bietet
- Persönlicher Chat mit dem Bot: Benutzerinnen und Benutzer starten eine Konversation direkt im Teams-Chat mit dem Bot.
- Automatischer Willkommensflow: Beim ersten Kontakt kann ein definierter Einstiegsflow ausgelöst werden, z.B. eine Begrüssung.
- Profilanreicherung: Beim ersten Kontakt werden Profildaten (Name, E-Mail, bevorzugte Sprache) automatisch über Microsoft Graph abgefragt und in die Session übernommen. So kann der Bot Benutzer namentlich ansprechen und die Sprache automatisch anpassen.
Voraussetzungen
Für die Integration wird Folgendes benötigt:
- Ein Azure Bot (Single Tenant) mit aktiviertem Microsoft-Teams-Channel
- Eine zugehörige App Registration in Microsoft Entra ID mit einem Client Secret
- Microsoft-Graph-Berechtigung
User.Read.Allmit Admin Consent für die Profilanreicherung
Teams-App installieren
Damit der Bot in Teams installierbar ist, braucht es ein Teams-App-Manifest als ZIP-Paket. Bubble Chat stellt dafür ein eingebautes Manifest-Tool bereit, das das ZIP inklusive Icons automatisch erzeugt.
Das Manifest-Tool ist über die folgende URL erreichbar:
https://<deine-domain>/ms-teams/<clientName>/manifest-tool
Das fertige ZIP-Paket lässt sich anschliessend im Teams Admin Center oder direkt in Teams als App installieren.
Angaben für das Manifest-Tool
Damit der Kunde die App selbst erstellen oder das Manifest-Tool vorbereitet ausfüllen kann, werden folgende Angaben benötigt:
| Angabe | Pflicht | Beschreibung |
|---|---|---|
| Kurzname | ja | Name des Bots, wie er in Teams angezeigt wird (max. 30 Zeichen) |
| Vollständiger Name | nein | Optionaler langer Name (max. 100 Zeichen) |
| Kurzbeschreibung | ja | Kurze Beschreibung des Bots (max. 80 Zeichen) |
| Ausführliche Beschreibung | nein | Längere Beschreibung für den Teams App Store |
| Bot-ID | ja | App ID aus der Azure App Registration (entspricht der App ID aus den Konfigurationsangaben) |
| Entwicklername | ja | Name des Unternehmens, das den Bot betreibt |
| Website-URL | ja | Öffentliche Website des Unternehmens |
| Datenschutz-URL | ja | URL zur Datenschutzerklärung |
| Nutzungsbedingungen-URL | nein | URL zu den Nutzungsbedingungen (Standard: Website-URL) |
| Akzentfarbe | nein | Hex-Farbwert für das Branding in Teams (Standard: #ffffff) |
| Farb-Icon | nein | PNG, 192 × 192 px – farbiges App-Icon, das in der Teams-App-Übersicht und im App Store angezeigt wird. |
| Kontur-Icon | nein | PNG, 32 × 32 px, transparent – einfarbiges Icon (weiss auf transparentem Hintergrund), das in der Teams-Seitenleiste und in Benachrichtigungen erscheint. |
Werden keine Icons hochgeladen, verwendet das Tool automatisch generierte Standard-Icons.
Beispiel: Ein Unternehmen namens «Muster AG» möchte einen internen HR-Bot in Teams bereitstellen:
| Angabe | Beispielwert |
|---|---|
| Kurzname | HR-Assistent |
| Vollständiger Name | HR-Assistent der Muster AG |
| Kurzbeschreibung | Dein digitaler Ansprechpartner für HR-Fragen. |
| Ausführliche Beschreibung | Der HR-Assistent beantwortet Fragen zu Ferien, Spesen, Lohnausweisen und internen Prozessen – rund um die Uhr, direkt in Microsoft Teams. |
| Entwicklername | Muster AG |
| Website-URL | https://www.muster-ag.ch |
| Datenschutz-URL | https://www.muster-ag.ch/datenschutz |
| Akzentfarbe | #0078d4 |
Einschränkungen
Die Integration unterstützt aktuell ausschliesslich den persönlichen Chat (Scope personal) zwischen einem Benutzer und dem Bot. Gruppen- oder Kanal-Konversationen sind nicht vorgesehen.
Ohne Microsoft-Graph-Berechtigung funktioniert der Bot vollständig, jedoch ohne Profilanreicherung – der Name des Benutzers und die bevorzugte Sprache stehen dann nicht automatisch zur Verfügung.