Docs

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.

Beginner

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

  1. Sign up at app.flexaura.ai. You land on the onboarding page.
  2. Name your workspace. Your agents, knowledge bases and conversations all belong to it.
  3. Open Settings → Organization to check the workspace details.
  4. Open Settings → Team members and invite colleagues by email.
  5. 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

  1. Open Templates in the sidebar. Under Generative agents, read each description and click Show instructions to see what it tells the AI.
  2. Click Use template on the closest fit, for example Customer Support or FAQ Bot.
  3. Basics: give the agent a name and check the suggested display name visitors will see.
  4. Personality: read the instructions and adjust the three tone sliders.
  5. Model: pick an AI model. If you're unsure, keep the default.
  6. 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.

Full guide: Build your first AI agent
b3Teach it your business with a knowledge baseGive the agent your documents so it answers from them instead of guessing.
All plans

Steps

  1. Open Knowledge Bases and create one, for example "Help centre".
  2. Upload documents: .pdf, .docx, .txt or .md, up to 25 MB each.
  3. To use your website, click Add from a URL instead, then add one page with Add URL or a whole site with Crawl site.
  4. Wait until every document has finished processing.
  5. 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

  1. On the Agents page, open the agent's menu and choose Playground.
  2. Ask five real questions your customers ask, plus one the agent shouldn't be able to answer.
  3. Where an answer is off, tighten the instructions on the Personality step, or add a document to the knowledge base.
  4. 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

  1. On the Channels step, keep Web chat on and set the colour, style, corner and welcome message.
  2. On the Publish step, open the JavaScript tab and copy the snippet.
  3. Paste it just before </body> on every page that should show the chat, or into your site builder's custom code setting.
  4. 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

  1. Open Conversations and pick one.
  2. Click Take over. The agent stops replying in that conversation.
  3. Type your reply. The visitor sees it labelled "Support agent".
  4. 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

  1. Open Analytics for the whole workspace, or choose Analytics from one agent's menu.
  2. Change the date range to compare weeks.
  3. Look at conversations per agent. For flow agents, also see where visitors stop and why they were handed to a person.
  4. 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

  1. Check the plan card on the Dashboard for this month's usage.
  2. Open Settings → Billing & plan to compare Free, Pro, Team and Enterprise.
  3. 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.

Intermediate

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

  1. Edit the agent and go to the Personality step.
  2. Say who the agent works for, what it must never do (for example, promise refunds), and when it should offer a person.
  3. List the topics it should politely decline.
  4. 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

  1. On the agent's Publish step, open the React tab for React apps: install @flexaura/react and render the FlexauraWidget component exactly as the tab shows.
  2. Open the iFrame tab for a chat that fills a space on the page, such as a help page.
  3. 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

  1. Open Email Configs and create one. You get a Flexaura email address for it.
  2. Attach an agent. Mail sent to an address with no agent attached is ignored.
  3. In your own mailbox settings, forward your support address to the Flexaura address.
  4. 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

  1. Open the agent's menu and choose Workflow.
  2. Switch on what you need: Search the knowledge base, Remember details, Offer reply buttons, Hand off to a human, Resolve conversations.
  3. 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

  1. Create an API key in your AI provider's console.
  2. Open Settings → LLM keys (BYOK) and add it. It is stored encrypted, and only its last few characters are shown again.
  3. 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

  1. Know the default: every incoming message is checked for harmful content before the agent replies, and a flagged message gets no AI reply.
  2. In the instructions, say when to offer a person: an angry customer, a billing dispute, anything legal.
  3. On Pro and above, switch on Hand off to a human (I4) so the agent can move the conversation itself.
  4. Decide who on your team watches Conversations for 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

  1. In Settings → Team members, choose Admin or Member for each person you invite.
  2. Revoke invites you no longer need.
  3. 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

  1. Open Templates and, under Flow agents, pick one such as Callback request or Order status.
  2. Open the card's "things to fill in" list to see what you'll need before it can go live.
  3. Click Use template, choose a name and how the chat looks, and create the agent. The flow editor opens.
  4. Work through the issues list: replace the example email addresses and api.example.com addresses, and add any secrets it names.
  5. 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.

Full guide: Build your first flow agent
Advanced

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

  1. Open Settings → Tools and start from a template (Shopify, WooCommerce, HubSpot, Zendesk, Calendly bookings, Send a lead) or from scratch.
  2. Set the HTTPS address, the method, and the inputs the AI should fill in, with a clear description of each.
  3. Add your API key as a secret. It is encrypted and never shown in full again.
  4. 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.
  5. Attach the tool on the agent's Workflow page 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

  1. Sketch the process first: what you ask, what you check, and where it ends.
  2. Create a Deterministic agent and choose Blank as the starting point.
  3. Add steps: Message, Buttons, Ask for (collects a value), Confirm, Condition or Switch, API call, Hand off and End.
  4. Move parts you repeat into a Sub-flow, and use Go to to return to a menu.
  5. Add keyword commands such as "menu" or "agent" that work at any point.
  6. Add Mark goal where 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.

Full guide: Flow step handbook
a3Test, publish and roll back flowsChange a live flow without breaking it.
Pro and above

Steps

  1. Run a conversation in the test panel and click Keep this conversation as a saved test.
  2. Build up saved tests until each main path has one.
  3. Edit the draft, run all saved tests, and publish only when they pass.
  4. Before publishing, read the list of changes since the live version.
  5. 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

  1. Choose Hybrid when you create the agent, and set it up like an AI agent: instructions, model and knowledge base.
  2. On its flow page, add the tasks that must follow an exact path, such as returns, each started by an intent.
  3. Anything that matches no intent is answered by the AI.
  4. Add an AI answer step 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.

Full guide: Build your first hybrid agent
a5Match what visitors mean, not just what they typeMake intents recognise real phrasing, typos and synonyms.
Pro and above

Steps

  1. For each intent, add keywords and several example phrases in your customers' own words.
  2. Review the settings for typos, "Did you mean…", switching between tasks, and synonyms.
  3. Turn on matching by meaning to catch phrasing your examples don't cover.
  4. 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

  1. On the agent's flow page, open Verified visitors and create a secret. Store it on your server only.
  2. For each logged-in customer, your server signs a JWT with that secret using HS256. It must contain sub (your customer's ID) and exp, at most one hour ahead. name, email and attrs are optional.
  3. Give the token to the chat: set userToken (or getUserToken, to fetch a fresh one when it expires) in FlexauraConfig for the JavaScript snippet, or as props on FlexauraWidget. Call Flexaura.identify(token) after a customer logs in on the page.
  4. Put a Verified only step before anything account-specific, such as freezing a card.
  5. 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

  1. Open a Deterministic agent's flow page and find the AI usage panel.
  2. Change the safety check on incoming messages from OpenAI to keywords (checked on Flexaura's own servers) or off.
  3. Read the statement at the top of the panel. It lists exactly which providers see this agent's messages.
  4. Remove any AI answer steps 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

  1. In the Playground or the conversation, open the reply's tool activity: which tool ran, with what inputs, and what came back.
  2. Check the reply's timings to see whether searching, the AI model or a tool call was slow.
  3. Check this month's tool-call usage, on the agent's Workflow page or in Analytics, against your plan's limit.
  4. 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