Falaah Falaah AI

AI Support Widget

Set up the Muin AI Support Widget to give visitors instant answers on your website. Configure knowledge base, AI responses, chat embedding, and escalation.

The Muin AI Support provides an intelligent support interface for your customers. Visitors get instant answers from your knowledge base, powered by AI. When the AI cannot help, conversations escalate seamlessly to your team through the Communications Hub.

Overview

How It Works

Visitor Opens Widget → Types Question → AI Searches Knowledge Base
        │                                         │
        │                                  Match Found?
        │                                  Yes → AI Responds
        │                                  No  → Offer Escalation
        │                                              │
        │                                     Human Agent Joins
        │                                     (via Communications Hub)
        └─→ Optional: CAPTCHA verification before chat starts

Key Features

Feature Description
AI-Powered Answers Instant responses from your knowledge base
Live Escalation Seamless handoff to human agents
Knowledge Base Centralized content library for AI
Documents the AI may use Classify any document in Documents so the assistant can answer from it
Resolution Learning AI improves from resolved conversations
Hand off to a person Collects an email when the assistant cannot answer, and creates a ticket with the transcript
CAPTCHA Protection Block bots and spam
Allowed origins Only the websites you list may host your widget
Multi-Language Answers in the language the visitor writes in, citing your own sources
Customizable Design Match your brand colors and style (not available yet)
SLA Monitoring Track response and resolution times (not available yet)
Analytics What visitors asked, how often it answered from a source, what it declined, and what nobody has answered yet

Setting Up the Widget

Prerequisites

  • Muin admin permissions
  • Knowledge base content (articles, FAQs, or documentation)

Quick Setup

  1. Navigate to Settings → Support
  2. Toggle Support enabled
  3. Configure the greeting message (under Pre-chat information)
  4. Add knowledge base content (articles, FAQs) via Knowledge Base
  5. Embed on your website: copy the <script> snippet shown in Settings and paste it on your site, or share the public support URL (/go/<your-slug>/support) with customers

Embedding on Your Site

Paste this snippet before the closing </body> tag on any page where you want the chat widget to appear:

<script
  src="https://muin.falaah.ai/embed/widget.js"
  data-type="support"
  data-tenant-slug="your-org-slug"
  data-position="bottom-right">
</script>

The exact code with your tenant slug pre-filled is available at Help Desk → Settings → Portal → Embed on your website (Copy button). data-position accepts bottom-right (default), bottom-left, top-right, or top-left. Full configuration reference: Support Widget Configuration.


Knowledge Base

The knowledge base is the AI’s source of truth. The better your content, the better the AI’s answers.

Adding Content

Go to Support Widget –> Knowledge Base to manage content:

Articles:

  1. Click Add Article
  2. Write a title and body
  3. Assign a category
  4. Add tags for better matching
  5. Click Publish

FAQ Pairs:

  1. Click Add FAQ
  2. Enter the question
  3. Enter the answer
  4. Add variations of the question (improves matching)
  5. Click Save

Add a web page:

  1. Go to Settings –> Connected sources
  2. Add the page’s URL and mark it public
  3. Choose Pages to read if you want it to follow links on the same site, and Re-read if you want Muin to go back on a schedule
  4. Muin fetches and indexes it, and the assistant can cite it

A crawl follows same-origin links only, up to 25 pages per site, and each page is indexed as its own source so an answer cites the page it came from. Full reference: Support Widget Configuration.

Bulk Import (not available yet):

  1. Click Import –> Upload File
  2. Upload a CSV or JSON file with your content
  3. Map columns to fields (title, body, category)
  4. Review and publish

Content Structure

Organize your knowledge base for optimal AI performance:

Element Purpose Best Practice
Categories Group related articles 5-15 categories max
Tags Cross-reference topics 3-5 tags per article
Titles Help AI match questions Use question format when possible
Body Provide the answer Clear, concise, step-by-step
Variations Alternative phrasings Add 3-5 per FAQ

Content Tips

  • Write articles as if answering a specific question
  • Use simple language (aim for 8th-grade reading level)
  • Include step-by-step instructions where applicable
  • Update content regularly based on what visitors actually ask
  • Review the “Unanswered Questions” report weekly

