list_bots
List Bots
List all bots in a Botpress workspace. Returns bot names, IDs, deployment status, and timestamps. Supports pagination for workspaces with many bots.
Supported Tools
manage_state
Manage State
Get or set persistent state for a bot. State is a key-value store scoped to a conversation, user, bot, or workflow. Useful for maintaining context across interactions.
manage_files
Manage Files
List, retrieve, delete, or search files in a bot's file storage. Use **search** for semantic/RAG search across indexed knowledge base files. Use **upsert** to create or update file metadata (returns an upload URL for content upload).
list_bot_issues
List Bot Issues
List or retrieve issues reported for a bot. Issues help diagnose and track problems with bot behavior and conversation flows.
send_message
Send Message
Send a message to a conversation via the Runtime API. Supports text, image, audio, video, file, location, card, carousel, choice, and dropdown message types. The **payload** must match the expected format for the given **messageType**.
manage_table_rows
Manage Table Rows
Create, read, update, delete, upsert, or search rows in a Botpress table. Use **find** for filtered or semantic search queries. Use **upsert** for idempotent inserts using a key column.
manage_bot
Manage Bot
Create, retrieve, update, or delete a Botpress bot. Use **action** to specify the operation. For updates, provide only the fields you want to change.
list_messages
List Messages
List messages in a bot's conversations. Optionally filter by conversation ID. Returns message content, sender, timestamps, and direction (incoming/outgoing).
get_bot_analytics
Get Bot Analytics
Retrieve analytics data for a bot including conversation counts, message volumes, and user engagement metrics. Optionally filter by date range.
list_integrations
List Integrations
List available integrations in a Botpress workspace. Search by name, filter by visibility (public/private), or retrieve a specific integration by ID or name.
manage_table
Manage Table
Create, retrieve, update, delete, or list tables in a bot's structured data store. Tables are used to store custom data like user profiles, labels, or extracted content.
create_event
Create Event
Send an event to a bot for asynchronous processing. Events trigger bot workflows and can be scoped to a conversation or user. Use this to push external data or signals into a bot.
manage_user
Manage User
Create, retrieve, update, delete, or list bot users via the Runtime API. Users represent people interacting with a bot within a specific integration.
manage_conversation
Manage Conversation
Create, retrieve, or list conversations for a bot. Conversations represent exchanges between users and a bot within an integration channel. Use **get-or-create** to idempotently ensure a conversation exists.
get_bot_logs
Get Bot Logs
Retrieve activity logs for a bot. Useful for debugging, monitoring bot behavior, and auditing conversation flows.
More integrations teams use with Botpress
Slack
Slack: connect with bot OAuth or user OAuth. Send, update, delete, and schedule messages; list and cancel scheduled messages; open DMs and group DMs; manage conversations, members, files, reactions, pins, bookmarks, reminders, user groups, and user status; search messages and files with user scopes; and retrieve user, conversation, and workspace info.
Linear
Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.
GitHub
Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.
Sharepoint
Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.
Salesforce
Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.
Microsoft Outlook
Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.
Technical notes for Botpress
Build, deploy, and manage AI-powered chatbots and conversational agents. Create and configure bots, manage conversations and messages across channels (WhatsApp, Slack, Telegram), handle users and participants, and store structured data in tables. Send and receive messages in various formats (text, image, audio, video, carousel, card, dropdown). Manage knowledge base files, trigger bot events via webhooks, execute bot actions, and maintain persistent state across conversations. Administer workspaces, collaborators, integrations, analytics, logs, and issue tracking.
Frequently asked questions
Common questions about connecting Botpress to AI agents with Metorial.
Can Metorial connect Botpress to AI agents?
Yes. Metorial connects AI agents to Botpress through a governed integration layer, so teams can use the provider while keeping access controlled and observable.Does the Botpress integration work with MCP?
Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.How does Metorial control access to Botpress?
Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.Can teams trace Botpress activity from agents?
Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.