Conectando o Slack ao seu app

Conecte o Slack para enviar mensagens, responder a eventos e disparar fluxos de trabalho a partir do seu app. Escolha Slack User quando as mensagens devem aparecer em nome da pessoa que conectou o Slack, ou Slack Bot quando devem aparecer em nome de um bot que você nomeia e personaliza.

Você precisa do Builder plan ou superior para usar conectores no seu app.

O que você pode fazer

Poste em canais

Envie atualizações ou anúncios para um canal quando algo acontece no seu app.

Notifique colegas

Envie um alerta no momento em que um ticket, prazo ou limite é atingido.

Automatize atualizações

Envie resumos, lembretes e digests recorrentes do seu app de forma agendada.

Prompts de exemplo para o Slack User

Poste uma mensagem no canal #support quando um novo ticket for criado.

Envie um resumo diário das tarefas concluídas para o canal do meu time no Slack.

Me notifique no Slack quando uma venda for feita no meu app.

Prompts de exemplo para o Slack Bot

Poste uma mensagem em #deployments quando uma nova release for publicada.

Envie um lembrete a um canal quando o prazo de uma tarefa estiver chegando.

Responda a menções ao app no Slack com um resumo do meu app.

Visão rápida

Identificadores de tipo

slack (Slack User), slackbot (Slack Bot)

Modelo de autenticação

OAuth

Tipos de conector

Para criadores de apps, Para usuários do app

Configuração da conexão

Nenhuma

Guia de permissões

Escopos e permissões do Slack

Slack User

As mensagens aparecem em nome da pessoa que conectou o Slack. Ideal quando um fluxo precisa agir como uma pessoa específica.

Slack Bot

As mensagens aparecem em nome de um bot que você nomeia e personaliza. Ideal para notificações compartilhadas e atualizações automatizadas.

Você pode usar um único app do Slack para Slack User e Slack Bot. Registre o app do Slack na Base44 duas vezes, uma para cada conector, usando o mesmo Client ID e Client Secret. Garanta que o app do Slack inclua todos os escopos exigidos pelos dois conectores. Se um escopo obrigatório faltar, o conector afetado não pode ser autorizado.

Conecte o Slack User

Para criadores de apps
Para usuários do app

Conecte uma conta do Slack para os fluxos de Slack do seu app. A Base44 cuida do app OAuth, então não há nada para registrar. Comece pelo AI chat ou por Integrations → Browse no dashboard do seu app.Para conectar o Slack User:

Vá para o editor do seu app.
Descreva no AI chat o que você quer fazer com o Slack, por exemplo: Poste uma mensagem no canal #support quando um novo ticket for criado.
Revise o que o AI chat solicita em We need your permission to access.
Clique em Connect to Slack User.
Na janela do Slack, escolha seu workspace, revise as permissões e clique em Allow.

Deixe cada pessoa conectar a própria conta do Slack. Um admin do workspace registra seu app do Slack uma vez, pelas configurações do workspace ou pelo AI chat. Depois, cada pessoa conecta ao usar o recurso.

Trate seu Client Secret como uma senha. Não o compartilhe nem o inclua em capturas de tela.

Crie um app do Slack

Crie um app do Slack em api.slack.com/apps e copie o Client ID e o Client Secret dele. Solicite os escopos do Slack User que seu app precisa.

Registre sua callback URL

Adicione https://connectors.base44.com/api/oauth/callback ao seu app do Slack. Essa única URL cobre todos os apps do seu workspace, incluindo domínios personalizados.Se você configurou este conector antes de a Base44 migrar para uma callback URL única, ele ainda usa uma URI separada para cada host de app. Em Workspace Settings → Connectors, clique em View redirect URIs for your apps, selecione seu app e adicione ao seu app do Slack todas as URIs listadas em Per-app URLs (for legacy connectors).

Adicione o conector na Base44

Nas configurações do workspace, clique em Connectors em Plugins.
Em Connectors For App Users, clique em Add Connector e escolha Slack User.
Insira um Connector name, seu Client ID e seu Client Secret.
Selecione seus escopos e clique em Add Connector.

Deixe as pessoas conectarem

Peça ao AI chat para adicionar o recurso do Slack ao seu app. Cada pessoa conecta a própria conta na primeira vez que usa, e seu app age como essa pessoa no Slack.

Conecte o Slack Bot

Uma conexão do Slack Bot é no nível do workspace. O bot é instalado em um workspace do Slack, não na conta de uma pessoa específica.

Para criadores de apps
Para usuários do app

Conecte um bot do Slack para os fluxos de Slack do seu app. A Base44 cuida do app OAuth, então não há nada para registrar. Comece pelo AI chat ou por Integrations → Browse no dashboard do seu app.Para conectar o Slack Bot:

Vá para o editor do seu app.
Descreva no AI chat o que você quer fazer com o Slack, por exemplo: Poste uma mensagem em #deployments quando uma nova release for publicada.
Revise o que o AI chat solicita em We need your permission to access.
Clique em Connect to Slack Bot.
Na janela do Slack, escolha seu workspace, revise as permissões e clique em Allow.

Registre seu próprio app do Slack para que o bot poste pelo seu app do Slack, e não pelo da Base44. Um admin do workspace o registra uma vez, pelas configurações do workspace ou pelo AI chat.

Trate seu Client Secret como uma senha. Não o compartilhe nem o inclua em capturas de tela.

Crie um app do Slack

Crie um app do Slack em api.slack.com/apps e copie o Client ID e o Client Secret dele. Solicite os escopos do Slack Bot que seu app precisa.

Registre sua callback URL

Adicione o conector na Base44

