Documentation

Build smarter chatbots

Everything you need to install, configure, and manage your Rexium AI chatbot. From quick setup to advanced customization.

Getting Started

Get your AI chatbot live in under 5 minutes. Here's a quick overview of the process:

1. Create Account

2. Add Knowledge

Upload your FAQs, product data, or website content. The AI learns from your actual business data using RAG technology.

3. Install Widget

Copy a single script tag to your website. Works with Shopify, WordPress, or any HTML site.

Quick tip

After creating your account, head to Settings → Widget to customize colors and behavior, then go to Knowledge Base to add your content. The widget starts working immediately — even before you add knowledge, it uses your general settings to respond.

Installation

Add the Rexium widget to any website with a single script tag. Copy the snippet from your dashboard (Overview → Install Widget) or use the template below:

Any HTML Website

Paste this before the closing body tag:

html

<script
  src="https://widget.rexium.ai/chat.js"
  data-tenant-id="YOUR_TENANT_ID"
  defer
></script>

Shopify

Go to Online Store → Themes → Edit Code → theme.liquid and paste the same snippet before the closing body tag. Alternatively, use the Shopify App (coming soon).

WordPress

Install a "Header/Footer Scripts" plugin (e.g., WPCode) and paste the snippet in the footer section. Or add it directly to your theme's footer.php before the closing body tag.

Important

Replace YOUR_TENANT_ID with your actual tenant ID. You can find it in Settings → General or in the install snippet on the Overview page.

Widget Customization

Customize the look and feel of your chatbot widget from Settings → Widget in the dashboard. Changes are applied in real-time.

Colors

Set a primary color for the widget bubble, header, and send button. Uses your brand color to blend seamlessly with your site.

Position

Choose between bottom-right or bottom-left placement.

Greeting Message

Set a custom greeting that appears when the chat opens. E.g., "Hi! How can I help you today?"

Auto-Open

Optionally open the chat automatically after a delay when visitors land on your site.

Branding

Show or hide the "Powered by Rexium" badge. Available on Pro and Enterprise plans.

Shadow DOM

The widget uses Shadow DOM by default, ensuring zero CSS conflicts with your site. No configuration needed.

Knowledge Base

The knowledge base is the core of your AI chatbot. It uses RAG (Retrieval Augmented Generation) to answer questions based on your actual business data. Go to Knowledge Base in the dashboard to manage your content.

Manual Entries

Create FAQ-style entries with a title and content. Ideal for return policies, shipping info, business hours, and common questions. Each entry is automatically chunked and embedded.

PDF Upload

Upload PDF documents (product catalogs, manuals, policy docs). The system extracts text, splits it into chunks, and generates embeddings. Supports files up to 10MB.

Web Crawler

Enter a URL and the crawler will scrape the page content (and optionally follow links). Great for importing existing help center articles or product pages.

Shopify Sync

Connect your Shopify store to automatically sync products, descriptions, prices, and availability. The AI can then recommend products and create cart links for customers.

How RAG works

When a customer asks a question, the AI converts it into an embedding vector and searches your knowledge base for the most relevant chunks. These chunks are then included as context in the AI prompt, ensuring accurate answers grounded in your actual data — not hallucinations.

AI Configuration

Fine-tune how your AI chatbot behaves from Settings → AI.

Setting	Description
Tone	Choose between Professional, Friendly, or Casual. Controls how the AI communicates with visitors.
Language	Set a default language or let the AI auto-detect. Supports PT, EN, FR, SV and more.
Custom Instructions	Add specific instructions for the AI. E.g., "Always mention our free shipping policy" or "Never discuss competitor products."
Bot Name	Set the display name for the AI assistant in the chat widget.
Escalation Rules	Define when the AI should escalate to a human agent (e.g., after N unanswered questions, negative sentiment).

Human Escalation

When the AI can't resolve an issue, conversations can be escalated to your team. The full chat history and context is preserved.

How it works

A visitor clicks the "Talk to human" button in the widget, or the AI auto-escalates based on your rules.
The conversation status changes to escalated and the AI stops responding.
Your team receives a notification via Slack and/or email (configurable in Settings → Escalation).
An agent clicks "Take Over" in the dashboard to start responding directly.
Once resolved, the agent marks the conversation as resolved.

Slack Integration

Connect your Slack workspace in Settings → Escalation to receive real-time alerts when conversations are escalated. The notification includes a summary of the conversation and a direct link to the dashboard.

Team Management

Invite team members from Settings → Team. Each agent gets their own login and can be assigned conversations. Roles include owner, admin, and agent.

API Reference

The Rexium API powers the widget and can be used for custom integrations. All endpoints are hosted on api.rexium.ai.

GET/widgetConfig

Returns widget settings (colors, position, greeting, branding) for a tenant.

Params: tenantId

POST/widgetInit

Initializes a new chat session. Returns a conversationId and visitor token.

Params: tenantId

POST/onMessage

Sends a visitor message. The AI processes it and responds using RAG context.

Params: tenantId, conversationId, message

POST/onMessageStream

Same as onMessage but returns a streaming SSE response for real-time typing effect.

Params: tenantId, conversationId, message

GET/getMessages

Retrieves messages for a conversation. Used by the widget for polling agent replies.

Params: tenantId, conversationId, after (timestamp)

POST/onEscalate

Escalates a conversation to a human agent. Triggers notifications.

Params: tenantId, conversationId

POST/uploadAttachment

Uploads a file attachment to a conversation (images, documents).

Params: tenantId, conversationId, file (multipart)

POST/submitRating

Submits a satisfaction rating for a conversation.

Params: tenantId, conversationId, rating, feedback

All requests require a valid tenantId. The widget handles authentication automatically. For custom integrations, include the tenant ID in your requests.

Billing & Plans

Rexium offers flexible plans for businesses of all sizes. All plans include a 7-day free trial.

Feature	Starter	Pro	Enterprise
Messages/month	1,000	10,000	Unlimited
Knowledge items	50	500	Unlimited
Team members	1	5	Unlimited
Shopify integration	—	✓	✓
Remove branding	—	✓	✓
Analytics	Basic	Advanced	Full
Price	€29/mo	€79/mo	€199/mo

Manage your subscription from Settings → Billing in the dashboard. Annual plans get a 20% discount. All prices in EUR.

Ready to get started?

Create your account and have your AI chatbot live in under 5 minutes.

Start Free Trial Back to Home