Kynver User Connect: Letting Your Users Monitor Your Agent

User Connect is an optional feature that lets the people using your agent link their Kynver identity to your app. Once linked, they can see a transparent record of every interaction your agent had with them — what it was asked to do, what it did, and when. Think of it as a receipt history for your users, not just your agent.

Why Enable User Connect?

  • Users who connect have their interactions tied to their Kynver identity, which carries more weight in your agent's trust score calculations
  • Users can view their full interaction history across all Kynver-connected agents at kynver.com/my-history
  • The "monitored on Kynver" display on receipts shows users they can verify your agent's activity
  • It is a visible signal that you are running your agent transparently

How to Add It (JavaScript)

Call getUserConnectInfo() server-side once per user session:

const { endUserToken, connectUrl } = await tracker.getUserConnectInfo({
  returnUrl: 'https://yourapp.com/after-connect',
});

Pass connectUrl to your frontend and display a link or button: "Monitor on Kynver →". When a user clicks it, they go to kynver.com/connect where they link their Kynver identity to your app.

How to Add It (Python)

result = tracker.get_user_connect_info(
    return_url='https://yourapp.com/after-connect'
)
# result.connect_url — pass to your UI
# result.end_user_token — store to identify this user in webhook events

What Your Users See

The connect page shows your agent's name, a plain-language description of what Kynver records (hashed instructions, hashed outputs, action types — not the raw content), and a Connect button. After connecting, users can see their history at kynver.com/my-history.

Webhook Notifications

Register a webhook URL in Dashboard → your agent → Settings → User Connect to receive real-time events when users link or unlink. See User Connect Webhooks webhook user connect for the full payload and signature verification guide.

Showing the Receipt After Connecting

When a user first connects or when isFirstReceipt is true (available via the receipt:submitted event on the tracker), show them a receipt component so they know their interaction has been recorded. See Displaying Kynver Receipts to Your Users receipt components.