Personalizar o bot de chat
Este guia mostra como remodelar o app do bot do lado do provedor sem sair do Control Center.
Pré-requisitos
Seção intitulada “Pré-requisitos”- O papel
ownerouadminno espaço de trabalho - Um provedor conectado. A linha Personalizar o bot só aparece quando o espaço de trabalho está conectado
- Um app que o Control Center consiga gerenciar. No Slack, isso significa que a conexão guarda um token de refresh da configuração do app (
xoxe-…); se não guardar, a linha avisa e permanece desativada
O que você pode alterar
Seção intitulada “O que você pode alterar”| Campo | Significado | Limite |
|---|---|---|
| Nome do app | Como o provedor lista o app | 1–35 caracteres |
| Nome do bot (o que se digita após @) | O que os membros digitam após @ |
1–80 caracteres |
| Descrição curta | Uma linha que o provedor mostra | 140 caracteres ou menos |
| O que o bot diz que sabe fazer | Mostrado acima de uma mensagem direta com o bot | 300 caracteres ou menos |
| Comando | O comando que os membros invocam, sem a barra | Em minúsculas, apenas a–z 0–9 _ -, truncado em 32 caracteres |
| Mensagens diretas | Se o bot expõe a experiência de mensagem direta e de agente | Ativado ou desativado |
O Control Center valida os quatro campos de texto antes de chamar o provedor, então você recebe “the app name must be between 1 and 35 characters” em vez de um invalid_manifest opaco vindo de um servidor que você não consegue ver. O comando não é rejeitado, mas normalizado: uma barra inicial é removida, o restante passa para minúsculas, tudo o que estiver fora de a–z 0–9 _ - é descartado e um resultado vazio volta para cc.
Editar o bot
Seção intitulada “Editar o bot”- Vá em Configurações → Espaço de trabalho → Geral e role até o cartão Pontes de chat
- No bloco do provedor, clique em Personalizar o bot
- A caixa de diálogo abre com os valores ao vivo do app, relidos do provedor — então o ponto de partida é uma alteração que alguém fez na própria interface do Slack
- Edite o que precisar e salve
Ler esses valores ao vivo custa uma rotação de token do lado do Slack, e é por isso que a linha exige um clique deliberado em vez de algo que a página faz ao carregar.
A gravação sobrepõe suas alterações à definição atual do app. Tudo o que o Control Center não modela — um segundo comando slash que você adicionou no Slack, uma etapa de fluxo de trabalho, uma configuração sem relação com o assunto — sobrevive intacto. Escopos e eventos são mesclados, nunca subtraídos.
Depois de salvar, o Control Center relê a identidade do bot para que o nome nas configurações corresponda ao nome no app de chat.
Reinstalar quando as permissões mudam
Seção intitulada “Reinstalar quando as permissões mudam”Quando um salvamento altera as permissões, a caixa de diálogo permanece aberta e diz “O Slack alterou as permissões do app. Reinstale-o para que passem a valer”, com um botão Reinstalar o app que abre a página de instalação desse app no time do Slack. No Slack, isso é Install App → Reinstall to Workspace.
Renomear o comando slash
Seção intitulada “Renomear o comando slash”Altere Comando e salve. A ponte então escreve as instruções usando o comando com o qual foi invocada por último, de modo que o texto de ajuda e as instruções de vinculação acompanham a renomeação em vez de citar um comando que não existe mais.
Renomear não quebra os threads já vinculados: os threads são indexados por conversa, não por comando.
O que o Control Center não altera
Seção intitulada “O que o Control Center não altera”- Configurações estruturais. O transporte (Socket Mode), os escopos obrigatórios e as assinaturas de eventos são impostos, não oferecidos. Um app que pode ser configurado até ficar em silêncio a partir de uma tela de configurações é um ticket de suporte, não um recurso
- O ícone do bot. Só as configurações de app do próprio provedor podem alterá-lo, e a caixa de diálogo diz isso
- As migrações de recursos do próprio provedor. Um app que já está no formato de assistente legado do Slack continua nele; esta caixa de diálogo edita uma descrição, não migra um app
Solução de problemas
Seção intitulada “Solução de problemas”Não há nenhuma linha Personalizar o bot
Seção intitulada “Não há nenhuma linha Personalizar o bot”O espaço de trabalho ainda não está conectado. A linha só aparece quando o bloco do provedor mostra uma conexão ativa. Consulte Configurar a integração com o Slack.
A linha Personalizar o bot está desativada
Seção intitulada “A linha Personalizar o bot está desativada”A conexão não tem nenhuma credencial de gerenciamento de app — o subtítulo da linha diz “O Control Center precisa de um token de configuração do app para editar o bot. Reconecte incluindo um.” No Slack, gere um par de tokens de configuração do app em api.slack.com/apps e reconecte com o token de refresh preenchido. Isso é esperado em um app criado à mão ou criado via Criar no Slack, porque o Slack nunca informa qual app ele criou.
“Control Center does not know which app to edit”
Seção intitulada ““Control Center does not know which app to edit””A conexão armazenada não carrega nenhum id de app — normalmente um app conectado à mão antes de um id ser registrado. Reconecte o espaço de trabalho, ou crie o app pelo Control Center.
O novo nome do bot ainda não apareceu no chat
Seção intitulada “O novo nome do bot ainda não apareceu no chat”Os provedores fazem cache dos metadados do app por pouco tempo. Se o nome ainda estiver desatualizado depois de um minuto, verifique se o salvamento pediu para você reinstalar o app.