RAQSFAQ
Frequently asked questions
RAQS is a voice AI assistant you add to any website with one line of code — visitors tap, speak, and the assistant answers from your own content. On this page we have grouped the most common questions by theme: setup, languages, cost, security, knowledge-base crawling, mascots and agent actions. If you do not find your answer here, scan the long FAQ list below.
Setup and getting started
Going live with RAQS does not require provisioning a server, writing code, or waiting on a developer. You add your site in the dashboard, receive a unique site key, and paste a single <script> line into your site's HTML. The assistant loads asynchronously, so it does not slow your page's first paint, because the heavy work (speech recognition, the language model, retrieval) runs entirely in the cloud.
The one meaningful task after install is feeding the knowledge base: crawl your site, paste text/FAQ, or upload files. Once the knowledge base is ready, the assistant starts answering from your site's real content. All of these steps typically take minutes.
One line of code
Paste the <script> line carrying your site key.
No server
Managed cloud; all heavy work runs server-side.
Fast load
Loads asynchronously; does not block first paint.
<script async src="https://raqs.ai/v1/raqs.js"
data-raqs="YOUR_SITE_KEY"></script>Languages and voice
RAQS currently supports Turkish and English. A visitor taps the orb (or a 3D mascot), speaks in natural language, and hears an instant spoken reply — no typing. The browser's Web Speech API catches the wake word, audio streams over a low-latency realtime layer, and speech-to-text and text-to-speech run on Azure Speech, while the language model (the brain) runs on Azure OpenAI.
The voice, tone, persona and assistant name are configurable from the dashboard, so you can define a personality that fits your brand. A visitor can barge in while the assistant is speaking to ask something new, holding a fluid dialogue with natural pauses.
Turkish + English
Natural spoken conversation in two languages.
Configurable voice
Voice, tone, persona and name set in the dashboard.
Barge-in
Interrupt the assistant mid-sentence.
Cost and pricing
RAQS is a managed (hosted) cloud service that works on a pay-as-you-go model: a usage-based cost sits on top of a base plan. That means you can start small and grow with demand. A free trial lets you try it before committing, and no credit card is required up front.
The base plan defines limits such as your crawlable page quota; usage then scales with the volume of conversations and actions the assistant performs. This model is especially low-risk for new sites, because while traffic is low your cost stays low too.
Pay-as-you-go
Base plan + usage-based cost.
Free trial
No credit card required up front.
Managed cloud
We run the infrastructure; no maintenance burden on you.
Security, privacy and compliance
RAQS is a multi-tenant architecture, and each customer's data is isolated with row-level security (RLS); one customer's knowledge base is never visible to another. The assistant only runs on the domains you allow in the dashboard (an origin allowlist) and is protected against abuse with Cloudflare Turnstile.
The crawler that reads your site is guarded against SSRF attacks and respects robots.txt rules. The infrastructure is hosted in Azure's EU region, and the service is designed to be KVKK- and GDPR-aware. In short, you operate on a footing aligned with your obligations around personal data and data residency.
RLS isolation
Each tenant's data separated at the row level.
Origin allowlist
Runs only on domains you authorize.
SSRF-guarded crawl
Respects robots.txt; blocks internal addresses.
EU region
Azure EU hosting; KVKK + GDPR awareness.
Knowledge base and crawling (RAG)
RAQS does not make things up; it answers only from the knowledge base you provide. You can feed that knowledge base three ways: by crawling your site (sitemap + pages; JavaScript-rendered SPA sites are processed with a headless browser so they aren't left blank, with content extracted cleanly via trafilatura), by pasting plain text/FAQ, or by uploading files (PDF, Word, TXT, MD, CSV).
Content is chunked, embedded with Azure embeddings (text-embedding-3-small) and stored in pgvector. At query time a hybrid search runs: semantic vector search plus Postgres full-text keyword search are combined with RRF fusion, and a similarity threshold filters out irrelevant results. If the answer isn't in your content, the assistant honestly says it doesn't know — the single most important design choice for preventing hallucination.
Three feed paths
Site crawl, paste text/FAQ, or upload files.
Headless render
Browser-based render for JS-driven SPA content.
Hybrid retrieval
Vector + keyword + RRF fusion + threshold.
Product data
Name/brand/price/stock/category from schema.org JSON-LD.
Mascots and agent actions
Instead of the classic orb you can pick a 3D mascot that roams the page: the flagship deer, the universal 'Spark', stylized characters and more than 30 animals. The mascot treats the page's real DOM elements as terrain — running, jumping and leading the visitor to the right target. The mascot is chosen with one click in the dashboard.
RAQS doesn't just answer; it also acts on the page. It 'sees' the page, guides the visitor to the right product/page, shows an item from a list, or triggers actions like add-to-cart. Sensitive operations (payment, account changes, deletion) always require the visitor's explicit confirmation — this smart safety layer prevents critical actions from happening by accident.
3D mascot pool
Deer, Spark, characters and 30+ animals.
DOM terrain
The mascot uses the page's real elements as ground.
Guidance + actions
Route to the right page, add-to-cart and more.
Confirm shield
Explicit user consent for payment/account/delete.
FAQ
How do I install RAQS on my site?
Add your site in the dashboard to get a unique site key, then paste a single <script> line into your site's HTML. No server setup or coding is required; the assistant loads asynchronously and goes live in minutes.
How long does setup actually take?
Pasting the script line is a few minutes of work. The real time goes into preparing the knowledge base: crawling your site, pasting text, or uploading files. For most sites the whole process is measured in minutes.
Which languages does RAQS support?
Turkish and English are supported today. The assistant's voice, tone, persona and name can be configured in the dashboard to fit your brand.
Can I change the assistant's voice and personality?
Yes. Voice, tone, persona and assistant name are chosen in the dashboard, so the assistant speaks with a character that matches your brand identity.
Will RAQS give wrong or made-up answers?
No. RAQS answers only from your knowledge base; if a fact isn't in your content it honestly says it doesn't know. This is the core design choice that prevents hallucination.
How do I feed the knowledge base?
Three ways: crawl your site (sitemap + pages, with headless render for SPAs), paste plain text/FAQ, or upload files (PDF, Word, TXT, MD, CSV). Content is chunked, embedded, and used for retrieval.
Can it crawl my JavaScript (SPA) site?
Yes. JavaScript-rendered pages are processed with a headless browser so content isn't left blank. Text is extracted cleanly with trafilatura, and robots.txt rules are respected.
Can visitors ask about product price and stock on an e-commerce site?
Yes. The schema.org JSON-LD data on product pages (name, brand, price, stock, category) is extracted too, so questions like 'is X in stock, how much?' are answered correctly.
How much does RAQS cost?
It is pay-as-you-go: a usage-based cost sits on top of a base plan. A free trial lets you try it first, and no credit card is required up front.
Is my data safe and KVKK/GDPR-compliant?
In the multi-tenant architecture each customer's data is isolated with row-level security (RLS). The assistant only runs on domains you allow, is protected by Cloudflare Turnstile, and the infrastructure is hosted in Azure's EU region; the service is designed to be KVKK- and GDPR-aware.
Can I restrict the assistant to only my own site?
Yes. You define an origin allowlist in the dashboard; the assistant only loads on the domains you authorize. This prevents your site key from being abused elsewhere.
What is a 3D mascot and how do I pick one?
Instead of the classic orb you can pick a 3D character that roams the page: the flagship deer, the universal Spark, stylized characters and more than 30 animals. The mascot uses the page's real elements as terrain and is chosen with one click in the dashboard.
Does the assistant only answer, or can it take actions too?
RAQS sees the page and acts on it: it guides the visitor to the right product/page, shows an item, or triggers actions like add-to-cart. Sensitive operations such as payment, account changes and deletion always require explicit user confirmation.
Can I add more than one site?
Yes. From the dashboard you can add multiple sites and manage a separate knowledge base, allowed domains, mascot and persona for each. You review conversations and analytics from the same dashboard.
Still have a question?
Try it free; make your site talk in minutes with one line of code.
Start free