Nas configurações do workspace, clique em Connectors em Plugins.
Em Connectors For App Users, clique em Add Connector e escolha Slack Bot.
Insira um Connector name, seu Client ID e seu Client Secret.
Selecione seus escopos e clique em Add Connector.

Deixe as pessoas conectarem

Peça ao AI chat para adicionar o recurso do Slack ao seu app. Cada pessoa autoriza o bot na primeira vez que usa, e o bot posta no workspace do Slack que ela escolher. Diferente do Slack User, as mensagens aparecem em nome do bot, não da pessoa.

Personalize a identidade do Slack Bot

Dê um nome e um ícone ao bot quando configurá-lo. O Slack Bot pode postar em canais públicos sem convite. Para canais privados, convide o bot para o canal primeiro.

Envie mensagens como "Deploy Bot" com um ícone de foguete.

Escopos e permissões do Slack

Cada conector usa os próprios escopos, e os dois conjuntos não são intercambiáveis. Selecionar um escopo do Slack User para o Slack Bot, ou o contrário, faz a conexão falhar.

Escopos do Slack User

Escopo	O que permite	Como é fornecido
`users:read`	Ver as pessoas do workspace	Always included
`users:read.email`	Ver endereços de email	Always included
`chat:write`	Enviar mensagens como a pessoa conectada	Escopos sugeridos
`channels:read`	Ver informações de canais públicos	Incluído em Additional scopes

channels:read é um escopo obrigatório para este conector funcionar e está incluído em Additional scopes. Se você removê-lo, o conector não funciona.

Escopos do Slack Bot

Escopo	O que permite	Como é fornecido
`chat:write.customize`	Definir o nome e o ícone do bot por mensagem	Always included
`chat:write.public`	Postar em canais públicos sem entrar neles	Always included
`chat:write`	Enviar mensagens como o bot	Escopos sugeridos

As listas de escopos podem mudar. Sempre revise as permissões mostradas durante o fluxo de conexão.

Use o Slack em uma backend function

Depois que o Slack está conectado, suas backend functions podem obter um access token e chamar a API do Slack diretamente. A Base44 cuida do fluxo OAuth e do armazenamento de tokens.

// Slack User: posts as the connected person
const userConn = await base44.asServiceRole.connectors.getConnection("slack");

// Slack Bot: posts as the bot
const botConn = await base44.asServiceRole.connectors.getConnection("slackbot");

Use getConnection() para uma conexão compartilhada ou getCurrentAppUserConnection() para que cada requisição use o token da pessoa conectada.

Shared connectors

Configure, faça deploy e chame uma conexão compartilhada a partir de uma backend function.

App user connectors

Obtenha o token da pessoa conectada e chame a API em nome dela.

Solução de problemas

A conexão falha com um erro de escopo inválido

Slack User e Slack Bot usam conjuntos de escopos diferentes e não podem ser misturados. Confira se você selecionou apenas os escopos listados para o conector que está configurando e se seu app do Slack solicita esses mesmos escopos.

A conexão falha com um erro de redirect URI

Confira se https://connectors.base44.com/api/oauth/callback está registrada no seu app do Slack, exatamente como mostrada. Se o conector ainda usa URLs por app, a URI no seu app do Slack deve corresponder a uma das mostradas em Per-app URLs (for legacy connectors) em View redirect URIs for your apps. Nesse caso, adicione todas as URIs listadas lá.

O bot não consegue postar em um canal privado

O Slack Bot posta em canais públicos sem convite. Para um canal privado, convide o bot para o canal primeiro.

Algumas pessoas não conseguem conectar a conta do Slack User

Se seu app do Slack não está distribuído, apenas pessoas do seu próprio workspace do Slack podem conectar. Ative a distribuição pública nas configurações do seu app do Slack.

Perguntas frequentes

Posso usar os dois conectores no mesmo app?

Sim. São conectores separados, então adicione cada um que você precisar.

Posso personalizar as mensagens do Slack?

Sim. Descreva no AI chat o formato, o conteúdo e o momento que você quer. Você também pode abrir a backend function gerada em Dashboard → Code → Functions para ajustar o conteúdo da mensagem, por exemplo usando blocks para layouts mais complexos.

Como troco ou desconecto uma conta do Slack?

Na aba Integrations do seu app, abra My integrations, encontre Slack User ou Slack Bot e clique no ícone More actions para trocar de conta, reconectar ou desconectar. Saiba mais sobre como gerenciar conectores.

Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.

Começando

Superagentes

Criando seu app

Protegendo seu app

Promovendo seu app

Conectores

Integrações

O que você pode fazer

Poste em canais

Notifique colegas

Automatize atualizações

Visão rápida

Slack User

Slack Bot

Conecte o Slack User

Conecte o Slack Bot

Personalize a identidade do Slack Bot

Escopos e permissões do Slack

Escopos do Slack User

Escopos do Slack Bot

Use o Slack em uma backend function

Shared connectors

App user connectors

Solução de problemas

Perguntas frequentes

​O que você pode fazer

Poste em canais

Notifique colegas

Automatize atualizações

​Visão rápida

Slack User

Slack Bot

​Conecte o Slack User

​Conecte o Slack Bot

​Personalize a identidade do Slack Bot

​Escopos e permissões do Slack

​Escopos do Slack User

​Escopos do Slack Bot

​Use o Slack em uma backend function

Shared connectors

App user connectors

​Solução de problemas

​Perguntas frequentes

O que você pode fazer

Visão rápida

Conecte o Slack User

Conecte o Slack Bot

Personalize a identidade do Slack Bot

Escopos e permissões do Slack

Escopos do Slack User

Escopos do Slack Bot

Use o Slack em uma backend function

Solução de problemas

Perguntas frequentes