Mental Model
This guide provides a high-level visual overview of how the SupportOS platform works from end to end.
In One Sentence
An Organization sets up AI Agents (equipped with brand instructions, playbooks, knowledge documents, and actions), connects them to customer Channels (website chat, messaging apps, and phone lines), and automatically turns completed conversations into organized Tickets and Audio Recordings.
The SupportOS System Flow
How a Customer Interaction Works
- Customer Connects: A customer starts a chat on your website, sends a message via Freshchat (from WhatsApp, Instagram, or mobile), or dials your support phone number.
- Live Agent Engages: SupportOS automatically routes the conversation to your currently deployed agent version.
- Intelligent Assistance:
- The agent determines what the customer needs and follows the appropriate scenario playbook.
- It searches your attached Knowledge Base for accurate company policies and answers.
- It runs real-time Actions to retrieve customer-specific data (e.g., order status or account details).
- Resolution & Handoff: The agent answers the question or, if necessary, escalates the conversation to a human support agent.
- Post-Conversation Ticket: When the conversation concludes, SupportOS generates a structured Support Ticket containing a summary, sentiment analysis, key journey steps, and call audio recordings for voice sessions.
Testing in the Sandbox
You can test your agent privately inside the builder simulator at any time without affecting live customer conversations or cluttering your ticket inbox.
What You Can Manage in SupportOS
| Dashboard Area | What You Manage |
|---|---|
| Agent Builder | Create agents, customize brand personality, write playbooks (scenarios), and deploy versions. |
| Knowledge Base | Upload documents, FAQs, and product manuals; monitor document processing and attach libraries to agents. |
| API Tools | Connect external REST API lookups and test them before attaching to your agents. |
| Phone Numbers | Acquire dedicated phone numbers and assign them directly to your voice agents. |
| Widgets | Customize your embeddable website chat widget and configure allowed website domains. |
| Integrations | Connect third-party messaging channels and support platforms like Freshchat and WhatsApp. |
| Tickets & Inbox | Review customer conversation summaries, tags, sentiment ratings, and audio recordings. |
| Evaluation | Run automated test scenarios to benchmark agent performance and accuracy before launching changes. |
| Billing & Usage | Monitor monthly usage metrics, conversation volume, invoices, and subscription plans. |
Three Best Practices to Remember
- "Saved Draft" vs. "Live Deployment" — Saving changes in the builder updates your private draft. To push your updates to live customers, always make sure to publish and deploy.
- Wait for Knowledge Processing — Newly uploaded documents take a short moment to index. Ensure processing is complete so your agent has full access to the information.
- Simulate Before Deploying — Always run a quick test conversation in the builder's preview simulator to verify changes before activating a new version.
Next Steps
Now that you understand the system flow, explore Agents Overview to learn how to create and customize your first AI agent.