Botpress tutorial - Autoplay SDK

Capture live website interactions with the Autoplay SDK and pull them into a Botpress agent on demand for real-time context.

✨ Final result

Without real-time context
With real-time context

Example chat: generic bot reply when the bot does not know which page the user is on

User: How do I create a project?

Bot: You're on the Pricing page comparing plans. Open My Projects from the sidebar,
click Add Project, then choose a workspace size that matches what you're configuring here.

(Knows canonical URL, recent clicks, and session — answers match where they are.)

Video walkthrough — Open on YouTube if the player does not load.

📋 Prerequisites

Complete the Quickstart. You should have:

Your activity source set up — PostHog (or Amplitude) capturing events in your app, with identify (or setUserId) setting a stable user_id you can also reference inside Botpress
A registered product — your product_id, mcp_url, and mcp_key from the Quickstart
A Botpress account — with a bot created in Botpress Studio

The building blocks

Follow the steps in order — each page stands alone so you can ship incrementally.

Connect real-time events — Pull a user’s live activity on demand from the Autoplay connector and wire an Autonomous Agent to answer with that context.
Define proactive triggers — Proactively message users in Botpress based on what they’re doing in your product. (Coming soon)

Step 2 — Define proactive triggers Step 1 — Connect real-time events