# Botpress AI integration on Definable

> Botpress is an open-source platform for building, deploying, and managing chatbots.

## What this connects

Botpress is an open-source platform for building, deploying, and managing chatbots.

Vendor: https://botpress.com/

## Tools available

**53** tools available. First 12:

- `BOTPRESS_BREAK_DOWN_WORKSPACE_USAGE_BY_BOT` — Break Down Workspace Usage By Bot — Tool to break down workspace usage by bot. Use this to get detailed usage metrics for individual bots within a workspace, such as invocation calls, storage count, or AI spend.
- `BOTPRESS_CHARGE_WORKSPACE_UNPAID_INVOICES` — BOTPRESS_CHARGE_WORKSPACE_UNPAID_INVOICES — Tool to charge unpaid invoices for a specific Botpress workspace. Use when you need to manually trigger payment for outstanding workspace invoices. Returns details of successfully charged invoices and any that failed.
- `BOTPRESS_CHECK_HANDLE_AVAILABILITY` — Check Handle Availability — Tool to check if a workspace handle is available in Botpress. Use when creating or renaming a workspace to verify the handle is not already taken. Returns availability status and suggestions for alternative handles if unavailable.
- `BOTPRESS_CREATE_ADMIN_INTEGRATION` — BOTPRESS_CREATE_ADMIN_INTEGRATION — Tool to create a new integration in a Botpress workspace via the Admin API. Use when you need to provision a new integration with configuration including name, version, code, actions, events, and channels.
- `BOTPRESS_CREATE_ADMIN_WORKSPACE` — BOTPRESS_CREATE_ADMIN_WORKSPACE — Tool to create a new workspace in Botpress via the Admin API. Use when you need to provision a new workspace for organizing bots and managing team resources. The workspace will be created under the authenticated account's ownership.
- `BOTPRESS_CREATE_BOT` — BOTPRESS_CREATE_BOT — Tool to create a new bot in a Botpress workspace via the Admin API. Use when you need to provision a new bot with optional configuration including name, code, tags, events, states, and integrations.
- `BOTPRESS_CREATE_CONVERSATION` — BOTPRESS_CREATE_CONVERSATION — Tool to create a new conversation in Botpress via the Runtime API. Use when you need to initiate a new conversation thread. The required tags must be provided according to the specific integration being used.
- `BOTPRESS_DELETE_ADMIN_WORKSPACE` — Delete Admin Workspace — Tool to permanently delete a workspace from Botpress admin. Use this to remove workspaces that are no longer needed. The deletion is irreversible and removes all associated bots and data.
- `BOTPRESS_DELETE_FILE` — Delete File — Permanently deletes a file from a Botpress bot's storage by its file ID. Use this tool to remove files that are no longer needed. The deletion is irreversible. Requires a valid file ID and the bot ID that owns the file.
- `BOTPRESS_DELETE_INTEGRATION_SHAREABLE_ID` — Delete Integration Shareable ID — Tool to delete a shareable ID for an integration installed in a Botpress bot. Use when you need to remove the human-readable identifier for a specific bot-integration crossover. This is an experimental feature used for the integrations channel sandbox.
- `BOTPRESS_DELETE_KNOWLEDGE_BASE` — Delete Knowledge Base — Permanently deletes a knowledge base from Botpress by its knowledge base ID. Use this tool to remove knowledge bases that are no longer needed. The deletion is irreversible. Requires a valid knowledge base ID and the bot ID that owns the knowledge base.
- `BOTPRESS_GET_ACCOUNT` — Get Account — Tool to get details of the authenticated account. Use after confirming valid credentials.

## Auth

Auth schemes: `API_KEY`.

## How agents use Botpress

Inside a Definable workflow, Botpress is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Botpress** — the Researcher (GPT-5.5) pulls context from Botpress (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Botpress** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Botpress (create record, post message, draft email).
- **Designer / Engineer → Distributor → Botpress** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Botpress (attach file, open PR comment, post status).

The Verifier checks every Botpress call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- ai chatbots — https://definable.ai/apps/category/ai-chatbots/
- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/botpress/
- Same category (ai chatbots): https://definable.ai/apps/category/ai-chatbots/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt