Skip to main content

Set Up Your Chatbot

Quick Setup

Most hotels set messages, bot instruction, and advanced settings in about 7 minutes.

This guide helps you configure the chatbot’s messages, tone, answer engine, advanced reply settings, and access. Use it when you need consistent guest answers.

Go to: Chatbot → Setup

Quick Reference​

TaskWhere to clickResult
Set a welcome messageBot Configuration → Welcome MessageGuests see your greeting first
Set a fallback replyBot Configuration → Default AnswerGuests get a response when no match exists
Define the bot’s toneBot Configuration → Bot InstructionThe chatbot follows your guidance
Choose the answer engineAdvanced Settings → Answer EngineSwitch between RAG and Agent (Pi)
Adjust reply styleAdvanced SettingsControls temperature, token cap, retrieval depth, and grounding mode
Enable Skill ModeAdvanced Settings → Skill ModeUses your configured Vertex ADK skill for streamed GenAI replies
Run Quick SetupQuick SetupPre-fills messages and tone
Choose chat modeWidget & Access → Chat modeAI, live chat, or hybrid
Create a landing pageWidget & Access → Create Landing PageGuest link and QR options appear
Allow widget domainsWidget & Access → Whitelisted DomainsWidget loads on your websites

Plan Access​

  • Chatbot setup requires a paid plan.
  • Free-tier accounts see an upgrade prompt and cannot save changes.

To upgrade, go to Settings → Billing & Subscription.

Before You Start​

Confirm these requirements:

  • You have permission to manage Chatbot settings
  • Your plan includes Chatbot features
  • You know the tone you want the bot to use

Configure Bot Messages​

  1. Go to Chatbot → Setup

  2. Stay on the Bot Configuration tab

  3. Update Welcome Message with a short greeting

  4. Update Default Answer with a helpful fallback reply

  5. Click Save under each card

    ✓ A success message appears.

Set the Bot Instruction​

  1. In Bot Instruction, describe the tone and rules

  2. Click Save

    ✓ The instruction is stored and used by the chatbot.

Good instruction examples

“Be concise and friendly. Ask a follow-up question if you are unsure.”

Set Advanced Reply Settings​

  1. Click Advanced Settings in the page header.

  2. In Answer Engine, choose RAG or Agent (Pi).

  3. Review the Generation section for reply behavior.

  4. If you choose RAG, review the Retrieval section.

  5. In Retrieval, turn Disable grounding RAG engine on or off.

  6. Set values within these ranges:

    • Temperature: 0 to 1
    • Top P: 0 to 1
    • Max Output Tokens: 500 to 3024
    • Retrieval K: 1 to 7

  7. If you turn on Disable grounding RAG engine, keep Retrieval K between 1 and 3.

  8. Click Save.

    ✓ The modal closes after a successful save.

What these settings control

Lower values keep replies more focused. Higher values add more variety. RAG uses your chatbot documents and retrieval settings. Agent (Pi) hides the RAG-only controls in the modal. Turning on Disable grounding RAG engine prefetches context directly before answering. It uses more tokens, but retrieval is more reliable. These settings affect chatbot replies and connected voice flows.

Use Skill Mode​

Use Skill Mode when your GenAI setup should stream responses through Vertex ADK.

  1. Click Advanced Settings.

  2. Turn on Use Skill Mode.

  3. Enter a Skill Name like booking-assistant.

  4. Click Save.

    ✓ The setting stays on after you reopen Advanced Settings. ✓ The modal keeps your skill name.

Skill name rules

Your Skill Name must use lowercase letters, numbers, and hyphens only. The field is required when Use Skill Mode is on. Vertex ADK runs the skill behind the scenes.

Use Quick Setup (Optional)​

  1. Click Quick Setup in the page header
  2. Follow the wizard to generate messages and tone
  3. Review the results in the fields
  4. Click Save on each section you want to keep

Choose a Chat Mode​

  1. Open the Widget & Access tab

  2. Select one mode:

    • AI only
    • Live chat only
    • Hybrid (AI + live chat)

    ✓ The selected mode highlights and takes effect.

Create a Landing Page Link​

  1. In Widget & Access, find Landing Pages

  2. Click Create Landing Page

    ✓ A new link appears for guest access.

  3. Use View QR to preview the guest code.

  4. Click Download chatbot QR if you need printed signage for rooms or welcome areas.

Manage Whitelisted Domains​

  1. In Whitelisted Domains, enter a domain like yourhotel.com
  2. Click Add Domain
  3. Use the toggle to enable or disable the domain
  4. Remove a domain only if the widget should stop working there

Troubleshooting​

Save button is disabled​

What you see: You cannot save a message or instruction.

Fix:

  1. Make sure the field is not empty
  2. Remove extra spaces and try again
  3. Confirm your plan includes Chatbot features

Advanced settings will not save​

What you see: The Save button stays disabled or shows validation errors.

Fix:

  1. Wait for the current advanced values to load
  2. Check every red validation message
  3. Keep Max Output Tokens between 500 and 3024
  4. Keep Retrieval K between 1 and 7
  5. If Disable grounding RAG engine is on, keep Retrieval K between 1 and 3
  6. Try Save again

RAG controls are missing​

What you see: You cannot find Retrieval K or Disable grounding RAG engine.

Fix:

  1. Open Advanced Settings

  2. Check the current Answer Engine

  3. Select RAG

  4. Click Save

    ✓ The RAG-only controls appear again.

Retrieval K looks too low​

What you see: Retrieval K only allows values from 1 to 3.

Fix:

  1. Turn off Disable grounding RAG engine
  2. Recheck Retrieval K
  3. Save the updated settings

Skill Mode will not save​

What you see: Saving fails after you turn on Use Skill Mode.

Fix:

  1. Confirm Skill Name is not blank
  2. Use lowercase letters, numbers, and hyphens only
  3. Try a name like booking-assistant
  4. Click Save again

Landing page will not create​

What you see: You get an error when creating a landing page.

Fix:

  1. Refresh the page and try again
  2. Follow any prompt to replace an older page
  3. Contact support if it still fails

Domain toggle does not work​

What you see: The switch changes but reverts.

Fix:

  1. Refresh the page
  2. Remove the domain and add it again
  3. Try the toggle again

Still Stuck?​

Contact success@vouch-technologies.com if:

  • ❌ Saves fail after multiple attempts
  • ❌ Landing pages do not generate
  • ❌ The issue lasts longer than 30 minutes

Helpful to include:

  • Screenshot of the Chatbot Setup page
  • The action you tried and the error message
  • Time the issue started