Microsoft Teams verbinden
Überblick
Die Verbindung bringt Meldungen aus dem System in einen Teams-Kanal — dorthin, wo das Team ohnehin liest. Verknüpft wird ein Teams-Kanal mit einem Projekt; die Meldungen dieses Projekts gehen dann dorthin.
Die Verknüpfung ist beidseitig eindeutig: ein Projekt hat höchstens einen Kanal, ein Kanal höchstens ein Projekt. Ein zweiter Eintrag auf dieselbe Seite wird mit einer Fehlermeldung abgewiesen, nicht stillschweigend übernommen.
Die Richtung ist bewusst einfach gehalten: Das System meldet nach Teams, und aus dem Kanal lassen sich einzelne Befehle absetzen. Es ist keine zweite Oberfläche, in der gearbeitet wird — Antworten und Entscheidungen bleiben im Vorgang, wo sie nachvollziehbar sind.
Kernaufgaben
Verbindung herstellen. Die Zugangsdaten des Bots (App-Kennung, App-Passwort, Mandant) liegen nicht auf dieser Seite, sondern bei den Integrationen unter dem Anbieter Microsoft. Ohne hinterlegte App-Kennung bleibt der Eingang geschlossen.
Einen Kanal verknüpfen. Unter Einstellungen → Teams wählen Sie das Projekt und tragen die Kanal-Id ein. Ab dann gehen die Meldungen dieses Projekts dorthin.
Eine Verknüpfung ruhen lassen oder lösen. Aktiv aus stoppt die Meldungen und behält die Zuordnung; Löschen entfernt sie ganz. Die Historie im Kanal bleibt in beiden Fällen.
Felder im Detail
Die Spalte Was es bewirkt beantwortet, was sich im System ändert — nicht, wie das Feld heißt. Der graue Name dahinter ist das Feld der API: unter ihm läuft dasselbe über Automation, Import und KI-Werkzeuge.
Kanal-Verknüpfung
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Projekt projectId | ja | bestehendes Projekt | Wessen Ereignisse gemeldet werden. Ein Projekt lässt sich nur einmal verknüpfen. |
Kanal-Id channelId | ja | Text, max. 190 Zeichen, Form 19:…@thread.tacv2 | Wohin gemeldet wird. Adressiert wird über die Id, nicht über den Namen — Kanäle lassen sich umbenennen, die Id bleibt. |
Kanal-Name channelName | nein | Text, max. 120 Zeichen | Reine Anzeige in dieser Liste, damit die Zeile lesbar bleibt. Er wird nicht zum Zustellen benutzt und darf leer bleiben. |
Aktiv active | nein | Ja/Nein (Standard: ja) | Ob die Verknüpfung trägt. Aus heißt: keine Ereignis-Posts und keine Bot-Befehle aus diesem Kanal — die Zuordnung bleibt aber bestehen. |
Was nicht auf dieser Seite eingestellt wird
| Angabe | Wo sie liegt | Warum dort |
|---|---|---|
| App-Kennung, App-Passwort, Mandant | Integrationen, Anbieter Microsoft | Zugangsdaten gelten für die ganze Anbindung, nicht je Kanal. Die App-Kennung ist zugleich der erwartete Empfänger jedes eingehenden Tokens: ohne sie wird alles abgewiesen. |
| Antwort-Adresse des Kanals | wird gelernt | Sie ist mandanten- und regionsabhängig. Das System merkt sie sich aus der ersten eingehenden Aktivität des Kanals, statt danach zu fragen. |
| Nutzer-Zuordnung Teams ↔ Octibiz | entsteht beim ersten Verknüpfen aus dem Kanal | Ein Bot-Befehl handelt mit den Rechten des zugeordneten Kontos. Ohne Zuordnung geschieht nichts — der Bot antwortet mit einem Hinweis, statt anonym zu handeln. |
| Welche Ereignisse gemeldet werden | Benachrichtigungen | Der Kanal ist ein geteilter Raum; er ist deshalb nicht vorbelegt. Jeder schaltet für sich frei, was im Projekt-Kanal erscheinen soll. |
Ohne eingerichtete App-Kennung wird alles abgewiesen — „noch nicht eingerichtet" heißt hier geschlossen, nicht offen. Eingehende Anfragen werden gegen den Schlüsselsatz von Microsoft geprüft; ein Verfahren ohne Signatur wird hart abgelehnt.
Einstellungen & Rechte
- Verknüpfungen sehen:
octi.msteams.read - Verknüpfungen verwalten:
octi.msteams.manage
Modul-Flag: module.msteams. Welche Ereignisse überhaupt gemeldet werden, steuern die Benachrichtigungs-Einstellungen — die Verknüpfung entscheidet nur über den Weg.
FAQ & Fehlerbilder
Es kommen keine Meldungen an. Prüfen Sie zuerst, ob für das Projekt überhaupt Benachrichtigungen über Teams eingeschaltet sind. Der Kanal ist nicht vorbelegt; ohne Ereignis gibt es keine Meldung.
Das Projekt lässt sich nicht ein zweites Mal verknüpfen. So gewollt: je Projekt ein Kanal, je Kanal ein Projekt. Lösen Sie die bestehende Zeile oder schalten Sie sie auf Aktiv = nein.
Ein Bot-Befehl antwortet „Kanal nicht verknüpft". Dann fehlt für diesen Kanal die Zeile, oder sie steht auf Aktiv = nein.
Die Verbindung ist abgelaufen. Erneuern Sie die Zugangsdaten in den Integrationen; die Verknüpfungen dieser Seite bleiben erhalten.