Guia de complementos do Pumble
As integrações do Pumble conectam perfeitamente diversas ferramentas de software (como Google Drive, Calendly, Polls e GitHub), facilitando a colaboração no seu espaço de trabalho. Ao consolidar todas as suas ferramentas essenciais, o Pumble reduz etapas desnecessárias e simplifica os fluxos de trabalho, criando um trabalho em equipe eficaz.
Este guia orientará você pelos conceitos básicos das integrações do Pumble, desde encontrar e adicionar complementos até entender sua funcionalidade.
| Tipo de assinatura | Número máximo de complementos |
|---|---|
| Assinatura gratuita | Até 3 complementos |
| Plano Pro | Até 10 complementos |
| Planos Business e Enterprise | Até 10 complementos |
Apenas proprietários e administradores podem instalar aplicativos. Se o seu espaço de trabalho tiver a aprovação de solicitação de aplicativos ativada, os membros podem solicitar uma instalação, e um proprietário ou administrador pode aprová-la ou recusá-la.
Tipos de complementos #
O Pumble suporta diferentes tipos de complementos. A forma como um aplicativo é construído determina sua instalação, gerenciamento e interação dentro do seu espaço de trabalho.
Encontrar e adicionar complementos #
Explore o Diretório de Aplicativos do Pumble ou navegue pelo CAKE.com Marketplace para encontrar e adicionar complementos ao seu espaço de trabalho:
- Clique nos três pontos ao lado do nome do seu espaço de trabalho
- Passe o mouse sobre Configurações do espaço de trabalho
- Clique em Configurar aplicativos
- Clique no botão Instalar ao lado do aplicativo que você deseja adicionar
- Clique em Permitir na tela de consentimento para concluir a ação
Você pode ser redirecionado para um site externo (o site desse aplicativo) para permitir a instalação do aplicativo.
Outra forma de instalar complementos para o Pumble é através do Marketplace da CAKE.com. Veja como:
- Clique nos três pontos ao lado do nome do seu espaço de trabalho
- Passe o mouse sobre Configurações do espaço de trabalho
- Clique em Configurar aplicativos
- Clique em Explorar o Marketplace
- Selecione o complemento que deseja instalar
- Clique em Instalar e permita a solicitação de acesso
Após a instalação do complemento, a autorização é concedida automaticamente. Assim que um aplicativo for instalado, outros usuários do espaço de trabalho devem ir para Configurações do espaço de trabalho > Configurar aplicativos e clicar em Autorizar para ativar o aplicativo para uso individual. A opção Autorizar está disponível apenas para aplicativos já instalados no espaço de trabalho.
Solicitar instalação de aplicativo #
Quando a opção Solicitada aprovação de aplicativo estiver ativada, os membros poderão enviar solicitações de instalação para análise.
Para ativar as solicitações de aplicativos:
- Clique nos três pontos ao lado do nome do seu espaço de trabalho
- Passe o mouse sobre Configurações do espaço de trabalho
- Clique em Configurar aplicativos
- Selecione a guia Configurações
- Marque a caixa ao lado de Permitir que os membros solicitem aplicativos para aprovação
Quando essa configuração estiver ativada, os membros poderão solicitar instalações seguindo estas etapas:
- Clique nos três pontos ao lado do nome do seu espaço de trabalho
- Passe o mouse sobre Configurações do espaço de trabalho
- Clique em Configurar aplicativos
- Encontre o aplicativo e clique em Instalar
- Revise as permissões necessárias para o aplicativo
- Adicione uma mensagem para o aprovador
- Clique em Enviar solicitação
Criar seu próprio complemento do zero #
Para criar seu próprio aplicativo do zero, siga estas etapas:
- Clique nos três pontos ao lado do nome do espaço de trabalho
- Passe o mouse sobre Configurações do espaço de trabalho
- Clique em Configurar aplicativos
- Clique em Criar aplicativo
- Clique em Criar do zero
6. Forneça os detalhes em Exibir informações na caixa de diálogo:
- Enter App name
- Envie o Avatar do aplicativo
- Insira uma Descrição sobre seu aplicativo
7. Configure as Configurações do aplicativo:
- Selecione Escopos de usuário e Escopos de bot na lista suspensa
- Selecione um Evento na lista suspensa
- Opcional: Ative a opção Modo Socket se quiser que seu aplicativo se conecte via modo Socket
8. Clique em Criar aplicativo
9. Anote as credenciais do seu aplicativo
10. Clique em Instalar aplicativo
O sistema exibirá o token de Usuário e o token de Bot.
11. Clique em Fechar
O aplicativo criado será adicionado à lista de aplicativos.
Os escopos de permissão do complemento #
Cada complemento possui escopos de permissão específicos, detalhando as informações que ele pode acessar e como essas informações podem ser usadas. Os escopos podem estar relacionados à publicação de mensagens, à execução de ações e ao acesso a informações. Esteja ciente de quais informações o aplicativo pode acessar e o que ele pode fazer com as informações acessadas, como publicar mensagens, modificar conteúdo ou criar canais.
Existem dois tipos de escopos:
- Escopo de usuário
- Escopo de bot
O escopo de usuário significa que o complemento pode realizar ações em nome dos usuários. Se o aplicativo tiver um escopo de bot, uma vez instalado, o bot do complemento será adicionado ao seu espaço de trabalho do Pumble como um novo usuário.
Para visualizar o escopo do complemento:
- Clique nos três pontos ao lado do nome do seu espaço de trabalho
- Passe o mouse sobre Configurações do espaço de trabalho
- Clique em Configurar aplicativos
- Clique nos três pontos ao lado do aplicativo em questão
- Selecione Exibir escopos no menu suspenso
Trabalhar com complementos instalados #
A forma como você usa e interage com um complemento depende de como ele foi construído. Algumas funcionalidades comuns incluem comandos de barra, atalhos de aplicativo e usuários de bot.
Comandos de barra #
Os comandos de barra permitem que os usuários interajam com o complemento de terceiros digitando um texto no editor de mensagens.
Para adicionar um comando de barra:
- Digite o ícone de barra / no editor de mensagens
- Selecione um comando da lista na janela pop-up
- Digite o texto adicional para o aplicativo
- Pressione Enter para concluir a ação
Você também pode acessar a lista de todos os comandos de barra disponíveis passando o mouse sobre o avatar do Bot ou nos detalhes do canal da sua conversa com o Bot.
Atalhos de complementos #
Alguns complementos oferecem atalhos para ações no Pumble. Existem dois tipos de atalhos:
- Atalhos globais
- Atalhos de mensagens
Para usar um atalho global:
- Digite o ícone de barra / no editor de mensagens
- Selecione um comando da lista na janela pop-up
- Pressione Enter para concluir a ação
Não é possível digitar texto adicional para comunicação com o aplicativo.
Para usar um atalho de mensagem:
- Clique nos três pontos para abrir o menu de mensagens
- Selecione um dos atalhos de mensagens listados
Use o ícone de barra para encontrar atalhos de aplicativos ou comandos.
Mensagens de complementos #
Certos complementos possuem bots que enviam mensagens e publicam em canais. Os bots ficam visíveis na seção Aplicativos, na parte inferior da barra lateral do Pumble.
Desinstalar um complemento #
Para desinstalar um complemento de terceiros:
- Clique nos três pontos ao lado do nome do seu espaço de trabalho
- Passe o mouse sobre Configurações do espaço de trabalho
- Clique em Configurar aplicativos
- Clique nos três pontos ao lado do aplicativo que deseja desinstalar
- Clique em Desinstalar para concluir a ação
Ao desinstalar um complemento, uma mensagem temporária aparecerá no canto inferior direito. Além disso, o chat do complemento será removido e você não poderá ver as mensagens trocadas com ele.
SDK do Pumble #
O Pumble também oferece integração com várias plataformas por meio do nosso Software Development Kit (SDK). Documentação abrangente sobre como criar um aplicativo Pumble no framework javascript pode ser encontrada aqui.