Microsoft Teams mit eigenem Bot verbinden

Manche Organisationen möchten, dass kanman Microsoft Teams über einen Bot erreicht, der ihnen selbst gehört. Der Bot liegt dann in deinem eigenen Microsoft-Mandanten, unter deinen Richtlinien, und nur Personen deiner Organisation können mit ihm sprechen. Diese Seite richtet sich an die IT-Administration, die ihn einrichtet. Es dauert etwa 15 Minuten.

Du brauchst:

• eine Admin-Rolle in Microsoft Entra, die App-Registrierungen anlegen darf,
• ein Azure-Abonnement, in dem du einen Azure Bot anlegen darfst (der Free-Tarif genügt),
• eine Teams-Administration, die eigene Apps hochladen darf,
• eine Inhaberin oder einen Admin in kanman, die die Verbindung in kanman hinzufügt (das kannst du selbst sein).

Microsoft Teams mit eigenem Bot gehört wie Microsoft Teams mit dem Bot von kanman zum Team-Tarif.

1. App-Registrierung anlegen

1. Öffne im Microsoft Entra Admin Center App-Registrierungen und wähle Neue Registrierung.
2. Gib einen Namen ein, etwa kanman, und wähle den Kontotyp Nur Konten in diesem Organisationsverzeichnis (Single-Tenant). Eine Umleitungsadresse ist nicht nötig.
3. Notiere in der Übersicht der Registrierung die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant).
4. Öffne Zertifikate & Geheimnisse, erstelle einen Neuen geheimen Clientschlüssel und kopiere sofort seinen Wert. Microsoft zeigt ihn nur einmal. Notiere, wann er abläuft; siehe Geheimen Clientschlüssel erneuern.

2. Verbindung in kanman hinzufügen

1. Öffne in kanman Workspace-Einstellungen > Verbindungen > Microsoft Teams (/<workspace>/settings/connections/microsoft_teams).
2. Wähle Microsoft Teams hinzufügen und dann Unser eigener Bot (Single-Tenant). Das Panel zeigt dieselben Schritte wie diese Seite.
3. Gib Verzeichnis-ID (Mandant), Anwendungs-ID (Client) und Geheimen Clientschlüssel ein und speichere.

kanman bewahrt den geheimen Clientschlüssel als Workspace-Secret auf: Niemand kann ihn wieder auslesen, auch Admins nicht. Er dient nur dazu, die Nachrichten deines Bots zu signieren.

Nach dem Speichern testet kanman die Verbindung: Es bittet deinen Mandanten um eine Anmeldung für den Bot. Stimmt etwas nicht, sagt die Verbindung, was:

Die Seite von Microsoft Teams zeigt jetzt deinen eigenen Bot mit dem Messaging-Endpunkt: einer Adresse, die mit /msteams-bot/bot/ und der ID der Verbindung endet. Adresse kopieren legt sie in die Zwischenablage. Du brauchst sie in Schritt 4.

3. Azure Bot anlegen

1. Leg im Azure-Portal eine Ressource vom Typ Azure Bot an.
2. Wähle einen Bot-Handle, dein Abonnement und deine Ressourcengruppe, den Tarif Free (F0), den App-Typ Single-Tenant und den Erstellungstyp Vorhandene App-Registrierung verwenden mit der Anwendungs-ID aus Schritt 1.

4. Messaging-Endpunkt setzen und Teams einschalten

1. Füge in der Konfiguration des Bots die Adresse von kanman unter Messaging-Endpunkt ein und speichere.
2. Füge unter Kanäle des Bots Microsoft Teams hinzu, akzeptiere die Bedingungen und speichere.

5. Teams-App hochladen

1. Wähle auf der Microsoft-Teams-Seite von kanman Teams-App herunterladen. Du erhältst kanman-teams-app.zip, das App-Paket für deinen Bot: Es enthält bereits die ID deines Bots und die Symbole von kanman.
2. Öffne im Teams Admin Center Teams-Apps > Apps verwalten und wähle Neue App hochladen. Wähle die Datei aus.
3. Erlaube die App in deiner App-Berechtigungsrichtlinie (oder in der Richtlinie der Personen, die kanman nutzen sollen) und lass sie dort installieren, wo deine Teams arbeiten.

6. Hallo sagen

Füge kanman in Microsoft Teams zu einem Team, einem Gruppenchat oder einer Direktnachricht hinzu und schick eine Nachricht. kanman antwortet im Chat. Ab dann merkt sich kanman jedes Team, jeden Kanal, jeden Gruppenchat und jede Direktnachricht, in die es aufgenommen wird, und Team-Admins wählen die Orte, an denen jedes Team spricht, wie in Mit kanman in Slack und Microsoft Teams arbeiten beschrieben.

Mit eigenem Bot brauchst du keinen Verknüpfungscode: Dein Bot gehört von Anfang an zu deinem Workspace.

Auf wen kanman hört

Dein eigener Bot ändert, wie Nachrichten kanman erreichen, nicht was kanman mit ihnen tut:

• kanman handelt nur für Mitglieder deines kanman-Workspaces, erkannt an ihrer geschäftlichen E-Mail-Adresse. Alle anderen erhalten einen kurzen Hinweis, dass kanman nur für Mitglieder handeln kann.
• Text in Teams wird als Information gelesen, nie als Anweisung an die Regeln von kanman. Wer aus dem Chat Stories entwerfen oder Entscheidungen beantworten darf, folgt den Einstellungen deines Teams, wie in der App.
• Dein Bot antwortet nur Personen deines eigenen Mandanten. Nachrichten anderer Organisationen erreichen kanman nicht.

Workspaces, die alles auf Runnern ausführen

Führt dein Workspace alles auf eigenen Runnern aus, ist Microsoft Teams die eine Verbindung, die nicht über den Runner läuft: Microsoft liefert die Nachrichten deines Bots an eine öffentliche Adresse, darum laufen Teams-Nachrichten über die Cloud von kanman. Die Microsoft-Teams-Seite sagt das. Alles andere läuft weiter auf deinen Runnern. Siehe Alles auf deinen Runnern ausführen.

Geheimen Clientschlüssel erneuern

Geheime Clientschlüssel laufen ab (nach 6, 12 oder 24 Monaten, je nach Wahl in Schritt 1). Erstelle vorher einen neuen geheimen Clientschlüssel in der App-Registrierung, öffne die Verbindung in kanman mit Bearbeiten, füge den neuen Wert ein und speichere. kanman testet die Verbindung sofort erneut.

Vom Bot von kanman wechseln

Hat deine Organisation bisher den Bot von kanman genutzt, füge die Verbindung mit eigenem Bot wie oben beschrieben hinzu. Sobald ihr Test gelingt, gehört deine Microsoft-365-Organisation zu deinem eigenen Bot, und die frühere Verknüpfung endet. Entferne danach die alte kanman-App aus deinem Teams Admin Center.

Verwandte Seiten

• Mit kanman in Slack und Microsoft Teams arbeiten
• Zuhörmodi und Leitplanken
• Verbindungen
• Alles auf deinen Runnern ausführen