Browser Extension — raia Developer Hub

Overview

The Raia Browser Extension lets users access any raia AI agent from any webpage via a persistent, slide-out drawer. It seamlessly integrates your existing Live Chat widget directly into the browser, enabling context-aware AI assistance without ever leaving the current tab.

Compatibility

Works on Chrome, Edge, Brave, and any Chromium-based browser.

Installation

01
Navigate to the Raia AI Agents Chrome Web Store page.
02
Click Add to Chrome.
03
Once installed, the Raia icon appears in your browser toolbar. Pin the extension for easy access.

Retrieving your Agent ID

To connect an agent to the extension, you need its unique Agent ID (also known as the data-api-key).

01
Log into the Raia Launch Pad.
02
Select your agent and navigate to the Launch tab.
03
Locate the Live Chat deployment channel and click Export / Embed Code.
04
In the JavaScript snippet, find the data-api-key attribute and copy its value.

html

<script src="https://raiabot.raia2.com/widget.js" data-api-key="YOUR_AGENT_ID_HERE"></script>

Connecting an agent

01
Click the Raia icon in your browser toolbar to open the extension popup.
02
Click the + button in the top-right corner.
03
Enter a friendly Agent Name (e.g., "Sales Assistant").
04
Paste the copied Agent ID into the corresponding field.
05
Click Connect. The extension validates the key and adds the agent to your list.

Multiple agents

You can add multiple agents using the same process. When more than one agent is connected, clicking the Floating Action Button (FAB) on a webpage presents an agent picker menu.

Configuration & settings

The extension popup provides several toggles that customize how the chat drawer behaves on webpages.

Setting	Description
Show chat icon on pages	Toggles the visibility of the purple Floating Action Button (FAB) in the bottom-right corner of all webpages.
Blur website when open	Blurs and dims the background webpage while the chat drawer is open to focus attention on the conversation.
Wide drawer	Increases the drawer width from the default 420px to a wider 680px, ideal for complex formatting or data tables.
Overlay chat	When enabled, the drawer slides over the page. When disabled (Squeeze Mode), the drawer pushes page content to the left so nothing is obscured.
Read page content	Extracts up to 10,000 characters of page text and sends it to the agent as context, so you can ask questions about the page you're viewing.

Security & privacy

Local storage

Agent IDs and settings are stored in chrome.storage.local. This data is sandboxed to your browser profile and is never transmitted to third parties.

Context extraction

The “Read page content” feature strips out scripts, styles, and hidden elements before sending text to the Raia API. Extraction only happens when the drawer is opened or when you explicitly click the context button inside the drawer.

API fallback

If the Live Chat widget cannot render inline due to a website's strict Content Security Policy (CSP), the extension automatically falls back to a native UI powered directly by the Raia REST API.