Como construir um bot frouxo

O Slack mudou fundamentalmente a maneira como os funcionários de equipes, escritórios e organizações inteiras se comunicam e colaboram. Existem inúmeras maneiras de personalizar o Slack da sua empresa, mas, além de usar os canais, arquivos GIF, integrações de aplicativos e emojis de reação, a maneira mais dinâmica de aprimorar sua experiência no Slack é usando bots.

Parte da interface do chatbot e parte do mecanismo de ação automatizado, os bots do Slack têm muitos usos em potencial. Dentro de um canal específico, os mais de 100 bots atualmente disponíveis no Diretório de Bots do Slack podem criar qualquer coisa, desde um formulário de pesquisa, pesquisa ou acompanhamento de tempo até análise de mensagens, pedidos de almoço e recomendações de restaurantes - tudo com uma mensagem direta rápida (DM) ou barra.

Muitos fornecedores de software de negócios, incluindo SurveyMonkey e Zenefits, já criaram bots que você pode ativar no Slack. Mas você não precisa esperar que outra pessoa crie o bot Slack de que sua organização precisa. Usando os recursos, a documentação e os tutoriais do desenvolvedor do Slack, você pode permitir que a empresa o guie na criação de seu próprio bot do Slack.

PCMag conversou com Amir Shevat, chefe de relações com desenvolvedores da Slack, e John Agan, gerente sênior de relações com desenvolvedores da Slack, sobre como criar um bot do Slack a partir do zero. O processo requer um conhecimento considerável dos desenvolvedores em alguns momentos, mas Shevat e Agan nos conduziram por dois cenários simples de criação de bots com os quais todas as empresas podem se relacionar: criar um bot básico de helpdesk e ativar notificações no canal. Continue lendo para obter instruções passo a passo sobre como criar seu próprio bot do Slack.

1 1. Crie um novo aplicativo Slack

Para começar, abra o menu de navegação esquerdo do seu cliente Slack e clique em "Aplicativos e integrações". No lado superior direito do Diretório de aplicativos, clique em "Compilar". Isso leva você à interface de programação de aplicativos (API) do Slack, na qual você clica em "Iniciar construção" no centro da página. Dê um nome ao seu aplicativo (neste caso, Helpdesk), escolha a equipe na qual você deseja implantar o aplicativo e clique em "Criar aplicativo".

Isso leva você para a página Informações básicas do seu aplicativo. Para uma personalização extra, role para baixo até a caixa Exibir informações na qual você pode adicionar uma descrição, alterar a cor do plano de fundo e adicionar um ícone para o seu futuro bot. Para o bot do Helpdesk, por exemplo, Agan deu ao bot o emoji do robô como seu ícone.



2 2. Escreva as mensagens do seu bot

Agora que você criou seu aplicativo, a API do Slack oferece várias opções para começar a personalizar o que ele pode fazer. Para o nosso aplicativo Helpdesk, estamos criando um bot que facilita o registro de um tíquete de suporte técnico em seu nome. Primeiro, Agan do Slack disse que você precisa escrever as mensagens que aparecerão quando um usuário digitar um comando de barra.

Na seção Mensagens do menu API do Slack, escolha a ferramenta Construtor de Mensagens. Isso fornece um código JSON pré-formatado, com um espaço para você escrever e visualizar seu texto. Para este bot, Agan digitou: "Deseja registrar este tíquete de assistência técnica?"

Quando um usuário clica em "Criar" para registrar seu ticket de suporte técnico, esta é a mensagem de confirmação que será exibida. Então, ao lado do texto, Agan adicionou o comando para: white_check_mark: para dar ao usuário do Slack uma marca de seleção verde emoji confirmando o envio de seu ticket. Assim, você escreveu o código de mensagem automatizado do seu bot. Mantenha isso à mão porque você precisará daqui a pouco.



3 3. Adicionar notificações

Agan e Shevat fizeram demonstrações separadas, mas Shevat explicou que uma das integrações de bot mais comuns que o Slack viu desde a abertura do recurso é um bot que recebe notificações de serviços de terceiros. Isso pode ser algo como um relatório de vendas semanal do Salesforce ou, nesse caso, da plataforma de helpdesk para a qual seu bot está criando tickets.



4 4. Ative webhooks de entrada

Para adicionar notificações ao seu bot do Helpdesk (o Shevat demonstrou essas etapas com um exemplo separado chamado "ReportBot"), primeiro você precisa habilitar os Webhooks de entrada. Um Webhook é um retorno de chamada HTTP simples que publica uma mensagem em uma URL quando uma ação específica é acionada.

Para fazer isso, volte para a página Informações básicas da sua API do Slack. A primeira caixa diz "Adicionar recursos e funcionalidade". Escolha a opção "Webhooks de entrada". No lado superior direito da página Ativar Webhooks de entrada, há um botão deslizante. Clique nele para alternar o botão de Desativado para Ativado.



