Integrations

Pumble Help Center Integrations Guide to Pumble Addons

Guide to Pumble Addons

5 min read
isidora.komaromi@cake.com

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 typeMaximum number of addons
Free subscriptionUp to 3 addons
Pro planUp to 10 addons
Business and Enterprise plansUnlimited 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. Click on the three dots next to your Workspace name
  2. Hover over Workspace settings
  3. Click on Configure apps
  4. Click on the Install button next to the app you want to add
  5. Click Allow on the consent screen to complete the action

You may be redirected to an external website (that app’s website) to allow the installation of the app.

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

  1. Click on the three dots next to your Workspace name
  2. Hover over Workspace settings
  3. Click on Configure apps
  4. Click on Browse Marketplace
  5. Select the addon you want to install
  6. Click 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 #

To create your own app, follow these steps:

  1. Click on the three dots next to your Workspace name
  2. Hover over Workspace settings
  3. Click on Configure apps
  4. Click on Create app
  5. Fill in the form to complete the action

After submitting the completed form, our team will promptly follow up with you.

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.

There are two types of scopes:

  • User scope
  • Bot scope

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. Click on the three dots next to your Workspace name
  2. Hover over Workspace settings
  3. Click on Configure apps
  4. Click on the three dots next to the app in question
  5. Select View scopes from the dropdown

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 commands #

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

To add a slash command:

  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. Press enter to complete the action

You can also access the list of all available slash commands if you hover over the Bot’s avatar, or in the channel details of your conversation with the Bot.

Addon shortcuts #

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

  • Global shortcuts
  • Message shortcuts

To use a global shortcut:

  1. Type slash icon / in the message editor
  2. Select a command from the list in the pop-up 
  3. Press Enter to complete the action

It is not possible to type additional text for communication with the app.

To use a message shortcut:

  1. Click on three dots to open a message menu
  2. Select one of the listed message shortcuts 

Use the slash icon to find app shortcuts or slash commands.

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. Click on the three dots next to your Workspace name
  2. Hover over Workspace settings
  3. Click on Configure apps
  4. Click on the three dots next to the app you want to uninstall
  5. Click Uninstall to complete the action

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 also offers integration with various platforms through our Software Development Kit (SDK). Comprehensive documentation on how to build a Pumble app in javascript framework can be found here.

Was this article helpful?

Thank you! If you’d like a member of our support team to respond to you, please drop us a note at support@pumble.com