Zum Hauptinhalt springen

Chat in SharePoint einbetten

Einen CLYE-Assistenten kannst du auf einer SharePoint-Seite anzeigen. CLYE stellt das fertige SPFx-Paket und den zentralen Token-Endpunkt bereit. Du musst keine eigene Entra-App registrieren, kein Paket bauen und keine Azure Function betreiben. Ein SharePoint-Administrator installiert das bereitgestellte Paket einmalig tenantweit und genehmigt die angeforderte API-Berechtigung.

Der Zugriff eines Assistenten auf SharePoint-Inhalte ist etwas anderes. Dafür gibt es die Katalog-Einträge unter SharePoint einrichten.

Was du vorab benötigst​

  • einen CLYE-Assistenten, den du in SharePoint verwenden möchtest
  • das aktuelle .sppkg-Paket von CLYE
  • Berechtigung, den Assistenten in CLYE zu konfigurieren
  • SharePoint-Administratorzugriff für App-Katalog und API-Zugriffsfreigabe
  • die Entra-Tenant-ID eurer Microsoft-365-Organisation

Die letzten Schritte auf der Seite kann eine Person mit Bearbeitungsrechten ausführen.

Tenant-ID ermitteln​

Die Tenant-ID ist die Verzeichnis-ID eurer Microsoft-Entra-Organisation. Sie ist nicht die CLYE-App-Client-ID und nicht die Bot-ID.

  1. Öffne das Microsoft Entra Admin Center.
  2. Wähle Microsoft Entra ID, dann Übersicht.
  3. Kopiere die Mandanten-ID (Tenant-ID).

Wenn du keinen Zugriff auf die Entra-Übersicht hast, bitte die IT-Administration um diese ID.

Tenant-ID im Assistenten hinterlegen​

  1. Öffne CLYE und wähle den gewünschten Assistenten.
  2. Öffne Einstellungen, dann Integrationen, dann Einbetten.
  3. Füge im Bereich SharePoint-Einbettung die Tenant-ID ein und speichere.
  4. Prüfe, dass die Tenant-ID als freigegeben angezeigt wird.

Wenn mehrere Assistenten eingebettet werden sollen, wiederhole diesen Schritt für jeden Assistenten.

SPFx-Paket im SharePoint-Tenant installieren​

Diesen Abschnitt führt ein SharePoint-Administrator einmalig pro Tenant aus. CLYE liefert das gebaute Paket. Es muss nicht selbst kompiliert werden.

  1. Öffne das SharePoint Admin Center.
  2. Navigiere zu Weitere Features, dann Apps, dann App-Katalog. Falls für den Tenant noch kein App-Katalog existiert, erstelle ihn.
  3. Öffne den App-Katalog und lade das von CLYE bereitgestellte .sppkg-Paket hoch.
  4. Bestätige die tenantweite Bereitstellung, damit das Webpart für die gewünschten SharePoint-Websites verfügbar wird.
  5. Öffne im SharePoint Admin Center Erweitert, dann API-Zugriff.
  6. Prüfe die ausstehende Anforderung für Widget.Access der CLYE-App sharepoint-embed-prod und genehmige sie. Genehmige keine zusätzlichen Microsoft-Graph- oder SharePoint-Inhaltsrechte, die hier nicht angefordert werden.

Für die Genehmigung kann zusätzlich eine Entra-Rolle mit Berechtigung zum Erteilen von Admin-Consent erforderlich sein. Wenn die Anfrage nicht erscheint, prüfe, ob das Paket erfolgreich bereitgestellt wurde und ob die Berechtigungsanfrage verfügbar ist.

Chat auf einer SharePoint-Seite einfügen​

  1. Öffne die gewünschte SharePoint-Seite und klicke auf Bearbeiten.
  2. Füge mit + das Webpart CLYE Assistant hinzu.
  3. Öffne die Webpart-Eigenschaften und trage die Bot-ID des freigegebenen CLYE-Assistenten ein.
  4. Prüfe die Vorschau, speichere und veröffentliche die Seite.

Funktion prüfen​

  1. Öffne die veröffentlichte SharePoint-Seite mit einem normalen Benutzerkonto aus eurer Organisation.
  2. Das Webpart verwendet die SharePoint-Anmeldung der Person. Ein separates CLYE-Login pro Benutzer sollte nicht erforderlich sein.
  3. Sende eine Testnachricht und prüfe, dass die Antwort des richtigen Assistenten erscheint.

Wenn es nicht lädt​

  • „Assistent konnte nicht geladen werden“: Prüfe, dass das Paket bereitgestellt und Widget.Access genehmigt wurde und dass die richtige Bot-ID in den Webpart-Eigenschaften steht.
  • Invalid token nach einer Änderung an der Entra-App: Melde dich in SharePoint vollständig ab und wieder an oder starte eine frische Sitzung, damit das Webpart einen neuen Zugriffstoken anfordert. Ein zwischengespeicherter Token kann noch das vorherige Format enthalten.
  • Webpart fehlt in der Auswahl: Prüfe den Status der tenantweiten Paketbereitstellung und ob die Seite zu demselben SharePoint-Tenant gehört.
  • SharePoint blockiert das Laden: Bitte die SharePoint-Administration, die Richtlinien zu prüfen, die SPFx-Webparts oder den Zugriff auf externe Dienste einschränken.
  • Tenant wird abgewiesen: Vergleiche die in CLYE gespeicherte Tenant-ID mit der Mandanten-ID aus dem Entra Admin Center.

Bei einer Supportanfrage gib die SharePoint-Seitenadresse, den Assistenten und den sichtbaren Fehlertext an. Sende keine Sitzungscookies, Authorization-Header oder Tokens.

Inhalt