Documents the AI may use

Your documents already live in the Documents module. Rather than uploading them a second time for the assistant, you set one thing on the document itself: its AI audience.

AI audience Who the assistant may quote it to
Public Anyone, including an unauthenticated visitor on your public help page
Staff only Signed-in members. This is the default, so nothing becomes public by accident
Not used by AI Nobody. The assistant ignores the document entirely

Classifying documents

  1. Go to Documents –> All Documents
  2. Select one document, or several at once
  3. Set AI audience to Public
  4. The assistant answers visitors from it, with the document cited

Because the classification lives on the document, a file kept current by a Google Drive sync stays classified: replacing its contents does not change who may hear it, and there is no second copy to keep in step.

Best Practices

  • Upload product manuals, policy documents, and technical guides
  • Keep documents up to date · AI always uses the latest version
  • Use descriptive file names for easier management
  • Review the “Sources” section of AI responses to verify document relevance

Resolution Learning

Resolution learning helps AI improve over time by learning from successfully resolved conversations.

How It Works

  1. When an agent resolves a conversation, the resolution is recorded
  2. AI analyzes the question-answer pair and the resolution approach
  3. Future similar questions benefit from the learned resolution pattern
  4. Over time, AI resolution rates improve as the learning corpus grows

Managing Learned Resolutions

Go to Support Widget –> Resolution Learning to review and manage learned resolutions. You can approve, edit, or remove resolutions that AI has learned from.


Pre-Chat Forms

Pre-chat forms collect visitor information before a conversation starts, helping route conversations and enrich AI context.

Configuring Pre-Chat Forms

  1. Go to Support Widget –> Pre-Chat Forms
  2. Add fields: name, email, topic, or custom fields
  3. Mark fields as required or optional
  4. Configure routing rules based on form responses (e.g., route “Billing” topics to the billing team)

Available Field Types

Field Type Description
Text Free-form text input
Email Email address with validation
Dropdown Select from predefined options
Topic Route conversations by topic

Configuring AI Responses

Response Settings

Go to Support Widget –> AI Settings:

Setting Options Description
Citations required On/Off When on, an answer whose claims do not map to a source is not shown at all: the assistant says it does not have that, and offers a person
Confidence threshold 0-1 Below it, the assistant offers a person rather than an answer (default 0.6)
Refusal topics Your own list Subjects it must never answer. Decided before anything is retrieved, so there is nothing to quote
Verification questions Your own list Each declares the right outcome - answered from a named source, or declined - and can be run against the real assistant whenever you change a document

Response Behavior

Configure how the AI handles different scenarios:

Scenario Behavior Configurable
Answered from a source The answer is shown with links to what it came from Citations can be required
Nothing matched It says so plainly and offers a person Always on
Below your threshold It offers a person rather than a weak answer Threshold adjustable
A refusal topic It declines, explains, and offers a person Topic list is yours
A number it cannot source The answer is withheld: every number, time, date and price must appear in the cited text Always on
Knowledge unreachable It says it cannot reach your information right now, never that you do not publish it Always on

Answering text messages (SMS and WhatsApp)

AI Help Desk also answers people who text your SMS number or message your WhatsApp number, with the same rules as the website chat.

  • Same answers. It answers only from your published articles and the documents you marked public, and the same refusal topics apply.
  • How the reply is sent. The reply goes through your auto-response settings in Communications > Settings > AI. At or above your auto-send threshold it is sent on the same channel; below it, it waits in your inbox for a person to approve. A reply about payments always waits for a person. Source numbers like [1] are left out, since a text message has no list of links under it.
  • When it cannot answer. A refusal topic, or a question your content does not cover, sends no AI answer. The conversation is escalated in Communications and one support ticket opens for the thread, marked SMS or WhatsApp. When you reply on the ticket, your reply goes back by text on the same channel.
  • Cost. Each AI answer uses AI credits and counts toward your monthly AI Help Desk conversations, like a website chat.
  • Requirements. Support must be on, your plan must include AI answers, and auto-response must be turned on for the SMS or WhatsApp channel. Without AI answers, text messages keep the standard Communications auto-response.
  1. AI will detect these and skip auto-response

