HomeDocumentazione

Chatbot Wizard

The Chatbot Wizard guides you through creating a fully configured AI chatbot in 8 simple steps.

Only Step 1 (Basics) and Step 8 (Summary) are required — every other step has a Skip button. From Step 5 (Widget Design) onward, a live preview of your widget is shown next to the form.

Step 1: Basics (Required)

Starting from a Template

At the top of Step 1 you can choose a template that pre-fills the wizard with optimized settings — persona, tonality, welcome and fallback messages, and behavior options. You can still adjust everything in the following steps.

TemplateBest For
BlankStart from scratch
SupportCustomer service & help desk
SalesLead generation & sales
OnboardingGuide new users & customers
CorporateProfessional & formal tone

The Blank template is always available. The pre-configured templates are available on paid plans — the wizard shows which plan unlocks them.

Name & Description

Configure the fundamental settings for your chatbot:

FieldDescriptionExample
NomeDisplay name for your chatbot"Support Assistant"
DescriptionInternal description for your team"Handles customer inquiries for our SaaS product"

The chatbot name is shown to visitors in the chat widget header.

Step 2: Persona

Define your chatbot's personality and background:

FieldDescriptionExample
Usa nome personaToggle whether the bot introduces itself by nameOn/Off
Nome della personaThe name your bot introduces itself as (if enabled)"Alex"
RuoloThe role your bot plays"Customer Success Manager"
BackgroundContext about your bot's expertise"5 years experience helping customers with technical issues"

Anonymous Mode

If you disable Usa nome persona, the chatbot will not introduce itself with a name. Instead of "Hello! I'm Alex, your customer service specialist." it will simply say "Hello! How can I help you?". The persona name field is hidden when this toggle is off.

A well-defined persona makes conversations feel more natural and helps the AI stay consistent. Use anonymous mode if you prefer a more neutral chatbot experience.

Communication Style

Choose a predefined communication style that sets the overall tone for your chatbot:

StyleBest For
Professionale & Moderno (Default)Agencies, tech companies, B2B
Esclusivo & DistintoBeauty clinics, law firms, luxury hotels
Caloroso & AccoglienteFamily businesses, restaurants, medical practices
Cool & CasualTattoo studios, trendy bistros, startups
PersonalizzatoUses your own Core Instructions instead of a preset

Each style adds detailed prompt instructions with appropriate tone, phrasing patterns, and examples.

Step 3: Tonality

Fine-tune your chatbot's communication style using sliders (1-5 scale):

SettingLow (1)High (5)
FormalitàCasual, friendlyFormal, professional
HumorSerious, no jokesPlayful, witty
VerbosityBrief, conciseDetailed, thorough
EmpathyFactual, directWarm, understanding
ProactivityReactive onlySuggests next steps

Step 4: Languages

Configure language support:

  • Lingua principale: The main language for responses; choose from the options shown in the wizard
  • Lingue supportate: Additional languages your bot can understand and respond in
  • Livello tecnico: A slider from Semplice to Tecnico that determines how technical the bot's language should be
  • Forma di cortesia: Formal or informal address where the visitor's language supports it
  • Prospettiva: Speak as the company using first person (We), or refer to its name in third person
  • Company Timezone: Select the company's actual timezone. Check the detected-timezone suggestion before adopting it. This is separate from personal notification timing and the informational timezone row in Account.

ChatReact supports all 24 official EU languages.

Address Form

Define how the chatbot should address website visitors:

SettingDescriptionExample
Formale (Sie/Vous)Polite form for professional/business communication"How may I assist you?" (German: "Wie kann ich Ihnen helfen?")
Informale (Du/Tu)Personal address for casual communication"How can I help you?" (German: "Wie kann ich dir helfen?")

The address form is only used in languages that have a formal/informal distinction (e.g., German, French, Spanish). In English and similar languages, this setting does not apply.

The widget automatically detects the visitor's browser language and responds in the appropriate language.

Step 5: Widget Design

Customize the appearance of your chat widget:

Position

  • Angolo in basso a destra (default)
  • Angolo in basso a sinistra
  • In linea (Integrato) — Widget is displayed where the embed script is placed, always open, no bubble, no close button. Ideal for dedicated chat pages or support sections.

Colors

First choose the Modalità: Scuro (dark background with light text) or Chiaro (white background with dark text, default).

Then pick a Tema colore — it applies to the selected mode:

ThemeDescription
PredefinitoThe standard ChatReact color scheme
AziendaUses your company's brand colors (available once they are set in Company Settings)
PersonalizzatoUnlocks individual color pickers

When Personalizzato is selected, you can adjust:

SettingDescription
Primary ColorMain accent color (buttons, headers)
Secondary ColorGradient and hover states
Colore di sfondoChat window background
Colore del testoMessage text color

Advanced Color Settings

Expand the advanced options for more granular control:

SettingDescription
Messaggi dei visitatoriBackground and text color of the visitor's message bubbles
Messaggi del botBackground and text color of the bot's message bubbles
Colore del testo dell'intestazioneText color in the widget header

Each advanced color can be reset to automatic, in which case ChatReact picks a contrast-safe color for you.

Dimensions

  • Raggio angoli: Rounded corners (0-32px)
  • Widget Width: Chat window width
  • Widget Height: Chat window height

Branding

  • Use Company Logo: Show your company logo in the widget header. Requires the Professional plan or higher; the logo itself is uploaded in Company Settings.
  • Titolo intestazione: Text in the widget header
  • Sottotitolo intestazione: Secondary text in the header. If you leave it unset, the widget shows a localized default subtitle. After creation, you can hide the subtitle entirely by clearing this field in the widget settings.

