Workplace

Benutzerdefinierte Integrationen

Integriere Workplace mit den Workplace APIs in deinen vorhandenen Workflow. 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).

Ü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:

  1. Öffne im Administrationsbereich den Tab Integrationen.
  2. Klicke auf den Button App erstellen.
  3. Wähle einen passenden Namen und eine Beschreibung für die App aus.
  4. 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.
  5. Wähle die erforderlichen Berechtigungen für die App, je nach den benötigten Integrationsfunktionen.
  6. Kopiere den angezeigten Zugriffsschlüssel und speichere ihn an einem sicheren Ort. Du benötigst diesen Schlüssel für API-Aufrufe.

Weiterlesen

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.