01
Getting started
Four steps take you from the plugin to a working assistant: install the plugin, connect your shop, get activated by Codexta, and run the guided setup. Do them in this order: until Codexta activates your shop, the assistant does not answer anyone, you included, so the guided setup cannot run yet.
How do I install the plugin?
WordPress admin › Plugins › Add New Plugin › Upload Plugin
- Get the Codexta Assistant plugin from us (see Codexta for WooCommerce).
- Upload the .zip file and press Install Now, then Activate Plugin.
- The plugin needs WordPress 6.4, PHP 7.4 and WooCommerce 8.0 or newer. It works with High-Performance Order Storage and the Cart and Checkout blocks.
The plugin does nothing until you connect it. Nothing is sent to Codexta before that, and the assistant is not shown on your storefront.
How do I connect my shop?
WordPress admin › WooCommerce › Codexta Assistant
- Press Connect to Codexta.
- WooCommerce shows its own screen asking you to approve access for Codexta Assistant. Approve it.
- You come back to the plugin page. It shows Connected to Codexta. and Status: Connected, with the Codexta page below it.
There are no keys or passwords to copy: WooCommerce creates the access key, and the plugin and Codexta set up the rest themselves. If you see The connection attempt expired. Please click Connect again., press Connect to Codexta again. While connecting, Codexta starts your knowledge base from your shop’s name and description, its published pages and its product categories.
The Settings part of the plugin page holds the Codexta URL and an optional Server URL. Leave them as they are unless we ask you to change them.
Why does the assistant not answer yet?
WooCommerce › Codexta Assistant › Settings › Plan
WooCommerce has no app billing, so a newly connected shop waits for Codexta to activate it on the plan you agree with us. Installing and connecting the plugin does not activate it. Until then every Codexta page shows:
YOU SEEWaiting for activation by Codexta. Your assistant will not answer shoppers until Codexta activates it; contact Codexta to agree the plan.
The assistant does not answer in Assistant › Chat either. If you press Set up my assistant or type a message there before activation, you read:
YOU SEEYour Codexta account is waiting for activation. The assistant starts answering, here and on your store, once Codexta activates your plan. If you have not agreed a plan with Codexta yet, contact us.
Shoppers who open the chat meanwhile read:
SHOPPERS SEEThe assistant is not available right now. Please try again later.
Contact us to agree the plan. You can already open the Codexta page and look around, but the assistant does not answer shoppers or you, and changes to the knowledge base, authoring and enrichment wait for activation too.
How do I know my shop is active? Reload the Codexta page. The “Waiting for activation” line is gone, and Settings › Plan shows your plan with the status active. Then run the guided setup.
How do I run the guided setup?
WooCommerce › Codexta Assistant › Overview › Set up your assistant
Your shop must be activated by Codexta first. The card shows from the start, but before activation the assistant answers with “Your Codexta account is waiting for activation” instead of starting the setup.
- Press Set up my assistant. Codexta opens Assistant › Chat and sends “Set up my assistant” for you.
- The assistant lists five areas: Assistant identity, Knowledge base, Voice and handover, On the storefront and Test. Each shows as done, partly done or missing. Then it asks How do you want to go on? Choose Go through what is missing, Review everything, Just one area or Stop here.
- Answer its questions. It asks which languages your shoppers write in and drafts a name, a greeting and up to four starter questions. Then it fills the knowledge base from your shop’s own pages, such as shipping, returns, payments, the FAQ and contact. It may ask for your shop’s web address.
- Before anything is saved, it shows you the exact text. A plain “yes” to a list of drafts approves exactly that list.
- In the Test step it asks a few real questions and shows which note answered each. Questions about orders, stock, prices or the cart cannot be tested from the admin: try those on your storefront.
You can skip any area, stop and come back later. Anything already done is kept. To continue or start again, type in Assistant › Chat:
- “What is left to set up”
- “Run the setup again”
- “Add my shipping and returns pages to the knowledge base”
The card stays on the Overview until you press Dismiss. Dismissing is remembered for this shop in this browser. The assistant never asks for passwords or API keys.
02
The Codexta page at a glance
Codexta lives on one page in the WordPress admin, under WooCommerce › Codexta Assistant. The page has its own menu bar at the top, with your shop’s name on the left and your role on the right. Each person sees only the entries their role allows.
| Menu entry | What it shows | Tabs | Who sees it |
| Overview | Tiles for the last 30 days (UTC) and a Conversations per day chart. Owners and admins also see the Set up your assistant card and a Support card. | — | Everyone |
| Assistant | The back-office chat; for owners and admins also authoring changes, code and guideline switches. | Chat, Changes, Code, Guidelines | Owner, Admin, KB editor (Chat only) |
| Conversations | Shopper conversations, read only, and questions the knowledge base could not answer. | All, Unanswered | Everyone |
| Shoppers | Everyone who chatted, their conversations and assisted orders. | — | Everyone |
| Knowledge base | The articles the assistant answers from, and the lessons on how it behaves. | Articles, Lessons, Editor | Everyone (only Owner, Admin and KB editor can change notes) |
| Events | Results and every tool the assistant used; pin numbers to the Overview. | — | Everyone |
| Settings | How the assistant looks and talks, the team, the plan and other channels. | General, Team, Plan, Integrations | Owner, Admin |
| Support console | The helpdesk: handed-over chats and tickets, opened inside the same page. | The console’s own sections | Owner, Admin, Support manager, Support agent |
The Codexta page grows with its content, so you scroll the WordPress page as usual. If you see Open Codexta from your store admin, open it from WooCommerce › Codexta Assistant rather than a saved link. This session is not allowed means the link has expired: reload the WordPress page.
03
Knowledge base
Two things shape your assistant: what it knows, and how it behaves. Articles are what it knows: notes with facts about your shop, such as delivery, returns, sizes, care and opening hours. When a shopper asks, the assistant looks there and answers from it. What is not written there, it does not know. Lessons are how it behaves: short nudges on how to act with shoppers, followed in every chat of the kind you pick (see Teach the assistant). For bigger changes to how it works, Owners and Admins edit its guidelines under Assistant › Guidelines. The page starts with a card for each, with the Add knowledge and Add lesson buttons, then three tabs: Articles, Lessons and Editor. When you connect, Codexta starts the knowledge base with notes about your shop, one for each published page, and your product categories, under the shop/ folder. Everyone with access can read notes; only the Owner, Admins and KB editors can change them.
How do I add a note?
WooCommerce › Codexta Assistant › Knowledge base
- Press Add knowledge and pick Write an article.
- Enter a Title, for example Returns and refunds, and the Text. Headings such as ## Shipping costs help the assistant find the right part of a long article.
- Press Add. The article shows on the Articles tab.
Add knowledge is also in the side bar of the Editor tab. There it asks for a Title and a Folder, then opens the note so you write its text.
How do I find an article?
WooCommerce › Codexta Assistant › Knowledge base › Articles
- Pick All, Written, Web page, PDF or Notion. Each shows how many articles it has.
- Type in Search articles to narrow the list.
- The table shows each article’s Name, Kind and when it was Updated. Press its name or the pencil to open it in the editor.
How do I change an article?
WooCommerce › Codexta Assistant › Knowledge base › Editor › (the note)
- Open the article from the Articles tab, or pick it in the editor’s side bar.
- Under Details, set the Title, Type, Short description (what this note answers; it helps the assistant find it) and Tags. The ID, when it was created and updated, and where it came from are shown but cannot be changed.
- Change the text below.
- Press Save.
Each folder’s index and change log are kept up to date by themselves when you create, save or delete a note.
How do I import or export notes?
WooCommerce › Codexta Assistant › Knowledge base
- Press Add knowledge and pick Markdown files (or press Import .md in the editor’s side bar). Choose a .zip export or one or more .md files.
- Optionally enter a Target folder (empty = the root), for example imported/faq.
- Press Preview. Files are grouped as Changed, Unchanged, Not imported and Rejected. Tick Overwrite {n} changed files if you want to replace existing notes.
- Press Import {n} notes.
To export, open the Editor tab and press Export…, tick notes and press Export selected, or press Export all.
How do I add a web page or a PDF?
WooCommerce › Codexta Assistant › Knowledge base › Add knowledge
- Pick Single web page, Whole website, PDF or Notion.
- For a web page, enter the Page address, for example https://example.com/shipping. For a whole website, enter the Website address and set how many pages on the same site to read (up to 50). For a PDF, choose the file (up to 20 MB).
- Press Add. For Notion, tick the pages shared with your Notion integration and import them.
The document becomes a note in the sources/ folder that the assistant can answer from. A web page’s text becomes an article; fetch it again after you change the page, or let it refresh daily or weekly (see below).
A PDF’s text becomes an article titled after the PDF, with its chapters as headings, read from the larger type. A PDF whose text is all one size gets one heading per page. A PDF of more than about 30,000 characters is split at its chapters into several articles, in a folder named after the PDF; each part is titled after the chapters it holds, and the first part opens. Each part counts as one document towards your plan’s knowledge base limit. Scanned PDFs (pictures of pages, with no text) cannot be imported.
How do I keep a web page note up to date?
WooCommerce › Codexta Assistant › Knowledge base › Articles
- Press Fetch again from its source on the article’s row. Only web page and Notion articles have it. You see Fetched again: the article was updated. or Fetched again: nothing changed.
- To refresh automatically, open the article in the editor and set Refresh by itself to daily or weekly. Fetch again from the page is there too.
How do I delete a note?
WooCommerce › Codexta Assistant › Knowledge base › Articles
- Press the bin on the article’s row. To delete several, tick them and press Delete {n}.
- Confirm in the page. This cannot be undone.
In the editor, an open note has a Delete button too.
Notes can only be deleted here. The chat does not delete notes; it merges or rewrites them instead.
How do I enrich a note?
WooCommerce › Codexta Assistant › Knowledge base › Editor › (the note)
- Open the note and press ✦ Enrich.
- Codexta extracts the people, places, projects and organisations in the note into its tags.
If your plan does not include enrichment, it is refused.
How do I add to the knowledge base by chatting?
WooCommerce › Codexta Assistant › Assistant › Chat
- Ask with a clear writing word — document, record, add, write up or publish. For example:
- “document how to …”
- “Add my shipping and returns pages to the knowledge base”
- “sync my FAQ”
- When a procedure changes, ask it to update the note; it rewrites the section rather than adding a second version.
Reading your shop’s pages into notes is part of the guided setup, which only the Owner and Admins can run.
What if the knowledge base is full?
Each plan allows a number of notes; your limit and how many you have are in Settings › Plan. When you reach the limit, creating, importing or adding a document stops with:
YOU SEEThe knowledge base holds {n} of the {quota} documents the {plan} plan allows. Delete a document or upgrade the plan.
Your current count is on Settings › Plan under Knowledge base notes. To raise the limit, contact us.
04
Fix a wrong or missing answer
Every time a shopper asks something the knowledge base has nothing for, Codexta records it. The shopper is not told.
How do I answer questions the assistant missed?
WooCommerce › Codexta Assistant › Conversations › Unanswered
- Each row shows a question and how often it was asked, for example “asked 3 times in 2 conversations”. The Overview tile Questions the KB missed opens this list too.
- Press Write KB article.
- The knowledge base asks Write a knowledge base article? with the question as the title. Press Create note.
- Write the answer and press Save.
When the list is empty it reads Nothing unanswered. Every question found something in the knowledge base.
How do I find out why an answer was wrong?
WooCommerce › Codexta Assistant › Conversations › All › (a conversation)
- Find the conversation with Search (words, session or shopper id) or the Outcome, Shopper, Channel, From and To filters, then press Apply.
- Open it. What the assistant did lists events such as Knowledge base had no answer or Handed to a person, and the Transcript shows which tool the assistant used.
- Correct the note in the Knowledge base, or ask the assistant in Assistant › Chat to document the right answer.
In Settings › General, tick Name the knowledge-base article an answer came from so answers name their note.
05
Teach the assistant: lessons and preferences
There are two kinds of “remember this”. A lesson is a rule for how the assistant treats your shoppers. A preference is how the assistant works for the person who asks, whether that is you, a colleague or a shopper. Facts your shop publishes, such as delivery times, returns or opening hours, are neither: put those in the knowledge base. To skip the guessing, type /lessons in the chat box and pick /lessons Teach the assistant when it shows above the message box: the assistant then treats your message as a lesson. Without it, the assistant asks once when it is unclear which you mean. You can also add, change and remove lessons on the Lessons tab of the Knowledge base page.
How do I teach the assistant a rule for my shoppers?
WooCommerce › Codexta Assistant › Assistant › Chat
- Start your message with /lessons (it shows as /lessons Teach the assistant as soon as you type /less), then say what the assistant should do for your shoppers. For example:
- “Remember this for my shoppers: when someone asks for a gift idea, ask for their budget first.”
- “From now on, when a shopper asks about sizes, suggest our size guide before recommending a size.”
- The assistant asks which of your shoppers’ conversations the lesson is for, offering up to four, for example WooCommerce shop - Product search and recommendations or WooCommerce shop assistant. Pick one or more. If you already named one, it skips this question.
- It shows the rule as it will store it, for example:
YOU SEEWhen a shopper asks for a gift idea, ask for their budget before suggesting products.
Press Save it, or Change it and say what to change. Nothing is stored before you approve the text. - It confirms which conversations the lesson was stored for. Shoppers get it from their next conversation.
Lessons are stored in your own knowledge base and reach only your shop’s shoppers. The assistant refuses a lesson that contains a person’s name, email or order, or that promises a discount, refund or delivery date your policies do not state, and says why. If a lesson on the same topic already exists, it tells you and shows its id instead of adding a second one.
How do I see or remove lessons?
WooCommerce › Codexta Assistant › Assistant › Chat
- Ask “What lessons do I have?” or “Show what you were taught for product search”. You get a table of each lesson’s id, title and rule, for example lessons/woocommerce_search/ask-budget-first.
- Say which one to drop, for example “Forget the gift budget lesson”. If more than one could match, it asks which.
- It asks you to confirm the ids. Press Remove it, or Keep it to cancel.
- It says what was removed. Shoppers stop getting it from their next conversation.
You can also remove a lesson on the Lessons tab of the Knowledge base page (see below).
How do I add, change or remove lessons on the Knowledge base page?
WooCommerce › Codexta Assistant › Knowledge base › Lessons
- Lessons are grouped by the kind of chat they apply to.
- To add one, press Add lesson. Enter a Short name, for example Ask who a gift is for, and The rule: one to three sentences, as an instruction, in the language your shoppers use, with no personal data.
- Under Applies to, tick the chats it is for. With a long list, type to find one.
- Press Save lesson.
- To change a lesson, press it or its pencil: it opens in the Editor tab. Press Save.
- To remove one, press its bin and confirm. The assistant stops applying it.
How do I set how the assistant works for me?
WooCommerce › Codexta Assistant › Assistant › Chat
- Say how you want it to work for you. For example:
- “Always answer me in short bullet points.”
- “When I ask for orders, show date, customer and total as a table.”
- It may ask whether this applies everywhere or only in one area, such as the back-office assistant. It then confirms what it saved and where.
- To check or undo: “What are my preferences?” shows them, and “Forget my table preference” removes one.
Your preferences are yours: colleagues and shoppers do not get them. A preference cannot switch off a confirmation or a safety step, for example “never ask me before changing a product”. The assistant says it cannot save that.
Can shoppers set their own preferences?
Yes, there is nothing for you to switch on. A shopper can tell the storefront assistant how they like to be helped, for example:
- “Keep your answers short, please.”
- “I wear EU size 39, remember that.”
- “Always show me the cheapest option first.”
The assistant keeps it for that shopper only and applies it to their later chats too: for a signed-in customer on their account, for a guest in the same browser. Asking “What do you remember about me?” shows it, and “Forget my size” removes it. A shopper’s preference never changes what the assistant tells other shoppers and never overrides your lessons or policies.
06
Name, greeting, starter questions and languages
How do I change them by chatting?
WooCommerce › Codexta Assistant › Assistant › Chat
- Type “Change the greeting and starter questions”, or run the guided setup.
- The assistant drafts the shop’s display name, its own name, a short greeting and up to four starter questions. It offers a translation for each language your shoppers use.
- It shows the exact text and saves only after you approve.
The chat cannot change the accent colour, widget position, widget theme, What your store sells, Allow guests or chat limits. Change those in Settings › General.
How do I change them in Settings?
WooCommerce › Codexta Assistant › Settings › General
- Store: Store name and What your store sells (one or two sentences the assistant keeps in mind in every chat).
- Assistant: Assistant name, Accent colour, Widget position, How the assistant writes, Reply window, Chat language, Knowledge base language and Widget theme.
- Contact options: WhatsApp number, Viber number and Phone number (calls), in international format such as +387 61 123 456. They become Chat on WhatsApp, Chat on Viber and Call us buttons when the assistant cannot answer. Where they show and their limits: contact options.
- Greeting and suggested questions: Greeting and Idea 1 to Idea 4. Leave the ideas empty to use the assistant’s defaults.
- Who can chat: Allow guests, Conversations per shopper per day and Guests’ share of monthly conversations (%).
- Press Save settings. You see Saved.
What do the other assistant settings do?
WooCommerce › Codexta Assistant › Settings › General › Assistant
- Your website and Draft from my website (under Store): Codexta reads your site and fills the store name, description, greeting and ideas. You see Drafted from your website: review it below, then save. Nothing is saved until you press Save settings.
- How the assistant writes: Precise (0.2), Balanced (0.5) or Creative (0.9). Default keeps Codexta’s own setting. Precise sticks closest to your notes; Creative words answers more freely.
- Reply window: Answer each message at once, or Wait {n} seconds for more lines (3, 5, 10 or 15). This is useful when shoppers type a question in several short lines: they get one answer to all of them. While it waits, the chat shows Sending in a moment; add more if you like.
- Chat language: the language of the chat window’s own buttons and labels, and the language the assistant starts in. Automatic (the page’s language), the default, follows the language your store is shown in; or pick English, Croatian, Bosnian, German, French or Spanish. A shopper who writes in another language is answered in theirs.
- Knowledge base language: the language your notes are written in. A question in another language is also searched in this one, so a shopper writing in German still finds an English note.
- Name the knowledge-base article an answer came from: when ticked, answers from your notes name the note they came from.
- Widget theme: System (follows the shopper’s device), Light or Dark. Accent colour is the main colour of the chat button and window; Widget position puts the button Bottom right or Bottom left.
Press Save settings. The chat window picks up the change the next time a shopper opens it.
How do I add a language?
WooCommerce › Codexta Assistant › Settings › General
- In Store or Greeting and suggested questions, choose a language from + Add language.
- Fill in its tab. Left empty, the default wording is used.
- Press Save settings.
The chat window shows the wording for the language your store is shown in, and the default in every other language. The assistant replies in the language the shopper writes in. The chat window’s own buttons and labels come in English, Croatian, Bosnian, German, French and Spanish. They follow the language your store is shown in; to fix one, set Chat language under Assistant.
07
The storefront assistant
Once your shop is connected, the plugin adds the chat button to your storefront by itself. There is nothing to place in your theme, and no on/off switch inside Codexta.
How do I turn it on or off?
WordPress admin › Plugins
- To take the assistant off for a while, Deactivate the Codexta Assistant plugin. The chat button disappears and Codexta starts no new conversations for your shop.
- To bring it back, Activate the plugin again. Your setup, notes and conversations are kept.
- Open your shop and check whether the chat button is shown.
A developer can keep the chat button off on some pages or until a visitor accepts your cookie banner, with the plugin’s codexta_widget_enabled filter. Until Codexta activates your shop the assistant does not answer: shoppers read The assistant is not available right now. Please try again later. Who may chat and how much is in Guest shoppers and chat limits.
How do I choose the pages that show the chat?
By default the chat button is on every page of your shop. To keep it off some pages, such as the cart and checkout, or to show it only on a few, list the pages in Codexta.
WooCommerce › Codexta Assistant › Settings › General › Pages with the chat
- Type one regular expression per line. Each one is tested against the page’s address without the domain: the path plus any query, for example /shop/?page=2. Capital letters do not matter.
- The chat is shown on a page when any line matches it. Leave the box empty, or enter *, to show it on every page.
- Press Save settings. Shoppers who browse without reloading see the change as they move between pages.
Examples:
- ^/$: the home page only.
- ^/products/: every product page.
- ^/(?!cart|checkout): every page except the cart and the checkout, and anything below them such as /cart/shipping.
- ^/(?!(cart|checkout)/?$): hide only those two pages exactly; their subpages keep the chat.
The lines work as “or”, so put every exclusion in one line. The two lines ^/(?!cart) and ^/(?!checkout) do not hide either page: the cart matches the second line and the checkout matches the first, so the chat shows on both. Write ^/(?!cart|checkout) instead. A line that is not a valid expression is skipped, so a typo never takes the chat off your whole shop. If your shop’s address paths are in another language, write them as they appear in the address bar, for example /korpa/ and /naplata/ for a shop in Bosnian.
How does the assistant use the cart?
The assistant uses the shopper’s own WooCommerce cart, for guests too. What it adds appears in the cart on your pages, which refreshes when it does. It can add, change and remove items, apply a coupon and send the shopper to your checkout. Shipping is settled at checkout, so the assistant quotes the goods without shipping.
How do I choose which discounts the assistant can offer?
The assistant only offers a discount you have marked for it. A discount without the mark stays yours: shoppers never see it from the assistant, so internal codes are safe.
WooCommerce › Marketing › Coupons
- Open the coupon and add #aiassistant to its Description (the text box above the coupon data). Capital letters do not matter.
- Press Update. For example Spring sale, 10% off #aiassistant.
- Ask the assistant “Is there a discount?”. It lists the marked discounts that are active now, with the code, the value, what it applies to and the end date. The mark itself is not shown to shoppers.
Even a marked coupon is not offered when it is a draft, restricted to certain emails, expired or used up. To stop offering a coupon, remove the mark. A shopper can still type any valid code at the cart; the mark only controls what the assistant offers.
Which orders does Codexta receive, and can I limit it?
Codexta learns about new orders from a WooCommerce webhook, to credit the orders that came from a chat. By default it only hears about an order that contains a product the assistant added to the shopper’s cart, and it receives only the order number, total, currency, date, customer number and the amount of each line. It never receives a name, address, phone number or email in that message.
WordPress admin › WooCommerce › Codexta Assistant › Settings › Orders sent to Codexta
- To send nothing about orders, untick Send orders to Codexta. No order leaves your shop and Codexta shows no assisted orders; the other two options are greyed out. Deleting a customer in WordPress still tells Codexta that customer’s number, so their chats can be erased.
- Untick Only orders the assistant helped with to send every new order, so Codexta can also credit the orders of signed-in customers who chatted without adding a product through the assistant.
- Untick Only the details needed to credit the order to send WooCommerce’s full order record.
- Press Save settings. It applies to the next order.
The assistant marks every line it adds with a hidden line-item note, _codexta, which is how an assisted order is told apart. The setting only changes Codexta’s own webhook; other webhooks of your shop are left alone. All three options are on after an update.
What do shoppers see in the chat window?
- Under the message box, every chat shows AI assistant. It can make mistakes, so check important information. with a Privacy link to Codexta’s privacy policy. It is shown in the shopper’s language and cannot be switched off.
- The greeting, the ideas to tap and the assistant’s name come from Settings › General (see above).
- Read aloud under an answer reads it out (Stop reading stops it). It appears only when your plan includes read aloud.
- The chat window shows Codexta’s mark. When your plan includes white label, the mark is left out, and if you set no assistant name the window is titled with your store’s name.
Settings › Plan lists read_aloud and white_label among your plan’s features, marked (not included) when they are not part of it.
08
Guest shoppers and chat limits
A guest is a shopper who chats without being signed in to your shop. Anyone can start a guest chat, so you decide whether guests may chat and how much of your monthly conversations they may use. Codexta adds a few limits of its own against abuse. Signed-in shoppers are never held back by the guest limits.
What can a guest do, and what needs signing in?
A guest can ask anything your knowledge base answers, search and compare products, fill the cart and go to checkout, and tell the assistant how they like to be helped. Signed-in customers can also ask about their own orders and request a return. Orders placed as a guest are not linked to a chat, so only signed-in customers’ orders count as assisted orders.
A guest is remembered in the same browser: an open chat is picked up again for 30 minutes after the last message, and their preferences stay with that browser. A new browser, a private window or cleared site data is a new guest. When a guest signs in, the shopper is then recognised by their account on your shop (My account).
How do I let only signed-in shoppers chat?
WooCommerce › Codexta Assistant › Settings › General › Who can chat
- Untick Allow guests.
- Press Save settings.
Guests still see the chat button, but the chat asks them to sign in first:
SHOPPERS SEEPlease sign in to the shop to chat with the assistant.
Allow guests does not apply to Instagram and the other messaging channels: they answer once you connect an account under Settings › Integrations.
How do I limit how many chats one shopper starts?
WooCommerce › Codexta Assistant › Settings › General › Who can chat
- Enter a number in Conversations per shopper per day. Empty or 0 means no limit.
- Press Save settings.
The limit counts new chats per shopper, signed in or guest, per day; the day starts at midnight UTC (London winter time). A shopper who reaches it reads:
SHOPPERS SEEYou’ve reached today’s limit of conversations. Please come back tomorrow.
A shopper you block gets the same message, so they are never told they are blocked.
How much of my monthly conversations can guests use?
WooCommerce › Codexta Assistant › Settings › General › Who can chat
Your plan has a number of conversations per month (Settings › Plan, the Conversations meter). Guests may use only a share of them, so a burst of anonymous visitors cannot use up the month and leave nothing for your signed-in customers.
- Leave Guests’ share of monthly conversations (%) empty to use your plan’s own share; the field shows it as its placeholder, for example “(plan default)”.
- Or enter your own percentage, from 1 to 100. Under the field you see what that means for your plan: Now {share}%: up to {n} of {monthly} conversations.
- Press Save settings.
The field is greyed out while Allow guests is off. Signed-in shoppers can always use the rest of the month. When guests have used their share, new guest chats are refused until the next month; guests who are already chatting can finish.
What other limits apply, and who sets them?
On top of your own settings, Codexta applies brakes you cannot change in the app. They protect your monthly conversations from scripts and floods:
- New guest chats from one internet connection (IP address) are limited per hour.
- New guest chats for your whole shop are limited per day. The daily number is never more than a thirtieth of your plan’s monthly conversations, so guests cannot spend the month in a few days.
- Messages from one shopper or one address are limited per minute, for guests and signed-in shoppers alike.
When a guest limit is reached, a new guest chat reads:
SHOPPERS SEEThe assistant is not available right now. Please try again later.
When someone sends too many messages at once:
SHOPPERS SEEToo many messages at once. Please wait a moment and try again.
If real shoppers meet these limits — for example during a sale or a campaign — contact us and we raise them for your shop. The same message is shown when your monthly conversations are used up: the Conversations meter on Settings › Plan tells you whether that is the reason.
09
Conversations, shoppers, events and assisted orders
These pages are open to the Owner, Admins, Support managers, Support agents and Viewers on every plan.
How do I choose what the Overview shows?
WooCommerce › Codexta Assistant › Events
- Choose 7 days, 30 days or 90 days.
- In Assistant activity, find a tool with Search tools….
- Press the pin to Show on the Overview, or again to Remove from the Overview. Pins are shared with the whole team.
A new shop’s Overview shows Conversations, Resolved or assisted, Assisted revenue, Assisted orders, Handoffs to a person and Questions the KB missed.
How do I read conversations?
WooCommerce › Codexta Assistant › Conversations › All
- Filter by Outcome (resolved, assisted, handoff, abandoned), Shopper (guest, customer, social) or dates, and press Apply.
- Open a conversation to see its Summary, Shopper, Order from this conversation, What the assistant did and Transcript.
Conversations are read only. Replies from your team show as Shop staff. Conversations are kept for your plan’s retention period.
How do I find or block a shopper?
WooCommerce › Codexta Assistant › Shoppers
- Use Search shoppers. Press Conversations on a row to see all their chats.
- Press Block or Unblock. Tick Blocked only to list blocked shoppers.
A blocked shopper is told they have reached today’s limit, never that they are blocked. Blocking a guest blocks that browser; a new browser or cleared cookies is a new guest.
What counts as an assisted order?
An order counts as assisted when a signed-in customer places it within 7 days after their chat added to the cart or sent a checkout link. It is counted at its total when it is placed. A guest checkout is not linked to a chat, so guest orders are not counted, even when the assistant helped.
10
Support console and taking over a chat
The support console is your helpdesk: press Support console in the Codexta page’s menu bar. Live chats the assistant hands over, tickets, return requests and emails arrive there as cases. The Support console guide explains every part of it, with examples.
How do I switch live chat, tickets or email intake on?
WooCommerce › Codexta Assistant › Support console › Settings › Backends
- Switch Tickets and incident reports, Live chat with a person or Email intake on or off. It takes a few seconds.
- Set live chat hours under Settings › Live chat.
The Overview’s Support card shows what is on and how many cases are open, with Pause for 1 hour, Pause until tomorrow and Resume now. More: switch the helpdesk on.
How do I take over a chat from the assistant?
WooCommerce › Codexta Assistant › Support console › Inbox
- A shopper asks for a person, for example “I want to talk to a real person”. Their chat shows Looking for an available agent…
- Open the chat under Unassigned and press Assign to me.
- Write in Reply. The shopper sees Connected to a human agent and keeps typing in the same window.
- When done, press Resolve.
A colleague with the Support agent or Support manager role can take cases after opening the console once; to change their queue or tier, see add a colleague. The full example, and what happens outside live chat hours: live chat.
How do returns and tickets reach me?
A signed-in customer can request a return of an item from one of their own orders in the storefront chat, with photos of the item and receipt. The return window counts from the date you marked the order completed. Submitting a request does not approve it: it becomes a ticket, and you decide on the order in WooCommerce › Orders. Problems reported in the chat, returns from guests or Instagram messages, and email to your support address become tickets too. In Assistant › Chat you can ask “Any open return requests” or “Any open tickets?”; to answer, assign or close a ticket, use the Support console.
See tickets and return requests and working on a case.
What else can I set up in the support console?
Most shops need only a few settings. The guide covers each one:
- Members, queues, tiers and custom roles
- Priorities, response targets and business hours
- Saved replies, labels and your own fields
- Macros and automation rules
- Your own email address and email intake
- Slack, Linear, Stripe and Notion
- Dashboards, reports and satisfaction ratings
- Help center, campaigns, monitors and calls
- Erasing a customer’s data and the audit log
- The setup guide: every Settings tab step by step, including forms for your store and WhatsApp, Viber and phone buttons
11
Back-office assistant
In Assistant › Chat, the Store assistant works with your WooCommerce data. KB editors can open the chat but cannot reach store data. Support managers, Support agents and Viewers do not see the Assistant page.
What can I ask?
WooCommerce › Codexta Assistant › Assistant › Chat
- “List this month’s orders”
- “Show me order #1004”
- “Which orders are still processing”
- “Which coupons have expired”
- “Any open return requests”
It reads orders, registered customers, products including drafts and private ones (a product with sizes or colours as one row per variation), coupons including expired ones, and support tickets. For anything else it can read from WooCommerce — product categories, order notes, refunds, reviews, reports — just ask. A guest checkout has no customer account, and the assistant says so.
How do I make a change?
WooCommerce › Codexta Assistant › Assistant › Chat
- Ask for the change, for example “Change the price of the Logo Hoodie to 49” or “Create a discount code SPRING10 for 10% off, valid until the end of May”.
- The assistant looks up the current value and asks a yes/no question naming the record, the old value and the new value.
- Answer yes to apply it. On no, nothing changes. Each change needs its own yes.
It can:
- change a product’s or variation’s regular and sale price, or end a sale;
- create a simple product (saved as a draft unless you ask to publish it);
- change a simple product’s name, description, stock or visibility;
- create a discount code with the terms you give;
- keep a note on a customer.
The customer note is kept by Codexta and is not shown in the WordPress admin, because WooCommerce has no customer tags.
Not available in the chat: refunds, cancelling or editing orders, deleting anything, products with sizes or colours (variations), photos and attributes, and staff accounts. Do those in WooCommerce › Orders, Products or Marketing › Coupons.
How do I contact Codexta from the chat?
Ask the Store assistant to contact support. It asks for an email address for the reply and sends your message. Stop ends a reply in progress and New chat starts over.
12
Team and roles
There is no invite button. Only WordPress users who can manage WooCommerce can open the Codexta page: administrators and shop managers. A WordPress administrator is always an Owner in Codexta. A shop manager becomes an Admin the first time they open the page; after that the Owner decides their role.
Who can change the Codexta address in WordPress?
WooCommerce › Codexta Assistant › Settings
Codexta URL and Server URL decide where the chat script on every page of your shop, the checkout included, is loaded from. Only a WordPress administrator can change them. A shop manager sees both fields read-only with Only an administrator can change this.; everything else on the page stays available to them.
This needs Codexta Assistant 0.1.3 or later. If you host Codexta yourself, an administrator enters your own address here: any http(s) address is accepted.
How do I give a colleague a role?
WooCommerce › Codexta Assistant › Settings › Team
- Give your colleague the Shop manager role in WordPress, and ask them to open WooCommerce › Codexta Assistant once.
- Under Members, choose their role in the dropdown. You see Role saved.
- To take access away, press Remove. A WordPress user who no longer has the Shop manager or Administrator role cannot open the page.
Only the Owner changes roles. Nobody can change their own role, and the last Owner cannot be removed or demoted. The Codexta staff access panel lists every time someone from Codexta worked in your shop’s data, with the reason they gave.
| Can… | Owner | Admin | KB editor | Support manager | Support agent | Viewer |
| Overview, Conversations, Shoppers, Events | Yes | Yes | Yes | Yes | Yes | Yes |
| Read the knowledge base | Yes | Yes | Yes | Yes | Yes | Yes |
| Change the knowledge base | Yes | Yes | Yes | No | No | No |
| Assistant › Chat | Yes | Yes | Yes, no store data | No | No | No |
| Teach lessons for shoppers | Yes | Yes | No | No | No | No |
| Changes to products, prices, customer notes, discount codes | Yes | Yes | No | No | No | No |
| Support console | Yes, with Settings | Yes, with Settings | No | Cases and reports | Cases | No |
| Settings (General, Integrations), guided setup | Yes | Yes | No | No | No | No |
| Assistant › Changes, Code, Guidelines | Yes | Yes | No | No | No | No |
| Change roles | Yes | View only | No | No | No | No |
| See the plan | Yes | Yes | No | No | No | No |
13
Authoring
Authoring changes how your store’s assistant behaves — rules, wording and policies such as “never promise delivery dates” — by describing it in a chat. Changes apply to your store only.
How do I change how the assistant behaves?
WooCommerce › Codexta Assistant › Assistant › Chat › Authoring
Start a new chat and choose Authoring at the top. (The other choices are Store assistant, your back-office helper, and Shopping assistant, a preview of what shoppers get.) Then describe the change, for example “When a shopper asks about delivery, never promise a date”. The assistant prepares the change as a draft that you can try first. Shoppers get it only when you say “Publish it”, and only in your store. Authoring changes the assistant’s rules only: not permissions, plans, sign-in, channels or other stores.
See the Authoring guide for worked examples: changing a rule, adding a guideline of your own, trying a change, publishing it and undoing it.
How do I switch an assistant skill off, or take Codexta’s updates?
WooCommerce › Codexta Assistant › Assistant › Guidelines
- Switch a guideline off for your store, or press Reset to go back to the default. It takes a few seconds.
- To switch off only one tool of a guideline, open Tools under it and untick the tool.
- Under Assistant › Changes › Updates from Codexta, choose View changes, Take the update, Use Codexta’s version (remove my copy) or Keep mine.
More in the Authoring guide: switching guidelines, switching a tool and Codexta’s updates.
14
Plan and usage
How do I check usage or change plan?
WooCommerce › Codexta Assistant › Settings › Plan
- See your plan and its status, for example pending or active.
- The Conversations and Knowledge base notes meters show this month’s use against your limit; the bar turns red at 90%. Below them, each feature is marked as included or not.
- To change plan, contact us. Pressing a plan button on this page tells you the same: The plan of a WooCommerce shop is set by Codexta; contact us to change it.
Plans and prices are agreed with Codexta directly; there is no checkout in WordPress. When the monthly conversation limit is reached, shoppers read:
SHOPPERS SEEThe assistant is not available right now. Please try again later.
Your team, in the Codexta pages, is told the reason instead: This assistant has reached its conversation limit for this month. Please try again next month, or use another way to get in touch.
How much of the month guests may use is set under Settings › General › Who can chat; see Guest shoppers and chat limits.
What do the features on Settings › Plan mean?
WooCommerce › Codexta Assistant › Settings › Plan
Below the meters, each feature your plan can switch on is listed, marked (not included) when it is not part of your plan:
- authoring: changing how the assistant behaves by chatting (see the Authoring guide).
- enrichment: ✦ Enrich on a knowledge-base note.
- instagram: Instagram and the other messaging channels.
- white_label and read_aloud: the chat window without Codexta’s mark, and reading answers aloud (see the chat window).
- linear, stripe, slack, notion and agent_bots: the apps and outside bots of the support console.
A feature that is not included is refused where you would use it, for example Your plan does not include this app. Upgrade the plan to use it. The number of conversations, knowledge-base notes and how long conversations are kept also depend on the plan; your own numbers are on this page.
15
Instagram and other channels
How do I connect Instagram?
WooCommerce › Codexta Assistant › Settings › Integrations (page title “Connect”)
- Under Instagram, press Connect Instagram. Instagram opens in a new window.
- Sign in with your Instagram professional account, then come back to Codexta.
- The panel shows the account as connected and when access is valid until. Use Reconnect when it expires, or Disconnect to stop answering.
The assistant answers direct messages with the same knowledge base and your products. Replies go out within 24 hours of the customer’s message. Allow guests does not apply to Instagram, and returns are requested in the storefront chat only.
If your plan does not include Instagram, the page says Instagram is not part of your current plan. The same page lists the other messaging channels.
Which other channels can I connect?
WooCommerce › Codexta Assistant › Settings › Integrations (page title “Connect”)
The page lists Instagram, Messenger, WhatsApp, Telegram, SMS (Twilio), SMS (Bandwidth) and LINE. Each panel says what to copy from that service and has its own Connect button, for example:
- Under Telegram, ask @BotFather in Telegram for a new bot (/newbot).
- Paste the token it gives you and press Connect Telegram.
- The panel shows Connected. To stop answering, press Disconnect and confirm.
A channel your plan does not include says Social messaging is not part of your current plan. One that says … is not set up on this Codexta installation. Ask your Codexta contact to enable it. needs us first: contact us. Every channel answers from the same knowledge base, and its chats appear under Conversations with the shopper shown as social.
16
Deactivate, disconnect and your data
- Deactivating the plugin pauses your shop in Codexta: the chat button disappears and no new conversations start. Activating it again resumes. Nothing is deleted.
- Disconnecting (the Disconnect button on WooCommerce › Codexta Assistant) or deleting the plugin removes everything the plugin set up in your shop: the WooCommerce access key and the webhooks Codexta used. Codexta stops working for your shop. Check WooCommerce › Settings › Advanced › REST API and Webhooks: no Codexta key or webhook should be left. A key you made yourself under another name is not touched; delete it there.
- 48 hours after you disconnect or delete the plugin, all of your shop’s data in Codexta is deleted. Nothing is deleted at the moment you disconnect: your knowledge base, lessons, settings and conversations are kept for those 48 hours. Press Disconnect and then Connect to Codexta again before then and they are all there, as they are after updating the plugin (an update never removes anything). Deleting the plugin removes everything it stored, including the random site id that links your shop to its Codexta setup, so a plugin installed again afterwards starts as a new connection and the old data is deleted after the 48 hours. Your webhooks and key are set up again when you connect, and the old ones are removed.
- While connected, conversations older than your plan’s retention are deleted every night; the retention period depends on the plan. Daily statistics keep counts only.
- Deleting a customer in WordPress deletes that customer’s conversations in Codexta automatically.
- Payments never pass through Codexta: checkout always happens in WooCommerce.
My shop is behind a password (a staging site). How does Codexta reach it?
A shop that asks for a username and password before any page (common on a staging site) uses the same request header as WooCommerce’s keys. Codexta sends your shop login in that header and its WooCommerce keys in two separate headers, X-Codexta-Key and X-Codexta-Secret, which the plugin hands to WooCommerce. The keys never appear in a web address, so they do not end up in your server’s access log.
Codexta admin › Settings › Config and Settings › Secrets
- Under Config, add woocommerce_http_auth_user with your shop login’s username.
- Under Secrets, add woocommerce_http_auth_pass with its password.
- Codexta then reaches your shop. The assistant’s calls work at once; the order webhooks are set up by the hourly check, or press Disconnect and connect again to do it immediately. Until you set the two values Codexta cannot reach a shop that is behind a login.
This needs Codexta Assistant 0.1.2 or later on that shop to keep the keys out of the address; an older plugin still works, but Codexta then falls back to sending the keys in the address. If your staging shop connected with an older plugin, its keys were sent in the web address and may be in the access log: update the plugin, press Disconnect and connect again to get a new key, and remove the old key under WooCommerce › Settings › Advanced › REST API.
Mention the chat assistant and Codexta in your shop’s privacy policy. See the privacy policy for what Codexta holds and who processes it.
17
Getting help
- The support page explains how to reach us.
- Email codexta@codecta.com. We reply within two business days.
- From inside the plugin, ask the Store assistant in Assistant › Chat to contact support.