Publish your integration on Botpress Hub
We're thrilled you want to publish your integration on the Botpress Hub! There is not much to do to make your integration publicly available to the other Botpress users, you're only a few steps away:
- navigate to your integration's page on the dashboard
- Whenever you integration is private, you'll see a blue banner with a Make Public button, just click on it.
- Accept the hub terms and conditions and you're good to go.
![](https://files.readme.io/f3ec409-Screenshot_2024-08-08_at_3.21.15_PM.png)
Getting your integration Verified ✅
To ensure the quality of contributions on the Botpress Hub, we've come up with the following verification process. You can follow the instructions below or follow along the video. There are four things to do, follow along in the video:
- Update your profile on Botpress Cloud.
- Update your integration's display information.
- Ensure your integration checks the configuration parameters if any.
- Prepare an example bot with your integration configured an
- Send it for approval
Your profile on Botpress Hub
When a user installs your app, your workspace information will be viewable by the user. Please ensure:
- Your Workspace has a url handle that represents you.
- You have a way for users to contact you, like an email or a website.
- Introduce yourself in the Workspace description (optional). This is the place for self-promotion.
- Add an icon to your Workspace that represents you (optional).
We suggest you create a Workspace specifically for publishing integrations, as this will make it easier to add collaborators to your workspace, and keep your production and dev environments separate.
Your integration's display information
Now we need to ensure the integration has all the assets and information it needs to be displayed on the Hub.
Your integration's integration.definition.ts file should contain:
- title: the display title of your integration for the hub. Do not include “Botpress”.
- name: your_workspace_handle/integration_handle
- description: a succinct description of what your integration does.
- icon: set this to 'icon.svg'.
- readme: set this to 'hub.md'.
Make sure to have these two files in the root of your integration folder:
- icon.svg : Use a pertinent icon related to the problem you are solving. Do not use the Botpress Icon.
- hub.md : It should contain an explanation of what the integration is, and how to use it. Self-promotion is not allowed here. Please also add a link to git repo if your integration is open source, this drastically increase your chances of getting approved.
Your integration's logic
Finally, we need to ensure your integration is robust and user-friendly.
- If your integration requires parameters to be configured: it should validate the parameters in the register method, and throw a RuntimeError if there is an issue.
import * as bpclient from "@botpress/client";
...
throw new RuntimeError(
"Configuration Error! The Mixpanel token is not set. Please set it in your bot integration configuration."
);
This RuntimeError will be shown to the user in the Botpress Studio when they try to add your integration to their bot and there is an issue.
Submitting your integration for verification
When you're done with above, we'd like to test your integration to ensure it works as expected, and that everything is in order. Whenever you're ready , just click the "Request Verification" button on the banner.
![](https://files.readme.io/3b20967-Screenshot_2024-08-08_at_3.30.44_PM.png)
To speed up the process, you can do the following proactively
- In your workspace, create a demonstration bot and configure your integration for it. We'll use this to try out the integration.
- Add
[email protected]
to your workspace with Admin privileges.
If you have any questions whatsoever, please don't hesitate to reach out to us at [email protected]!
Updated about 1 month ago