# Botpress

## Installing Botpress

To start your Botpress integration, you need to have your own instance up and running. There are three ways of doing that:

* Download and install an [Open Source](https://botpress.com/download) instance of Botpress. You will find all the information needed to have an online instance ready to go on the website. If you don't know how to use docker composer, we will provide a step-by-step guide soon.
* Go with the [paid version](https://botpress.com/pricing) of Botpress – fees are project- and user-based. In that case, hosting will be provided by Botpress.
* Go with Virbe – we can set it all up for you! Just contact us and let us know what your needs are! We will give you custom pricing for that.&#x20;

## Botpress setup for Virbe: virbe-payload module

Once you have a Botpress instance up and running, in order to make it work with Virbe payload, you need to download a [plugin file](https://drive.google.com/file/d/1Vnae-6WVBsM7k3kweXF18hu2ulssh58A/view?usp=sharing) and import it into the Botpress admin panel as a new module.

![Upload module in the Botpress admin panel](/files/n2PqonRlXfjZKEHzOLfY)

![The module has to be enabled](/files/lQ8kCjiia2hFKtShuSJu)

## Create your first chatbot

Now, you're ready to create your first chatbot. You can either create a new chatbot from scratch or import an existing project.&#x20;

![Start from scratch or import an existing project](/files/bLX9BgeZkVxXCwTb7JBT)

![Pick a name and a unique ID for your chatbot](/files/m69579VSS50sN4AAB7IV)

## How to design conversation flow with Botpress?

Once you have your bot ready for "data and text input" we suggest you [see our last webinar](https://youtu.be/ic-yt0m7mHY) where one of our experts gives an excessive tour through the Botpress dashboard.&#x20;

**Conversation design process**

{% embed url="<https://youtu.be/ic-yt0m7mHY>" %}

**Working with Botpress**

{% embed url="<https://youtu.be/ic-yt0m7mHY?t=2354>" %}

If you want to learn more you can go directly to [Botpress youtube channel with tutorials](https://www.youtube.com/c/Botpress/playlists).

## Connect your chatbot to Virbe Hub

To connect your Botpress project to Virbe Hub, copy the configuration information of your selected chatbot in Botpress and paste it in Virbe Hub:

* "Botpress Origin" - your Botpress instance URL
* "Botpress Bot ID" - your chatbot's unique ID

![Botpress origin](/files/tPxYuVGL9qA9Cns14gZ8)

![Bot ID](/files/UJoxR1ib560UdW3uZQZs)

![Paste information to Virbe dashboard](/files/W0oVZeBrD6XMD5iOgX8g)

## All set! You can deploy and test your being!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.virbe.ai/dashboard-management/other-conversational-engines/botpress.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