Every design option can be changed after creation, and additional settings (such as a custom logo URL and the chat bubble text) are available there too. See Widget Customization for the full reference.

Step 6: Behavior

Configure automated behaviors:

SettingDescription
Messaggio di benvenutoFirst message shown when chat opens
Messaggio di fallbackResponse when bot can't answer
Saluto proattivoAutomatically greet visitors
Proactive DelayWait time before greeting (1-10 seconds)
Auto OpenAutomatically open widget
Auto Open DelayWait time before opening (1-15 seconds)
Suoni abilitatiPlay a notification sound when the bot responds
Indicatore di digitazioneShow typing animation

Pre-Chat Form

Collect visitor information before the chat begins:

  1. Enable Modulo pre-chat
  2. Add fields (Text, Email, Phone, Textarea)
  3. Mark required fields as "Required" as needed

After creation, you can click Traduci con AI in the chatbot's behavior settings to automatically translate all field labels and placeholders into your supported languages.

Learning Phase

Salta la fase di apprendimento: Turn this on to start your chatbot with full confidence from day one — no cautious responses. A warning reminds you to make sure your knowledge base is well-prepared before going live.

If the learning phase is active, you can determine how the chatbot behaves when uncertain about answers:

ModeDescription
CautiousBot is reserved and actively refers to email handoff when uncertain. Proactively adds uncertainty phrases.
Balanced (Default, marked "Recommended")Normal responses. Only shows uncertainty when the user questions accuracy.
ConfidentResponds as in normal operation. The learning phase only collects feedback without changing response behavior.

Additional Learning Phase Instruction: Optional free text for special instructions during the learning phase, e.g., "Always refer pricing questions to the team."

The learning phase mode is also configurable in chatbot settings after creation.

Live Chat

Let visitors talk to human support agents in real time (requires the Professional plan or higher):

  1. Turn on Abilita chat dal vivo
  2. Choose a Modalità Chat dal vivo:
ModeDescription
Solo trasferimentoThe AI bot handles conversations and hands off to humans when needed
AutonomaDirect human chat, separate from the AI bot
EntrambeAI bot with handoff plus standalone human chat

Learn more in the Live Chat guide.

On white-label plans, Step 6 also shows a Branding section with a toggle to show or hide the "Powered by ChatReact" badge in the widget.

Step 7: Restrictions & Compliance

Set rules and limitations:

Blocked Topics

Topics your chatbot should avoid discussing:

  • Competitor products
  • Legal advice
  • Pricing negotiations

Best Practice Compliance

Select from eight industry-standard compliance rules:

  • Nessun consiglio legale — recommends consulting a legal professional (pre-selected)
  • Nessun impegno vincolante — never makes binding commitments about pricing, discounts, or delivery (pre-selected)
  • Riferire al supporto umano — offers to connect with human support for sensitive or complex issues (pre-selected)
  • Nessuna informazione interna — does not disclose internal company information or confidential details
  • Nessuna informazione sui concorrenti — does not share information about competitors or make comparisons
  • Nessun consiglio medico — recommends consulting a healthcare professional
  • Nessun consiglio finanziario — never provides financial or investment advice
  • Protezione dei dati — handles personal data carefully and doesn't ask for unnecessary information

Core Instructions

Custom rules for your chatbot, managed as a list:

  • Add, edit, or delete individual instructions
  • Activate or deactivate each instruction without deleting it
  • Click Migliora con IA to have your instructions automatically refined

Example instructions:

  • "Always recommend scheduling a demo for complex questions"
  • "Never share customer data or internal metrics"
  • "Refer pricing questions to the sales team"

Core Instructions have the highest priority and are always included in every chat response.

After creation, manage Core Instructions in Knowledge Base → Istruzioni. The editor supports formatting and clickable links.

Response Limits & Handoff

  • Lunghezza massima risposta: Character limit for responses (100-2000 characters)
  • Trigger per passaggio a operatore: Describe in your own words when the bot should hand the chat off to a human, e.g., "For product complaints or refund requests"
  • Email per passaggio a operatore: Email address the bot directs visitors to when handing off to a human

Appointment contact option

In Impostazioni → Restrizioni, choose one Opzione di contatto per appuntamenti:

OptionWhat the visitor can do
DisattivatoNo appointment contact action is offered
Pagina di prenotazioneOpen your configured public HTTPS booking page after clicking
TelefonoOpen the phone app using your international number, beginning with + and the country code
Modulo di contattoOpen an existing active, unlocked contact form belonging to this chatbot

The action can be offered after a clear new-appointment request. It does not check availability or create, confirm, cancel or reschedule appointments. A phone action does not place a call automatically. Submitting a form is a separate inquiry, not a booking confirmation. Use Disattivato to turn these actions off and test the chosen destination in Anteprima.

Step 8: Summary (Required)

Review all settings before creating your chatbot:

  • Verify all configurations
  • Preview the widget design
  • Click Crei il Chatbot to finish

After Creation

When you click Crei il Chatbot, you're taken directly into the Configura la base di conoscenza wizard, which fills your chatbot's knowledge base in three quick steps:

  1. Scan Website — Enter your website URL; ChatReact discovers pages automatically and lets you select which ones to import
  2. Upload Documents — Add PDF, DOCX, TXT, MD, CSV, or JSON files
  3. Fatto — Continue to your dashboard

Both content steps can be skipped — you can always add knowledge later. See the Knowledge Base guide for details.

From there you can:

  1. Test - Use the Preview feature to test conversations
  2. Incorpora - Add the widget to your website
  3. Iterate - Adjust settings based on feedback

Next Steps