DOCS / CODEXTA FOR SHOPIFY

MERCHANT GUIDE

Codexta for Shopify: full reference

New here? Start with the short, illustrated Codexta for Shopify guide. This page has every screen, message and limit in one place.

How to install Codexta, set up the assistant your shoppers talk to, and work with the back-office assistant and reports in your Shopify admin. Each task names the exact place, the buttons to press, who can do it and which plan it needs.

New to Codexta? Watch the video tutorial
The onboarding video, with the same steps written out below it.
Watch and read →

Places are written as Shopify admin › Apps › Codexta › Settings › Team. Things you can type in the chat look like “Set up my assistant”. Unfamiliar words such as guideline, lesson or guest are explained in the glossary.

ON THIS PAGE
01

Getting started

Four steps take you from install to a working assistant: install the app, choose a plan, switch on the app embed, and run the guided setup.

How do I install Codexta?

  • Who: the Shopify account owner
  • Plan: any
  1. Install Codexta from the Shopify App Store (see Codexta for Shopify) and approve the access Shopify asks for.
  2. Shopify opens Codexta in your admin. The Shopify account owner becomes the Owner in Codexta.
  3. Choose a plan (next task). Until you do, the assistant does not answer shoppers.

How do I choose a plan and start the trial?

  • Who: Owner
  • Plan: any

Shopify admin › Apps › Codexta › Settings › Plan

  1. When you first open Codexta without a plan, it sends you to Shopify’s plan page. You can also press Choose a plan in the banner at the top of every page.
  2. Pick a plan and approve it in Shopify. Shopify’s plan page shows what each plan includes and costs. The free trial, if shown there, starts when you approve.
  3. Shopify brings you back to Codexta’s Overview. Open Settings › Plan to see your plan and its status.

Until a plan is approved, every page shows the banner Choose a plan to switch the assistant on. Colleagues who are not the owner see Ask the store owner to choose a plan. Shoppers who open the chat meanwhile read:

SHOPPERS SEEThe assistant is not available right now. Please try again later.

How do I show the assistant on my storefront?

  • Who: Owner, Admin (the setup card is shown to them)
  • Plan: any

Shopify admin › Apps › Codexta › Overview › Set up your assistant

  1. Under Show the assistant on your storefront., press Open the theme editor. The theme editor opens in a new tab.
  2. Check that Codexta assistant is switched on under App embeds.
  3. Press Save.

Without the card: Shopify admin › Online Store › Themes › Customize › App embeds › switch on Codexta assistant › Save. The same link is in Settings › General under Show the assistant on your storefront.

How do I run the guided setup?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Overview › Set up your assistant

  1. Press Set up my assistant. Codexta opens Assistant › Chat and sends “Set up my assistant” for you.
  2. 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.
  3. 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 starts the knowledge base from your Shopify policies and online-store pages.
  4. Before anything is saved, it shows you the exact text. A plain “yes” to a list of drafts approves exactly that list.
  5. 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 admin at a glance

Codexta has no menu of its own inside Shopify. Its pages appear in the Shopify sidebar under the app’s name, and the page name shows in Shopify’s title bar. Clicking Codexta opens the Overview. Each person sees only the pages their role allows.

Sidebar entryWhat it showsTabsWho sees it
OverviewTiles 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
AssistantThe back-office chat; for owners and admins also authoring changes, code and guideline switches.Chat, Changes, Code, GuidelinesOwner, Admin, KB editor (Chat only)
ConversationsShopper conversations, read only, and questions the knowledge base could not answer.All, UnansweredEveryone
ShoppersEveryone who chatted, their conversations and assisted orders.—Everyone
Knowledge baseThe articles the assistant answers from, and the lessons on how it behaves.Articles, Lessons, EditorEveryone (only Owner, Admin and KB editor can change notes)
Support consoleThe helpdesk: handed-over chats and tickets.The console’s own sectionsOwner, Admin, Support manager, Support agent
EventsResults and every tool the assistant used; pin numbers to the Overview.—Everyone
SettingsHow the assistant looks and talks, the team, the plan and other channels.General, Team, Plan, IntegrationsOwner, Admin

