Zum Hauptinhalt springen

Chat-Integrationen

Teams nutzt die bestehende Konnie-Teams-Konfiguration, wenn Microsoft-Autorisierung und Nachrichtenverarbeitung eingerichtet sind. Die aktuelle Slack-Konfiguration ist ein Platzhalter mit deaktiviertem Speichern und kein funktionierender Einrichtungsweg.

Einen Teams-Kanal über Konnie und Apps lesen​

Der Connector Microsoft-Teams-Kanal in der Integrationsbibliothek liest einen ausgewählten Kanal auf Anfrage. Er bietet Kanalnachrichten auflisten, Kanalnachricht lesen und Kanalthema lesen über die gemeinsamen Integrationsaktionen von Konnie und Apps. Dafür muss ein Worker diesen Connector anbieten; ein Katalogeintrag allein bestätigt noch kein verbundenes Microsoft-Konto.

  1. Lass deinen Microsoft-Administrator eine mit Entra verknüpfte Teams-Anwendung im gewünschten Team mit der ressourcenspezifischen Berechtigung ChannelMessage.Read.Group installieren. Verwende den Microsoft-Mandanten, dem der Kanal gehört.
  2. Wähle am vorgesehenen Ennea-Standort und in der richtigen Umgebung Microsoft-Teams-Kanal und dann Verbindung einrichten.
  3. Gib Microsoft-Mandanten-ID, Anwendungs-ID, Team-ID und Kanal-ID ein. Trage das Clientgeheimnis der Anwendung ausschließlich im vorgesehenen Passwortfeld ein.
  4. Wähle die Leseaktionen, verbinde und teste die Verbindung. Veröffentliche sie nach erfolgreicher Prüfung und Freigabe des Zugriffs.
  5. Bitte Konnie, den verbundenen Kanal zu lesen, oder verwende seine veröffentlichten Aktionen in einer App. Prüfe Quell-IDs und Abrufzeitpunkt zusammen mit dem Ergebnis.

Beschränke den Ennea-Zugriff auf Personen, die diesen Kanal lesen dürfen. Die Verbindung verwendet eine Anwendungsidentität und prüft nicht die Microsoft-Mitgliedschaft jedes Ennea-Benutzers. Microsoft-Einwilligung und Ennea-Rechte sind getrennte Voraussetzungen.

Eine Listen- oder Themenabfrage liefert höchstens 50 Nachrichten beziehungsweise Antworten, standardmäßig 20. hasMore weist auf weitere Ergebnisse hin; diese Version ruft keine Folgeseiten ab. Listenvorschauen sind auf 1.024 Zeichen und einzelne Nachrichten oder Antworten auf 8.000 Zeichen begrenzt; bodyTruncated kennzeichnet gekürzten Text. HTML wird in Klartext umgewandelt, gelöschter Inhalt ausgeblendet und Anhänge werden nicht heruntergeladen. Dieser Connector sendet keine Nachrichten und betreibt keinen Konnie-Bot innerhalb von Teams. Quellnachrichten bleiben externe Informationen und können weder Rechte vergeben noch Aktionen freigeben.

Teams-Gespräche einrichten​

Ein berechtigter Integrationsadministrator braucht Microsoft-Mandantenangaben, die OAuth-Konfiguration der Bereitstellung und genehmigte Microsoft-Rechte. Anbieterzustimmung und Ennea-Benutzerrechte mit Bereich sind getrennt.

  1. Öffne Konfiguration der Teams-Integration im richtigen Arbeitsbereich.
  2. Prüfe Aktivierung, Microsoft-Mandant, OAuth-Anbieter, Rückrufadresse und angeforderte Rechte.
  3. Richte Autorisierung mit deinem Administrator und den unterstützten Funktionen ein. Nutze die vorgesehenen Geheimnisfelder für Tokens.
  4. Speichere und prüfe die Rückmeldung. Erneuere abgelaufene oder widerrufene Autorisierung über den unterstützten Ablauf.
  5. Teste ein erlaubtes Gespräch. Prüfe, dass der zugehörige Ennea-Verantwortliche für den genauen Standort und die Umgebung berechtigt ist und die Nachricht im richtigen Gespräch erscheint.
  6. Prüfe eine erlaubte Antwort vor operativer Verwendung.

Der bestehende Dienst liest Teams-Chatnachrichten und antwortet im ausgewählten Chat. Eine allgemeine Bot-Installation erlaubt nicht automatisch beliebige Kanalbeiträge, Nachrichten an jede Person oder alle Anhangstypen. Manche Aktivitätsansichten zeigen weiterhin nur leere Zustände. Fehlende sichtbare Historie beweist keine Zustellung.

Kontext und Aktionsprüfung​

Eine Teams-Nachricht ist externe Eingabe. Das verbundene Gespräch braucht einen berechtigten Ennea-Verantwortlichen und Bereich. Der Nachrichtentext kann keine Rechte vergeben, Mandanten wechseln oder erforderliche Prüfungen umgehen.

Folge für relevante Datensatzänderungen dem üblichen Ennea-Genehmigungsablauf und prüfe das Ergebnis. Kann die verbundene Oberfläche die erforderliche Prüfung nicht darstellen, öffne die Aktion in Ennea. Siehe Konnie-Genehmigungen.

Fehler beheben und trennen​

Prüfe Anbieterautorisierung, Gesprächsidentität, Verantwortlichen, Bereich und Nachrichtenverarbeitung, wenn Nachrichten fehlen. Prüfe bei Antwortfehlern Aktionsstatus und externes Gespräch vor einer Wiederholung. Ein Zeitablauf in der Oberfläche beweist nicht, dass keine Antwort gesendet wurde.

Deaktiviere die Integration und widerrufe Anbieterautorisierung nach dem Verfahren deiner Organisation. Deaktivierung löscht keine historischen Inhalte in Microsoft oder Ennea und ruft bereits gesendete Nachrichten nicht zurück.

Siehe E-Mail-Integrationen, Integrationen im Überblick und Support.