Develop a Botpress Bot
Botpress is an on-prem, open-source chatbot-building platform for businesses.
Botpress Quick Start Guide
Integrate Rocket.Chat with Botpress following this sample
Botpress workflow
This example workflow shows how Botpress can be integrated with Rocket.Chat Omnichannel Live Chat widget.
Setup
Let us see how to set up a Botpress server and integrate it with a Rocket.Chat workspace.
Requirements
You are required to have a registered workspace and Omnichannel activated.
Install connector app
To be able to interact with the bot, you need a connector. Follow these steps to get it installed on your Rocket.Chat workspace.
Navigate to Administration > Workspace > Apps
Search and install the Botpress Connector app by Luis Hlatki
Cloning Example code
Clone the starter code and enter the directory by running
Edit the docker-compose.yml
file to remove the rocketchat
and mongo
services if you already have a running instance of Rocket.Chat.
Spin up the container with
The botpress dashboard is made available at on port
3001
visit it and configure the admin userImport the bot_lab.tgz found in the directory cloned above
Set the bot id as lab and Import bot
Click on the bot to open up then click Train chatbot at the bottom right
Create a bot and agent user
Create the following Rocket.Chat users to be used for the integration
Navigate to Administration > Workspace > Users
Create a bot user for the bot with these roles:
bot
,user
,livechat-agent
andlivechat-manager
Create an agent user with these roles
user
andlivechat-agent
Configure the Botpress Connector installed earlier in Administration > Apps > Installed > Botpress Connector > Settings with the following details:
Rocket.Chat bot username:
bot
Botpress bot id:
lab
Botpress server URL:
<http://your-botpress-server-url>
Default handover department:
GENERAL
Then Save changes
Configure Omnichannel
Navigate to Avatar Menu > Omnichannel > Departments
Create a
GENERAL
department and enable it to show on the registration form. Set thebot
user as an agentCreate an
OTHER
omnichannel department, don't enable show on the registration form and set the user agent as an agent
You should have something like below
Edit the user agent user status to available
Log in as the bot user and create a PAT (Personal Access Token) without 2 Factor Authentication and copy it. see this guide
Configure Botpress settings
Back on your botpress server dashboard, do these settings to complete. This involves setting up details about your Rocket.Chat server.
Fill in the Rocket.Chat server URL and PATH gotten from above in the
bot.config.json
file at Dashboard > Code Editor > Configurations > Current Bot > bot.config.json then Save
Update the transfer room ID with that of the desired department ID in Dashboard > Flows > Main Flow > transfer-room node
Testing the Integration
To test the integration,
Visit
http://<your Rocket.Chat server>/livechat
and start a new Live Chat conversation.Optionally you can integrate the Live Chat widget while taking into consideration the X-Frame-Options
When successful, you should see something like below
Last updated