If you see Open Codexta from your store admin, open the app from the Shopify admin rather than a saved link. This session is not allowed means the link has expired: open Codexta again from your store admin.

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. A new shop starts with one note, How to use this knowledge base. Everyone with access can read notes; only the Owner, Admins and KB editors can change them.

How do I add a note?

  • Who: Owner, Admin, KB editor
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base

  1. Press Add knowledge and pick Write an article.
  2. 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.
  3. 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?

  • Who: anyone who can open the page
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base › Articles

  1. Pick All, Written, Web page, PDF or Notion. Each shows how many articles it has.
  2. Type in Search articles to narrow the list.
  3. 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?

  • Who: Owner, Admin, KB editor
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base › Editor › (the note)

  1. Open the article from the Articles tab, or pick it in the editor’s side bar.
  2. 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.
  3. Change the text below.
  4. 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?

  • Who: Owner, Admin, KB editor (import); anyone who can open the page (export)
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base

  1. 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.
  2. Optionally enter a Target folder (empty = the root), for example imported/faq.
  3. Press Preview. Files are grouped as Changed, Unchanged, Not imported and Rejected. Tick Overwrite {n} changed files if you want to replace existing notes.
  4. 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?

  • Who: Owner, Admin, KB editor
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base › Add knowledge

  1. Pick Single web page, Whole website, PDF or Notion.
  2. 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).
  3. 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?

  • Who: Owner, Admin, KB editor
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base › Articles

  1. 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.
  2. 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?

  • Who: Owner, Admin, KB editor
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base › Articles

  1. Press the bin on the article’s row. To delete several, tick them and press Delete {n}.
  2. 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?

  • Who: Owner, Admin, KB editor
  • Plan: not on every plan (see Shopify’s plan page)

Shopify admin › Apps › Codexta › Knowledge base › Editor › (the note)

  1. Open the note and press ✦ Enrich.
  2. 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?

  • Who: Owner, Admin, KB editor
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Chat

  1. 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”
  2. When a procedure changes, ask it to update the note; it rewrites the section rather than adding a second version.

Reading your Shopify policies and pages into notes is part of the guided setup, which only the Owner and Admins can run.

What if the knowledge base is full?

  • Who: Owner, Admin, KB editor
  • Plan: limits differ by plan

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.

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?

  • Who: everyone sees the list; Owner, Admin and KB editor write the notes
  • Plan: any

Shopify admin › Apps › Codexta › Conversations › Unanswered

  1. 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.
  2. Press Write KB article.
  3. The knowledge base asks Write a knowledge base article? with the question as the title. Press Create note.
  4. Write the answer and press Save.

When the list is empty it reads Nothing unanswered. Every question found something in the knowledge base.

The list and the Overview numbers are counted every few minutes. A question asked just now can take up to five minutes to appear.

How do I find out why an answer was wrong?

  • Who: Owner, Admin, Support manager, Support agent, Viewer (to read)
  • Plan: any

Shopify admin › Apps › Codexta › Conversations › All › (a conversation)

  1. Find the conversation with Search (words, session or shopper id) or the Outcome, Shopper, Channel, From and To filters, then press Apply.
  2. 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.
  3. 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Chat

  1. 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.”
  2. The assistant asks which of your shoppers’ conversations the lesson is for, offering up to four, for example Shopify shop - Product search and recommendations or Shopify shop assistant. Pick one or more. If you already named one, it skips this question.
  3. 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.
  4. 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Chat

  1. 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/shopify_search/ask-budget-first.
  2. Say which one to drop, for example “Forget the gift budget lesson”. If more than one could match, it asks which.
  3. It asks you to confirm the ids. Press Remove it, or Keep it to cancel.
  4. 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?

  • Who: anyone who can open the page sees the lessons; Owner, Admin and KB editor change them
  • Plan: any

Shopify admin › Apps › Codexta › Knowledge base › Lessons

  1. Lessons are grouped by the kind of chat they apply to.
  2. 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.
  3. Under Applies to, tick the chats it is for. With a long list, type to find one.
  4. Press Save lesson.
  5. To change a lesson, press it or its pencil: it opens in the Editor tab. Press Save.
  6. To remove one, press its bin and confirm. The assistant stops applying it.

How do I set how the assistant works for me?

  • Who: anyone who can open Assistant › Chat
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Chat

  1. 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.”
  2. 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.
  3. 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?

  • Who: any shopper in the storefront chat
  • Plan: any

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 shopper 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Chat

  1. Type “Change the greeting and starter questions”, or run the guided setup.
  2. 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.
  3. 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Settings › General

  1. Store: Store name and What your store sells (one or two sentences the assistant keeps in mind in every chat).
  2. Assistant: Assistant name, Accent colour, Widget position, How the assistant writes, Reply window, Chat language, Knowledge base language and Widget theme.
  3. 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.
  4. Greeting and suggested questions: Greeting and Idea 1 to Idea 4. Leave the ideas empty to use the assistant’s defaults.
  5. Who can chat: Allow guests, Conversations per shopper per day and Guests’ share of monthly conversations (%).
  6. Press Save settings. You see Saved.

What do the other assistant settings do?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Settings › General › Assistant

  • 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Settings › General

  1. In Store or Greeting and suggested questions, choose a language from + Add language.
  2. Fill in its tab. Left empty, the default wording is used.
  3. 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

Turn the storefront assistant on or off

The storefront assistant is the theme app embed Codexta assistant. There is no on/off switch inside Codexta itself, and the embed has no settings of its own.

How do I turn it on or off?

  • Who: anyone who can edit your theme in Shopify
  • Plan: any

Shopify admin › Online Store › Themes › Customize › App embeds

  1. Switch Codexta assistant on or off.
  2. Press Save.
  3. Open your shop and check whether the chat button is shown.

Without an active plan 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?

  • Who: Owner, Admin
  • Plan: any

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.

Shopify admin › Apps › Codexta › Settings › General › Pages with the chat

  1. 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.
  2. The chat is shown on a page when any line matches it. Leave the box empty, or enter *, to show it on every page.
  3. 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. Shopify’s paths look like /cart and /collections/watches, so write them as they appear in the address bar.

How do I choose which discounts the assistant can offer?

  • Who: the Shopify account owner or a staff member who can edit discounts
  • Plan: any

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.

Shopify admin › Discounts

  1. Open the discount and add #aiassistant to its Title. A Shopify discount has no description, so the title carries the mark. Capital letters do not matter.
  2. Save. For example Summer 10% #aiassistant. Codes and automatic discounts both work.
  3. 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.

The assistant shows the title without the mark. Only active discounts are offered, and only the first 25 active ones are read, so keep the number of active discounts below that. To stop offering a discount, remove the mark. A shopper can still type any valid code at checkout; the mark only controls what the assistant offers.

What do shoppers see in the chat window?

  • Who: any shopper
  • Plan: any; read aloud and hiding Codexta’s mark are not on every plan (see Shopify’s plan page)
  • 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?

  • Who: any shopper
  • Plan: any

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. A guest who checks out is still counted for assisted orders when the chat added to that cart.

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 Shopify customer account.

How do I let only signed-in shoppers chat?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Settings › General › Who can chat

  1. Untick Allow guests.
  2. 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Settings › General › Who can chat

  1. Enter a number in Conversations per shopper per day. Empty or 0 means no limit.
  2. 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › 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.

  1. 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)”.
  2. 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.
  3. 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?

  • Who: set by Codexta; ask us to change them
  • Plan: any

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?

  • Who: Owner, Admin (pin); everyone else reads
  • Plan: any

