Encyclos

Help center

How to use Encyclos

Step-by-step guides for every feature. Pick your role to see what you can do yourself, and who to ask for everything else.

I am…

Not sure of your role? It's shown next to your name on the Team page.

I want to…

Getting started

Encyclos gives you an automated agent that answers customer questions on your website and on WhatsApp, using your own information, and passes conversations to your team when a person is needed.

Set up your first agent

Sidebar → Bots → New bot, then the agent's Overview

From nothing to a live agent on your website in six steps. Every agent's Overview page has a “Get started” checklist that ticks these off as you go.

Who can do what

  • Create a new agent OwnerAdminAgentViewer
  • Follow the checklist on an agent's Overview OwnerAdminAgentViewer

How to

  1. Open Bots and click New bot. Give it a name (up to 60 characters, e.g. “Support assistant”) and an optional description, then click Create bot. It starts as a Draft.
  2. Add knowledge: upload your documents, import your website or write Q&A pairs, under Knowledge.
  3. Test in the Playground: ask what your customers ask, and fix wrong answers right there.
  4. Tune its behavior: instructions, tone, what it may answer, and when to hand over to your team.
  5. Customize the widget (colours, icon, welcome message) and copy the one-line install code onto your website. Optionally connect WhatsApp.
  6. Click Publish. Until you do, the chat on your website says “This assistant is not available.”

Limits and rules

  • Your plan sets how many agents you can create (Free: 1). At the limit you'll see “Your plan's bot limit has been reached.”

Tips

  • Start with your FAQ, returns policy and shipping information: they cover most questions.
  • Watch Knowledge → Unanswered during the first week and add answers for anything that comes up.

How Encyclos fits together

Everywhere

A few ideas that explain everything else: workspaces and agents, where answers come from, drafts and publishing, and roles.

Who can do what

  • Look at every agent and its pages OwnerAdminAgentViewer
  • Change an agent OwnerAdminAgentViewer

Options explained

Workspace
Your company's space: agents, team, plan and settings. You can belong to several.
Agent (bot)
One assistant, with its own knowledge, behavior, widget and WhatsApp number. The app calls agents “bots”.
Where answers come from
1) A matching Q&A pair, word for word. 2) Otherwise your knowledge (documents, website, text); you can choose to show customers the source. 3) Live data from your connected systems when the question needs it. 4) If nothing fits, your fallback answer, and the question appears under Unanswered.
Draft and live
Behavior and widget changes are saved as a draft and reach customers only when you Publish. Knowledge, Q&A and live-data changes apply as soon as they're processed.
Status
Draft (never published), Live (published), or Paused (not answering).
Conversation states
With the agent (it replies), Needs human (your team replies; the agent stays quiet), Resolved.
Roles
Owner, Admin, Agent and Viewer. See “Who can do what” at the bottom of this page.

Train your agent

The agent answers from what you give it. Add documents and pages, write exact answers for important questions, connect live data, and set how it behaves.

Add knowledge: files and text

Agent → Knowledge → Add knowledge

Upload documents or paste text. The agent reads them, splits them into searchable pieces, and answers from them.

Who can do what

  • See sources, their status and size OwnerAdminAgentViewer
  • Upload files, add text, re-sync or delete sources OwnerAdminAgentViewer
  • Edit a source: rename it, change a text, or replace a file OwnerAdminAgentViewer

