1Die Integration in drei Etappen

Der AuxData.ai Teams Bot ist die Integration des globalen Org-Chatbots in MS Teams. Die Einrichtung läuft in drei Etappen. (Teams-Doku, Einleitung)

1. Azure-Ressource + App-Registrierung anlegen, Microsoft-App-Daten in AuxData hinterlegen und die Berechtigungen festlegen.
2. Manifest-Datei erstellen (manifest.json aus der Vorlage).
3. Manifest über Microsoft Teams installieren und testen.

2Architektur: Teams → Azure-Bot → AuxData

Eine Azure-Bot-Ressource nimmt die Teams-Nachrichten entgegen und leitet sie an den AuxData-Endpoint weiter. Pro Anfrage liest AuxData Microsoft User ID und E-Mail aus, ordnet die Person dem AuxData-Benutzer zu und prüft innerhalb der Plattform die Rechte — so erreicht jeder nur die Agenten, für die er berechtigt ist. (M365-Doku, „AuxData.ai Teams Bot")

3Voraussetzungen

Microsoft-Tenant

Azure-Portal-Zugang als Tenant-Administrator (Ressource, App-Registrierung, Admin-Consent).

AuxData-Plattform

Organisations-Administrator für den Microsoft-Konnektor und den Access-Token.

Agent

ein in C1 angelegter/freigeschalteter Helpdesk-Assistent.

Manifest-Vorlage

das AuxData-GitHub-Vorlage-Repo für manifest.json.

1Ressource anlegen (1.1)

Melde dich im Azure Portal (https://portal.azure.com) mit dem Administrator-Account an. (Teams-Doku 1.1)

1. „Ressource erstellen" öffnen.
2. Kategorie „KI-Apps und -Agents" → „Azure Bot".
3. Bot-Namen vergeben (z. B. AuxData_Bot), Abonnement ist vorausgewählt, Ressourcengruppe neu anlegen oder wählen.
4. Type of App: Single Tenant; Creation Type: „Create new Microsoft App ID".
5. „Überprüfen + erstellen" → „Erstellen".

2App-Registrierung & geheimer Clientschlüssel (1.3)

Zurück ins Hauptmenü → App-Registrierung → die Anwendung über ihren Bot-Handle-Namen suchen (ggf. unter „Alle Anwendungen"). Dort einen „Neuer geheimer Clientschlüssel" anlegen (Name + Gültigkeitsdauer). Der Schlüssel wird nur einmalig angezeigt — sofort kopieren. Unter „Übersicht" findest du die Anwendungs-ID (Client) = die Client-ID.

1Warum der Bot Graph-Rechte braucht

AuxData braucht von Microsoft die Information, welcher Benutzer den Chatbot aufruft, um sie mit dem AuxData-User-Management abzugleichen und die Rechte des Anwenders zu prüfen. (Teams-Doku 1.4)

2Bot-Scopes (massgeblich: M365-Doku)

User.Read

Anwendungsberechtigung (Microsoft Graph) — Basis-Benutzerinfo.

User.Read.All

Anwendungsberechtigung — Benutzer dem AuxData-User zuordnen (User ID + E-Mail).

3Admin-Consent (Pflichtschritt)

Die Scopes sind Anwendungsberechtigungen (nicht delegiert). Danach muss ein Tenant-Administrator die Administratorzustimmung erteilen (Schaltfläche „Administratorzustimmung erteilen" → bestätigen). Erst dann erscheinen die grünen Haken und Graph-Aufrufe funktionieren.

1Endpoint in der Azure-Ressource (1.2)

In der Azure-Ressource unter Einstellungen → Konfiguration den Endpunkt eintragen. Form für die AuxData-Plattform: https://auxdata.ai/organisation/teamschat/<ACCESSTOKEN>. (Teams-Doku 1.2)

Den Platzhalter <ACCESSTOKEN> beziehst du in AuxData unter Organisation → Reiter Konfiguration → Externer Zugriff → „Accesstoken für Chatbot" (Kopieren-Button).

2Microsoft-Konnektor in AuxData (1.3)

Im AuxData-Microsoft-Konnektor (Organisation → Reiter Microsoft-Konnektor) die Tenant-ID eintragen, MS Teams Bot aktivieren und die Microsoft App-ID unter „Teams Bot App ID" eintragen. Das Teams-Bot-Passwort ist der in Stufe 2 erzeugte geheime Clientschlüssel. Dann im Azure-Portal „Anwenden" und in AuxData „Speichern".

3Kanal festlegen (Azure)

In Azure unter Einstellungen → Kanäle Microsoft Teams auswählen, den Benutzungsbestimmungen zustimmen („Agree"), für ein kommerzielles Unternehmen Microsoft Teams Commercial wählen und „Apply".

1Vorlage holen und anpassen

Die Manifest-ZIP enthält drei Dateien: die manifest.json und zwei Icons (color.png, outline.png). AuxData stellt unter https://github.com/AuxData-ai/teamsbot-manifest eine Vorlage bereit. (Teams-Doku, Manifestdatei)

In der Vorlage stehen Platzhalter <ID> — diese durch deine Teams-Bot-ID (= die Microsoft App-ID <APP-ID>) ersetzen. Anschliessend manifest.json, color.png und outline.png in eine ZIP-Datei packen.

2Schematische manifest.json

{
  "manifestVersion": "1.x",
  "id": "<APP-ID>",
  "packageName": "ai.auxdata.teamsbot",
  "name": { "short": "AuxData Helpdesk" },
  "bots": [
    {
      "botId": "<APP-ID>",
      "scopes": [ "personal", "team", "groupchat" ]
    }
  ],
  "validDomains": [ "auxdata.ai" ]
}

1Klickpfad zum Upload

Das Manifest wird über den Apps-Manager in MS Teams hochgeladen. (Teams-Doku, Upload)

1. MS Teams öffnen → Apps.
2. Im Apps-Manager „Apps verwalten".
3. „Apps hochladen" → „Benutzerdefinierte App hochladen".
4. Deine Manifest-ZIP auswählen.
5. Die App-Informationen erscheinen → „Hinzufügen".

2Test im Client

Den Helpdesk-Bot öffnen und eine einfache Helpdesk-Frage stellen. Prüfen, dass die Antwort aus den Wissensdatenbanken des berechtigten Agenten kommt und die Benutzerzuordnung greift (der angemeldete Teams-Nutzer wird auf seinen AuxData-Benutzer abgebildet).

1Globaler Modus vs. agentgebunden

Der Teams-Bot ist der globale Chatbot der Organisation — der Anwender chattet über ihn mit den Wissensdatenbanken der einzelnen Agenten (inkl. Datei-/Bild-Funktionen), für die er berechtigt ist. Er ist also nicht an genau einen Agenten gebunden, sondern routet org-weit. (M365-Doku)

2Rechteprüfung (plattformseitig)

Pro Anfrage liest AuxData Microsoft User ID + E-Mail aus, ordnet die Person zu und prüft die Berechtigungen innerhalb der Plattform — nur berechtigte Agenten sind erreichbar. Wer im Tenant ist, aber in AuxData keine Agent-Rechte hat, bekommt keine Inhalte (Org-Sicht/Freigabe → D2).

3Secret- & Token-Rotation

Der geheime Clientschlüssel hat eine Gültigkeitsdauer (Stufe 2) — vor Ablauf einen neuen erzeugen und in Azure und im AuxData-Konnektor (${BOT_SECRET}) aktualisieren. Den Access-Token für Chatbot (Endpoint-Bestandteil) wie ein Secret behandeln und gemäß AH 9.6 mindestens jährlich bzw. bei Admin-Wechsel rotieren. Nach einer Token-Rotation muss der Endpoint in der Azure-Ressource neu gesetzt werden (alter Token wird ungültig → Bot bricht ab).