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
Plan Pro	Up to 10 addons
planes Business y Enterprise	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. Haz clic en tres puntos next to your Workspace name
2. Pasa el cursor sobre Configuración del espacio de trabajo
3. Haz clic en Configuración de aplicaciones
4. Haz clic en Instala button next to the app you want to add
5. Click Allow on the consent screen to complete the action

Es posible que seas redirigido a un sitio web externo (el sitio web de esa aplicación) para permitir la instalación de la aplicación.

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

1. Haz clic en tres puntos next to your Workspace name
2. Pasa el cursor sobre Configuración del espacio de trabajo
3. Haz clic en Configuración de aplicaciones
4. Haz clic en Browse Marketplace
5. Select the addon you want to install
6. Haz clic en Instala 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 #

Para crear tu propia aplicación, sigue estos pasos:

1. Haz clic en tres puntos next to your Workspace name
2. Pasa el cursor sobre Configuración del espacio de trabajo
3. Haz clic en Configuración de aplicaciones
4. Haz clic en Create app
5. Rellena el formulario para completar la acción

Después de enviar el formulario completo, nuestro equipo pondrá en contacto contigo de inmediato.

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.

Hay dos tipos de alcances:

• Alcance del usuario
• Alcance del bot

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. Haz clic en tres puntos next to your Workspace name
2. Pasa el cursor sobre Configuración del espacio de trabajo
3. Haz clic en Configuración de aplicaciones
4. Haz clic en tres puntos junto a la aplicación en cuestión
5. Selecciona Ver alcances del menú desplegable

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.

Comandos de barra diagonal #

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

Para añadir un comando de barra diagonal:

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. Pulsa enter para completar la acción

También puedes acceder a la lista de todos los comandos de barra disponibles si pasas el cursor sobre el avatar del Bot o en los detalles del canal de tu conversación con el Bot.

Addon shortcuts #

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

• Atajos globales
• Atajos de mensajes

Para utilizar un atajo global:

1. Type slash icon / in the message editor
2. Select a command from the list in the pop-up 
3. Presiona Enter para completar la acción

No es posible escribir texto adicional para comunicarse con la aplicación.

Para usar un atajo de mensaje:

1. Haz clic en three dots to open a message menu
2. Selecciona uno de los atajos de mensajes enumerados 

Utiliza el ícono de barra diagonal para buscar accesos directos a aplicaciones o comandos de barra diagonal.

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. Haz clic en tres puntos next to your Workspace name
2. Pasa el cursor sobre Configuración del espacio de trabajo
3. Haz clic en Configuración de aplicaciones
4. Haz clic en tres puntos next to the app you want to uninstall
5. Haz clic en Desinstalar para completar la acción

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.

SDK de Pumble #

Pumble también ofrece integración con varias plataformas a través de nuestro kit de desarrollo de software (SDK) (SDK). Puedes encontrar documentación completa sobre cómo crear una aplicación Pumble en el marco de JavaScript aquí.