Osonflow docs
Everything you need to run Osonflow: teach the assistant about your business, put it on your website and messengers, work the inbox with your team, and automate the questions that should be answered the same way every time.
- Channels
- Website chat, Telegram, Instagram, WhatsApp
- Knowledge files
- PDF, CSV, TXT, DOCX and web pages
- Building on Osonflow?
- Read the API reference
On this page
Get started
Teach your assistant
Get started
Welcome
Osonflow puts an AI assistant on your website and in your messengers. It answers customers from the documents and pages you give it — and nothing else — and hands the conversation to your team when a person is needed.
This guide follows the dashboard from top to bottom. If you are just starting, read the Quickstart; the rest you can come back to when you need it.
Get started
Quickstart
After you sign up, the dashboard walks you through these steps. Most businesses finish in about fifteen minutes.
Switch the assistant on
Osonflow writes answers using OpenAI. Its own keys work out of the box; add your company's key in Integrations if you want AI usage billed to your own account.
Tell it about your business
Paste your website address and it reads the pages itself. Add price lists, policies and FAQs to the Knowledge base later.
Make it look like you
Choose the assistant's name, the first thing it says, and the colour of the chat button in Widget customization.
Put it on your website
Copy one line of code and paste it into your site. A chat button then appears in the corner of every page. See Website chat.
Your first conversation
Every chat arrives in your inbox. Read along while the assistant answers and step in as a human at any point.
Get started
How it works
- You teach it. Give it your documents, prices and policies. It reads them and nothing else.
- It answers first. Every customer is answered right away, day and night, and every reply shows the source it came from so your team can check it.
- You get the hard ones. When a question can't be answered from your content, or a customer asks for a person, the conversation is escalated to your team.
- It gets better. Questions it could not answer show up in AI performance, so you know what to add to the knowledge base next.
Teach your assistant
Set up with AI
The fastest way to a working assistant. In Set up with AI, give it your website address and it reads the site, asks you to fill in what the website doesn't say, and then writes your knowledge base, instructions and chat window.
Nothing goes live on its own: what it writes is saved as a draft for you to review and change before you publish.
Teach your assistant
Knowledge base
The documents and web pages the assistant is allowed to answer from — the single most important page in the dashboard. The assistant answers only from what you put here, so it cannot invent a price or a policy.
| Source | What to use it for |
|---|---|
| Web pages | Your site, help centre and product pages. Re-read them when they change. |
PDF · DOCX | Policies, contracts, manuals and anything you already have as a document. |
CSV | Price lists, product catalogues and opening hours — anything that is a table. |
TXT | Short notes and answers you want the assistant to know word for word. |
When AI performance lists a question the assistant could not answer, the fix is almost always a missing document here.
Teach your assistant
Customer memory
When someone comes back a second time, the assistant remembers what it learned about them — their name, their order, what they asked last time — so they don't have to repeat themselves. Customer memory shows what it remembers about each person.
Go live
Website chat
A chat button on your website that answers visitors with your knowledge base, day and night. Add the code once — changes you make in Widget customization appear on your site automatically.
Copy the snippet from Integrations → Website chat, where your organization ID is already filled in, and paste it before the closing </body> tag. There are ready-made versions for plain HTML, React, Next.js and vanilla JavaScript.
<script
src="https://widget.osonflow.uz/widget.js"
data-organization-id="YOUR_ORGANIZATION_ID"
data-agent-id="default"
data-position="bottom-right"
defer
></script>Send the snippet to whoever manages your website if you would rather not touch the code yourself.
Go live
Widget customization
Behaviour, copy, brand, launcher and voice for the widget your customers see. Everything is edited as a draft and published as a version you can roll back.
- Brand: the assistant's name, logo, colours, radius and typeface. Every visitor-facing colour pair is checked live for contrast.
- Copy: the greeting, the headline on the home screen and the placeholder in the message box.
- Launcher: the button that sits on your page when the chat is closed, plus an optional invitation that appears above it.
- Help content: the topics and articles shown on the widget home screen.
- Voice: let visitors talk to the assistant out loud instead of typing.
Go live
Telegram, Instagram, WhatsApp
The same assistant answers in your messengers, and every conversation lands in the same inbox as your website chats. Connect each one in Integrations.
| Channel | What you need |
|---|---|
| Telegram | A bot token from @BotFather. Customers who message your bot are answered by your assistant. |
| An Instagram professional account. Sign in once and direct messages are answered and collected in your inbox. | |
| A WhatsApp Business number — its phone number ID and access token from Meta. |
Every day
Conversations
Every chat with a customer, from every channel. Read them, reply yourself, and mark them done. Each conversation is in one of three states:
| Status | Meaning |
|---|---|
| Unresolved | Open. The assistant is answering, and your team can read along. |
| Escalated | Your team has it — the customer asked for a person, the assistant could not answer from your content, or someone on your team replied. The assistant stops replying. |
| Resolved | Done and closed. No more messages go into it. |
You can step in as a human at any point. Your first reply escalates the conversation, so from then on the customer hears only from your team.
Every day
Leads
People who left a name, email or phone number during a conversation. Leads is your follow-up list.
Every day
AI voicechats
If you turn on voice in Widget customization (it needs your own AI key), visitors can speak to the assistant instead of typing. AI voicechats keeps the transcript of every spoken conversation.
Every day
AI performance
How often the assistant finished the job on its own, how fast it replied, and the questions it could not answer. Check it weekly — the unanswered questions tell you exactly what to add to the knowledge base next.
Automate
Workflows
For questions you want answered the exact same way every time — a refund request, a booking — draw the steps on a canvas instead of trusting the assistant to improvise.
| Group | Steps |
|---|---|
| Scripted | Message, Cards, Carousel, Buttons, Listen — say something, show something, wait for a reply. |
| Tools | API, Function, Integration, MCP — reach the systems you already run. |
| Logic | Set, Condition, Operator, Code, Workflow, End — route the conversation and hand parts of it to AI. |
Test every run in the builder before you publish. Once published, workflow conversations appear in the inbox with their own tag, so you can filter them apart from assistant conversations.
Automate
Assistant tools
Things the assistant can do beyond talking — look something up, write a row into a spreadsheet, book a call. Set them up in Assistant tools, then choose which ones each widget may use. For example:
- Google Sheets: find, add and update rows. The assistant collects exactly the columns you pick.
- Google Calendar: check free time and book meetings. Connect once — every calendar tool uses the same account.
- Your own API: call any HTTP endpoint with the parameters the assistant works out from the conversation, and test it in the console before it goes live.
Automate
Event webhooks
Send a notice to Discord, Telegram, WhatsApp or your own system whenever something happens — a new chat, a message, a conversation handed to your team. Add destinations in Integrations → Event webhooks.
Developers who want signed payloads and delivery retries should use API webhooks instead.
Account
Your AI keys
Osonflow's own AI keys work out of the box. Add your company's keys in Integrations → Your AI keys only if you want AI usage billed to your own OpenAI or Google account. Voice is the exception: it needs your own OpenAI or Gemini key before you can choose a voice model.
Account
Plans & Billing
Every plan includes the whole product — chat widget, shared inbox, routing and human handover. Start on Starter for free, move to Growth when the assistant is carrying real work, and talk to sales about Enterprise. Plans & Billing shows your plan, usage and invoices; prices are on the pricing page.
Account
Data transfer
Move a whole setup between organizations — for example from a test organization to the real one. Data transfer exports your knowledge sources and widget as one Osonflow setup file, which you download or copy and then import into the other organization. Sources that already exist there are skipped, unless you choose to replace them.