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
- Navigate to Settings → Support
- Toggle Support enabled
- Configure the greeting message (under Pre-chat information)
- Add knowledge base content (articles, FAQs) via Knowledge Base
- 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:
- Click Add Article
- Write a title and body
- Assign a category
- Add tags for better matching
- Click Publish
FAQ Pairs:
- Click Add FAQ
- Enter the question
- Enter the answer
- Add variations of the question (improves matching)
- Click Save
Add a web page:
- Go to Settings –> Connected sources
- Add the page’s URL and mark it public
- 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
- 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):
- Click Import –> Upload File
- Upload a CSV or JSON file with your content
- Map columns to fields (title, body, category)
- 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
- Go to Documents –> All Documents
- Select one document, or several at once
- Set AI audience to Public
- 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
- When an agent resolves a conversation, the resolution is recorded
- AI analyzes the question-answer pair and the resolution approach
- Future similar questions benefit from the learned resolution pattern
- 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
- Go to Support Widget –> Pre-Chat Forms
- Add fields: name, email, topic, or custom fields
- Mark fields as required or optional
- 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 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.
- 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:
- Greeting Message - Initial AI message
- Quick Actions - Clickable buttons for common topics
- Search Bar - Search of the knowledge base by meaning, not just keywords (the same retrieval the chat uses)
- 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:
- Agent receives notification with full conversation history
- What was asked and what the assistant answered are both visible on the ticket
- The agent replies on the ticket
- 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:
- Go to Support Widget –> Security
- Toggle Enable CAPTCHA
- 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 |
- 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
- Support Widget Setup Checklist - The eight readiness checks and verifying with your own questions
- Communications Hub - Full multi-channel setup
- Smart Forms - Structured data collection
- WhatsApp Setup - Connect WhatsApp to your widget