Leitfaden für Add-ons in Pumble
Die Pumble-Integrationen verbinden verschiedene Softwaretools (z. B. Google Drive, Calendly, Polls, GitHub) nahtlos und optimieren die Zusammenarbeit in deinem Arbeitsbereich. Durch die Konsolidierung all deiner essenziellen Tools reduziert Pumble unnötige Schritte und vereinfacht Workflows, wodurch eine effektive Teamarbeit entsteht.
Der Leitfaden führt dich durch die Grundlagen der Pumble-Integrationen und hilft dir, Add-ons leichter zu finden und hinzuzufügen sowie deren Funktionalität besser zu verstehen.
| Abonnement | Maximale Anzahl an Add-ons |
|---|---|
| Kostenloses Abo | Bis zu 3 Add-ons |
| Pro-Plan | Bis zu 10 Add-ons |
| Business- und Enterprise-Pläne | Unbegrenzte Anzahl von Add-ons |
Nur Besitzer und Administratoren können Apps installieren. Wenn für deinen Arbeitsbereich die App-Freigabe aktiviert ist, können Mitglieder eine Installation anfragen, die von einem Besitzer oder Administrator genehmigt oder abgelehnt wird.
Typen von Add-ons #
In Pumble werden verschiedene Typen von Add-ons unterstützt. Die Art und Weise, wie eine App entwickelt wurde, bestimmt ihre Installation, Verwaltung und Interaktion in deinem Arbeitsbereich.
Add-ons finden und hinzufügen #
Durchsuche das Pumble App-Verzeichnis oder navigiere durch den CAKE.com Marketplace, um Add-ons zu finden und deinem Arbeitsbereich hinzuzufügen:
- Klicke auf die drei Punkte neben dem Namen deines Arbeitsbereichs
- Fahre mit der Maus über Arbeitsbereicheinstellungen
- Klicke auf Apps konfigurieren
- Klicke auf die Schaltfläche Installieren neben der App, die du hinzufügen möchtest
- Klicke auf Zulassen im Zustimmungsbildschirm, um den Vorgang abzuschließen
Du wirst möglicherweise zu einer externen Website (Website der App) umgeleitet, um das Installieren der App zuzulassen.
Eine weitere Möglichkeit, Pumble Add-ons zu installieren, ist über den CAKE.com Marketplace. Hier ist die Vorgehensweise:
- Klicke auf die drei Punkte neben dem Namen deines Arbeitsbereichs
- Fahre mit der Maus über Arbeitsbereicheinstellungen
- Klicke auf Apps konfigurieren
- Klicke auf Marketplace durchsuchen
- Wähle das Add-on aus, das du installieren möchtest
- Klicke auf Installieren und gewähre die Zugriffsberechtigung
Nach der Installation des Add-ons wird die Autorisierung automatisch erteilt. Sobald eine App installiert ist, müssen andere Arbeitsbereichs-Benutzer zu Arbeitsbereichseinstellungen > Apps konfigurieren navigieren und auf Autorisieren klicken, um die App für die individuelle Nutzung zu aktivieren. „Autorisieren“ ist nur für Apps verfügbar, die bereits im Arbeitsbereich installiert sind.
App-Installation anfragen #
Wenn die Option zur Anforderung der App-Genehmigung aktiviert ist, können Mitglieder Installationsanfragen zur Überprüfung senden.
So aktivierst du App-Anfragen:
- Klicke auf die drei Punkte neben dem Namen deines Arbeitsbereichs
- Bewege den Mauszeiger über Arbeitsbereichseinstellungen
- Klicke auf Apps konfigurieren
- Wähle den Tab Einstellungen
- Aktiviere das Kontrollkästchen neben Mitgliedern erlauben, Apps zur Genehmigung anzufragen
Sobald diese Einstellung aktiviert ist, können Mitglieder wie folgt Installationen anfragen:
- Klicke auf die drei Punkte neben dem Namen deines Arbeitsbereichs
- Bewege den Mauszeiger über Arbeitsbereichseinstellungen
- Klicke auf Apps konfigurieren
- Suche die gewünschte App und klicke auf Installieren
- Überprüfe die von der App benötigten Berechtigungen
- Füge eine Nachricht für die freigebende Person hinzu
- Klicke auf Anfrage senden
Eigenes Add-on von Grund auf erstellen #
Um eine eigene App von Grund auf neu zu erstellen, gehe wie folgt vor:
- Klicke auf die drei Punkte neben dem Namen deines Arbeitsbereichs
- Fahre mit der Maus über Arbeitsbereicheinstellungen
- Klicke auf Apps konfigurieren
- Klicke auf App erstellen
- Klicke auf Von Grund auf neu erstellen
6. Gib im Dialogfenster die Anzeigeinformationen ein:
- App-Name eingeben
- App-Avatar hochladen
- Beschreibung deiner App eingeben
7. Konfiguriere die App-Einstellungen:
- Wähle die Benutzer-Berechtigungen und Bot-Berechtigungen aus der Dropdown-Liste aus
- Wähle ein Event aus der Dropdown-Liste aus
- Optional: Aktiviere den Schalter Socket-Modus, wenn sich deine App über den Socket-Modus verbinden soll.
8. Klicke auf App erstellen
9. Notiere dir deine App-Anmeldedaten
10. Klicke auf App installieren
Das System zeigt das Benutzer-Token und das Bot-Token an.
11. Klicke auf Schließen
Die erstellte App wird zur App-Liste hinzugefügt.
Berechtigungsumfänge des Add-ons #
Jedes Add-on hat bestimmte Berechtigungsbereiche, die dir darlegen, auf welche Informationen das Add-on zugreifen kann und wie die Informationen verwendet werden können. Die Bereiche können sich auf das Posten von Nachrichten, die Ausführung von Aktionen und den Zugriff auf Informationen beziehen. Du solltest beachten, auf welche Information die App zugreifen kann und was sie mit den Informationen tun kann, auf die sie Zugriff hat - z.B. Nachrichten posten, Inhalte ändern oder Kanäle erstellen.
Es gibt zwei Arten von Berechtigungsbereichen:
- Benutzerbereich
- Botbereich
Der Benutzerbereich impliziert, dass das Add-on Aktionen im Namen von Benutzern ausführen kann. Falls die App über den Botbereich verfügt, wird der Add-on-Bot nach dem Installieren zu deinem Pumble-Arbeitsbereich als ein neuer Benutzer hinzugefügt.
So kannst du den Add-on-Bereich ansehen:
- Klicke auf die drei Punkte neben dem Namen deines Arbeitsbereichs
- Fahre mit der Maus über Arbeitsbereicheinstellungen
- Klicke auf Apps konfigurieren
- Klicke auf die drei Punkte neben der ausgewählten App
- Wähle Bereiche anzeigen aus dem Dropdown-Menü
Mit installierten Add-ons arbeiten #
Die Art und Weise, wie du ein Add-on verwendest und mit dieser arbeitest, hängt davon ab, wie es erstellt ist. Übliche Funktionen sind Slash-Befehle, App-Tastenkombinationen und Bot-Benutzer.
Slash-Befehle #
Die Slash-Befehle ermöglichen Benutzern, mit Drittanbieter-Add-ons zu interagieren, indem Benutzer einen String in den Nachrichten-Editor eingibt.
So fügst du einen Slash-Befehl hinzu:
- Gib das Slash-Symbol / in den Nachrichten-Editor ein
- Wähle einen Befehl aus der Liste im Pop-up-Fenster
- Gib einen zusätzlichen Text für die App ein
- Drücke die Eingabetaste, um den Vorgang abzuschließen
Du kannst auch auf die Liste aller verfügbaren Slash-Befehle zugreifen, wenn du auf den Bot-Avatar zeigst sowie in Kanalinformationen auf deine Unterhaltung mit dem Bot zugreifen.
Tastenkombinationen für Add-ons #
Einige Add-ons bieten Tastenkombinationen für Aktionen in Pumble. Es gibt zwei Arten von Tastenkombinationen:
- Globale Tastenkombinationen
- Nachrichten-Tastenkombinationen
So benutzt du globale Tastenkombinationen:
- Gib das Slash-Symbol / in den Nachrichten-Editor ein
- Wähle einen Befehl aus der Liste im Pop-up-Fenster
- Drücke die Eingabetaste, um den Vorgang abzuschließen
Es ist nicht möglich, einen zusätzlichen Text zur Kommunikation in der App einzugeben.
So benutzt du Nachrichten-Tastenkombination:
- Klicke auf die drei Punkte, um das Nachrichten-Menü zu öffnen
- Wähle eine der aufgelisteten Nachrichten-Tastenkombinationen
Benutze das Slash-Symbol, um nach App-Tastenkombinationen oder Slash-Befehlen zu suchen.
Add-on-Nachrichten #
Einige Apps verfügen über Bot-Benutzer, die Nachrichten senden oder in Kanälen posten. Bot-Benutzer sind im Apps-Abschnitt unten in der Pumble-Seitenleiste sichtbar.
Add-on deinstallieren #
So deinstalliert du ein Drittanbieter-Add-on:
- Klicke auf die drei Punkte neben dem Namen deines Arbeitsbereichs
- Fahre mit der Maus über Arbeitsbereicheinstellungen
- Klicke auf Apps konfigurieren
- Klicke auf die drei Punkte neben der App, die du deinstallieren möchtest
- Klicke auf Deinstallieren, um die Aktion abzuschließen
Wenn du ein Add-on deinstallierst, erscheint eine Pop-up-Meldung in der unteren rechten Ecke. Außerdem wird der Add-on-Chat entfernt, und du wirst keine Nachrichten sehen können, die mit dem Add-on erstellt wurden.
Pumble SDK #
Pumble bietet auch Integrationen mit verschiedenen Plattformen durch unser Software Development Kit (SDK). Du kannst hier ausführliche Dokumentation zum Erstellen einer Pumble-App im JavaScript-Framework finden.