Learn Flexaura, one step at a time.
Four in-depth guides, and twenty-four short tutorials in three levels. Each tutorial says what you'll build, which plan it needs, the steps in order, and how to check it worked.
Guides
Longer walkthroughs that build one agent from start to finish, and a reference for every flow step.
Get your first agent live
No technical skills needed. By the end you have an AI agent on your website that answers from your own documents, and you know how to step in when a visitor needs a person.
b1Set up your workspaceCreate an account, name your workspace and invite the people you work with.All plans
Steps
- Sign up at
app.flexaura.ai. You land on the onboarding page. - Name your workspace. Your agents, knowledge bases and conversations all belong to it.
- Open
Settings → Organizationto check the workspace details. - Open
Settings → Team membersand invite colleagues by email. - If you belong to more than one workspace, switch between them at the top of the sidebar.
Check it worked: Your invitee gets an email, and after accepting sees the same dashboard you do.
Good to know: The number of team seats depends on your plan.
b2Create your first agent from a templatePick a ready-made starting point and go through the setup steps.All plans
Steps
- Open
Templatesin the sidebar. Under Generative agents, read each description and clickShow instructionsto see what it tells the AI. - Click
Use templateon the closest fit, for example Customer Support or FAQ Bot. - Basics: give the agent a name and check the suggested display name visitors will see.
- Personality: read the instructions and adjust the three tone sliders.
- Model: pick an AI model. If you're unsure, keep the default.
- Continue through Knowledge and Channels (tutorials B3 and B5), then Publish.
Check it worked: The agent appears on the Agents page as active.
Good to know: When you start from + New agent instead, you choose Generative, Deterministic or Hybrid first, and that can't be changed later. Choose Generative to begin with.
b3Teach it your business with a knowledge baseGive the agent your documents so it answers from them instead of guessing.All plans
Steps
- Open
Knowledge Basesand create one, for example "Help centre". - Upload documents:
.pdf,.docx,.txtor.md, up to 25 MB each. - To use your website, click
Add from a URL instead, then add one page withAdd URLor a whole site withCrawl site. - Wait until every document has finished processing.
- Edit your agent, choose this knowledge base on the Knowledge step, and save.
Check it worked: Ask the agent something only your documents answer, such as your returns window. It should give your policy.
Good to know: Short documents on one topic each answer better than one huge file. The number of documents you can add depends on your plan.
b4Test it in the PlaygroundChat with the agent privately before visitors do.All plans
Steps
- On the
Agentspage, open the agent's menu and choosePlayground. - Ask five real questions your customers ask, plus one the agent shouldn't be able to answer.
- Where an answer is off, tighten the instructions on the Personality step, or add a document to the knowledge base.
- Clear the chat to start a fresh conversation after each change.
Check it worked: For the question it can't answer, the agent says it doesn't know or offers a person instead of making something up.
b5Put the chat on your websiteAdd the chat bubble to your site with one snippet.All plans
Steps
- On the Channels step, keep
Web chaton and set the colour, style, corner and welcome message. - On the Publish step, open the
JavaScripttab and copy the snippet. - Paste it just before
</body>on every page that should show the chat, or into your site builder's custom code setting. - Publish your site and open it in a private browser window.
Check it worked: The bubble appears in the corner you chose, and your test messages show up under Conversations.
Good to know: On the Free plan the chat shows "Powered by Flexaura".
b6Read conversations and take overSee what visitors ask, and reply yourself when needed.All plans
Steps
- Open
Conversationsand pick one. - Click
Take over. The agent stops replying in that conversation. - Type your reply. The visitor sees it labelled "Support agent".
- When you're done, click
Return to bot, or mark the conversation resolved.
Check it worked: Take over a test chat on your own site: your reply arrives with the "Support agent" label and the agent stays quiet.
b7Understand your analyticsKnow how much your agents are used and where they struggle.All plans
Steps
- Open
Analyticsfor the whole workspace, or chooseAnalyticsfrom one agent's menu. - Change the date range to compare weeks.
- Look at conversations per agent. For flow agents, also see where visitors stop and why they were handed to a person.
- Turn what you find into a fix: a missing document, or a clearer instruction.
Check it worked: You can name the kind of question your agent hands over most often.
b8Plans, credits and upgradingKnow what your plan includes before you reach a limit.All plans
Steps
- Check the plan card on the
Dashboardfor this month's usage. - Open
Settings → Billing & planto compare Free, Pro, Team and Enterprise. - Upgrade through checkout. New features are available straight away.
Good to know: Free covers web chat with AI agents. Email, tools, flow agents and your own AI provider key start at Pro.
Shape how it behaves, and reach more places
For people who have one agent live and want it to act more precisely, answer email, take simple actions, or run on their own AI provider account.
i1Write better agent instructionsTurn a template's instructions into ones that fit your business exactly.All plans
Steps
- Edit the agent and go to the Personality step.
- Say who the agent works for, what it must never do (for example, promise refunds), and when it should offer a person.
- List the topics it should politely decline.
- Save, then ask your Playground questions from B4 again.
Check it worked: Ask it to break one of your rules. It declines and stays on topic.
i2Embed with React or an iframePlace the chat inside a React app, or inside a page of its own.All plans
Steps
- On the agent's Publish step, open the
Reacttab for React apps: install@flexaura/reactand render theFlexauraWidgetcomponent exactly as the tab shows. - Open the
iFrametab for a chat that fills a space on the page, such as a help page. - Try either one on a test page before your live site.
Check it worked: All three ways reach the same agent, and their chats appear in the same Conversations list.
i3Answer email with an agentLet an agent reply to messages sent to your support address.Pro and above
Steps
- Open
Email Configsand create one. You get a Flexaura email address for it. - Attach an agent. Mail sent to an address with no agent attached is ignored.
- In your own mailbox settings, forward your support address to the Flexaura address.
- Optionally, add your own domain so replies come from your address. This needs DNS records at your domain provider.
Check it worked: Send a test email to your support address. The reply arrives, and the thread appears in Conversations.
Good to know: Replies only come from your own domain once its DNS records have been verified.
i4Turn on built-in toolsLet the agent do more than talk: offer buttons, remember details, hand over.Pro and above
Steps
- Open the agent's menu and choose
Workflow. - Switch on what you need:
Search the knowledge base,Remember details,Offer reply buttons,Hand off to a human,Resolve conversations. - Save, then try each one in the Playground. For example, ask for a person and check the conversation moves to your team.
Check it worked: Reply buttons appear in the chat, and the Playground shows which tools ran.
Good to know: Tool calls count toward a monthly limit (Pro 5,000, Team 50,000). At the limit the agent keeps answering, without tools.
i5Use your own AI provider keyRun agents on your own OpenAI, Anthropic or Google account.Pro and above
Steps
- Create an API key in your AI provider's console.
- Open
Settings → LLM keys (BYOK)and add it. It is stored encrypted, and only its last few characters are shown again. - On the agent's Model step, choose one of that provider's models.
Check it worked: After a few test messages, the usage appears in your provider's dashboard.
Good to know: Safety checks on messages always run on Flexaura's account, never on your key.
i6Safety checks and handover in practiceKnow what's blocked automatically, and set up a dependable way to reach a person.All plans
Steps
- Know the default: every incoming message is checked for harmful content before the agent replies, and a flagged message gets no AI reply.
- In the instructions, say when to offer a person: an angry customer, a billing dispute, anything legal.
- On Pro and above, switch on
Hand off to a human(I4) so the agent can move the conversation itself. - Decide who on your team watches
Conversationsfor handovers, and when.
Check it worked: Ask for "a real person" in the Playground. The conversation moves to your team and waits for a reply.
i7Team roles and getting help from FlexauraGive teammates the right access, and invite our support team when you need help.All plans
Steps
- In
Settings → Team members, chooseAdminorMemberfor each person you invite. - Revoke invites you no longer need.
- For help with setup, invite a Flexaura support address into your workspace. It doesn't use a seat, and you can remove it at any time.
Good to know: Flexaura staff can only see your workspace when you invite them in.
i8Your first flow agent, from a templateAn agent that follows fixed steps and buttons, with no AI-written replies.Pro and above
Steps
- Open
Templatesand, under Flow agents, pick one such as Callback request or Order status. - Open the card's "things to fill in" list to see what you'll need before it can go live.
- Click
Use template, choose a name and how the chat looks, and create the agent. The flow editor opens. - Work through the issues list: replace the example email addresses and
api.example.comaddresses, and add any secrets it names. - Run the template's saved tests, then publish.
Check it worked: Every saved test passes, and publishing no longer reports any issues.
Good to know: A template can't be published while its placeholders are still there, so a half-finished flow never goes live.
Connect your systems and design flows
For people comfortable with APIs and process design: agents that look up and change data in your systems, follow exact paths, and know who they're talking to.
a1Connect your own API with a custom toolLet an agent call your API, for example to look up an order.Pro and above
Steps
- Open
Settings → Toolsand start from a template (Shopify, WooCommerce, HubSpot, Zendesk, Calendly bookings, Send a lead) or from scratch. - Set the HTTPS address, the method, and the inputs the AI should fill in, with a clear description of each.
- Add your API key as a secret. It is encrypted and never shown in full again.
- For anything that changes data, switch on
Ask the visitor before running: the agent describes the action, and it runs only after the visitor replies. - Attach the tool on the agent's
Workflowpage and try it in the Playground.
Check it worked: Ask the agent for an order's status. The Playground shows the call and what came back.
Good to know: Only public HTTPS addresses work, redirects aren't followed, and each call stops after 10 seconds or 1 MB.
a2Build a flow from scratchDesign a conversation step by step on the canvas.Pro and above
Steps
- Sketch the process first: what you ask, what you check, and where it ends.
- Create a Deterministic agent and choose
Blankas the starting point. - Add steps:
Message,Buttons,Ask for(collects a value),Confirm,ConditionorSwitch,API call,Hand offandEnd. - Move parts you repeat into a
Sub-flow, and useGo toto return to a menu. - Add keyword commands such as "menu" or "agent" that work at any point.
- Add
Mark goalwhere the flow succeeds, so analytics can count it.
Check it worked: Walk every branch in the test panel, including what happens when a message isn't understood.
a3Test, publish and roll back flowsChange a live flow without breaking it.Pro and above
Steps
- Run a conversation in the test panel and click
Keep this conversation as a saved test. - Build up saved tests until each main path has one.
- Edit the draft, run all saved tests, and publish only when they pass.
- Before publishing, read the list of changes since the live version.
- If something goes wrong, open the version history and restore the previous version.
Check it worked: A deliberately broken edit makes a saved test fail before you publish it.
a4Hybrid agents: flows plus AIUse exact flows for key tasks, and let AI answer everything else.Pro and above
Steps
- Choose Hybrid when you create the agent, and set it up like an AI agent: instructions, model and knowledge base.
- On its flow page, add the tasks that must follow an exact path, such as returns, each started by an intent.
- Anything that matches no intent is answered by the AI.
- Add an
AI answerstep inside a flow when you want an answer from the knowledge base at that point.
Check it worked: "I want to return my order" starts the returns flow, and "What are your opening hours?" gets an AI answer.
a5Match what visitors mean, not just what they typeMake intents recognise real phrasing, typos and synonyms.Pro and above
Steps
- For each intent, add keywords and several example phrases in your customers' own words.
- Review the settings for typos, "Did you mean…", switching between tasks, and synonyms.
- Turn on matching by meaning to catch phrasing your examples don't cover.
- After launch, check "How messages were understood" in the agent's analytics and add missed phrases to the right intent.
Good to know: Matching by meaning sends visitors' messages to OpenAI. It isn't available when the agent's safety check is set to keywords or off (A7).
a6Verify who the visitor isLet only your logged-in customers reach account-specific steps.Pro and above
Before you start
You need a developer who can change your website's server code.
Steps
- On the agent's flow page, open
Verified visitorsand create a secret. Store it on your server only. - For each logged-in customer, your server signs a JWT with that secret using HS256. It must contain
sub(your customer's ID) andexp, at most one hour ahead.name,emailandattrsare optional. - Give the token to the chat: set
userToken(orgetUserToken, to fetch a fresh one when it expires) inFlexauraConfigfor the JavaScript snippet, or as props onFlexauraWidget. CallFlexaura.identify(token)after a customer logs in on the page. - Put a
Verified onlystep before anything account-specific, such as freezing a card. - Optionally switch on
Only verified visitors can chat.
Check it worked: Logged out, the flow stops at the Verified only step. Logged in, it continues.
Good to know: If the secret leaks, create a new one: tokens signed with the old one stop working.
a7Run a flow agent without AI providersFor regulated work where messages must not be sent to an AI company.Team and above
Steps
- Open a Deterministic agent's flow page and find the
AI usagepanel. - Change the safety check on incoming messages from OpenAI to keywords (checked on Flexaura's own servers) or off.
- Read the statement at the top of the panel. It lists exactly which providers see this agent's messages.
- Remove any
AI answersteps if no AI provider may be involved.
Good to know: Only flow agents can do this. If your plan drops below Team, the check goes back to OpenAI, never to off.
a8Find out why a reply went wrongSee why a reply was slow, wrong or didn't use a tool.Pro and above
Steps
- In the Playground or the conversation, open the reply's tool activity: which tool ran, with what inputs, and what came back.
- Check the reply's timings to see whether searching, the AI model or a tool call was slow.
- Check this month's tool-call usage, on the agent's
Workflowpage or inAnalytics, against your plan's limit. - For a flow, use "Show the steps it took on the canvas" to replay the path a conversation took.
Good to know: Tool activity and timings appear only in your dashboard, never to visitors.
Stuck on a step, or found one that doesn’t match what you see? Tell us