Shopify admin › Apps › Codexta › Events

  1. Choose 7 days, 30 days or 90 days.
  2. In Assistant activity, find a tool with Search tools….
  3. 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?

  • Who: Owner, Admin, Support manager, Support agent, Viewer
  • Plan: any

Shopify admin › Apps › Codexta › Conversations › All

  1. Filter by Outcome (resolved, assisted, handoff, abandoned), Shopper (guest, customer, social) or dates, and press Apply.
  2. 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?

  • Who: everyone listed above (find); Owner, Admin (block, see email)
  • Plan: any

Shopify admin › Apps › Codexta › Shoppers

  1. Use Search shoppers. Press Conversations on a row to see all their chats.
  2. 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?

  • Who: everyone listed above
  • Plan: any

An order counts as assisted when the shopper’s chat added to the cart or sent a checkout link in the 7 days before the order. It counts only once the order is paid. Orders awaiting payment are reported separately; cancelled, refunded or voided orders are not counted, and a partly refunded order counts at what is left.

10

Support console and taking over a chat

The support console is your helpdesk: open it from Support console in the Shopify sidebar. 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Support console › Settings › Backends

  1. Switch Tickets and incident reports, Live chat with a person or Email intake on or off. It takes a few seconds.
  2. 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?

  • Who: Owner, Admin, Support manager, Support agent
  • Plan: any (live chat switched on)

Shopify admin › Apps › Codexta › Support console › Inbox

  1. A shopper asks for a person, for example “I want to talk to a real person”. Their chat shows Looking for an available agent…
  2. Open the chat under Unassigned and press Assign to me.
  3. Write in Reply. The shopper sees Connected to a human agent and keeps typing in the same window.
  4. 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?

  • Who: Owner, Admin, Support manager, Support agent
  • Plan: any

A problem a shopper reports in the chat, a return from a guest or an Instagram message, and email to your support address become tickets in the console. A signed-in customer’s return is different on Shopify: the assistant checks the order and photos and requests the return on the order in Shopify, where you approve or decline it. The customer must be signed in on your shop. The return window is counted from the order’s delivery date; an order with no recorded delivery date still reaches you, marked for review. 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?

  • Who: Owner, Admin
  • Plan: any; Slack, Linear, Stripe, Notion and agent bots are not on every plan (see Shopify’s plan page)

Most shops need only a few settings. The guide covers each one:

11

Back-office assistant

In Assistant › Chat, the Store assistant works with your Shopify 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Chat

  • “List this month’s orders”
  • “Show me order #1004”
  • “Which orders are not fulfilled yet”
  • “Who are my best customers”
  • “Any open return requests”

It reads orders, customers, products including drafts, your shop’s languages, currency, locations and collections, returns and support tickets. Dates are in your shop’s time zone.

How do I make a change?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Chat

  1. Ask for the change, for example “Change the price of the Meridian 38 to 199” or “Add this shirt as a product into the Shirts collection” with a photo attached.
  2. The assistant looks up the current value and asks a yes/no question naming the record, the old value and the new value.
  3. Answer yes to apply it. On no, nothing changes. Each change needs its own yes; one yes covers one whole product creation or edit.

It can:

  • change a customer’s note or tags;
  • change a variant’s price and compare-at price;
  • create a product from a photo (saved as a draft), edit a product or add a colour;
  • put products into a collection;
  • create discount codes.

Photos are used as sent — no editing or generated images. It recommends checking draft products and publishing them in Shopify yourself.

Not available in the chat: refunds, cancelling or editing orders, adding or removing sizes, removing colours, stock of existing products, automatic discounts and staff accounts. Do those in the Shopify admin. If the assistant reports “access denied”, the Owner needs to approve the app’s updated access in Shopify.

How do I contact Codexta from the chat?

  • Who: anyone who can open Assistant › Chat
  • Plan: any

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. Colleagues must be staff in your Shopify admin. The first time they open Codexta from the Shopify admin they appear as Viewer; the Owner then gives them a role.

