# Billing & Add-ons
Source: https://recepai.ai/docs/admin-panel/billing
Purchase additional credits and premium features to keep your receptionist working at the front desk.
The Billing & Add-ons page is where you purchase extra credits and unlock premium features for your receptionist.
**How to access this page:** Click the **RecepAI menu icon** in the top-right corner of your admin panel, then select **"Billing & Add-ons"** from the dropdown menu. This page is not in the main sidebar navigation.
At the top-right corner, the **"Check Credits"** button takes you directly to the [Analytics → Usage](/admin-panel/history#usage) tab where you can see how many credits you have remaining.
***
## Call Credits
Purchase additional voice call capacity for your receptionist. Each package adds credits to your account immediately. Multiple package sizes are available — pick the one that fits your needs.
The **"Most Popular"** badge highlights the recommended package for most hotels.
***
## Chat Credits
Purchase additional text conversation capacity. Like call credits, these are added to your account immediately after purchase. Several package options are available at different price points.
***
## Extra Skills
Unlock premium capabilities for your receptionist. Each skill adds a new ability or removes a limitation.
| Skill | What It Does |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Smart Eyes** | Your receptionist can now see and read. Guests can share passport photos, room photos, menu screenshots, and any document for instant answers. |
| **Custom AI Avatar** | A custom-designed avatar with voice clone — your receptionist gets a unique face and voice that matches your brand. |
| **WhatsApp Integration** | Connect your receptionist to WhatsApp Business so guests can chat through their preferred messaging app. |
| **Telegram Integration** | Connect your receptionist to Telegram for guests who prefer this channel. |
| **Custom Domain** | Host the chat widget on your own custom domain instead of the default RecepAI domain. |
| **Remove "Powered By RecepAI"** | Remove the RecepAI branding from the chat widget for a fully white-labeled experience. |
**Not sure which skills you need?** Start with the basics — your plan already includes chat and voice. Add skills as your guests' needs grow. WhatsApp and Telegram are great first additions if your guests prefer messaging apps.
***
## How Purchasing Works
Browse the available options and click **"Buy Now"** on the one you want.
You'll be redirected to a secure checkout page to enter your payment details.
After successful payment, you're returned to the Billing page with a confirmation message. Credits and skills are active right away — no waiting.
***
## Credit Expiry
**Credits are valid for 6 months** after purchase. They are used **after** your monthly plan credits are consumed. If your plan includes enough credits for the month, your purchased add-ons remain untouched until needed.
To monitor your credit balance, click **"Check Credits"** at the top of this page or visit the [Analytics → Usage](/admin-panel/history#usage) tab.
# Chat Settings
Source: https://recepai.ai/docs/admin-panel/conversation-agent
Teach your receptionist how to talk to guests via Chat Widget, WhatsApp, or Telegram.
The Chat Settings page is where you define how your receptionist communicates through **text** — via your website chat widget, WhatsApp, or Telegram.
**Why is Chat separate from Voice?** Written and spoken communication follow different rules. In chat, guests expect detailed answers with links and formatting. On a phone call, your receptionist needs to be brief and conversational. Splitting these lets you fine-tune each channel independently.
## How They Should Chat
This is the most important field on this page. Think of it as the training manual you'd hand a new receptionist on their first day — explain the tone, the boundaries, and how they should handle different situations.
**Common mistake:** Don't put hotel information (room types, prices, hours, policies) in this field. That belongs in [Training Materials](/admin-panel/documents). This field is for *behavior* — how your receptionist should act, not what they should know. Your receptionist automatically pulls knowledge from Training Materials during conversations.
**Character Limit:** 12,000 characters maximum. The counter changes color to guide you:
* **Green (0 - 8,000):** Optimal range
* **Orange (8,000 - 10,000):** Getting long — consider moving details to Training Materials
* **Red (10,000 - 12,000):** May affect response quality
For best results, keep your instructions under 10,000 characters. Detailed information (room types, restaurant hours, policies) should go in [Training Materials](/admin-panel/documents), not here — your receptionist will automatically reference them when needed.
Click the **Expand** button for a full-screen editing experience — much easier for longer instructions.
The quality of your receptionist's responses depends directly on how well you write these instructions. Take the time to be specific. For a step-by-step guide, see the [Chat Prompts Guide](/prompt-engineering/chat-prompts).
## Thinking Engine
This field shows which AI model powers your receptionist's chat responses. It's configured by the RecepAI team and displayed as **read-only** so you always know what's running behind the scenes.
If you need a different model, contact your account manager.
## Creativity Level
The creativity slider controls how predictable your receptionist's responses are:
| Level | Range | Best For |
| ------------ | --------- | ------------------------------------------------------------ |
| **Focused** | 0.0 - 0.3 | Most accurate and consistent. **Recommended for reception.** |
| **Balanced** | 0.4 - 0.7 | More natural, slightly less predictable |
| **Creative** | 0.8 - 1.0 | Not recommended for guest services |
For hotel receptionists, we recommend the **Focused** range (0.3 or lower). Guests need accurate, reliable answers — not creative interpretations.
If your hotel uses a reasoning model (a model that thinks more deeply before responding), the Creativity Level slider won't appear. These models manage their own response style internally.
## Chat Quality Criteria
Define what "success" means for your hotel's chat conversations. After each chat, your receptionist automatically evaluates whether these criteria were met — and flags conversations that need your attention.
**How to set criteria:**
1. Click **"Add Criteria"**
2. Give it a clear name (e.g., "Guest Question Answered")
3. Describe what success looks like (e.g., "The guest's specific question was answered with accurate information")
**Example criteria:**
* Guest confirmed their question was answered
* Booking inquiry was handled with reservation contact info
* Guest expressed satisfaction or thanks
Quality criteria work hand-in-hand with [Training Opportunities](/admin-panel/dashboard#training-opportunities) on your Dashboard. When your receptionist fails a criteria because it lacks knowledge on a topic, that conversation shows up as a training opportunity — telling you exactly what to add to your [Training Materials](/admin-panel/documents).
For a deeper dive into quality criteria, see the [Chat Evaluation Guide](/quality/chat-evaluation).
## Saving Changes
Click **"Save Personality"** at the top of the page to apply your changes. If you have unsaved changes and try to leave, you'll see a warning.
Use the **"Reset Changes"** button at the bottom to discard everything and go back to the last saved version.
# Dashboard
Source: https://recepai.ai/docs/admin-panel/dashboard
Your command center — track your receptionist's performance, complete setup, and discover training opportunities.
The Dashboard is the first thing you see when you log in. It greets you by name, shows your hotel, and gives you everything you need at a glance: setup progress, performance stats, savings, and training opportunities.
## Onboarding Checklist
When you first start, a **7-step checklist** guides you through hiring your receptionist. Each step lights up with a gold checkmark as you complete it:
Set your receptionist's greeting, tone, and how they chat with guests. Takes you to the [Conversation Agent](/admin-panel/conversation-agent) page.
Define your quality standards — after every chat, your receptionist will tell you how it went and what to teach next.
Pick their voice, first words, and phone personality. Takes you to the [Voice Agent](/admin-panel/voice-agent) page.
Set call quality rules — your receptionist will evaluate and flag what went wrong.
Upload everything they need to assist your guests. Takes you to [Training Materials](/admin-panel/documents).
Your receptionist is ready for the front desk! Takes you to the [Widget Builder](/admin-panel/widget-builder).
Review their work and usage — they'll show you what needs attention. Takes you to [History](/admin-panel/history).
Once all 7 steps are complete, the checklist collapses into a **"Your RECEPtionist is live"** banner. You can expand it anytime with the **Show/Hide** toggle, or click **Preview** to see your receptionist in action.
## Savings Calculator
This is where you see the real impact. The savings widget shows:
* **Total time worked** — how many hours and minutes your receptionist has spent answering guest questions
* **Estimated savings** — the dollar value of that work, calculated from an hourly rate you set
* **Start date** — when your receptionist first started working for your hotel
### Customize Your Hourly Rate
Click the **Edit** link next to "Based on \$15/hour" to enter the average hourly receptionist salary in your area. This makes the savings estimate match your real costs — so you can see exactly how much your receptionist is saving you.
You can filter savings by **All Time**, **This Month**, or **This Year** to track performance across different periods.
**Why this matters:** If a human receptionist in your area costs $20/hour and your AI receptionist handled 40 hours of guest conversations this month, that's $800 in savings — visible right on your dashboard.
## Statistics
Below the savings widget, four cards show your receptionist's activity this month:
| Card | What It Shows |
| -------------------- | -------------------------------------- |
| **Chats this month** | Number of text conversations handled |
| **Calls this month** | Number of voice calls handled |
| **Training docs** | Total documents in your knowledge base |
| **Guest feedback** | Thumbs up and thumbs down from guests |
Each card is clickable — tap any card to jump directly to the relevant page for more details.
### Training Opportunities
The **Chats** card has a special feature: when your receptionist encounters a question it couldn't answer well, a blue **training opportunities** badge appears below the chat count.
For example: a guest asks *"Can I bring my pet to the hotel?"* — if your receptionist hasn't been trained on your pet policy, it flags this conversation. The badge shows how many such gaps exist.
Click the badge to see exactly which topics need attention, then add the missing information to your [Training Materials](/admin-panel/documents). This is how your receptionist gets smarter over time — it tells you what it doesn't know, so you can teach it.
Make it a habit to check training opportunities regularly. Each one represents a real guest question that your receptionist couldn't fully answer — and a chance to improve.
## Quick Actions
At the bottom of the dashboard, shortcut buttons let you jump to the most common tasks:
| Button | Where It Goes |
| --------------------- | ------------------------------------------------------------------------------ |
| **Chat Personality** | [Conversation Agent](/admin-panel/conversation-agent) — edit chat instructions |
| **Give Them a Voice** | [Voice Agent](/admin-panel/voice-agent) — configure voice settings |
| **Train Them** | [Training Materials](/admin-panel/documents) — upload documents |
| **Get Add-ons** | [Billing](/admin-panel/billing) — purchase additional credits |
| **Show Time** | [Widget Builder](/admin-panel/widget-builder) — preview and deploy |
# Desk Bell
Source: https://recepai.ai/docs/admin-panel/desk-bell
Set up automatic notifications when your receptionist needs attention — get alerts via email, SMS, or WhatsApp.
The Desk Bell page lets you configure automatic notifications so you know when your receptionist needs your attention — without constantly checking the dashboard.
**How to access this page:** Click the **RecepAI menu icon** in the top-right corner of your admin panel, then select **"Desk Bell"** from the dropdown menu.
Think of it as a real desk bell at a hotel front desk. When something needs your attention, it rings.
***
## Ring the Bell
At the top of the page, the **"Ring the bell"** toggle controls whether Desk Bell notifications are active. When turned **off**, no notifications are sent — regardless of channel or alert type settings below. Everything underneath becomes grayed out.
Turn it **on** to activate the system and configure your channels and alert types.
***
## How to Reach You
This section controls **where** your notifications are delivered. You can enable one, two, or all three channels — each works independently.
### Email
Add up to **5 email addresses** to receive notifications. Click **Add** after entering each address. Remove any address by clicking the **×** next to it.
### SMS
Add up to **3 phone numbers** in international format (e.g., `+905551234567`). Each number receives a short text message when an alert triggers.
### WhatsApp
Add up to **3 WhatsApp-enabled phone numbers** in the same international format. Messages are delivered as WhatsApp Business messages.
**Use multiple channels for critical alerts.** For example, enable both Email and SMS so you get a detailed email *and* an instant text message.
### Email Settings
Below the channel cards, two optional fields let you customize your email notifications:
| Field | What It Does |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Email Sender Name** | The "From" name that appears in the recipient's inbox (e.g., "Grand Hotel Front Desk"). If left empty, defaults to `RecepAI`. |
| **Reply-To Address** | When someone replies to a notification email, the reply goes to this address instead of a no-reply address (e.g., `info@yourhotel.com`). |
***
## Alert Types
This section controls **what** triggers a notification. Each alert type can be toggled on or off independently, and you choose which channels it uses.
### Chat Quality Criteria
**What it detects:** Your receptionist couldn't answer a guest question in chat — a topic was asked that isn't covered in your training materials.
**When it triggers:** After every chat conversation, your receptionist evaluates whether it could answer everything. If a knowledge gap is found, you get notified with the missing topic names.
**What you receive:**
* **Email:** A branded message listing the missing topics, with a direct link to add training material.
* **SMS:** A one-line alert with the first missing topic and a link to your training page.
* **WhatsApp:** A short message with the missing topic summary.
**What to do:** Click the link in the notification to go directly to your [Training](/admin-panel/documents) page and add the missing information.
### Voice Quality Criteria
**What it detects:** A voice call didn't meet one or more of your quality criteria — the standards you defined on the [Voice Settings](/admin-panel/voice-agent) page under "Voice Quality Criteria."
**When it triggers:** After every voice call ends, the AI evaluates the conversation against your defined criteria. If any criterion gets a "fail" result, you get notified with the specific criteria that weren't met.
**What you receive:**
* **Email:** A branded message listing the failed criteria names, with a link to review the call in Voice History.
* **SMS:** A one-line alert naming the failed criterion (or count if multiple) with a link to Voice History.
* **WhatsApp:** A short message with the hotel name and failed criteria summary.
**What to do:** Click the link to go to [Analytics → Voice History](/admin-panel/history) and review the specific call.
### Channel Pills
Each alert type shows three channel pills: **Email**, **SMS**, and **WhatsApp**. Click a pill to toggle that channel for that specific alert type. A highlighted (gold) pill means that channel is active for this alert.
A channel pill only works if the channel itself is enabled **and** has at least one recipient in the "How to Reach You" section above. If you activate SMS for an alert type but haven't added any phone numbers, no SMS will be sent.
***
## Send Test
Each alert type has a **Send Test** button. When clicked, it sends a test notification through all active channels for that alert type. This lets you:
* Verify that your email, SMS, and WhatsApp delivery is working
* See exactly what the notification looks like
* Confirm the right people are receiving alerts
The test sends to the **first recipient** of each active channel. Test notifications are marked with a `[TEST]` prefix so you can distinguish them from real alerts.
***
## Recent Rings
At the bottom of the page, a delivery log shows every notification that was sent. Each entry includes:
| Column | What It Shows |
| ------------- | ------------------------------------------------------------------------------------- |
| **Date** | When the notification was sent |
| **Type** | Which alert type triggered it (e.g., `training_opportunity`, `voice_criteria_failed`) |
| **Channel** | How it was delivered (Email, SMS, or WhatsApp) |
| **Recipient** | Who received it |
| **Status** | Delivery result — `sent`, `failed`, or `skipped` |
Use this log to confirm that notifications are being delivered and to troubleshoot any delivery issues.
***
## Saving Changes
Changes on this page are **not saved automatically**. When you make any change — toggle a channel, add a recipient, enable an alert type — a floating **"Save Changes"** bar appears at the bottom of the screen. Click it to save all your changes at once.
If you leave the page without saving, your changes will be lost. Always click **Save Changes** before navigating away.
***
## How It All Works Together
A guest asks a question your receptionist can't answer (chat), or a voice call fails your quality criteria (voice).
The system looks at your alert type settings — is this alert type enabled? Which channels are active for it?
For each active channel with recipients, a notification is sent. Email gets a detailed message, SMS and WhatsApp get a short one-liner.
Click the link in the notification to go directly to the relevant page — Training for chat gaps, Voice History for quality issues.
***
## Tips
**Start with email only.** Enable one alert type with email first. Once you're comfortable with the frequency and content, add SMS or WhatsApp for instant mobile alerts.
**Set up Voice Quality Criteria first.** Before Voice Quality Alerts can work, you need to define at least one criterion on the [Voice Settings](/admin-panel/voice-agent) page. Without criteria, there's nothing to evaluate.
**Check Recent Rings if something seems off.** If you're not receiving notifications, scroll to the bottom of the Desk Bell page and check the delivery log. A `failed` status usually means an invalid email address or phone number.
# Training Materials
Source: https://recepai.ai/docs/admin-panel/documents
Upload, manage, and organize the knowledge your receptionist uses to help guests.
The Training Materials page is where you teach your receptionist everything about your hotel — room types, restaurant hours, policies, local tips, and anything else a guest might ask about.
**This is the most impactful page in your entire setup.** The quality of what you upload here directly determines how well your receptionist answers guest questions. A receptionist with great instructions but poor training materials will still give poor answers.
**How it connects to your Dashboard:** When your receptionist encounters a question it can't answer, it flags the conversation as a [training opportunity](/admin-panel/dashboard#training-opportunities). Those flags point you right back here — telling you exactly what knowledge to add. This is how your receptionist gets smarter over time.
## Adding Content
You have four ways to teach your receptionist. Each method creates entries in your **Receptionist's Library** below.
Upload files directly. Supports **PDF, DOCX, TXT, CSV, XLSX, JSON, and Markdown**. You can select multiple files at once and upload them in a single batch.
Sync pages directly from your Notion workspace. Perfect if your team already manages hotel information in Notion. Changes in Notion can be re-synced anytime.
Create content directly in RecepAI using the built-in editor. Choose **New Page** for rich-text content or **Q\&A** for frequently asked questions. This is the fastest way to add knowledge.
Import content from your hotel's website — either a single page or an entire sitemap. Your receptionist learns directly from your live web pages.
### Add Docs
Click **"Add Docs"** to upload files from your computer.
1. Enter a **Material Name** (e.g., "Hotel Policy", "Room Types")
2. Click or drag files into the upload area — **multiple files supported**
3. Click **Upload** to start processing
**Supported file types:** PDF, DOCX, TXT, CSV, XLSX, JSON, Markdown
**What are "pieces"?** When you upload a document, your receptionist breaks it into smaller knowledge pieces (chunks). A 10-page PDF might become 15-20 pieces. This is normal — AI processes smaller chunks more accurately than one large block of text.
### Write Notes
Click **"Write Notes"** to create content directly in RecepAI. A dropdown lets you choose between two formats:
**New Page** — Opens a full-page editor where you can write rich-text content with formatting. The editor supports **bold**, **italic**, **headings**, **links**, **bullet and numbered lists**, **blockquotes**, and **dividers**. Content is saved in [Markdown](https://www.markdownguide.org/basic-syntax/) format, which your receptionist reads with high accuracy.
1. Give your page a title (e.g., "Room Types", "Spa Menu")
2. Write or paste your content — use the toolbar to format
3. Click **Save** — or click **Save & New** to save and immediately start another page
**Q\&A** — Opens a full-page editor designed for question-and-answer pairs. Each pair is a card with a question field and an answer field.
1. Give your Q\&A set a title (e.g., "Check-in FAQ", "Room Service Questions")
2. Fill in question-answer pairs — click **"Add Question"** for more
3. Click **Save** — or click **Save & New** to save and start a new set
**Q\&A is the most effective format** for training your receptionist. It maps directly to how guests ask questions — "What time is breakfast?" gets a precise answer instead of your receptionist searching through a long document. Start with Q\&A for your most common guest questions, then use New Page for longer content like policies and descriptions.
### Notion Library
If your team uses Notion to manage hotel information, you can sync pages directly:
**Connecting for the first time:**
1. Click **"Notion Library"** — a side panel opens
2. Click **"Import from Notion"**
3. Authorize RecepAI to access your Notion workspace
4. Select which pages to import — you can choose multiple
5. Click **"Import Selected"** — your receptionist learns the content automatically
**Updating existing Notion content:**
1. Open the side panel and click **"Check for Updates"**
2. If pages were modified in Notion, you'll see a list of changed documents
3. Click **"Train RECEPtionist"** to sync the latest content
**Deleted pages:** If you delete a page in Notion, RecepAI detects this and warns you. You'll see a "pages no longer exist in Notion" message with an option to **"Remove All from Library"** to clean up.
**Editing a Notion document:**
* Click the **view icon** (eye) on any Notion document in your library
* You'll see the current content (read-only) and sync status
* Click **"Edit in Notion"** to open the page in Notion
* After editing, come back and click **"Train RECEPtionist"** to sync your changes
If the connection to Notion breaks (e.g., you revoked access), click **"Reconnect to Notion"** in the side panel to re-authorize.
**Need more details?** Our complete Notion guide covers how the sync mechanism works, what to do when pages show as deleted, who should connect Notion, troubleshooting tips, and best practices.
### Scan Web
Import content directly from your hotel's website. Your receptionist learns from your live web pages.
**Single page import:**
1. Click **"Scan Web"** — a side panel opens
2. Paste any page URL (e.g., `https://yourhotel.com/rooms`)
3. Optionally enter a title (otherwise the page title is used)
4. Click **"Import Page"**
**Sitemap import (multiple pages):**
1. Paste your sitemap URL (e.g., `https://yourhotel.com/sitemap.xml`)
2. RecepAI analyzes the sitemap and shows all available pages
3. Use **Select All** or pick individual pages
4. Click **"Import Pages"** — progress updates in real-time
**50 page limit.** Your receptionist can learn from up to 50 web pages total. The counter shows how many slots you've used. If you need to add more, delete some existing web pages first.
**Advanced filters (sitemap mode):**
When importing from a sitemap, you can filter which pages to include:
| Filter | What It Does | Example |
| ----------------- | ----------------------------------------- | --------------------------------------------- |
| **Include Pages** | Only import pages matching these patterns | `/en/` — only English pages |
| **Ignore Pages** | Skip pages matching these patterns | `/blog/`, `/fr/` — skip blog and French pages |
Focus on pages that help guests — rooms, amenities, restaurants, location, contact info. Skip blog posts, career pages, and non-guest-facing content.
**Keeping web content fresh:**
* Click the **view icon** on any web document to see its extracted content
* Click **"Re-fetch Page"** to pull the latest version from your website
* Click **"Download"** to save the extracted content as a Markdown file
## Receptionist's Library
All your training materials appear in a searchable table:
| Column | What It Shows |
| ----------------- | --------------------------------------------------------- |
| **Material Name** | Document title (with type icon) |
| **Type** | Source type — File, Notion, Page, Q\&A, or Web |
| **Pieces** | How many knowledge pieces the document was split into |
| **Status** | "Learned" when your receptionist has absorbed the content |
| **Actions** | View, edit, replace, or delete (varies by type) |
### Filtering and Searching
* Use the **search bar** to find specific documents by name
* Click **filter pills** (All, Files, Notion, Page, Q\&A, Web) to filter by type
* Each filter shows a count of documents in that category
### Actions by Document Type
| Type | Available Actions |
| ---------- | --------------------------------------------------- |
| **File** | Replace file (upload new version), Delete |
| **Page** | Edit in full-page editor, Delete |
| **Q\&A** | Edit question-answer pairs, Delete |
| **Notion** | View content (read-only), Delete |
| **Web** | View content, Re-fetch page, Download as MD, Delete |
**Bulk delete:** Select multiple documents using checkboxes, then click **"Delete Selected"** to remove them all at once.
**Replace file:** For file-type documents, you can upload a new version without deleting and re-creating. Click the replace icon, upload the new file, and your receptionist re-learns the updated content.
## After Uploading
**Always test after uploading new content.** Open the chat widget and ask questions about the content you just uploaded. If the answers aren't accurate, review the [Document Preparation Guide](/knowledge-base/document-preparation) for tips on formatting your content for better results.
For detailed guidance on structuring your documents, see the [Knowledge Base Overview](/knowledge-base/overview).
# Analytics
Source: https://recepai.ai/docs/admin-panel/history
Monitor guest conversations, see your receptionist in action, and keep track of your credits.
The Analytics page is your window into every guest interaction — text conversations, voice calls, and credit usage. Use it to monitor performance, spot knowledge gaps, and continuously improve your receptionist.
**This is where the self-improving loop happens.** Your receptionist automatically evaluates every conversation, identifies where it couldn't help, and flags those as training opportunities. You review them here, add the missing knowledge to [Training Materials](/admin-panel/documents), and your receptionist gets smarter with every cycle.
The page has three tabs: **Chat History**, **Voice History**, and **Usage**.
***
## Chat History
Shows every text conversation your receptionist has had with guests.
### Conversation Table
Each row in the table displays:
| Column | What It Shows |
| -------------- | ----------------------------------------------------------------------- |
| **Date/Time** | When the conversation started |
| **Session ID** | Unique identifier for the conversation |
| **Messages** | Total number of messages exchanged |
| **Feedback** | Guest thumbs up/down reactions (if any) |
| **Status** | Quality evaluation result — see [Quality Status](#quality-status) below |
Click any row to open the **Conversation Details** panel on the right side.
### Filters
Use the toolbar at the top to narrow down conversations:
| Filter | Options | What It Does |
| -------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Date Range** | Start and end date pickers | Show conversations within a specific period. Defaults to the last 30 days. |
| **Feedback** | All, With Feedback, Positive, Negative | Filter by guest reactions. "With Feedback" shows any conversation where a guest gave a thumbs up or down. |
| **Quality** | All, Successful, Needs Training, Other Issues, Partial, Pending | Filter by how well your receptionist performed. **"Needs Training"** is the most actionable — these are conversations where adding knowledge will make a difference. |
| **Search** | Free text | Search through conversation content |
**Start with "Needs Training" filter.** These conversations show exactly where your receptionist couldn't help because it was missing information. Fix these first for the biggest impact.
### Export
Click **"Export JSON"** to download all visible conversations as a JSON file. Useful for external analysis or record-keeping.
### Conversation Details
Click any conversation row to open a slide-in panel with two tabs:
**Overview tab:**
* **Session metadata** — Session ID, start time, end time, message count
* **Guest Feedback** — Every thumbs up/down the guest gave, including any written comments with timestamps
* **Quality Criteria** — Each evaluation criterion shows a pass/fail result with a rationale explaining why. See [Quality Status](#quality-status) for details.
* **Training Opportunity** — If the conversation failed, this box shows the specific topics your receptionist couldn't answer. These appear as tags (e.g., "spa hours", "parking policy") so you know exactly what to add to [Training Materials](/admin-panel/documents).
* **Mark as Trained** — After you've added the missing information, click this button to mark the conversation as resolved. See [Training Workflow](#training-workflow) below.
**Transcript tab:**
* The complete conversation between the guest and your receptionist, displayed as a chat timeline with timestamps for each message.
***
## Voice History
Shows every voice conversation — whether the guest called through the website widget, a lobby kiosk, or a phone line.
### Call Table
| Column | What It Shows |
| ------------- | ----------------------------------------------- |
| **Date/Time** | When the call started |
| **Duration** | Call length (minutes:seconds) |
| **Messages** | Number of conversation turns |
| **Status** | Evaluation result — Success, Failed, or Unknown |
| **Details** | Eye icon — click to open the call details panel |
### Filters
| Filter | Options | What It Does |
| -------------- | ----------------------------- | ------------------------------- |
| **Date Range** | Start and end date pickers | Defaults to the last 30 days |
| **Status** | All, Success, Failed, Unknown | Filter by call outcome |
| **Search** | Free text | Search through call transcripts |
### Export
Click **"Export JSON"** to download all visible voice conversations.
### Call Details
Click the eye icon on any row to open the details panel:
* **Audio Player** — Listen to the recorded call directly in the panel (when recording is available)
* **Overview tab** — Call metadata (date, duration, messages, status) plus evaluation criteria results with pass/fail for each criterion
* **Transcription tab** — Full text transcript of the voice conversation, showing what the guest said and how your receptionist responded
Voice evaluation criteria are configured on the [Voice Settings](/admin-panel/voice-agent#guest-satisfaction-criteria) page. If you haven't set up criteria yet, conversations will show as "Unknown" status.
***
## Usage
Track your credit consumption and manage your plan.
### Plan Header
At the top you'll see:
* **Plan badge** — Your current plan name (e.g., RECEPTIONIST)
* **Next renewal date** — When your credits reset
* **Current billing cycle** — The date range for your current period
* **Upgrade Plan** — Button to view available plan upgrades
### Voice Credits
A progress bar showing your monthly voice minute consumption:
* **Monthly Allowance** — Used minutes vs. total allocation (e.g., "628 / 100.0K")
* **Percentage indicator** — Color-coded: green (normal), orange (approaching limit), red (near limit)
* **Sync button** — Refresh the usage data to get the latest numbers
* **Buy More** — Purchase additional voice credits if you're running low
### Chat Credits
Same layout as Voice Credits:
* **Monthly Allowance** — Used credits vs. total allocation
* **Percentage indicator** — Same color-coded system
* **Buy More** — Purchase additional chat credits
If you've purchased add-on credits (via "Buy More"), they appear as a separate purple progress bar below the monthly allowance, with their expiration date shown.
### Your Feature Add-ons
Shows any premium features you've activated — WhatsApp integration, Telegram integration, Custom Avatar, and more. If you haven't purchased any add-ons yet, you'll see a **"Browse Features"** button to explore available options.
For details on purchasing add-ons and managing your subscription, see the [Billing](/admin-panel/billing) page.
***
## Quality Status
After each conversation ends, your receptionist automatically evaluates it against the success criteria you've defined on the [Chat Settings](/admin-panel/conversation-agent) or [Voice Settings](/admin-panel/voice-agent) page. The result appears as a colored badge:
| Badge | Color | Meaning | Action Needed |
| ------------------ | ----------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Success** | Green | All quality criteria were met | None — your receptionist handled it well |
| **Needs Training** | Red | Your receptionist couldn't answer because it was missing information | **Yes** — add the missing info to [Training Materials](/admin-panel/documents) |
| **Other Issues** | Gray | The conversation didn't go well, but it's not a knowledge gap | Review the conversation to understand what happened |
| **Partial** | Orange | Some criteria passed, some failed | Review which criteria failed and whether adding knowledge would help |
| **Pending** | Yellow (animated) | Still being analyzed — results ready in about 5 minutes | Wait — the evaluation is processing |
| **Skipped** | Gray | Evaluation was skipped (e.g., conversation was too short) | None |
| **Trained** | Purple | Previously "Needs Training" but you've marked it as resolved | None — you've already handled it |
**No criteria = no evaluation.** If you haven't set up quality criteria on the [Chat Settings](/admin-panel/conversation-agent) or [Voice Settings](/admin-panel/voice-agent) page, conversations won't be evaluated and will show as "Skipped".
***
## Training Workflow
This is the most important workflow in RecepAI — the cycle that makes your receptionist smarter over time:
Your [Dashboard](/admin-panel/dashboard) shows a **Training Opportunities** badge with the number of conversations that need attention. Click it to jump directly to Chat History, pre-filtered to show only "Needs Training" conversations.
Click a conversation to open the details panel. In the **Training Opportunity** box, you'll see the specific topics your receptionist couldn't answer — displayed as tags like "spa hours", "parking rates", "late checkout policy".
Go to [Training Materials](/admin-panel/documents) and add the information your receptionist was missing. Use **Write Notes** in Q\&A format for the fastest results.
Return to the conversation and click **"Mark as Trained"**. The status changes from "Needs Training" to "Trained" (purple badge), and the Dashboard badge count decreases.
**Check every 2-3 days.** Regular reviews help your receptionist improve quickly. Focus on "Needs Training" conversations first — "Other Issues" are usually not fixable with documents alone.
# Team Members
Source: https://recepai.ai/docs/admin-panel/users
Manage who on your team can access and configure your AI receptionist — set roles, permissions, and module access.
The Team Members page lets you control who on your team can access your receptionist's settings — and exactly what they can do.
**How to access this page:** Click the **RecepAI menu icon** in the top-right corner of your admin panel, then select **"Team Members"** from the dropdown menu. This page is not in the main sidebar navigation.
**Manager access required.** To see the Team Members menu, your RecepAI account manager must first grant you **Manager** access. If you don't see "Team Members" in the dropdown, contact your RecepAI account manager to request it.
***
## Roles: Manager vs Staff
Every team member has one of two roles:
| Role | Badge | What They Can Do |
| ----------- | ------------ | ------------------------------------------------------------------------------------------------ |
| **Manager** | Purple badge | Add, edit, and archive other team members. Full control over team settings. |
| **Staff** | Green badge | Work within their assigned permissions and modules. **Cannot** add or manage other team members. |
Only a **RecepAI account manager** (Hotel Linkage staff) can promote someone to Manager. Managers themselves cannot change someone's role — they can only set permissions and module access for existing Staff members.
***
## Permissions
Each team member gets granular permissions that control what actions they can take:
| Permission | Badge Color | What It Allows |
| ---------- | ----------- | ----------------------------------------------------------------------------------------------- |
| **Read** | Blue | View all settings, documents, conversations, and analytics (read-only) |
| **Edit** | Yellow | Modify settings, upload documents, change configurations — everything Read can do, plus writing |
| **Delete** | Red | Remove documents, archive conversations — everything Edit can do, plus deletion |
Permissions are **cumulative** — a team member with Edit automatically has Read, and a team member with Delete has both Read and Edit.
**Recommended setup:** Give most team members **Read + Edit**. Reserve **Delete** for senior staff who need to remove documents or manage content. This prevents accidental deletions while keeping everyone productive.
***
## Team Members Table
The main table shows all team members at a glance:
| Column | What It Shows |
| --------------- | ------------------------------------------------------------------------- |
| **Team Member** | Name, email address, and hotel access count (for chain users) |
| **Permissions** | Permission badges (Read, Edit, Delete) plus role badge (Manager or Staff) |
| **Status** | Active (green dot) or Inactive (gray dot) |
| **Actions** | Edit and Archive buttons (or Edit and Reactivate for archived members) |
### Hide Archived Toggle
By default, archived (inactive) team members are hidden. Toggle **"Hide Archived"** off to see all team members, including those who have been archived. This is useful when you need to reactivate someone.
***
## Adding a Team Member
Click **"Add Team Member"** to open a slide-in panel with the following sections:
### Account Information
| Field | Required | Details |
| ----------------- | ----------------- | ----------------------------------------------------------------------------- |
| **Display Name** | Yes | The name shown in the team members table |
| **Email Address** | Yes | Used for login — must be a valid email |
| **Password** | Yes (new members) | Minimum 8 characters with uppercase, lowercase, number, and special character |
### Permissions
Choose which actions this team member can perform:
* **Read** — View settings and data (enabled by default)
* **Edit** — Modify settings and upload content (enabled by default)
* **Delete** — Remove documents and content (off by default)
Click each permission toggle to enable or disable it. At minimum, every team member has Read access.
**You can only grant permissions you have.** If you don't have Delete permission yourself, you cannot give Delete to someone else. Toggles for permissions you don't have will be grayed out.
### Staff Access
Control which sections of the admin panel this team member can see:
**Full Access** — Complete access to all receptionist tools. The team member sees every page in the admin panel.
**Limited Access** — Choose specific modules. When selected, a grid of module cards appears:
| Module | What It Includes |
| --------------- | -------------------------------------------------------- |
| **Chat Agent** | Chat personality and AI settings |
| **Voice Agent** | Voice personality and call settings |
| **Training** | Document upload and knowledge base management |
| **Widget** | Widget appearance and deployment settings |
| **Analytics** | Conversation history, evaluation results, and usage data |
| **Front Desk** | PMS integration and guest management |
Select one or more modules by clicking their cards. You must select at least one module when using Limited Access.
**Match access to responsibilities.** Give your marketing team access to Widget and Training — they know your brand best. Give your front desk manager access to Analytics and Chat Agent — they see guest needs firsthand. Everyone contributes what they know.
### Advanced Options
| Setting | What It Does |
| ---------- | ------------------------------------------------------------------------------------------------------ |
| **Active** | When off, the team member cannot log in. Use this to temporarily suspend access without removing them. |
***
## Editing a Team Member
Click the **Edit** button (pencil icon) on any row to open the same slide-in panel with the team member's current settings pre-filled. You can change:
* Display name
* Password (leave blank to keep the current one)
* Permission toggles (Read, Edit, Delete)
* Staff Access (Full or Limited, with module selection)
* Active status
**Hierarchy rules apply.** Managers can freely edit any Staff member — including granting Delete permission. However, when editing another Manager, you can only modify their settings if your permission level is higher than theirs. You cannot edit a Manager with equal or higher permissions.
***
## Archiving & Reactivating
RecepAI uses **archiving** instead of permanent deletion. This keeps a record and makes it easy to bring someone back.
### Archiving a Team Member
1. Click the **Archive** button (box icon) on the team member's row
2. A confirmation dialog appears explaining that the member will lose access
3. Click **"Archive"** to confirm
The team member's status changes to **Inactive** — they can no longer log in, but their record is preserved.
### Reactivating a Team Member
1. Turn off the **"Hide Archived"** toggle to see inactive members
2. Click the **Reactivate** button (checkmark-person icon) on the archived member's row
3. Their status changes back to **Active** and they can log in again
**Seasonal staff?** Archive team members at the end of the season and reactivate them when they return. Their permissions and module access are preserved — no need to set everything up again.
***
## Hotel Chain Users
If your organization manages multiple hotels, the Team Members page supports **per-hotel access control**.
Instead of the standard Permissions section, chain users see a **Hotel Access** section where you can:
* Add multiple hotels from a dropdown
* Set **different permissions** (Read, Edit, Delete) for each hotel
* Click **"Add Another Hotel"** to grant access to additional properties
* Remove a hotel from the list with the **x** button
This means a team member could have Edit access at one hotel and Read-only access at another — giving you precise control across your portfolio.
# Voice Settings
Source: https://recepai.ai/docs/admin-panel/voice-agent
Choose your receptionist's voice, speaking style, and call quality criteria — for website, kiosk, or phone.
The Voice Settings page is where you define how your receptionist communicates through **voice** — whether guests are speaking through your website chat widget, a lobby kiosk, or a phone line.
**Voice works everywhere, not just phone.** Your receptionist's voice feature appears as a microphone button in the chat widget. Guests can type a message *or* tap the microphone to have a real-time voice conversation — just like a voice assistant. The same voice settings apply whether the conversation happens on your website, an embedded kiosk, or a phone line.
**Want to connect voice to your phone line?** Phone integration requires additional setup. Contact your account manager or the RecepAI support team to get started.
## Voice Selection
The sidebar shows your currently selected voice with a **preview button** to hear a sample. Click the **settings icon** to open the Voice Settings modal, or click the voice name to open the voice selection modal.
In the voice selection modal, you can:
* Browse all available voices in a visual grid
* Preview each voice before selecting
* Choose the voice that best represents your hotel's personality
Listen to several voices before choosing. A luxury resort might want a calm, measured voice. A boutique city hotel might prefer something warmer and more energetic.
## How They Should Talk
This is the most important field on this page. Think of it as the training manual you'd hand a new receptionist — explain the tone, the boundaries, and how they should handle different situations during a voice conversation.
**Common mistake:** Don't put hotel information (room types, prices, hours, policies) in this field. That belongs in [Training Materials](/admin-panel/documents). This field is for *behavior* — how your receptionist should speak, not what they should know. Your receptionist automatically pulls knowledge from Training Materials during conversations.
**Key difference from chat:** Voice responses must be short (2-3 sentences max), use natural speech patterns, and avoid formatting like bullet points, links, or markdown — none of that translates to spoken audio.
See the [Voice Prompts Guide](/prompt-engineering/voice-prompts) for detailed guidance.
**Character Limit:** 12,000 characters maximum. The counter changes color to guide you:
* **Green (0 - 8,000):** Optimal range
* **Orange (8,000 - 10,000):** Getting long — consider moving details to Training Materials
* **Red (10,000 - 12,000):** May affect response quality
For best results, keep your instructions under 10,000 characters. Detailed information (room types, restaurant hours, policies) should go in [Training Materials](/admin-panel/documents), not here.
Click the **Expand** button for a full-screen editing experience — much easier for longer instructions.
The quality of your receptionist's voice responses depends directly on how well you write these instructions. Take the time to be specific. For a step-by-step guide, see the [Voice Prompts Guide](/prompt-engineering/voice-prompts).
## Voice Settings
Click the **settings icon** (gear) next to the voice selector to open the Voice Settings modal. Settings are organized into two sections:
### AI Brain
| Setting | What It Does |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Thinking Model** | Shows which AI model powers your receptionist's voice responses. This is **read-only** — configured by the RecepAI team. Contact your account manager if you need a different model. |
| **Creativity Level** | Controls how predictable responses are. **Focused (0.0 - 0.3):** Most accurate, recommended for reception. **Balanced (0.4 - 0.7):** More natural. **Creative (0.8 - 1.0):** Not recommended for guest services. |
For hotel receptionists, we recommend the **Focused** range (0.3 or lower). Guests need accurate, reliable answers — not creative interpretations.
### Voice Quality
| Setting | What It Controls | Recommended Range |
| --------------- | --------------------------------------------------------------------------- | ------------------------- |
| **Stability** | Voice emotional variation. Lower = more expressive, Higher = calmer | 0.5 - 0.7 for most hotels |
| **Speed** | Speaking pace. 0.9x = relaxed (resorts), 1.1x = efficient (business hotels) | 0.9 - 1.1 |
| **Voice Match** | How closely AI matches the selected voice | 0.75 - 0.85 |
## Greeting
Set the first thing your receptionist says when a guest starts a voice conversation. Keep it short and welcoming:
> "Hello, welcome to Grand Hotel Istanbul. How may I help you today?"
**Character limit:** 500 characters. A great greeting is 1-2 sentences.
## Guest Satisfaction Criteria
Define what "success" means for your hotel's voice conversations. After each conversation, your receptionist automatically evaluates whether these criteria were met — and flags conversations that need your attention.
**How to set criteria:**
1. Click **"Add Criteria"**
2. Give it a clear name (e.g., "Guest Question Answered") — up to 50 characters
3. Describe what success looks like (e.g., "The guest's specific question was answered with accurate information") — up to 2,000 characters
**Example criteria:**
* Guest confirmed their question was answered
* Reservation inquiry handled with specific contact information
* Alternative options offered when first choice unavailable
**Avoid:**
* Vague criteria like "Good service"
* Multiple conditions in one criterion
Satisfaction criteria work hand-in-hand with your conversation history. When your receptionist fails a criteria because it lacks knowledge on a topic, that conversation shows up as a training opportunity — telling you exactly what to add to your [Training Materials](/admin-panel/documents).
Click **"View results in Voice History"** at the bottom of the criteria section to see how your receptionist is performing against these standards.
For a deeper dive, see the [Voice Evaluation Guide](/quality/voice-evaluation).
## Saving Changes
Click **"Save Voice"** at the top of the page to apply your changes. If you have unsaved changes and try to leave, you'll see a warning.
# Website Widget
Source: https://recepai.ai/docs/admin-panel/widget-builder
Customize how your receptionist looks, speaks, and interacts — then deploy it to your website, kiosk, or custom domain.
The Website Widget page is where you design your receptionist's entire guest-facing experience — from visual appearance and greeting messages to language support, security settings, and deployment options.
Every change you make is reflected in the **live preview** on the right side of the page. Click **"Open Full Preview"** at the top to see the full widget in a new tab.
## Brand Look
Set the visual identity that guests see when they interact with your receptionist.
| Setting | What It Does |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hotel Name** | Displayed in the widget header. Use your hotel's official name. |
| **Primary Color** | Your brand color — affects buttons, accents, links, and the overall widget feel. Click the color circle to open the picker, or type a hex code directly (e.g., `#C49E47`). |
## Staff Appearance
Upload the visual assets that represent your receptionist. Each element has specific size and format requirements:
**280×100px** — PNG, JPG, or SVG (max 2MB). Displayed in the widget header.
**800×800px square** — PNG or JPG (max 2MB). The profile picture shown next to your receptionist's messages and on the floating avatar.
**720×720px square** — MP4 or WebM (max 50MB). An optional welcome video that plays when guests first see the widget. Great for a personal touch.
**128×128px** — PNG, JPG, or SVG (max 2MB). Small icon displayed in the chat header bar.
If you don't upload custom media, RecepAI's default receptionist avatar and branding will be used.
### Staff Glow
A colorful shimmer effect that animates around your receptionist's floating avatar — rotating purple, blue, and pink gradients that draw the guest's eye.
* **On (default):** Eye-catching glow that makes your receptionist stand out on the page
* **Off:** Clean, simple shadow — better for a corporate or minimalist look
Luxury resorts and boutique hotels typically keep the glow on. Business hotels and corporate properties often prefer it off for a more understated presence.
## Greeting Bubbles
Floating speech bubbles that appear above your receptionist's avatar before the guest opens the chat. These are your first chance to start a conversation.
| Setting | What It Does |
| ----------------- | ------------------------------------------------------------------ |
| **Show Bubbles** | Toggle the floating messages on or off |
| **Bubble Line 1** | First message guests see (e.g., "Hello, I'm your AI Receptionist") |
| **Bubble Line 2** | Second message that cycles in (e.g., "Click to talk with me!") |
The two messages alternate automatically — the first appears, fades out, and the second takes its place. After two full cycles, the bubbles stop to avoid being intrusive.
**Smart behavior:** If a guest dismisses the bubbles twice, they won't appear again for 24 hours. This respects guest preferences while still engaging new visitors.
## Chat Display
Control what guests see when they open the chat window.
| Setting | What It Does |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Greeting Message** | The first message guests see when opening the chat (e.g., "Hello! Welcome to Grand Hotel. How can I help you today?") |
| **Input Placeholder** | Ghost text shown in the message input field before typing (e.g., "Type your message...") |
| **Hide Sidebar on Start** | When on, the conversation history sidebar is collapsed when guests first arrive — so they focus on your receptionist. Past chats are still accessible via the menu icon. |
## Helpful Conversation Starters
Pre-set questions that appear as clickable pills above the message input, making it easy for guests to start a conversation without thinking about what to type.
| Setting | What It Does |
| ----------------------------- | ------------------------------------ |
| **Enable Guided Suggestions** | Toggle suggestion pills on or off |
| **First Suggestion** | e.g., "What are the check-in times?" |
| **Second Suggestion** | e.g., "Do you have room service?" |
Choose questions your guests ask most. Check your [Dashboard training opportunities](/admin-panel/dashboard#training-opportunities) to see the most common topics.
## Service Channels
Control which communication channels are available in the widget.
### Voice
Toggle voice calls on or off. When enabled, guests see a microphone button in the chat widget for real-time voice conversations.
Voice must be configured first on the [Voice Settings](/admin-panel/voice-agent) page. If voice isn't set up yet, you'll see a warning when trying to enable it here.
### WhatsApp Integration
Connect your receptionist to WhatsApp Business so guests can message via WhatsApp and get instant AI responses.
* **Price:** \$29/mo (add-on)
* **Setup:** Subscribe via the Billing page, then our team connects your WhatsApp Business within 7 days
* **When active:** Enter your WhatsApp phone number and toggle on
### Telegram Integration
Connect your receptionist to Telegram so guests can message via a Telegram bot.
* **Price:** \$19/mo (add-on)
* **Setup:** Subscribe via the Billing page, then our team connects your Telegram bot within 7 days
* **When active:** Enter your Telegram bot username (without @) and toggle on
### Guest Ratings
When enabled, guests can rate AI responses with thumbs up/down. This feedback appears in your [Conversation History](/admin-panel/history) and helps you identify where your receptionist needs improvement.
## Guest Terms
Require guests to accept terms and conditions before starting a conversation. Useful for GDPR compliance and data privacy requirements.
| Setting | What It Does |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Guest Agreement** | Master toggle — when on, guests must accept before chatting |
| **Terms Content** | The terms text displayed to guests. Supports Markdown formatting: `**bold**`, `*italic*`, `[links](url)` |
| **Full Terms URL** | Optional link to your full terms page (e.g., `https://yourhotel.com/terms`). Shows as a "Read full terms" link below the content. |
## World Languages
Set up translations so your receptionist greets guests in their preferred language. RecepAI currently supports **20 languages**: English, Turkish, German, French, Spanish, Italian, Russian, Arabic, Chinese, Japanese, Korean, Portuguese, Dutch, Polish, Ukrainian, Greek, Hebrew, Hindi, Thai, and Vietnamese.
### Language Menu
When enabled, guests see a language dropdown in the chat and can switch languages anytime during their conversation. When disabled, language is detected automatically.
### Default Language
The fallback language used when automatic detection can't determine the guest's preference.
### How Language Detection Works
Your receptionist automatically selects the right language for each guest using this priority order:
1. **URL parameter** — If the link contains `?lang=de`, German is used
2. **URL path** — If the page URL starts with `/tr/` or `/de/`, that language is used
3. **Saved preference** — If the guest changed language before, their choice is remembered
4. **Browser language** — The guest's browser language setting
5. **Default language** — Your configured default
### Adding a Language
Click **"+ Add Language"** to open the language panel. Select a language, then customize all guest-facing text for that language:
* Welcome bubble messages
* Chat greeting text
* Input placeholder
* Button labels (Chat, Call)
* Footer disclaimer
* Terms & conditions (if enabled)
Add the languages most common among your guests. A hotel in Istanbul might add Turkish, English, German, and Arabic. A Paris hotel might add French, English, Spanish, and Chinese.
### Video Timestamps
If you uploaded a **Staff Video** with greetings in multiple languages, you can set timestamps so the video automatically skips to the right language section for each guest.
**Example:** Your video has English at 0s, German at 15s, and French at 30s. A German guest sees the video start at 0:15 automatically.
This section only appears when a staff video is uploaded.
## Widget Placement
Control where the floating receptionist avatar appears on the page. Desktop and mobile have **separate position settings** so you can optimize for each screen size.
**Available positions:** Bottom Right, Bottom Center, Bottom Left, Middle Right, Middle Left
Click a dot on the visual position grid to change placement. The label updates to show the current selection.
**Bottom Right** is the most common position — guests expect chat widgets there. Only move it if your website has a conflicting element in that corner.
## Protection
Security settings to protect your widget from unauthorized use and abuse.
### Domain Security
Restrict your receptionist to work only on specific websites. When enabled, the widget will only load on domains you've added to the **Allowed Domains** list.
**How to set up:**
1. Toggle **Domain Security** on
2. Type your website domain (e.g., `grandhotel.com`) and click **Add**
3. Add all domains where the widget will be used — including `www` variants
**Domain Security enabled + empty domain list = widget blocked everywhere.** Always add at least one domain before enabling this setting. If you accidentally lock yourself out, disable Domain Security to restore access.
**Subdomain matching:** Adding `hotel.com` automatically allows `www.hotel.com`, `booking.hotel.com`, and any other subdomain. You don't need to add each one separately.
### Intelligent Abuse Protection
Automatically limits high-frequency requests to block automated bots while keeping the experience seamless for real guests. When enabled, each guest is limited to **10 messages per minute**.
Normal guests never hit this limit — only bots or automated scripts would be blocked.
### Daily Limits
Set maximum daily usage to control costs and prevent unexpected charges.
| Limit | What It Controls | Range | Default |
| -------------- | ----------------------------- | ---------- | ------- |
| **Chat Limit** | Maximum chat messages per day | 30 – 5,000 | 1,000 |
| **Call Limit** | Maximum voice calls per day | 30 – 5,000 | 100 |
When a limit is reached, the other channel still works — so if chat hits its limit, guests can still use voice, and vice versa. Limits reset daily at midnight.
Start with the defaults and adjust based on your traffic. A small boutique hotel might lower limits. A busy resort during peak season might increase them.
## Reception Ready!
The dark section at the bottom of the page contains everything you need to deploy your receptionist.
### Embed on Your Website
Copy the **RECEPtionist Code** and paste it before the closing `` tag on your website:
```html theme={null}