Skip to content

Commit

Permalink
adds the application process for publishing integrations (#320)
Browse files Browse the repository at this point in the history
  • Loading branch information
ptrckbp authored May 23, 2024
1 parent 0ecab96 commit fa266a5
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 1 deletion.
3 changes: 2 additions & 1 deletion pages/developers/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,6 @@
"howTo":"How To",
"concepts": "Key Concepts",
"webchat": "Web Chat old",
"webchat-v2": "Web Chat v2"
"webchat-v2": "Web Chat v2",
"publishing-to-botpress-hub": "Publishing to Botpress Hub"
}
46 changes: 46 additions & 0 deletions pages/developers/publishing-to-botpress-hub.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Publish your integration on Botpress Hub

We're thrilled you want to publish your integration on the Botpress Hub! To ensure the quality of contributions on the Botpress Hub, we've come up with the following application process.

## Your profile on Botpress Hub
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.

In your Botpress Workspace's configuration:

- [ ] Make sure your Workspace has a url handle that represents you.
- [ ] Add a way for integration users to contact you, like an email or a website
- [ ] Introduce yourself in the Workspace snippet
- [ ] Add an icon to your Workspace that represents you

When a user installs the app, these may be shown to the user.


## Your integration's display information

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**: the icon of the service you are connecting to, or the problem you are solving. Do not use the Botpress Icon.
- [ ] **readme**: the name of the markdown file in the folder that contains the integration code. It should contain an explanation of what the integration is, and how to use it. Self-promotion is not allowed here.

## Your integration's logic

- [ ] 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 bpclient.RuntimeError(
"Configuration Error! The Mixpanel token is not set. Please set it in your bot integration configuration."
);
```

## Submitting your integration to our team for approval
- [ ] In your workspace, add a bot and configure your integration for it, with some example flows that demonstrate the integration's capabilities. If any external test account is used, please provide credentials.
- [ ] When you're done with these steps, add `[email protected]` to your workspace with Admin privileges and send an email to it linking to the integration you'd like to publish as well as a .bpz export of the bot that has your integration configured.

You can also send an email to [[email protected]](mailto:[email protected]) if you have any questions!

0 comments on commit fa266a5

Please sign in to comment.