Guide to Pumble Addons

Pumble’s integrations seamlessly connect various software tools (e.g., Google Drive, Calendly, Polls, GitHub), making collaboration easier within your workspace. By consolidating all your essential tools, Pumble reduces unnecessary steps and simplifies workflows, creating effective teamwork.

This guide will walk you through the basics of Pumble integrations, from finding and adding addons to understanding their functionality.

Subscription type	Maximum number of addons
Free subscription	Up to 3 addons
Pro-Plan	Up to 10 addons
Business and Enterprise plans	Unlimited number of addons

Only admins and workspace owners can install an addon. Once installed, any member (except single-channel guest users) can connect their account to use the addon.

Types of addons #

Pumble supports different types of addons. The way an app is built determines its installation, management, and interaction within your workspace.

Find and add addons #

Explore the Pumble App Directory or browse the CAKE.com Marketplace to find and add addons to your workspace:

1. Klicke auf das drei Punkte next to your Workspace name
2. Bewege den Mauszeiger über Arbeitsbereicheinstellungen
3. Klicke auf Configure apps
4. Klicke auf das Install button next to the app you want to add
5. Click Allow on the consent screen to complete the action

Du wirst möglicherweise zu einer externen Website (Website der App) umgeleitet, um das Installieren der App zuzulassen.

Another way to install Pumble Addons is through the CAKE.com Marketplace. Here’s how you can do it:

1. Klicke auf das drei Punkte next to your Workspace name
2. Bewege den Mauszeiger über Arbeitsbereicheinstellungen
3. Klicke auf Configure apps
4. Klicke auf Browse Marketplace
5. Select the addon you want to install
6. Klicke auf Install and allow access request

Upon installation of the addon, authorization is automatically granted. All the other Workspace users need to navigate to the Configure apps tab in the Workspace settings and click on Authorize to enable the app for individual use.

Create your own addon #

Um deine eigene App zu erstellen, solltest du diesen Schritten folgen:

1. Klicke auf das drei Punkte next to your Workspace name
2. Bewege den Mauszeiger über Arbeitsbereicheinstellungen
3. Klicke auf Configure apps
4. Klicke auf Create app
5. Fülle das Formular aus, um die Aktion abzuschließen

Nach der Einreichung des ausgefüllten Formulars wird unser Team umgehend mit dir in Kontakt treten.

The addon permission scopes #

Each addon has specific permission scopes, detailing the information it can access and how that information can be used. Scopes can be related to posting messages, performing actions, and accessing information. Be aware of which information the app can access and what it can do with the information it accesses, such as posting messages, modifying content, or creating channels.

Es gibt zwei Arten von Berechtigungsbereichen:

• Benutzerbereich
• Botbereich

User scope implies that the addon can perform actions on behalf of users. If the app has a Bot scope, once installed, the addon Bot will be added to your Pumble workspace as a new user.

To view the addon scope:

1. Klicke auf das drei Punkte next to your Workspace name
2. Bewege den Mauszeiger über Arbeitsbereicheinstellungen
3. Klicke auf Configure apps
4. Klicke auf das drei Punkte next to the app in question
5. Wähle Bereiche anzeigen aus dem Dropdown-Menü

Working with installed addons #

How you use and interact with an addon depends on how it was built. Some common features include slash commands, app shortcuts, and bot users.

Slash-Befehle #

Slash commands allow users to interact with the third-party addon by typing a string into the message editor. 

So fügst du einen Slash-Befehl hinzu:

1. Type slash icon / in the message editor 
2. Select a command from the list in the pop-up 
3. Type an additional text for the app
4. 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.

Addon shortcuts #

Some addons offer shortcuts for actions in Pumble. There are two types of shortcuts:

• Globale Tastenkombinationen
• Nachrichten-Tastenkombinationen

So benutzt du globale Tastenkombinationen:

1. Type slash icon / in the message editor
2. Select a command from the list in the pop-up 
3. Drücke Eingabetaste , um den Vorgang abzuschließen

Es ist nicht möglich, eine zusätzlichen Text zur Kommunikation in der App einzugeben.

So benutzt du Nachrichten-Tastenkombination:

1. Klicke auf three dots to open a message menu
2. Wähle eine der aufgelisteten Nachrichten-Tastenkombinationen 

Benutze das Slash-Symbol, um nach App-Tastenkombinationen oder Slash-Befehlen zu suchen.

Addon messages  #

Certain addons have bots that send messages and post in channels. Bots are visible in the Apps section at the bottom of your Pumble sidebar.

Uninstall an addon #

To uninstall a third-party addon:

1. Klicke auf das drei Punkte next to your Workspace name
2. Bewege den Mauszeiger über Arbeitsbereicheinstellungen
3. Klicke auf Configure apps
4. Klicke auf das drei Punkte next to the app you want to uninstall
5. Klicke auf Deinstallieren, um den Aktion abzuschließen

When you uninstall an addon, a toast message will appear in the bottom right corner. Also, the addon chat will be removed, and you won’t be able to see messages with the addon.

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.