How do I give a colleague a role?

  • Who: Owner (Admins can view the page)
  • Plan: any

Shopify admin › Apps › Codexta › Settings › Team

  1. Ask your colleague to open Codexta once from the Shopify admin.
  2. Under Members, choose their role in the dropdown. You see Role saved.
  3. To take access away, press Remove. Staff removed in Shopify lose access within about a minute.

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…OwnerAdminKB editorSupport managerSupport agentViewer
Overview, Conversations, Shoppers, EventsYesYesYesYesYesYes
Read the knowledge baseYesYesYesYesYesYes
Change the knowledge baseYesYesYesNoNoNo
Assistant › ChatYesYesYes, no store dataNoNoNo
Teach lessons for shoppersYesYesNoNoNoNo
Changes to products, prices, customers, discountsYesYesNoNoNoNo
Support consoleYes, with SettingsYes, with SettingsNoCases and reportsCasesNo
Settings (General, Integrations), guided setupYesYesNoNoNoNo
Assistant › Changes, Code, GuidelinesYesYesNoNoNoNo
Change rolesYesView onlyNoNoNoNo
Change planYesView onlyNoNoNoNo
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?

  • Who: Owner, Admin
  • Plan: not on every plan (see Shopify’s plan page)

Shopify admin › Apps › Codexta › 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › Assistant › Guidelines

  1. Switch a guideline off for your store, or press Reset to go back to the default. It takes a few seconds.
  2. To switch off only one tool of a guideline, open Tools under it and untick the tool.
  3. 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?

  • Who: Owner (change); Admin (view)
  • Plan: any

Shopify admin › Apps › Codexta › Settings › Plan

  1. See your plan, its status (for example trialing or active) and that it is billed through Shopify.
  2. The Conversations and Knowledge base notes meters show this month’s use against your limit; the bar turns red at 90%.
  3. Under Change plan, press Switch to {plan}. Shopify’s plan page opens; approve the change there.

Prices and the free trial are on Shopify’s plan page and the App Store listing, together with what each plan includes. 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?

  • Who: Owner, Admin
  • Plan: any

Shopify admin › Apps › Codexta › 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?

  • Who: Owner, Admin
  • Plan: not on every plan (see Shopify’s plan page)

Shopify admin › Apps › Codexta › Settings › Integrations (page title “Connect”)

  1. Under Instagram, press Connect Instagram. Instagram opens in a new window.
  2. Sign in with your Instagram professional account, then come back to Codexta.
  3. 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, product carousels and a checkout link. Replies go out within 24 hours of the customer’s message. Instagram customers place orders only after linking their shop account. Allow guests does not apply to Instagram.

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?

  • Who: Owner, Admin
  • Plan: not on every plan (see Shopify’s plan page)

Shopify admin › Apps › Codexta › 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:

  1. Under Telegram, ask @BotFather in Telegram for a new bot (/newbot).
  2. Paste the token it gives you and press Connect Telegram.
  3. 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

Uninstall and your data

  • Uninstalling cancels your Shopify subscription and revokes Codexta’s access to your shop.
  • 48 hours after you uninstall, all of your shop’s data is deleted. If you reinstall before then, your shop’s Codexta setup is reactivated, but you choose a plan again.
  • While installed, conversations older than your plan’s retention are deleted every night; the retention period depends on the plan. Daily statistics keep counts only.
  • Customer deletion requests from Shopify delete that shopper’s conversations, events, tickets and order links automatically.
  • Customer data requests: when a customer asks Shopify for their data, Codexta prepares an export (conversations, tickets, order links) that you can download as a JSON file in the Codexta admin under Settings › Data requests, and mails your admins. The file is kept for 30 days, then deleted.
  • Payments never pass through Codexta: checkout always happens in Shopify.

See the privacy policy for what is held 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 app, ask the Store assistant in Assistant › Chat to contact support.