Visão geral
Um chatbot é um tipo de Integração personalizada com a qual os usuários do Workplace na sua empresa podem interagir por meio do Workchat. Com ele, é possível automatizar ações específicas e agilizar alguns processos. As possibilidades são infinitas, mas os casos de uso mais populares são abrangidos neste documento.
Nesta seção, explicaremos como criar o seu próprio bot e dividiremos as instruções em duas etapas: Como configurar um bot no Workplace e Como implementá-lo nos seus servidores.
Para obter mais detalhes sobre integrações e configurações no geral, consulte esta seção.
Como configurar um botComo configurar um chatbot no Workplace
A primeira etapa para criar um chatbot é configurá-lo no Workplace. Para isso, você precisa entrar no Workplace como um administrador que tenha a permissão para alterar as configurações da empresa e configurar integrações. Quando tiver entrado na sua conta, você poderá concluir as seguintes etapas:
Depois de ter criado o bot, você poderá configurar o restante dele.
Configuração básica
Na seção Integrações do Painel Administrativo, clique no nome do bot a ser configurado. Os detalhes básicos nos quais você precisa prestar atenção.
Esse token será enviado nas solicitações de API que o seu bot gerará para que o Workplace possa verificar se elas vêm do seu bot.
Se o bot não estiver visível, os usuários não poderão interagir com ele. Você pode ativá-lo no fim do processo quando as outras configurações estiverem definidas. No entanto, não se esqueça de fazer isso antes de lançá-lo.
Permissões
Na tela de configuração da integração, há uma seção chamada Permissões. Nela, você pode escolher a quais permissões o seu bot precisará de acesso.
Além dela, pode ser útil selecionar outras permissões das quais o seu bot pode precisar para funcionar. Por exemplo, se o bot precisar recuperar o perfil de usuários do Workplace, será necessário selecionar a permissão "Ler perfil profissional".
Webhooks
Outra seção que precisará ser configurada para um chatbot é a de Webhooks. Com os Webhooks, você poderá assinar eventos específicos e receber atualizações em tempo real. Quando houver uma alteração/evento no Workplace (por exemplo, um usuário envia uma mensagem para o seu bot), uma solicitação HTTPS POST será enviada à URL de retorno de chamada correspondente a cada aplicativo que assinou o tópico de webhook em questão.
Antes de continuar essa configuração, implemente o código do bot no seu servidor da web. Mais informações podem ser encontradas aqui.
Com esses eventos, ficaremos sabendo quando um usuário enviar uma mensagem para o nosso bot e quando ele interagir com um dos botões do bot.
Segurança
Para uma integração, a última seção da configuração é a de Segurança. Embora essa configuração não seja estritamente necessária para que o seu bot funcione, recomendamos configurá-la antes de lançar o bot para a produção.
Isso exigirá a prova e a hora da chave secreta do aplicativo quando o seu servidor enviar as solicitações de API para o Workplace a fim de garantir uma camada extra de segurança.
Como implementar um chatbot no seu servidor
A segunda etapa para criar um chatbot é implementar o código do bot no seu servidor. Para isso, você precisa implementar um código em um servidor da web próprio.
Criamos alguns exemplos de bot que podem ser copiados na íntegra, sendo necessário apenas substituir os tokens no código. Você pode encontrá-los nos links a seguir:
- Bot da Central de Suporte: bot para automatizar as solicitações da Central de Suporte enviadas pelos usuários para a TI.
- Bot de reconhecimento: bot para automatizar o reconhecimento entre os usuários.
- Bot de perguntas frequentes relacionadas ao RH: bot para fornecer acesso fácil a perguntas frequentes sobre RH para os seus usuários.