Embedding the Widget

Add AI support to any website with a single JavaScript snippet. The widget renders as a floating chat bubble and expands to a panel when a visitor clicks it. See Quick Setup above for the embed code and position options: your pre-filled snippet is always available at Help Desk → Settings → Portal → Embed on your website.

You can also share your public support portal URL directly with customers: https://muin.falaah.ai/go/your-org-slug/support. The portal includes the same AI-powered chat, knowledge base, and agent handoff.

CMS Integration (not available yet)

WordPress, Squarespace, and Shopify integrations are in development.


Customization

Visual Design (not available yet)

Full visual design customization is in development. You will be able to customize button icon, size, header, colors, border radius, shadow, font, and animation.

Custom CSS (not available yet)

Custom CSS support for advanced widget styling will be available alongside the visual design editor.

Welcome Flow

Configure what visitors see when they open the widget:

  1. Greeting Message - Initial AI message
  2. Quick Actions - Clickable buttons for common topics
  3. Search Bar - Search of the knowledge base by meaning, not just keywords (the same retrieval the chat uses)
  4. Recent Articles - Show popular help articles

Escalation Rules

Configuring Escalation

When AI cannot resolve a question, configure handoff to humans:

In Settings –> Support, name the staff member who receives escalations and set your business hours. A handoff happens when:

Trigger Description
The visitor asks They choose “Talk to a person” at any point
Nothing to answer from No source matched their question
Below your confidence threshold The assistant would rather not guess
A refusal topic The question is on the list you said it must never answer

The ticket carries the whole transcript, the page the visitor was on, and the contact details they left. It is assigned to the staff member you named, so a person is told rather than a queue nobody watches. Outside your business hours the after-hours message leads and the form is offered first.

Agent Takeover

When an agent takes over from AI:

  1. Agent receives notification with full conversation history
  2. What was asked and what the assistant answered are both visible on the ticket
  3. The agent replies on the ticket
  4. The visitor sees the reply in the same chat if it is still open, and receives it by email either way

CAPTCHA Protection

Enabling CAPTCHA

Prevent bot spam in your support widget:

  1. Go to Support Widget –> Security
  2. Toggle Enable CAPTCHA
  3. Choose CAPTCHA type:
Type Description Friction
Invisible Background verification, no user action None
Checkbox “I’m not a robot” checkbox Low
Challenge Image-based challenge Medium
  1. Configure when CAPTCHA triggers:
Trigger Description
Always Every new chat session
Suspicious Only when bot-like behavior detected
After Hours Only outside business hours
High Volume When traffic exceeds threshold

SLA Monitoring (not available yet)

SLA monitoring for support conversations is in development. When available, you will be able to:

  • Set response time targets (AI response, first human response, resolution time)
  • Configure alerts for SLA breaches (email, push notification, dashboard indicators)
  • Auto-escalate conversations that breach SLA thresholds
  • Track SLA compliance metrics in the analytics dashboard

Analytics (Partial)

Widget Dashboard

Basic conversation statistics are available now. View them at Support Widget –> Analytics:

Metric Description Status
Total Conversations Chat sessions started Available
AI Resolved Percentage handled by AI alone Available
Escalated Percentage requiring human agent Available
Avg. AI Response Time How fast AI responds Not available yet
Avg. Resolution Time How long to fully resolve Not available yet
CSAT Score Customer satisfaction rating Not available yet
Top Questions Most frequently asked topics Not available yet
Unanswered Questions Questions AI could not answer Not available yet

The full analytics dashboard with charts and trend views is in development.

Improvement Insights (not available yet)

The analytics dashboard will provide actionable recommendations:

  • Knowledge Gaps - Topics visitors ask about that are not covered
  • Low Confidence Areas - Topics where AI accuracy is low
  • High Escalation Topics - Areas where humans are always needed
  • Popular Articles - Most-referenced knowledge base content
  • Drop-Off Points - Where visitors abandon the chat

Next Steps