Chatbot – Integrando o Botpress com o Rocket.Chat

Desenvolvemos esta integração com a finalidade de fazer com que um chatbot criado no Botpress responda a chats do Omnichannel do Rocket.Chat.

Primeiramente, se você ainda não viu como criar um chatbot com o Botpress e até mesmo como rodar um Botpress, sugiro que primeiro você veja os artigos abaixo, pois utilizaremos o exemplo da URA para esta integração:

docker-compose.yml para Botpress

Criando um Chatbot simples em formato de URA com o Botpress

Habilitando o App de integração no Rocket.Chat

Acesse a administração do Rocket.Chat e execute os seguintes passo:

1 – Vá para o Marketplace

2 – Procure por ligerosmart

3 – Clique em LigeroSmart Botpress

Na tela a seguir, confirme que está de acordo com os termos e políticas e clique em “Get”:

Em seguida, confirme as permissões clicando em “Agree”:

Agora preencha os campos da tela de configurações do APP:

Importante: Ao instalar o aplicativo, o próprio Rocket.Chat já cria um usuário. Basta então colocá-lo no campo Bot Username: ligerosmart-botpress.bot (Você pode associar com outro usuário se preferir)

O Botpress BOT ID, é o ID de seu Bot criado no Botpress. Você pode consultá-lo lá nas configurações de seu Bot, no próprio Botpress:

Finalmente, a URL, pode ser a URL interna de seu botpress. O ideal é realmente não expor seu bot para o mundo externo 🙂

No “Default Handover Department”, você pode colocar um departamento padrão do Omnichannel para alguns casos de transferência, porém, é raro disso acontecer.

Não esqueça de clicar em “Salvar alterações” no canto superior direito.

Ajustando o papel do usuário bot no Rocket.Chat

Agora é necessário que você ajustes o papel do usuário ligerosmart-botpress.bot para que ele efetivamente seja reconhecido como tal! Acesse a Administração, em seguida “Usuários”:

Pesquise por ligerosmart, clique no usuário LigeroSmart Botpress, em seguida em “Editar” e adicione os papeis bot e Livechat Agent:

Importante: Você vai precisar definir um e-mail para o usuário antes de conseguir salvar.

Além disso, você pode também customizar o nome do usuário e o Avatar do Bot nesta mesma tela.

Ajustes no Omnichannel

Para delegar novos chats ao Bot, você precisará ajustar uma configuração no roteamento do Omnichannel.

Acesse então Administração -> Omnichannel. Procure pela seção “Roteamento” e Habilite a opção “Atribuir novas conversas para um agente bot”:

Precisamos também ajustar o status do bot para “Disponível”. Para isso, acesse Omnichannel -> Agentes -> LigeroSmart Botpress -> Editar

Certifique a “Situação” do agente está “Disponível”, caso contrário, ajuste-a.

Testando o cenário

Finalmente, vamos acessar o Omnichannel e criar nosso primeiro departamento para realizar os testes iniciais.

Acesse Omnichannel -> Departamentos -> “+ Novo”

Preencha os campos conforme a seguir:

Importante: Não esqueça de clicar em “Adicionar” nos Agentes para adicionar o Bot neste departamento.

Clique em Salvar após o preenchimento.

Para realizar nosso primeiro teste, acesse o livechat do seu Rocket.Chat. Basta colocar “/livechat” no final do endereço do seu servidor Rocket.Chat:

https://meurocket.minhaempresa.com/livechat

Com isso concluímos este artigo.

No próximo, iremos mostrar como efetivamente realizar a transferência entre departamentos no Rocket.Chat e concluir nossa URA.