Botpress integration for Dimension Labs
This brings in your Botpress bot conversations, message by message: what each user wrote and what the bot answered. Each Botpress conversation becomes one conversation. You run it on your side: a small script pulls from the Botpress API and posts each message to the universal API.
- Platform
- Botpress
- Type
- Chat, messaging and AI agents
- Connects by
- Universal API
- Setup
- 5 steps
- Guide checked
- 2026-10-26, against Botpress's documentation
Every Botpress message, in the same shape as everything else.
Each record lands in the Dimension Labs conversation format, so Dimensions, reports and the agent work the same way as for every other source.
payload.text text Skip messages without text (images, cards).
userId of the conversation's incoming messages userId The end user's Botpress id. The bot's messages can carry a different userId, so use the end user's on both sides. Fall back to the sessionId.
direction incoming true for incoming, false for outgoing.
conversationId sessionId Prefix it, for example botpress-.
conversationId conversationId Same value as sessionId.
createdAt dimensionlabs_timestamp Convert with toMillis.
type, id platformJson type is the message type, such as text, choice or quick_reply.
5 steps. Then it runs on its own.
A small job on your side reads Botpress through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Open the full Botpress guide ›- 01Get API access in Botpress
- 02Pull new messages
- 03Map the fields
- 04Send it
- 05Run it
What you need
- A Botpress account with access to the bot's workspace, to create a personal access token.
- The bot id.
- A Dimension Labs API key for a new Universal API source.
[03] What you can ask
Questions teams answer with Botpress data.
- Where does the bot fail, and what does it cost?
- What do customers say right before they ask for a person?
- Which intents should be automated next?
Botpress integration questions
Does Dimension Labs integrate with Botpress?
Yes. A small job on your side reads Botpress through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. The setup guide was checked against Botpress's documentation on 2026-10-26.
What Botpress data does Dimension Labs bring in?
This brings in your Botpress bot conversations, message by message: what each user wrote and what the bot answered. Each Botpress conversation becomes one conversation. You run it on your side: a small script pulls from the Botpress API and posts each message to the universal API.
What do I need to connect Botpress?
A Botpress account with access to the bot's workspace, to create a personal access token. The bot id. A Dimension Labs API key for a new Universal API source.
How often does Botpress data update?
Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Can I connect a platform that is not Botpress?
Yes. Any platform with an API connects through the same universal API, and any tool with an export button works as a file upload. The integrations page lists the platforms with a written guide.
Stop reporting. Start understanding.
Start with one file. Ask why a number moved. Plans from $299 a month, no demo and no contract on monthly plans.