Skip to main content
Skip to main content

Chat Widget Setup

Install and configure the Raya chat widget on your website so she can greet visitors and resolve questions instantly.

5 min readUpdated 2026-11-08
Raya

Tour Raya’s Support Desk

Where customers reach Raya across web chat, 24/7 phone line, email, and WhatsApp, plus her Knowledge Base, connected apps, and escalations.

Full transcript

What Is the Chat Widget?

The chat widget is a lightweight snippet you embed on your website. Once live, Raya appears as a chat bubble in the corner of every page. Visitors click to ask questions and Raya responds in real time, drawing from your knowledge base and escalation rules.

In addition to answering product and policy questions, Raya executes approved support actions: she looks up order statuses, processes refunds within your policy, creates support tickets, and escalates to your human team when needed across 54+ languages and 19 Arabic dialects, 24/7.

Setup Steps

Follow these five steps to get Raya live on your website. The entire process takes under 5 minutes.

  1. 1

    Create or select Raya

    Go to the Dashboard and create a new Support teammate (Raya), or select an existing one. This teammate will power the widget.

  2. 2

    Open Chat/Widget settings

    Navigate to the employee's channel settings and select the Chat/Widget tab. This is where you control appearance, behavior, and allowed domains.

  3. 3

    Configure brand, behavior, and domains

    Set your brand colors, greeting text, welcome message, widget position, and the domains where the widget is allowed to appear. See the configuration table below for all available settings.

  4. 4

    Copy the embed snippet

    Click "Copy Code" to get the JavaScript embed snippet. This is a single script tag you paste into your website.

  5. 5

    Paste before closing body tag

    Paste the snippet just before the closing </body> tag in your website's HTML. Raya goes live immediately. No page reload required for returning visitors.

Pro Tip

Using a CMS like WordPress, Shopify, or Webflow? You do not need to edit HTML directly. Most CMS platforms have a "Custom Scripts" or "Code Injection" section in settings where you paste the snippet once. It automatically appears on every page.

Widget Configuration

Every aspect of the chat widget is customizable. Use the table below to configure Raya's appearance and behavior.

SettingDescriptionOptions / Default
ThemeLight or dark mode for the chat windowLight (default), Dark
Brand ColorMain brand color for the widget header and buttonsAny hex value (default: #0047AF)
System HeadingTitle displayed at the top of the chat windowCustom string (default: "Hi there Raya is ready to help ✨")
System ParagraphSubtitle text below the system headingCustom string (default: "Ask any question, Raya is fast and friendly.")
Welcome MessageFirst message Raya sends when the chat opensCustom string (default: "Hi there 👋 How can I help?")
Input PlaceholderPlaceholder text in the message input fieldCustom string (default: "Type your message...")
Pre-Set Quick RepliesSuggested prompts shown to visitors as clickable buttonsList of strings (e.g., "Pricing", "Book a demo")
Voice NotesAllow visitors to send voice notesOn (default) / Off
Image UploadAllow visitors to send imagesOn (default) / Off
Real-Time Voice CallsAllow visitors to start live website voice calls through the widget (unlocked on Pro+)On / Off (default)
Collect EmailAsk visitors for their email before starting a chatOn / Off
Collect PhoneAsk visitors for their phone number before starting a chatOn / Off
Custom Chat IconReplace the default chat bubble icon with your own imageUpload image (PNG, SVG)
Custom Button IconReplace the submit button icon with your own imageUpload image (PNG, SVG)
Allowed DomainsDomains where the widget is permitted to loadComma-separated list (e.g., "example.com, app.example.com")

Widget Limitations

The chat widget requires HTTPS. It will not load on pages served over plain HTTP. Some browser ad-blockers and privacy extensions may block the widget script. If visitors report that the widget is missing, ask them to allowlist your domain in their ad-blocker settings.

Warning

Always add your domain to the Allowed Domains list before going live. Without it, the widget will not load, even if the embed snippet is correctly installed. This is a security feature that prevents your widget from being embedded on unauthorized sites.

Frequently Asked Questions

Can I use the chat widget on multiple websites?
Yes. Add each domain to the Allowed Domains list in widget settings. The same embed snippet works across all of them, and Raya uses the same knowledge base for every domain.
How many credits does each chat response cost?
Raya usage depends on the channel and applicable measured usage. See Billing for the current published rate; a reply is not the same as a resolved support ticket.
Does the widget slow down my website?
No. The widget loads asynchronously after your page content, so it does not block rendering. The script is under 30 KB gzipped.

Related Guides

Ready to try Raya?

Free launch for your first business or free onboarding for your existing business + 5 starter Credits, no credit card required.

Explore Raya

Was this article helpful?

Raya
Adam

Still need a hand?

Ask us anything in any language. Raya (Support) and Adam (Sales) answer 24/7 across 54+ languages and 19 Arabic dialects.