Skip to main content

Documentation Index

Fetch the complete documentation index at: https://botpress.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

You can inspect your agent’s behaviour in the Inspect section of your agent’s menu. Here’s a breakdown of each sub-section:

​
Logs

You can view logs from all your agent’s conversations in the Logs sub-section. This includes system logs that provide updates on your agent’s status, as well as logs from any integrations you have installed:
Logs
You can filter logs by date and time to narrow down your search for a specific event or conversation.

​
Custom logs

You can add custom logs when writing code in Studio—just use JavaScript’s console.log: 
console.log('An error occured.')
Once you’ve published your changes, your bot will print that statement to its logs every time the code executes.

​
Events

Events represent what happens within your bot, such as messages from users and system-level occurrences. You can view all incoming events processed by your agent in the Events section:
Events
An event is any action that triggers bot activation. Only incoming messages & events that a bot listens to count towards your event quota.The following actions count as an incoming message & event:
  • A user saying “Hello” to a bot
  • A reaction being added to a message
  • A Trigger that opens the bot
  • A session timeout event
  • Opening the bot’s shareable URL
  • Publishing your bot (counts as 3 events)
The following actions don’t count as an incoming message & event: ‍
  • A message sent by the bot in response to a user message
  • An execute code card
  • Workflow transitions

​
Event data

Select any event to view a detailed JSON representation of all its associated data:
Event JSON data

​
Quota

Incoming events count towards your plan’s Incoming Messages & Events quota. If you need to increase this quota, go to the Billing section.

​
Files

You can view all files uploaded to your agent in the Files section. This includes:

​
Inspect file data

Select any file to view a detailed JSON representation of all its associated data:
File JSON data

​
View a file

To view a file, select it and open its URL.

​
Download a file

To download a file, select to open additional options, then Download.

​
Delete a file

To delete a file, select to open additional options, then Delete.

​
Quota

Any files you store count against your File Storage quota. You can increase your quota in your dashboard’s Billing menu.

​
Issues

You can view any problems or errors your agent encountered in the Issues sub-section:
Issues
The Category field tells you where the issue came from, while the Events field tells you how many times it occurred. Select any issue to view a list of all occurrences:
Issue events
This gives you detailed information about each occurrence, like:
  • Its payload
  • The associated user and conversation IDs
  • The channel or integration on which it occurred
Last modified on May 15, 2026