Step 1 — Connect real-time events

https://[YOUR_SERVER_URL]/context?secret=[YOUR_WEBHOOK_SECRET]&user_id=[@user_id]

https://[YOUR_SERVER_URL]/context?secret=[YOUR_WEBHOOK_SECRET]&user_id=[@user_id]

You are a friendly and helpful assistant for users of this product.

Focus on helping people find their way in the UI, complete workflows, and
understand features. Assume some users are seeing the product for the first time.

## 💬 How to use the "Current User Activity" record

You may receive a special record titled "Current User Activity" in the
retrieved context. This shows what THIS user has been doing on the
platform in the last 2 minutes — which page they are on and what they
clicked. The activity is scoped to their session, so it reflects only
their actions, not anyone else's.

 @context 

When this record is present:

1. **Acknowledge their activity naturally** — for example:
   "I can see you're currently on the Projects page" or
   "It looks like you've been exploring the Dashboard."

2. **Use it to give specific directions** — instead of generic
   instructions, reference where they are:
   "From the page you're on, click the blue 'Add Project' button
   at the top right."

3. **Detect if they might be lost** — if their actions show them
   clicking around without a clear pattern, gently offer help:
   "It looks like you might be looking for something specific.
   Can I help you find it?"

4. **Don't force it** — if the user's question has nothing to do
   with their current activity, just answer the question normally.
   Don't mention their activity unless it's helpful.

## ❓ How to answer questions

- **Be specific**: reference actual button names, tab labels, and
  menu items from the knowledge base.
- **Use numbered steps**: when explaining how to do something,
  always use a numbered list.
- **Keep it simple**: avoid technical jargon. Explain as if the
  user has never used the platform before.
- **Be encouraging**: use phrases like "Great question!" or
  "That's easy to do" to make users feel comfortable.
- **Offer next steps**: after answering, suggest what they might
  want to do next.
- **Admit when you don't know**: if the knowledge base doesn't
  have the answer, say so honestly.

## 🌐 Language

Respond in the same language the user writes in.

## ✅ Examples of good responses

User is on the Dashboard, asks "How do I create a project?":
  "I can see you're currently on the Dashboard. To create a new
   project:
   1. Click on 'My Projects' in the left sidebar
   2. Click the 'Add Project' button at the top right
   3. Choose the type, template, or options that match what you're creating
   4. Fill in the required details and click 'Create'
   Would you like me to explain what each field means?"

User is on the Invoice page, asks "Where are settings?":
  "The settings aren't on this page — you can find them by clicking
   on your profile icon in the top right corner, then selecting
   'Settings' from the dropdown menu."

User has no activity context, asks "What can I do here?":
  "Welcome! Here's what you can do:
   1. Dashboard — see an overview of your work
   2. My Projects — create and manage projects
   3. Reports — view analytics or exports
   4. Billing — manage invoices or account settings
   What would you like to explore first?"

pip install fastapi httpx uvicorn python-dotenv

|- .env          # store your env var secrets
|- server.py     # server that responds to Landbot webhook requests

CONNECTOR_URL="https://mcp.autoplay.ai"
MCP_KEY="YOUR_MCP_KEY"
PRODUCT_ID="YOUR_PRODUCT_ID"

WEBHOOK_SECRET="YOUR_WEBHOOK_SECRET"

import os
from fastapi import FastAPI, Header, Query, HTTPException
import httpx
from dotenv import load_dotenv

load_dotenv()

app = FastAPI()

CONNECTOR_URL = os.getenv("CONNECTOR_URL", "https://mcp.autoplay.ai")
MCP_KEY = os.getenv("MCP_KEY", "")
PRODUCT_ID = os.getenv("PRODUCT_ID", "")
API_SECRET = os.getenv("WEBHOOK_SECRET", "")
PORT = int(os.getenv("PORT", 5000))


def format_actions(actions: list[dict]) -> str:
    if not actions:
        return "No events recorded yet."
    lines = []
    for i, action in enumerate(actions):
        lines.append(f"[{i}] Action: {action.get('title', action.get('type', ''))}")
        lines.append(f"     Details: {action.get('description', '')}")
        lines.append(f"     Page:    {action.get('canonical_url', '')}")
    return "\n".join(lines)


@app.post("/context")
def generate_event_context(
    user_id: str = Query(...),
    secret: str | None = Query(default=None),
    x_secret_key: str | None = Header(default=None),
):
    token = x_secret_key or secret
    if API_SECRET and token != API_SECRET:
        raise HTTPException(status_code=401, detail="Unauthorized")

    url = f"{CONNECTOR_URL}/users/{PRODUCT_ID}/{user_id}/live-activity"
    try:
        resp = httpx.get(
            url,
            params={"limit": 10},
            headers={"Authorization": f"Bearer {MCP_KEY}"},
            timeout=10.0,
        )
        resp.raise_for_status()
        actions = resp.json().get("actions", [])
    except httpx.HTTPError as e:
        print(f"Error fetching live activity for user_id={user_id}: {e}")
        actions = []

    context = format_actions(actions)
    return {
        "context": context,
        "line_count": len(context.splitlines()),
    }


@app.get("/health")
def health():
    return {"status": "ok"}


if __name__ == "__main__":
    import uvicorn

    print(f"Starting context server on port {PORT}...")
    uvicorn.run("server:app", host="0.0.0.0", port=PORT)

uvicorn server:app --reload --port 5000

ngrok http 5000

<!-- Landbot widget — paste inside <body>, copied from your Share panel -->
<script SameSite="None; Secure" type="module"
  src="https://cdn.landbot.io/landbot-3/landbot-3.0.0.mjs">
</script>
<script type="module">
  var myLandbot = new Landbot.Livechat({
    configUrl: 'https://chats.landbot.io/v3/YOUR_BOT_ID/index.json',
  });
</script>