Personalizar o bot de chat
Este guia mostra-lhe como reformular a aplicação do bot do lado do fornecedor sem sair do Control Center.
Pré-requisitos
Secção intitulada “Pré-requisitos”- O papel
ownerouadminno espaço de trabalho - Um fornecedor ligado. A linha Personalizar o bot só aparece depois de o espaço de trabalho estar ligado
- Uma aplicação que o Control Center consiga gerir. No caso do Slack, isso significa que a ligação guarda um token de renovação da configuração da aplicação (
xoxe-…); se não guardar, a linha diz isso mesmo e permanece desativada
O que pode alterar
Secção intitulada “O que pode alterar”| Campo | Significado | Limite |
|---|---|---|
| Nome da aplicação | Como o fornecedor lista a aplicação | 1–35 caracteres |
| Nome de apresentação do bot | O que os membros escrevem após @ |
1–80 caracteres |
| Descrição | Uma linha que o fornecedor mostra | 140 caracteres ou menos |
| Descrição do agente | Mostrada acima de uma mensagem direta com o bot | 300 caracteres ou menos |
| Comando slash | O comando que os membros invocam, sem a barra | Em minúsculas, apenas a–z 0–9 _ -, truncado a 32 caracteres |
| Mensagens diretas | Se o bot expõe a experiência de mensagens diretas/agente | Ligado ou desligado |
O Control Center valida os quatro campos de texto antes de contactar o fornecedor, por isso recebe «o nome da aplicação tem de ter entre 1 e 35 caracteres» em vez de um opaco invalid_manifest vindo de um servidor que não consegue ver. O comando não é rejeitado, mas sim normalizado: uma barra inicial é removida, o resto passa a minúsculas, tudo o que esteja fora de a–z 0–9 _ - é descartado e um resultado vazio recorre a cc.
Editar o bot
Secção intitulada “Editar o bot”- Vá a Definições → Espaço de trabalho → Geral e desloque-se até ao cartão Pontes de chat
- No bloco do fornecedor, clique em Personalizar o bot
- A caixa de diálogo abre com os valores em direto da aplicação, lidos do fornecedor — por isso, o ponto de partida é uma alteração que alguém tenha feito na própria interface do Slack
- Edite o que precisar e guarde
Ler esses valores em direto custa uma rotação de token do lado do Slack, e é por isso que a linha exige um clique deliberado em vez de ser algo que a página faz ao carregar.
A escrita sobrepõe as suas alterações à definição atual da aplicação. Tudo o que o Control Center não modela — um segundo comando slash que tenha adicionado no Slack, um passo de fluxo de trabalho, uma definição não relacionada — sobrevive intacto. Os âmbitos e os eventos são adicionados por junção, nunca retirados.
Depois de guardar, o Control Center volta a ler a identidade do bot para que o nome nas definições corresponda ao nome na aplicação de chat.
Reinstalar quando as permissões mudam
Secção intitulada “Reinstalar quando as permissões mudam”Quando guardar altera permissões, a caixa de diálogo mantém-se aberta e diz «O Slack alterou as permissões da aplicação. Reinstale-a para que passem a valer.», com um botão Reinstalar a aplicação que abre a página de instalação na equipa do Slack para essa aplicação. No Slack, isso é Install App → Reinstall to Workspace.
Renomear o comando slash
Secção intitulada “Renomear o comando slash”Altere Comando slash e guarde. A ponte passa então a escrever instruções com o comando com que foi invocada pela última vez, por isso o texto de ajuda e as instruções de ligação acompanham a renomeação em vez de nomearem um comando que já não existe.
A renomeação não quebra as threads já ligadas: as threads têm como chave a conversa, não o comando.
O que o Control Center não altera
Secção intitulada “O que o Control Center não altera”- Definições estruturais. O transporte (Socket Mode), os âmbitos necessários e as subscrições de eventos são impostos, não oferecidos. Uma aplicação que pode ser configurada até ao silêncio a partir de um ecrã de definições é um pedido de assistência, não uma funcionalidade
- O ícone do bot. Só as definições da própria aplicação do fornecedor o podem alterar, e a caixa de diálogo diz isso
- As migrações de funcionalidades do próprio fornecedor. Uma aplicação que já esteja na forma legada de assistente do Slack mantém-na; esta caixa de diálogo edita uma descrição, não migra uma aplicação
Resolução de problemas
Secção intitulada “Resolução de problemas”Não existe nenhuma linha Personalizar o bot
Secção intitulada “Não existe nenhuma linha Personalizar o bot”O espaço de trabalho ainda não está ligado. A linha só aparece depois de o bloco do fornecedor mostrar uma ligação ativa. Consulte Configurar a integração com o Slack.
A linha Personalizar o bot está desativada
Secção intitulada “A linha Personalizar o bot está desativada”A ligação não tem credencial de gestão da aplicação — o subtítulo da linha diz «O Control Center precisa de um token de configuração da aplicação para editar o bot. Volte a ligar incluindo um.». Para o Slack, gere um par de tokens de configuração da aplicação em api.slack.com/apps e volte a ligar com o token de renovação preenchido. Isto é o esperado numa aplicação criada à mão ou através de Criar no Slack, porque o Slack nunca informa qual foi a aplicação que criou.
«O Control Center não sabe qual é a aplicação a editar»
Secção intitulada “«O Control Center não sabe qual é a aplicação a editar»”A ligação guardada não tem id de aplicação — tipicamente uma aplicação ligada à mão antes de haver um id registado. Volte a ligar o espaço de trabalho ou crie a aplicação a partir do Control Center.
O novo nome do bot ainda não apareceu no chat
Secção intitulada “O novo nome do bot ainda não apareceu no chat”Os fornecedores colocam os metadados da aplicação em cache durante um curto período. Se o nome continuar desatualizado após um minuto, verifique se ao guardar lhe foi pedido que reinstalasse a aplicação.