Workplace from Meta wird eingestellt. Du kannst Workplace noch bis zum 31. August 2025 nutzen. Weitere Informationen dazu findest du in unserem Hilfebereich.
Selbstdefinierte Integrationen
Übersicht
Benutzerdefinierte Integrationen in Workplace sind Services, die die Funktionen von Workplace mit der Graph API und der Account Management API erweitern.
Mit einer benutzerdefinierten Integration kannst du Mitarbeiterinformationen mit einem Identitätsservice synchronisieren, die Gruppenmitgliedschaft automatisieren, Backups von Beiträgen in Gruppen erstellen oder das Posten in bestimmten Gruppen anhand der Aktivität in einem anderen Service automatisieren.
Außerdem kannst du mit benutzerdefinierten Integrationen Gruppen und Chat-Bots erstellen, die in Gruppen auf Workplace und in Work Chat kommunizieren können.
Benutzerdefinierte Integrationen eignen sich für die Eigenentwicklung für dein Unternehmen (oder die maßgeschneiderte Entwicklung für die alleinige Nutzung durch einen einzelnen Workplace-Kunden). Wenn du ein anderes Ziel verfolgst (beispielsweise wenn du eine SaaS- oder PaaS-Integration für mehrere Workplace-Kund*innen anbieten möchtest), solltest du stattdessen Drittanbieter-Apps verwenden.
Die für benutzerdefinierte Integrationen generierten Zugriffsschlüssel sind nicht mit dem*der Nutzer*in verknüpft, der*die den Schlüssel generiert hat. Folglich laufen Zugriffsschlüssel nicht ab und werden nicht ausgetauscht, wenn Nutzer*innen entfernt oder deaktiviert werden. Zugriffsschlüssel bleiben so lange gültig, bis sie von einem*einer Workplace-Administrator*in manuell ausgetauscht werden, oder die benutzerdefinierte Integration deaktiviert wird.
Erstellen von Apps für Workplace
Die Graph API und die Account Management API für Workplace sind öffentlich verfügbare APIs. Jeder Entwickler, der sich mit REST-basierten APIs auskennt, kann diese aufrufen. Der Zugriff auf diese APIs wird durch Apps mit bestimmten Berechtigungen und Zugriffsschlüsseln gesteuert.
Nur Systemadministratoren einer Workplace-Community können in dieser Community Apps erstellen und Zugriffsschlüssel generieren.
Apps und Seiten
Mit einer benutzerdefinierten Integration werden zwei Objekte erstellt:
- Eine App mit bestimmten Berechtigungen, die auf dem Bildschirm „App bearbeiten“ definiert werden.
- Eine Seite des Typs „Bot“, die nur in deiner Workplace-Community sichtbar ist. Der Seitenname spiegelt den Namen deiner benutzerdefinierten Integration wider. Das Profilbild entspricht dem Symbol, das du beim Erstellen deiner benutzerdefinierten Integration ausgewählt hast.
Ein Token für die benutzerdefinierte Integration wird generiert und angezeigt, wenn du deine benutzerdefinierte Integration erstellst. Mit diesem Token kannst du Beiträge als deine Seite lesen und schreiben.
Erstellen benutzerdefinierter Integrationen
So erstellst du eine App für Workplace:
- Öffne im Administrationsbereich den Tab Integrationen.
- Klicke auf den Button App erstellen.
- Wähle einen passenden Namen und eine Beschreibung für die App aus.
- Füge ein Profilbild für die App hinzu. Mit diesem Bild wird die App an allen passenden Stellen visuell dargestellt, beispielsweise beim Posten eines Beitrags in einer Gruppe.
- Wähle die erforderlichen Berechtigungen für die App, je nach den benötigten Integrationsfunktionen.
- Kopiere den angezeigten Zugriffsschlüssel und speichere ihn an einem sicheren Ort. Du benötigst diesen Schlüssel für API-Aufrufe.
Mehr dazu
Mehr über das Erstellen von Apps für Workplace oder die möglichen Anwendungsfälle für benutzerdefinierte Integrationen erfährst du in den folgenden Leitfäden.