This guide shows how to integrate Roundtable’s bot detection suite into any web app.

​

Quick start

<script
  src="https://cdn.roundtable.ai/v1/rt.js"
  data-site-key="YOUR_SITE_KEY"
  data-user-id="OPTIONAL_USER_ID"
  >
</script>

<!-- 2 ‑ (optionally) set / update the UID when the tracker is ready (skip if you used data-user-id) -->
<script>
  const setUid = () => window.setRoundtableUserId?.('USER_ID');  // Only runs if script is ready
  setUid(); // Try right away
  window.addEventListener('roundtable:ready', setUid, { once:true }); // Try again once if event
</script>

The Roundtable tracker dispatches a roundtable:ready event on window as soon as it finishes loading. Block 2 listens for that event so you can safely call window.setRoundtableUserId once the script is loaded.

​

Script‑tag attributes

The tracker recognizes two data‑attributes that let you tailor its behavior:

• data-site-key (required) – Your workspace’s site key (find it in the Roundtable Dashboard).
• data-user-id (optional) – A stable identifier for a logged‑in user to track them over multiple sessions (a hashed value is fine).

​

React / SPA example

Add the Roundtable tracking script in public/index.html:

<script
  src="https://cdn.roundtable.ai/v1/rt.js"
  data-site-key="YOUR_SITE_KEY">
</script>

Then wire the user ID in React:

// useRoundtableUid.tsx
import { useEffect } from 'react';

export const useRoundtableUid = (uid?: string) => {
  useEffect(() => {
    if (!uid) return;

    const send = () => {
      if (window.setRoundtableUserId) {
        window.setRoundtableUserId(uid);
        return true;             // tracker ready
      }
      return false;              // not yet
    };

    if (send()) return;          // ran instantly
    window.addEventListener('roundtable:ready', send, { once: true });
    return () => window.removeEventListener('roundtable:ready', send);
  }, [uid]);
};

Call the hook in your auth/provider component; it runs every time currentUser changes, so it sets the UID immediately on page‑refresh and again right after a fresh login.

const { currentUser } = useAuth();
useRoundtableUid(currentUser?.uid);

​

Using the Session ID

Every page‑view (or SPA session) gets a unique session ID that Roundtable stores in sessionStorage under rtSessionId. You can reference this ID to pull risk scores and data from the session in your back end.

// Access the session ID anywhere in the front end
const sessionId = sessionStorage.getItem('rtSessionId');
console.log('Roundtable session:', sessionId);

Because the session ID is stored in sessionStorage, the value is scoped to the current tab and cleared automatically when the tab is closed. Roundtable does not use any cookies or local storage.

​

Next steps

• Visit your Roundtable Account to access your public API key.
• Learn how to Access Session Data to retrieve risk scores and session data.
• Explore our API Reference for more details.