Como construir um bot Slack

O Slack mudou fundamentalmente a forma como os funcionários de equipes, escritórios e organizações inteiras se comunicam e colaboram entre si. 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 evocar qualquer coisa, desde uma enquete, pesquisa ou formulário de rastreamento de tempo até análises de mensagens, pedidos de almoço e recomendações de restaurantes, tudo com uma mensagem direta rápida (DM) ou comando de barra.

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

A PCMag conversou com Amir Shevat, chefe de relações com desenvolvedores do Slack, e John Agan, gerente sênior de relações com desenvolvedores do Slack (visite o site da Zenefits), sobre como construir um bot do Slack do zero. O processo requer algum conhecimento considerável do desenvolvedor em alguns pontos, mas Shevat e Agan nos guiaram por dois cenários simples de criação de bots com os quais todas as empresas podem se relacionar: construir um bot básico de helpdesk e habilitar 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 à esquerda do seu cliente Slack e clique em "Aplicativos e integrações". No lado superior direito do Diretório de Aplicativos, clique em “Build”. Isso leva você à interface de programação de aplicativos (API) do Slack, onde você clica em "Iniciar criaçã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ê à página de informações básicas do seu aplicativo. Para 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 seu futuro bot. Para o bot do Helpdesk, por exemplo, Agan deu ao bot o emoji do robô como í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 ela pode fazer. Para nosso aplicativo Helpdesk, estamos criando um bot que facilita a apresentação de um tíquete de helpdesk 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 Criador de mensagens. Isso fornece um código JSON pré-formatado, com um espaço para você escrever e visualizar seu texto. Para esse bot, Agan digitou: "Você gostaria de registrar este tíquete de suporte técnico?"

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

3. 3. Adicionar notificações

Agan e Shevat deram 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 semanal de vendas do Salesforce (Visite o site em Salesforce.com) ou, neste caso, da plataforma de suporte técnico para a qual seu bot está criando tickets.

4. 4. Ative Webhooks de entrada

Para adicionar notificações em seu bot de Helpdesk (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 envia uma mensagem para uma URL quando uma ação específica é acionada.

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

5. 5. Autorizar Notificações do Canal

Depois que os Webhooks estiverem ativados, 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 automatizadas. Neste exemplo, Shevat escolheu #general, mas neste caso, você pode querer postar esta notificação para sua equipe de suporte técnico ou canal do departamento de TI. Assim, não apenas um novo ticket será criado em sua plataforma de helpdesk, 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

Uma vez autorizado, você verá um URL de Webhook básico na página e um botão para copiá-lo. Acima disso está sua solicitação de curl de amostra, que você pode copiar para um editor de texto para dizer o que quiser. Nesse cenário, em vez de "Hello, World", você pode escrever "New Helpdesk Ticket Enviado" ou o que descreva com precisão as notificações que você gostaria que seu bot enviasse. A partir daqui, você pode pegar seu código de solicitação curl e URL de Webhooks e executá-lo em qualquer script. Você também precisará desse código na próxima etapa.

7. 7. Construa seu bot

Agora que você tem o código da mensagem escrito e o URL do Webhooks à mão, está pronto para criar seu bot. A maioria das integrações do Slack exige que um servidor responda e inicie solicitações, principalmente quando a lógica do bot automatizado e os comandos de barra estão envolvidos. O Slack oferece suporte a vários provedores, mas Agan criou o bot de suporte técnico usando um serviço chamado Glitch.

Esta etapa requer algum conhecimento de codificação. Agan criou um novo projeto Glitch e começou a adicionar algum código JavaScript de código aberto. Se você não quiser escrever todo o código sozinho (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 construiu chamado TinySpeck e depois colou no código do Message Builder que escrevemos anteriormente. Com o código do 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 helpdesk foi criado". É isso. Se você quiser adicionar seu código de Webhooks para acionar uma notificação no canal que você designou, você também pode colá-lo aqui. 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 vamos para a próxima etapa.

8. 8. Ativar mensagens interativas

Você já criou seu bot de Helpdesk, então 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 funcionalidades. Uma vez nessa página, clique em "Ativar mensagens interativas", cole a URL do servidor da etapa anterior e salve as alterações.

9. 9. Crie um comando de barra

Feito isso, volte para a caixa Add Features and Functionality e vá para 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 de solicitação, ele colou a mesma URL do servidor de Glitch. Em seguida, basta inserir uma breve descrição para o comando ("Criar um ticket de suporte técnico"), uma dica de uso de como o usuário deve digitar sua solicitação, verificar a visualização abaixo para garantir que tudo esteja correto e clicar em Salvar .

10. 10. Instale seu aplicativo

O bot do Helpdesk agora está pronto para arrasar. De volta à página principal da API do seu aplicativo, vá para 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 verde "Sucesso!" faixa de notificação na tela que confirma que seu bot está instalado.

11. 11. Leve seu bot para dar uma volta

De volta ao cliente Slack da sua equipe, vá para o canal no qual você designou para colocar seu novo bot para funcionar. Digite o comando de barra com uma consulta, por exemplo: "/helpdesk meu Wi-Fi está quebrado". Em seguida, você será solicitado com um botão para criar um ticket de suporte técnico. Parabéns; você acabou de criar um bot Slack funcional!