How to

  1. Open Knowledge and click Add knowledge → Files. Choose up to 10 files (PDF, Word, Excel, PowerPoint, text, Markdown, CSV or HTML) and upload.
  2. Or choose Add knowledge → Text, give it a title (e.g. “Shipping policy”) and paste the content. Markdown headings (# Title) help structure it.
  3. Each source shows Queued, then Processing…, then Ready. The list refreshes by itself. Ready sources are used straight away; no Publish needed.
  4. To change a source, click its pencil (Edit). For text you can change the title and content; for a file you can rename it or upload a new version to replace it. Saving re-reads it, and the agent keeps using the current version until that finishes.
  5. Click Re-sync to read a source again as it is, or Delete to remove it.

Options explained

Sources / Q&A pairs / Chunks indexed
How many sources you have, how many Q&A pairs, and how many searchable pieces your documents were split into.
Knowledge size
Characters stored, against your plan's limit.
Status: Failed
Hover the row or read the red message under it: for example a scanned PDF without text, an encrypted PDF, or the knowledge size limit.

Limits and rules

  • Files: up to 20 MB each, 10 per upload. If one file is rejected, none of that upload is added; remove the bad file and try again.
  • Scanned PDFs and images have no text to read and aren't supported yet.
  • Text sources: title up to 200 characters, content up to 200,000.
  • A source can't be edited while it's Processing… or Scanning site…; wait for it to finish.
  • Sources per agent depend on your plan (Free 20, Pro 500, Business 5,000). Knowledge size is checked while processing; over the limit the source fails with “Your plan's knowledge size limit has been reached.”

Tips

  • Clean, specific documents beat large general ones. Split long manuals by topic if you can.
  • Use Q&A pairs for answers that must be exact, such as prices or legal wording.

Import your website

Agent → Knowledge → Add knowledge → Website

Give a web address and the agent reads your public pages. You can let it suggest which pages are useful and review the list before anything is indexed, and keep it up to date automatically.

Who can do what

  • See imported sites and which pages were picked OwnerAdminAgentViewer
  • Import a website, choose its pages, re-sync or delete it OwnerAdminAgentViewer
  • Change an imported website's settings OwnerAdminAgentViewer

How to

  1. Click Add knowledge → Website and enter the address, e.g. https://example.com/help.
  2. Choose What to fetch: Crawl links (follow links on the site), Sitemap (use sitemap.xml) or This page (only that address).
  3. Optionally limit it with “Only paths starting with” and “Skip paths starting with” (one per line, e.g. /blog), set Max pages, and pick Auto re-sync (Never, Daily, Weekly or Monthly).
  4. Leave “Let the AI choose useful pages” ticked to have pages suggested for you. Click Start.
  5. The site shows “Scanning site…”, then “Review pages”. Click it to see every page with a Keep or Skip suggestion and a reason. Adjust the ticks and click Index selected pages.
  6. Later re-syncs keep your choices; new pages follow the suggestion. Unchanged pages are skipped and pages removed from your site are removed from the agent.
  7. To change the settings later, click the site's pencil (Edit). A new address, a different “What to fetch” or new path filters read the site again and, with page suggestions on, ask you to review the pages again. Changing only the name or the re-sync schedule doesn't re-read anything.

Limits and rules

  • Only public pages on the same domain are read, and robots.txt is respected.
  • Max pages is capped by your plan (Free 50, Pro 1,000, Business 5,000). Higher numbers are lowered silently.
  • PDF links, images and pages with almost no text are skipped. Upload PDFs as files instead.
  • Addresses must be http or https on the normal ports; private or internal addresses are refused (“destination address is not allowed”).

Tips

  • Point it at your help center rather than your whole site to keep answers focused.

Write exact answers (Q&A)

Agent → Knowledge → Q&A tab, or Add knowledge → Q&A

A Q&A pair is a question with the exact answer you want given. When a customer asks it, or something very close, the agent replies with your answer word for word. Q&A takes priority over everything else.

Who can do what

  • Read Q&A pairs OwnerAdminAgentViewer
  • Add, edit or delete Q&A pairs OwnerAdminAgentViewer

How to

  1. Open Knowledge → Q&A and click Add Q&A.
  2. Type the Question, add “Other ways to ask” (one per line) and write the Answer. Click Save.
  3. It works immediately for questions worded the same way, and for similar wordings a moment later.

Limits and rules

  • Question up to 500 characters, answer up to 5,000, and up to 10 other phrasings.
  • Answers from Q&A don't count towards your monthly answers.

Tips

  • Fix a wrong answer in seconds: in the Playground, click ✎ Fix this answer under the reply.
  • Answering an item under Unanswered creates a Q&A pair and clears that item.

Fill the gaps: unanswered questions

Agent → Knowledge → Unanswered tab

Every question the agent couldn't answer from your knowledge is collected, with how often it was asked. Answer it once and the agent knows from then on.

Who can do what

  • See unanswered questions OwnerAdminAgentViewer
  • Add an answer or dismiss a question OwnerAdminAgentViewer

How to

  1. Open Knowledge → Unanswered. Questions are listed by how often they were asked.
  2. Click Add answer to write a Q&A pair, pre-filled with the question. Saving removes it from the list.
  3. Click Dismiss for questions you don't want to answer. It comes back if someone asks again.

Limits and rules

  • Playground questions are included, and so are questions that went unanswered because the monthly limit was reached.

Connect live data (your store, orders, stock)

Agent → Live data APIs

Let the agent look up current information while it answers, such as prices, stock, delivery options or order status, by connecting your own system's API. It decides per question whether to use your knowledge or look something up.

Who can do what

  • See connected systems and their lookups OwnerAdminAgentViewer
  • Connect a system, review, test, enable or delete lookups OwnerAdminAgentViewer

How to

  1. Click Add API. Enter a Name, the Base URL (must be https), and optionally the address of your API documentation or OpenAPI/Swagger file and a short note on what data it has.
  2. Choose Authentication (None, API key in a header, API key in the URL, or Bearer token) and paste the key. It's stored encrypted and never shown to customers.
  3. Leave “Discover endpoints from the docs now” ticked. In a minute or two, suggested lookups appear as Proposed (switched off).
  4. Open each one with Edit and test: check the path, parameters and the description of when to use it, then Send test request to see exactly what the agent will receive.
  5. Tick Enabled (or use Enable in the list). Changes apply immediately, without publishing.
  6. You can also add a lookup by hand: Add endpoint, give it a lower_snake_case name, a path like /products/{product_id}, and describe when to use it.

Limits and rules

  • For public data only: lookups are read-only, never include who the customer is, and any customer can trigger them. Don't connect anything that returns private customer data.
  • Up to 20 connections and 60 lookups per agent; up to 10 lookups per answer.
  • Each lookup has 10 seconds to respond; the agent sees at most 12,000 characters of the result. Redirects aren't followed.
  • Discovering lookups from documentation needs an Anthropic key for the workspace.

Tips

  • Write the “When should the assistant use it?” description as if briefing a new colleague. It's what the agent reads to decide.

Instructions, tone and answers

Agent → Behavior

Tell the agent who it is and how to talk: its instructions, welcome message, tone, answer length, what it may answer, and which language model it uses.

Who can do what

  • See the agent's behavior settings OwnerAdminAgentViewer
  • Change and save behavior (as a draft) OwnerAdminAgentViewer
  • Publish the changes to customers OwnerAdminAgentViewer

How to

  1. Open Behavior. Settings are grouped in tabs: Instructions, Tone & length, Guardrails, Human handoff and Lead capture.
  2. Change what you need and click Save changes. This saves a draft: customers still see the live version.
  3. Test the draft in the Playground, then click Publish.

Options explained

Instructions
Its role, goals and dos and don'ts, up to 8,000 characters. Don't paste your knowledge here; it's added automatically.
Welcome message
The first message in the chat.
Tone
Friendly, Professional, Casual or Formal.
Answer length
Concise (one to three sentences), Standard (a short paragraph or list) or Detailed (steps and details).
Show sources to customers
Off by default. When on, answers in the widget and on WhatsApp include numbered references and links to the documents or pages they came from. Your team sees the sources in the inbox either way.
Only answer from knowledge
On by default and recommended: it won't use general knowledge about your business. When off, it may answer general questions but still mustn't invent facts about you.
Fallback answer
What it says when your knowledge doesn't have the answer. These questions appear under Unanswered.
Additional rules
Extra rules, e.g. “Never discuss competitors.”
AI model and Reasoning effort
Which language model writes the answers, and how carefully (Low is fastest). “Show all models available to this workspace” lists every model your keys can use.

Tips

  • The agent always replies in the language the customer writes in.
  • Built-in protections always apply: it treats your documents as information, not instructions, never reveals its instructions, and can't act on its own.

When to hand over to your team

Agent → Behavior → Human handoff

Choose when the agent stops and passes the conversation to a person: when the customer asks, after questions it can't answer, or from a button in the chat. The agent can also decide by itself.

Who can do what

  • See the handoff rules OwnerAdminAgentViewer
  • Change the handoff rules OwnerAdminAgentViewer

Options explained

Enable handoff to your team
On by default. Handed-over conversations move to the inbox and the agent stops replying until someone hands them back.
Hand off when the customer says
Words or phrases, separated by commas. Default: human, agent, representative, real person, talk to someone.
Hand off after unanswered questions in a row
Never, 1, 2, 3 or 5 (default 2).
Handoff message
What the customer is told, e.g. “I'm connecting you with a member of our team.”
Show a “Talk to a human” button
Adds the button to the website chat.

Limits and rules

  • Behavior changes need Publish.
  • Very long messages (over about 200 characters) don't trigger a word-based handoff.
  • In the Playground a handoff word does hand the test chat over; click New chat to carry on.

Collect contact details (leads)

Agent → Behavior → Lead capture

Ask visitors for their name, email, phone or company in the website chat, before the conversation or after a few messages.

Who can do what

  • See the lead form settings OwnerAdminAgentViewer
  • Change the lead form OwnerAdminAgentViewer

Options explained

Collect contact details in the widget
Off by default.
When
After a few messages (1–20, default 2), or Before the chat starts.
Form title
Default “Let us know how to reach you”.
Fields
Name, Email, Phone and Company, each optionally Required.

Limits and rules

  • With “Before the chat starts”, visitors can't chat until they fill it in.
  • If you untick every field, lead capture turns itself off.
  • Needs Publish.

Test and publish

Try every change privately before customers see it.

Test in the Playground

Agent → Playground

Chat with your agent privately, see exactly where each answer came from, and fix wrong answers on the spot.

Who can do what

  • Open the Playground OwnerAdminAgentViewer
  • Chat with the agent in the Playground OwnerAdminAgentViewer
  • Fix an answer (save it as a Q&A pair) OwnerAdminAgentViewer

How to

  1. Open Playground. Under Testing, choose “Draft (unpublished changes)” or “Published version”.
  2. Ask what your customers would ask. Enter sends; Shift+Enter adds a new line.
  3. Under each reply, see what it was answered from (Q&A, knowledge, live data, or not found), which documents and lookups were used, the model, and the time taken.
  4. If an answer is wrong, click ✎ Fix this answer, write the correct answer and click Save answer. The agent uses it from then on.
  5. Click New chat to start over.

Limits and rules

  • Playground answers count towards your monthly answers, but not towards analytics or the inbox.
  • Up to 30 messages a minute.
  • Viewers can open the Playground but can't send messages.

Publish changes

The bar at the top of Behavior and Channels → Web widget

Behavior and widget changes are saved as a draft. Publishing makes the draft the new live version for your website and WhatsApp.

Who can do what

  • See whether there are unpublished changes OwnerAdminAgentViewer
  • Publish OwnerAdminAgentViewer

How to

  1. After saving Behavior or widget changes you'll see “You have unpublished changes. Customers still see the live version.”
  2. Test in the Playground with “Draft (unpublished changes)”.
  3. Click Publish. The draft becomes the next version (v1, v2…) and goes live immediately.

Options explained

Needs Publish
Behavior (instructions, tone, guardrails, handoff, lead capture) and the widget's look and text, including its icon.
Live immediately
Knowledge, Q&A pairs and live data lookups.

Limits and rules

  • Until an agent is published for the first time, the website chat says “This assistant is not available.” and WhatsApp messages are ignored.
  • There's no undo for a publish. To go back, change the settings and publish again.

Put it on your website and WhatsApp

One agent can answer on your website and on a WhatsApp number at the same time, with the same knowledge and rules. Both use the published version.

Add the chat to your website

Agent → Channels → Web widget → Install

Paste one line of code into your website and a chat button appears in the corner of every page.

Who can do what

  • Copy the install code and open the test page OwnerAdminAgentViewer
  • Chat with the agent on your website Anyone

How to

  1. Publish the agent at least once.
  2. Open Channels → Web widget. Under Install, click Copy next to the code.
  3. Paste it just before </body> on every page of your website (in most site builders: Settings → Custom code → Footer).
  4. Reload your site: the chat button appears in the bottom corner. Click Open test page to try it on a blank page first.

Options explained

On phones
The chat opens full-screen.
Unread badge
A red dot on the button when a reply arrives while the chat is closed.
Open from your own button
Call encyclos('open'), encyclos('close') or encyclos('toggle') from your page's code.

Limits and rules

  • If the agent isn't published or is paused, visitors see “This assistant is not available.”
  • If you've set Allowed domains, the chat only loads on those sites (“This assistant is not enabled on this website.”). The test page always works for your team.
  • Each visitor can send 20 messages a minute by default; change it under Abuse protection.

Tips

  • Restrict the chat to your own sites under Settings → Allowed domains so nobody can put your agent on theirs.

Customize the chat: colours, icon, button and effects

Agent → Channels → Web widget

Match the chat to your brand: name, colours, your own icon or an animated character, the button's style and effects, a greeting bubble, a frosted-glass or solid chat window, welcome message, suggested questions and a footer note.

Who can do what

  • See the widget settings and live preview OwnerAdminAgentViewer
  • Change the widget and save it as a draft OwnerAdminAgentViewer

How to

  1. Open Channels → Web widget. The live preview on the right is your real chat, on a sample page: click its button to open and close it, type a message to see the animations, and switch the page background to check glass and glow effects.
  2. Pick a style under “Start from a style” (Classic, Glass, Neon, Playful mascot, Minimal or Aurora) to fill in the look in one click, then fine-tune any setting. Your name, colours, icon and texts are kept.
  3. Click Save widget. Changes are a draft until you Publish.

Options explained

Display name
Shown in the chat header (up to 60 characters).
Brand colour and second colour
The brand colour fills the button, header and your customers' messages. Gradients, glows and rings also use a second colour: pick one, or leave it to us to choose a matching shade.
Icon
Your logo or avatar on the chat button and in the header. PNG, JPEG or GIF, 32–1024 pixels, under 512 KB; square images look best. Tick “Remove icon” to go back to the first letter of the name.
Theme
Light, Dark or “Match visitor's system”.
Corner roundness
From square to very round.
Chat button: style, shape and size
Solid, gradient, frosted glass, outline or neon; a circle, rounded square, square, or a pill with a short text (up to 24 characters). Size from 44 to 72 pixels.
On the button
Your icon (or a symbol, if you haven't uploaded one), or an animated character — robot, cat, ghost, blob, owl, alien, bear or cyclops — whose eyes follow the visitor's pointer. The chat header shows the same.
Position
Any corner of the page, with the distance from the edges in pixels.
Auto-open after
Opens the chat by itself after a number of seconds, once per visit. 0 means never.
Hide the chat on phones
Visitors on small screens don't see the button at all.
Motion & effects
An attention animation (it plays a few times, then rests, and stops once the chat was opened), what happens on hover and on click, how the button appears, and its shadow, glow and ring.
Greeting bubble
A short message next to the button (up to 80 characters), shown once per visit after a delay, when the visitor scrolls down, or when they are about to leave. Visitors can close it, and it can hide itself after some seconds.
Chat window
Size (compact, standard or large), a solid or frosted-glass background with adjustable blur and solidity, the header style, a pattern behind the messages, bubble shape, border, shadow, glow, opening and message animations, typing indicator, font, text size and a pointer spotlight.
Welcome message
The first bubble in the chat. Same setting as on Behavior.
Suggested questions
Up to 6 buttons shown before the first message; clicking one asks it.
Input placeholder and footer
The grey text in the message box, and a short note under the chat.
Feedback and “Talk to a human”
Show 👍/👎 under answers, and a button to reach your team (needs handoff turned on).
Abuse protection
Messages per visitor per time window, and the message shown when someone sends too fast.

Limits and rules

  • SVG icons aren't accepted. Images are re-processed for safety, so animated GIFs become still images.
  • If an icon is rejected, your other changes are still saved.
  • Visitors who ask their device for less motion see no animations, and pointer effects only work with a mouse. On phones the chat uses nearly the full screen and a pill button becomes a circle.
  • Frosted glass needs a recent browser; older ones show a solid window instead.
  • Needs Publish.

Connect WhatsApp

Agent → Channels → WhatsApp

Link a WhatsApp number to the agent by scanning a QR code, like WhatsApp Web. Customers who message that number get answers from the agent.

Who can do what

  • See the WhatsApp connection status OwnerAdminAgentViewer
  • Connect, restart, resume or disconnect WhatsApp OwnerAdminAgentViewer
  • Reply to WhatsApp customers from the inbox OwnerAdminAgentViewer

How to

  1. Open Channels → WhatsApp and click Connect WhatsApp.
  2. On your phone open WhatsApp → Settings → Linked devices → Link a device, and point it at the QR code.
  3. No camera handy? Use “Or link with phone number”: enter the number with its country code, click Get code, and type the code in WhatsApp → Linked devices → Link with phone number.
  4. When it shows “● Working”, you're connected. Share the wa.me link shown on the page so customers can start a chat.
  5. Make sure the agent is published: unpublished or paused agents don't answer.

Options explained

Restart session
Use when it's connected but not responding.
Resume sending
Appears if WhatsApp rejected a message and sending was paused to protect the number. Replies written while paused wait, and are sent when you resume (if it's within a day).
Disconnect
Unlinks the number. Conversations are kept; you'll need to scan a QR code again to reconnect.

Limits and rules

  • One number per agent.
  • Text only: photos and voice notes without a caption get a polite request to type the question.
  • Group chats and status updates are ignored.
  • A conversation continues if the customer writes again within 24 hours; after that a new one starts.
  • Replies are paced like a person typing to protect your number from spam protection.
  • If the page says “WhatsApp isn't configured on this server”, contact your platform operator.

Tips

  • Use a dedicated business number rather than someone's personal phone.

Conversations and your team

Every conversation from your website and WhatsApp lands in the inbox. The agent answers by itself; your team steps in when needed.

The inbox

Agent → Inbox

See every customer conversation as it happens, filtered by state and channel. The list and the open conversation update live.

Who can do what

  • Read conversations and filter the inbox OwnerAdminAgentViewer
  • Reply, take over, resolve, assign and tag OwnerAdminAgentViewer

Options explained

Open
Everything not resolved (the default view).
Needs human
Conversations your team is handling. The agent stays quiet in these.
AI
Conversations the agent is handling by itself.
Resolved / All
Finished conversations, or everything.
Channel and Mine
Show only website or WhatsApp conversations, or only the ones assigned to you.
Blue dot
Unread: the customer wrote since anyone last opened it.
Under each answer
The agent's confidence, the customer's 👍/👎, the sources it cited and any live data it looked up.
Contact panel
On wide screens: name, email, phone, “Verified user” if they were signed in on your site, when first seen and message count.

Limits and rules

  • The list shows the 100 most recently active conversations for the current filter.
  • Playground chats don't appear here.
  • Viewers can read conversations but have no reply box or buttons, and reading one doesn't mark it as read for the team.

Take over, reply and resolve

Agent → Inbox → open a conversation

Step into any conversation, reply as yourself, hand it back to the agent when you're done, or mark it resolved.

Who can do what

  • Read the conversation OwnerAdminAgentViewer
  • Take over, reply, hand back to the agent, resolve or reopen OwnerAdminAgentViewer

How to

  1. Open a conversation and click Take over. The agent stops replying and you're assigned if nobody was.
  2. Type in the reply box and press Enter (Shift+Enter for a new line). Your reply goes to the website chat or WhatsApp, under your name. Replying without clicking Take over takes over too.
  3. When you're finished, click Hand back to AI to let the agent continue, or Resolve to close it.
  4. Resolved conversations reopen by themselves if the customer writes again. You can also click Reopen.

Limits and rules

  • Replies are up to 4,000 characters.
  • For WhatsApp conversations the agent's WhatsApp must be connected, or you'll see “WhatsApp is not connected for this bot”.

Tips

  • Type ! at the start of the reply box to insert a saved reply.

Assign and tag conversations

Agent → Inbox → conversation → side panel

Make it clear who's handling what, and label conversations so you can spot patterns.

Who can do what

  • See assignees and tags OwnerAdminAgentViewer
  • Assign a conversation and set its tags OwnerAdminAgentViewer

How to

  1. In the side panel, pick someone under Assignee and click Save. Only Owners, Admins and Agents can be assigned.
  2. Under Tags, type labels separated by commas (e.g. billing, vip) and click Save.
  3. Tick Mine in the inbox filters to see only your conversations.

Limits and rules

  • Up to 10 tags per conversation, each up to 30 characters. Tags are saved in lower case.

Saved replies

Sidebar → Saved replies (outside an agent)

Write answers you send often once, give each a short name, and insert it in any conversation by typing ! and the name.

Who can do what

  • Create, use and delete saved replies OwnerAdminAgentViewer

How to

  1. Open Saved replies from the workspace sidebar.
  2. Enter a Shortcut (e.g. refund) and the Reply text, then click Save reply. Saving an existing shortcut replaces its text.
  3. In any inbox conversation, type ! then the first letters of the shortcut, and pick it from the list (or press Enter for the first match).

Limits and rules

  • Shortcuts: 1–30 letters, numbers, dashes or underscores. Replies: up to 2,000 characters.
  • Saved replies are shared by every agent in the workspace.
  • Viewers don't see Saved replies: it's for people who reply.
  • Deleting has no confirmation.

Leads

Agent → Leads

Every set of contact details collected by the website chat's lead form, with a link to the conversation. Export them as a spreadsheet.

Who can do what

  • See leads and export them as CSV OwnerAdminAgentViewer
  • Turn the lead form on and choose its fields OwnerAdminAgentViewer

How to

  1. Turn on the form under Behavior → Lead capture and publish.
  2. Open Leads to see name, email, phone, company and date. Click Conversation → to read the chat.
  3. Click Export CSV to download them (date, channel, name, email, phone, company).

Limits and rules

  • The page shows the latest 500; the export includes up to 50,000.
  • Leads come from the website chat only.

Results and agent settings

See how well the agent is doing, and manage the agent itself.

Versions and tests (A/B tests, gradual rollouts)

Agent → Versions & tests

Every publish is kept as a version you can go back to. You can also run two or more versions at the same time, each for a share of your customers, and compare their results before choosing one for everyone.

Who can do what

  • See versions, tests and their results OwnerAdminAgentViewer
  • Save a version, make a version live, start, change or end a test OwnerAdminAgentViewer

How to

  1. To go back: find the version in Version history and click Make live. All customers get it right away. Edit as draft copies it into your draft instead, without changing anything for customers.
  2. To test a change: edit the draft in Behavior, then on Versions & tests click Save draft as a version. That stores it without making it live.
  3. Under Start a test, give each version a share. 50/50 is a classic A/B test; 90/10 is a careful rollout of a new version. The shares must add up to 100%.
  4. While the test runs, compare the versions in the table. Change the shares at any time, for example 10% → 25% → 50%.
  5. Click End test and choose which version everyone gets from then on.

Options explained

Share
The percentage of customers a version serves. A customer keeps the same version for the whole test, on the website chat and on WhatsApp. Raising a version's share only moves customers onto it, never back and forth.
Baseline
The version the others are compared with: the live version, or the oldest version in the test if the live one isn't part of it.
AI resolution / Unanswered / Satisfaction
The same measures as in Analytics, counted separately for the conversations each version answered.
Better / worse
Shown only when the difference from the baseline is unlikely to be chance (95% confidence) and each side has at least 30 conversations, answers or ratings. Until then you see “needs more data” or “no clear difference”.
Avg. reply time, Tokens / answer
How long the version takes to answer and how much AI usage one answer costs, useful when comparing models.

Limits and rules

  • One test at a time per agent, with 2 to 5 versions.
  • While a test runs you can't publish or make another version live; end the test first. You can still edit the draft and save it as a version.
  • A version holds the Behavior and widget settings. Knowledge, Q&A pairs and live-data connections are shared by all versions.
  • Results are counted from when this feature was switched on; earlier conversations aren't assigned to a version. Playground chats never count.

Analytics

Agent → Analytics

How your agent performs with real customers: conversation volume, how many it resolved without your team, customer ratings, channels, most-used knowledge and unanswered questions.

Who can do what

  • See analytics OwnerAdminAgentViewer

How to

  1. Open Analytics and pick 7, 30 or 90 days.

Options explained

Conversations
New conversations in the period, and how many messages customers sent.
AI resolution rate
The share of conversations handled without your team at any point.
Handoff rate
The share that needed your team at any point: handed over, taken over, or replied to by a person. It stays counted even after the conversation is handed back.
Satisfaction
👍 as a share of all 👍 and 👎 ratings.
Conversations over time
A daily chart of conversations and handoffs.
By channel
Website versus WhatsApp.
Most cited knowledge
The documents the agent relied on most.
Unanswered questions
The questions asked most often in the period that it couldn't answer, with a link to answer each.

Limits and rules

  • Playground chats aren't counted.

Tips

  • A falling resolution rate usually means new questions. Check Unanswered and add Q&A pairs.

Rename, pause or delete an agent

Agent → Settings

General settings for one agent: its name and description, pausing it, and deleting it. These apply immediately, without publishing.

Who can do what

  • See the agent's settings and ID OwnerAdminAgentViewer
  • Rename, pause or re-index the agent OwnerAdminAgentViewer
  • Delete the agent OwnerAdminAgentViewer

Options explained

Name and description
Name up to 60 characters, description up to 300.
Pause this bot
The website chat shows as unavailable and WhatsApp messages aren't answered. Unpause to go back to live.
Re-index knowledge
Re-processes every source. Only needed if the platform operator changes how knowledge is indexed.
Delete bot
Type the agent's name to confirm. Permanently deletes its knowledge, conversations, leads and channel connections, and disconnects WhatsApp.

Limits and rules

  • Deleting can't be undone.

Allowed domains

Agent → Settings → Allowed domains

Choose which websites may show your chat. Leave it empty to allow any site (not recommended).

Who can do what

  • See the allowed domains OwnerAdminAgentViewer
  • Change the allowed domains OwnerAdminAgentViewer

How to

  1. Open Settings → Allowed domains.
  2. Enter one site per line, e.g. example.com, https://shop.example.com or https://*.example.com for all subdomains.
  3. Click Save domains. It applies immediately.

Limits and rules

  • Up to 50 entries. https:// is assumed if you leave it out.
  • A wildcard like https://*.example.com covers subdomains but not example.com itself; add both if you need both.

Recognise signed-in customers (identity verification)

Agent → Settings → Identity verification

If customers log in to your website, your server can tell the chat who they are. The conversation then follows them across devices, and your team sees “Verified user” with their name and email.

Who can do what

  • See whether identity verification is on OwnerAdminAgentViewer
  • Generate, rotate or turn off the secret OwnerAdminAgentViewer

How to

  1. Click Generate secret and copy it straight away: it's shown only once. Give it to your developer to store on your server.
  2. Your server creates a short-lived token (a JWT signed with HS256 and the secret) with the customer's user_id, and optionally name and email, expiring within 24 hours.
  3. Your page passes it to the chat: encyclos('identify', { token }).
  4. To replace the secret, click Rotate secret (the old one stops working immediately). To stop, click Disable.

Limits and rules

  • Tokens must expire within 24 hours, and user_id is required.
  • If a token is rejected, the chat shows “Identity verification failed” until the page is reloaded.

Tips

  • Signed-in customers whose email you pass won't be asked for it by the after-messages lead form.

Workspace and team

A workspace is your company's space in Encyclos. It holds your agents, your team and your plan. Everyone in it has one role, which applies to every agent in the workspace.

Team members and roles

Sidebar → Team

See who has access to the workspace, what role each person has, and whether they have two-factor sign-in turned on. Admins and Owners can change roles and remove people.

Who can do what

  • See the member list, roles and 2FA status OwnerAdminAgentViewer
  • Change a member's role between Admin, Agent and Viewer OwnerAdminAgentViewer
  • Remove a member from the workspace OwnerAdminAgentViewer
  • Make someone an Owner, or change or remove an Owner OwnerAdminAgentViewer

How to

  1. Open Team in the sidebar. Every member is listed with their role and whether two-factor sign-in (2FA) is Enabled or Off. Your own row says “(you)”.
  2. To change a role, pick the new role in that person's row and click Update. The change applies straight away, on every agent in the workspace.
  3. To remove someone, click Remove in their row and confirm. They lose access immediately; the conversations they handled stay in the inbox.

Options explained

Owner
Everything an Admin can do, plus workspace settings (name, required 2FA, provider keys) and managing other Owners. A workspace always has at least one Owner.
Admin
Creates and edits agents: knowledge, live data, behavior, channels, publishing, and agent settings. Invites and removes people, sets handoff alert numbers, and can see the audit log.
Agent
Works the inbox: replies to customers, takes over, resolves, assigns and tags conversations, and uses saved replies. Can chat in the playground. Can't change any agent.
Viewer
Read-only: can look at agents, conversations, leads, analytics and usage, and export leads. Can't reply or change anything.

Limits and rules

  • Only an Owner can give someone the Owner role, or change or remove an existing Owner. If an Admin tries, they see “only owners can change owners”.
  • The last Owner can't be demoted or removed: “a workspace needs at least one owner”. Make someone else an Owner first.
  • You can't change your own role or remove yourself. Ask another Admin or Owner.
  • Admins see an Owner's role as a label, without Update or Remove.
  • There's no “leave workspace” button. Ask an Admin or Owner to remove you.

Tips

  • Give people the lowest role that lets them do their job. Most support staff only need Agent.
  • Owners can require two-factor sign-in for everyone in Workspace settings.

Invite a teammate

Sidebar → Team → Invite a teammate

Create an invitation link for a colleague and choose their role. Encyclos doesn't email it: you copy the link and send it yourself.

Who can do what

  • Invite people as Admin, Agent or Viewer OwnerAdminAgentViewer
  • Revoke a pending invitation OwnerAdminAgentViewer
  • Accept an invitation sent to your email address Anyone
  • Invite a new Owner Platform operator

How to

  1. Open Team, enter your teammate's email address and pick a role: “Agent — inbox only”, “Admin — manage bots” or “Viewer — read only”.
  2. Click Create invite. A link appears once, with a Copy button. Copy it now: it can't be shown again.
  3. Send the link to your teammate (email, chat, anything). It works once, only for that email address, for 7 days.
  4. Your teammate opens the link. If they already have an Encyclos account with that email, they log in and click Accept invitation. If not, they click Create an account, choose their name and a password, and join.
  5. Until it's used, the invitation appears under Pending invite with its role and expiry. Click Revoke to cancel it.

Limits and rules

  • Invitations expire after 7 days. Create a new one if it runs out.
  • An invitation only works for the email address it was created for. If your teammate is logged in with a different address, they're asked to log out first.
  • Pending invitations count towards your plan's team member limit until they're used, revoked or expire.
  • If the person is already a member you'll see “that person is already a member”.
  • Owners can't be invited from the Team page. New Owners are invited by the platform operator, and only an Owner can revoke such an invitation.

Tips

  • Invitations work even when public sign-up is turned off.
  • If you made a mistake with the role, revoke the invitation and create a new one, or change the role after they join.

Get WhatsApp alerts when a customer needs a person

Sidebar → Team → Handoff alerts column

Members with a phone number get a WhatsApp message when a conversation is handed over to the team. It contains a link to read the chat and reply from their phone, without logging in.

Who can do what

  • See who receives handoff alerts OwnerAdminAgentViewer
  • Set anyone's alert phone number and turn alerts on or off OwnerAdminAgentViewer
  • Receive alerts and reply from the alert link OwnerAdminAgentViewer

How to

  1. Make sure at least one agent in the workspace has WhatsApp connected: alerts are sent from one of the workspace's connected WhatsApp numbers.
  2. On the Team page, enter the member's mobile number with the country code (for example +1 555 010 2000), tick on, and click Save.
  3. When a conversation is handed over, that person gets a WhatsApp message with a link. Opening it shows the conversation; they can reply to the customer and mark it resolved from there.

Limits and rules

  • Numbers must be the full international number: 8–15 digits including the country code.
  • Alert links stop working after 24 hours.
  • Agents and Viewers can see their own number but can't change it. Ask an Admin or Owner.
  • Only Owners, Admins and Agents receive alerts. A link stops working if that person is removed or loses inbox access.

Tips

  • Anyone who has the link can reply, so don't forward alert messages.

Workspace settings

Sidebar → Settings (outside an agent)

Settings that apply to every agent in the workspace: its name, whether everyone must use two-factor sign-in, and which language-model provider keys it uses.

Who can do what

  • See the workspace settings OwnerAdminAgentViewer
  • Rename the workspace OwnerAdminAgentViewer
  • Require two-factor sign-in for every member OwnerAdminAgentViewer
  • Add or remove the workspace's own provider keys OwnerAdminAgentViewer

Options explained

Workspace name
Shown to your team. 1–80 characters.
Require two-factor authentication
Members without 2FA are sent to set it up before they can open this workspace. You must turn on 2FA for your own account first.
AI provider keys
Only used when the platform operator has switched your workspace to its own keys. Paste a key to store it (it's encrypted and never shown again), leave a field blank to keep the current key, or tick “Remove the stored key”. The page tells you which mode your workspace is in.

Limits and rules

  • Admins, Agents and Viewers see these settings greyed out with “Only owners can change workspace settings.”
  • There's no option to delete the workspace or transfer ownership here. To add another Owner, ask the platform operator for an Owner invitation.

Usage and plans

Sidebar → Usage & plan

See how much of your plan you've used this month and what each plan includes. Usage resets on the first of each month.

Who can do what

  • See usage and plan limits OwnerAdminAgentViewer
  • Change the workspace's plan Platform operator

How to

  1. Open Usage & plan. You'll see your plan and four meters: answers this month, agents, team members, and the size of your largest agent's knowledge.
  2. Meters turn amber at 80% (“Approaching limit”) and red at 100% (“Limit reached”).
  3. To change plan, contact the platform operator. Plans aren't changed from inside the workspace.

Options explained

Answers this month
Replies written by the agent. Exact Q&A matches don't count. Resets on the 1st of each month (UTC).
Agents
How many agents the workspace has.
Team members
Current members. Pending invitations also count when you invite someone new.
Knowledge size
Characters stored for your largest agent.
PlanAnswers / monthAgentsTeam membersSources / agentPages / website
Free $0/mo200122050
Pro $49/mo5,0005105001,000
Business $199/mo40,00025505,0005,000
Enterprise1,000,0001000100050,00020,000

Limits and rules

  • When the monthly answers run out, the agent stops answering. If handoff is on, customers are passed to your team (“A member of our team will reply here as soon as possible”); otherwise they're asked to try again later.
  • At the agent, member or source limit you'll see “Your plan's … limit has been reached. Upgrade your plan to continue.”
  • Website imports stop at your plan's page limit without an error.
  • Moving to a smaller plan doesn't delete anything; it only stops new additions above the new limits.

Audit log

Sidebar → Audit log

A record of security-relevant changes in the workspace: who did what, when, and from which IP address. It shows the latest 300 entries.

Who can do what

  • View the audit log OwnerAdminAgentViewer

Options explained

Recorded
Workspace changes, invitations and role changes, agent creation, behavior and widget saves, publishing, knowledge and live-data changes, domain and identity changes, WhatsApp connections, and replies sent from alert links.
Not recorded
Ordinary inbox replies, assignments, tags, saved replies, sign-ins and 2FA changes.

Limits and rules

  • Only Admins and Owners see Audit log in the sidebar.

Switch between workspaces

Sidebar → your name (bottom)

If you belong to more than one workspace, switch between them from the menu at the bottom of the sidebar. Your role can differ in each.

Who can do what

  • Switch workspace Every user
  • Create an additional workspace Platform operator

How to

  1. Click your name at the bottom of the sidebar. Under Workspaces you'll see each workspace and your role in it.
  2. Click a workspace to open it. Encyclos remembers it as your current workspace.

Limits and rules

  • New workspaces aren't created from inside the app. You join one through an invitation, or the platform operator creates one for you.
  • If you aren't in any workspace yet you'll see “You're not in a workspace yet”. Ask your workspace owner for an invitation link.

Your account

Settings that belong to you, not the workspace. They follow you into every workspace you're in.

Sign up and log in

encyclos.com → Log in / Start free

Create an account with your work email, or log in to an existing one. Signing up creates your own workspace on the Free plan, with you as its Owner.

Who can do what

  • Sign up (when public sign-up is open) Anyone
  • Log in and log out Every user

How to

  1. To sign up, click Start free and enter your name, work email, a password of at least 12 characters, and your workspace name (usually your company). You land on your new workspace.
  2. To log in, enter your email and password. If you've turned on two-factor sign-in, enter the 6-digit code from your authenticator app next.
  3. To log out, click your name at the bottom of the sidebar and choose Log out.

Limits and rules

  • Passwords must be 12–256 characters. A passphrase works well.
  • After 8 wrong passwords the account is locked for 15 minutes (“too many failed attempts; try again later”).
  • Sessions last 7 days from when you log in, then you're asked to log in again.
  • There's no self-service password reset. If you've forgotten your password, contact your platform operator.
  • If public sign-up is turned off, the sign-up page doesn't exist. Join through an invitation instead.

Two-factor sign-in and sessions

Sidebar → Account → Security

Protect your account with an authenticator app, and sign out of every device at once if you think your account was used by someone else.

Who can do what

  • Turn two-factor sign-in on or off for your account Every user
  • Sign out everywhere Every user

How to

  1. Open Security and click Set up 2FA.
  2. In your authenticator app (1Password, Google Authenticator, Authy…), choose “enter a setup key” and type the key shown. Settings: time-based, 6 digits, 30 seconds.
  3. Type the 6-digit code your app shows and click Verify & enable. From now on you'll need a code each time you log in.
  4. To turn it off, enter your password and a current code, then click Disable 2FA.
  5. To sign out on every device, including this one, click Sign out everywhere.

Limits and rules

  • There are no backup codes. If you lose your authenticator, contact your platform operator.
  • If you click Set up 2FA again, a new key is created and the old one stops working.
  • If your workspace requires 2FA you'll be sent here until it's on.

Light and dark mode

Top bar → moon / sun button

Encyclos follows your device's light or dark setting. In the app you can switch with the moon and sun button in the top bar.

Who can do what

  • Switch between light and dark Every user

Limits and rules

  • The choice is saved in this browser only, not on your account.

Platform administration

Only for the operator running this Encyclos installation. Workspace Owners don't see these pages.

Platform admin

Sidebar → Platform (platform operators only)

Create workspaces, invite their Owners, set plans, manage provider keys, watch platform-wide numbers, and configure the live demo on the home page.

Who can do what

  • Create a workspace and invite its Owner Platform operator
  • Change a workspace's plan Platform operator
  • Manage provider keys and assign them to workspaces Platform operator
  • See the platform dashboard Platform operator
  • Configure the live demo on the home page Platform operator

Options explained

Organizations
Create a workspace (name, Owner email, plan); the Owner invitation link is shown once and works for 7 days. Each workspace card lets you set its plan, choose platform or own keys, and issue another Owner invitation.
API keys
Store provider keys (shown only by their last 4 characters), test them, see how many workspaces use each, and delete them. Deleted keys fall back to the environment default.
Dashboard
Totals and charts for workspaces, users, agents, conversations, answers and leads.
Live demo
Turn the home-page demo on or off, choose the demo agent, and set how many messages and website previews visitors get.

Limits and rules

  • Platform operators are made from the command line (encyclos set-superadmin). They aren't automatically members of other workspaces.
  • Plans can also be set from the command line: encyclos set-plan <workspace id> <plan>.

Who can do what

Every workspace member has one role. Roles apply to every agent in the workspace. If you can't do something, the last column says who can.

  • Owner

    Runs the workspace. Can do everything, including workspace-wide settings and the plan.

  • Admin

    Builds and manages agents and the team. Everything except workspace-wide settings.

  • Agent

    Handles customer conversations: replies, takes over, resolves, assigns and tags.

  • Viewer

    Read-only. Can look at agents, conversations, leads and analytics, but change nothing.