Skip to content
← Developer Hub

Developer Hub

Browser Extension

Install the Raia Chrome extension, connect agents with their API key, and configure the slide-out drawer behavior on any webpage.

01

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.
02

Installation

  1. 01

    Navigate to the Raia AI Agents Chrome Web Store page.

  2. 02

    Click Add to Chrome.

  3. 03

    Once installed, the Raia icon appears in your browser toolbar. Pin the extension for easy access.

03

Retrieving your API key

To connect an agent to the extension, you need the agent's API key (the Agent Secret Key generated in raia CX).

  1. 01

    Log into raia CX.

  2. 02

    Select your agent and open the section where API keys are managed.

  3. 03

    Generate (or copy) the Agent Secret Key for that agent.

  4. 04

    Copy the key — you'll paste it into the extension in the next step.

Keep your API key safe

The Agent Secret Key grants full access to that agent through the raia API. Treat it like a password: never share it publicly, and regenerate it if you suspect it has been exposed.
04

Connecting an agent

  1. 01

    Click the Raia icon in your browser toolbar to open the extension popup.

  2. 02

    Click the + button in the top-right corner.

  3. 03

    Enter a friendly Agent Name (e.g., "Sales Assistant").

  4. 04

    Paste the copied API key into the corresponding field.

  5. 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.
05

Configuration & settings

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

SettingDescription
Show chat icon on pagesToggles the visibility of the purple Floating Action Button (FAB) in the bottom-right corner of all webpages.
Blur website when openBlurs and dims the background webpage while the chat drawer is open to focus attention on the conversation.
Wide drawerIncreases the drawer width from the default 420px to a wider 680px, ideal for complex formatting or data tables.
Overlay chatWhen 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 contentExtracts 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.
06

Security & privacy

Local storage

API keys 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.