5 5. Autorizar notificações de canal

Depois que o Webhooks estiver ativado, role para baixo e clique em "Adicionar novo Webhook à equipe". Você será solicitado a escolher o canal no qual deseja que seu bot publique notificações automáticas. Neste exemplo, a Shevat escolheu #general, mas nesse caso, convém postar essa notificação na equipe de suporte técnico ou no canal do departamento de TI. Portanto, não apenas um novo ticket será criado em sua plataforma de suporte técnico, mas uma notificação automática será enviada ao canal Slack do departamento de TI para notificá-los sobre o ticket. Depois de escolher seu canal, clique em "Autorizar".



6 6. Personalize seu Webhook

Depois de autorizado, você verá um URL básico do Webhook na página e um botão para copiá-lo. Acima disso, está o seu exemplo de solicitação de curvatura, que você pode copiar para um editor de texto para dizer o que quiser. Nesse cenário, em vez de "Olá, mundo", convém escrever em "Novo ticket enviado para o suporte técnico" ou o que quer que descreva com precisão as notificações que você deseja que seu bot envie. A partir daqui, você pode pegar o código de solicitação de ondulação e o URL do Webhooks e executá-lo em qualquer script. Você precisará desse código na próxima etapa também.



7 7. Crie seu bot

Agora que você já escreveu seu código de mensagem e o URL do Webhooks, está pronto para criar seu bot. A maioria das integrações do Slack exige que um servidor responda e inicie solicitações, principalmente quando estão envolvidos comandos automatizados de lógica de bot e barra. O Slack suporta vários fornecedores, mas Agan criou o bot do helpdesk usando um serviço chamado Glitch.

Esta etapa requer alguns conhecimentos de codificação. Agan criou um novo projeto Glitch e começou a adicionar um código JavaScript de código aberto. Se você não quiser escrever todo o código (ou reinventar a roda), poderá escolher entre inúmeras estruturas e bibliotecas de bot para importar sua lógica básica de bot.

Agan nomeou seu projeto "Index.js", adicionou um pacote que ele mesmo criou chamado TinySpeck e colou no código do Message Builder que escrevemos anteriormente. Com o código bot principal agora em vigor, ele simplesmente adicionou um comando de retorno de chamada para acionar um novo ticket e a mensagem de confirmação "Um ticket de assistência técnica foi criado". É isso aí. Se você deseja adicionar o código do Webhooks para acionar uma notificação no canal que você designou, cole-o aqui também. O Glitch cria um URL exclusivo para o seu servidor de bot, então copie esse URL depois de adicionar todo o seu código e seguirmos para a próxima etapa.



8 8. Ativar mensagens interativas

Você já criou seu bot do Helpdesk; agora, tudo o que você precisa fazer é voltar para a API. Em vez de escolher "Criar novo aplicativo", basta clicar em "Gerenciar aplicativos" e escolher o aplicativo Helpdesk. Na página Informações básicas, escolha "Mensagens interativas" na caixa Adicionar recursos e funcionalidade. Uma vez nessa página, clique em "Ativar mensagens interativas", cole o URL do servidor na etapa anterior e salve as alterações.



9 9. Crie um comando barra

Feito isso, volte para a caixa Adicionar recursos e funcionalidade e entre em Slash Commands. Clique em "Criar novo comando". Isso leva você a uma página de formulário com alguns campos.

Na caixa Comando, digite seu comando de barra. Nesse caso, Agan digitou "/ helpdesk". No campo URL da solicitação, ele colou na mesma URL do servidor da Glitch. Em seguida, basta inserir uma descrição curta para o comando ("Criar um ticket de suporte técnico"), uma dica de uso de como o usuário deve digitar sua solicitação, verifique a visualização abaixo para garantir que tudo esteja correto e clique em Salvar.



10 10. Instale seu aplicativo

O bot do Helpdesk está pronto para o rock. De volta à página principal da API do seu aplicativo, acesse a página Instalar aplicativo, que pode ser encontrada no menu Configurações do lado esquerdo. Clique em "Instalar aplicativo para sua equipe". Isso solicitará que você autorize o aplicativo. Depois de fazer isso, seu bot estará ativo. Você verá um "Sucesso!" Verde fita de notificação no topo da tela que confirma que seu bot está instalado.



11 11. Dê uma olhada no seu bot

De volta ao cliente Slack de sua equipe, vá para o canal em que você designou para colocar seu novo bot em funcionamento. Digite o comando barra com uma consulta, por exemplo: "/ helpdesk, meu Wi-Fi está quebrado." Você será solicitado a pressionar um botão para criar um tíquete de suporte técnico. Parabéns; você acabou de criar um bot Slack funcional!