Tutorials
We install and configure it for you, but the assistant is yours. Here's how to review what it knows, adjust how it behaves and read its statistics, step by step.
The plugin's dashboard is currently in Spanish. In this guide, menu paths are shown as they appear on screen, followed by their meaning in English.
1. How the assistant answers
It's a floating button that appears on your website. When someone writes to it, the assistant prepares its answer using, in this order:
- Your knowledge base: the questions and answers we prepare with you (delivery, opening hours, terms, services…).
- The page the visitor is on, including the product page if they're viewing one.
- Your WooCommerce catalogue, if you have a shop: name, price, offers, stock and image.
With all of that, the AI writes a natural answer in the customer's language. It's instructed never to invent prices, lead times or stock: if a detail isn't available, it says so and offers contact with your team.
Every conversation is stored in your WordPress and you can read it in full under Estadísticas › Conversaciones (Statistics › Conversations). The chat always shows the notice “Answers generated by AI”, as required by the EU AI Act.
2. Where everything is
In the WordPress menu you'll see Asistente IA (AI Assistant) with four sections:
- Estadísticas (Statistics): the month's overview, topics, conversations and reports.
- Conocimiento (Knowledge): what the assistant knows about your business.
- Ajustes (Settings): appearance, AI and licence, WooCommerce and conversion.
- Tutorial: a quick guide inside the dashboard itself.
The licence and AI come already configured under Ajustes › IA y licencia (Settings › AI and licence); you don't need an account or key with any provider. Plugin updates arrive automatically in your WordPress dashboard.
3. Appearance and which pages it appears on
Under Ajustes › General (Settings › General) you can change:
- The assistant's colour, name and image, and the button text.
- The text colour on your main colour (button, header and your messages). On “Automatic” it's white, unless your colour is so light that white can't be read.
- The position (right or left), margins and window size. On mobile it opens full screen.
- The welcome message.
- Where it appears: across the whole website, only on the home page or only in the shop, and the URLs where you don't want it to appear.
4. Knowledge base
This is the most important part: the better it is, the better the answers. It's made up of question-and-answer pairs that the assistant checks before replying.
Review and extend it
Under Conocimiento (Knowledge) you'll see all the entries. You can correct any answer, add new entries and save. Write the answers as you would to a customer: clear, complete and with exact details.
Import and export as CSV
With Exportar CSV (Export CSV) you download all the knowledge to edit in a spreadsheet, and with Importar CSV (Import CSV) you upload it again. It's the easiest way to make lots of changes at once. It's also how we prepare your initial knowledge base.
Generate it from your pages
Generar centro de conocimiento (Generate knowledge centre) reads the pages and posts published on your WordPress (contact, delivery, opening hours, policies…) and proposes a draft. Always review it before saving.
It learns from what it doesn't know
Under Estadísticas › Resumen (Statistics › Overview), the Enséñale a tu asistente (Teach your assistant) block collects the questions it had to pass on to your team. Click Añadir a Conocimiento (Add to Knowledge) to answer it once so it can answer it itself next time, or Descartar (Dismiss) if it isn't worth it.
5. WooCommerce
If you sell online, under Ajustes › WooCommerce (Settings › WooCommerce) the assistant connects to your catalogue.
- API keys: created under WooCommerce › Settings › Advanced › REST API, with read-only permission.
- Index or reindex the catalogue: builds the index the assistant uses to search. Individual price or stock changes are picked up automatically; reindex if you change lots of products at once. On large catalogues it runs in batches, without blocking your website.
- Additional product nouns: words specific to your catalogue (for example “stool” or “sideboard”) that should trigger a product search.
- Category synonyms: for when a customer uses a word that isn't in your categories (they ask for “café tables” and your category is called “bar”).
- Campaign discounts: a store-wide or per-category discount the assistant applies when showing prices.
The product cards in the chat include photo, price, offer and availability, and link to the product page. Customers also get a History tab with what they've viewed and can download a quote.
6. Contact and conversion
Under Ajustes › Conversión (Settings › Conversion) you decide how customers reach you:
- Te llamamos (Call me back): a tab in the chat where visitors leave their phone number. The notification reaches you by email at the address you choose.
- Quick-action buttons: call, open WhatsApp or go to any page. You can translate them if your website has several languages.
- Proactive message: opens the chat with a message after a few seconds on the page, including in the cart.
- Appointment booking: links to your booking page. Only enable it if that page exists.
- Sales model: if you don't sell online, tick it so the assistant doesn't suggest buying on the website.
- Abandoned cart reminder: if someone is about to leave with products in their cart, the chat offers help and a button to “Checkout”, at most once per visit. It comes switched off: turn it on and write your message. If you want to offer a discount, create a coupon in WooCommerce and put the code in the message.
- Google and Trustpilot reviews: paste the “Ask for reviews” link from your Google Business Profile (or your place ID) and, if you like, your rating. If you are on Trustpilot, add your domain or the link to your page and your TrustScore (both scores are typed in by hand: update them when they change). The assistant shows them in a notice next to the button, in the chat (a “Reviews” button, and when someone asks about reviews) and, for shops, on the “thank you for your order” page, inviting customers to leave a review. It also works without an online shop and needs no accounts or keys. If you already use the Trustpilot plugin to ask for reviews by email, turn off the thank-you page so customers are not asked twice.
- Social proof (WooCommerce only): under each product the chat recommends, it shows the real rating (with 3 reviews or more) and how many orders it has had in recent days, if it reaches the minimum you choose. It comes switched on. You can also turn on a notice next to the button, while the chat is closed, showing recent purchases or reviews of 4 stars or more. You decide how many appear per visit (up to 50) and how many seconds pass between them. They appear in random order, two purchases for every review, never repeating within a visit, and never on the cart or checkout pages. Under “Names” you choose what is shown about each customer: nothing, only the city, or first name and city.
7. Several languages (WPML or Polylang)
If your website has several languages, the assistant detects it automatically:
- It replies in the visitor's language and translates what it takes from your knowledge base.
- When it links to a page or category, it uses the version in the right language if there is one.
- The assistant's name, the button text and the quick-action buttons accept a translation per language in the format
language_code = text. - You can limit the chat to the languages you choose.
- If each language is on a different domain, the statistics have a selector per market. Remember that each domain needs its own plan.
8. Statistics
- Resumen (Overview): conversations, attributed value, leads generated and questions resolved without your team, compared with the previous period. It includes the funnel, the activity map by day and hour, and assisted sales with their calculation method order by order.
- Temas (Topics): what your customers ask most and what remains unresolved. The AI classifies them automatically every hour.
- Conversaciones (Conversations): each conversation in full, just as the visitor saw it.
- Informes (Reports): a PDF with the indicators and topics for a period, to share with your team without giving them access to the dashboard.
- Avanzado (Advanced): deletes the statistics from your tests so you can start clean. It doesn't touch your settings or knowledge base.
You also get a summary of the last 30 days on your WordPress dashboard.
9. Cookies and consent
The chat always works, whether or not the visitor accepts cookies. What changes is what gets measured: the cookies used to link a purchase to a conversation are only stored if the visitor accepts statistics. That way your website complies with cookie rules and you can still see what the assistant contributes.
What the chat stores
| Type | Name | Purpose | Duration |
|---|---|---|---|
| Functional | cbf_session_id, cbf_panel_open | Keep the conversation going and remember whether the chat was open when changing page | The visit |
| Functional | Conversation, viewed products, notices already shown, cbf_consent | Let visitors pick up their conversation and not see the same notice twice; remember their answer to the chat's consent request | 1 to 60 days |
| Statistics | cbf_attribution_id, cbf_chat_sid | Link a later purchase to the conversation | 30 days |
| Statistics | cbf_open, cbf_nudge, cbf_cart, cbf_pro_click | Know whether the visitor opened the chat or saw a notice before buying | 30 days |
How it decides whether it can measure
Under Ajustes › Cookies y consentimiento (Settings › Cookies and consent) you'll find these options:
- Automatic (recommended): the chat reads what the visitor chose in your cookie banner. It works with no configuration with Complianz, CookieYes, Cookiebot, Borlabs, Iubenda, OneTrust, GDPR Cookie Compliance, Cookie Notice and any manager compatible with the WP Consent API. If the visitor withdraws consent, the chat deletes their statistics cookies.
- If your website has no cookie manager and it's a shop, the chat asks for permission itself after its first answer, with equally visible “Yes, OK” and “No, thanks” buttons. You can turn this off with the checkbox below.
- My cookie manager blocks the chat until statistics are accepted: only choose this if your manager is set up that way.
- I manage consent myself: the chat always stores the statistics cookies. Only choose this if your website already informs visitors about them and obtains consent another way; as the website owner, the decision is yours.
Sales measured without cookies
Without permission for statistics, the assistant still links to the conversation, on your own server and without storing anything else in the browser, purchases made during the same visit, purchases by customers with an account and purchases by anyone who left their email or phone number in “Call me back”. Only purchases made days later by anonymous visitors who didn't accept are left out.
What to put in your cookie and privacy policies
- If you use Complianz or a manager compatible with the WP Consent API, the chat's cookies appear in its list automatically.
- If not, copy the table above into your cookie policy.
- In your privacy policy, add the text you'll find under Ajustes › Cookies y consentimiento (Settings › Cookies and consent), which explains how orders are linked to conversations.
10. Google Analytics 4 events
If your website uses Google Analytics 4, the assistant can send it what happens in the chat so you can see it alongside the rest of your analytics. Turn it on under Ajustes › Google Analytics 4 (Settings › Google Analytics 4).
| Event | When it's sent | Data included |
|---|---|---|
wooaibot_chat_open | The visitor opens the chat | — |
wooaibot_question | They send a question | question_number (1st, 2nd…) |
wooaibot_product_click | They click a product recommended by the chat | item_name, link_url |
wooaibot_assisted_add_to_cart | They add something to the cart after talking to the chat | — |
wooaibot_contact_click | They click call, WhatsApp or email | channel (phone, whatsapp, email) |
wooaibot_button_click | They click a quick-action button | button_label |
wooaibot_lead | They submit the “Call me back” form | — |
wooaibot_proactive_shown | The proactive message is shown | — |
wooaibot_cart_reminder_shown | The cart reminder is shown | — |
wooaibot_limit_reached | The month's quota runs out | — |
They all also carry wooaibot_lang, the chat's language. The text of questions and visitors' personal data are never sent.
If you have GA4 installed with gtag.js
There's nothing else to do: the events reach your GA4 property automatically.
If you use Google Tag Manager
- In GTM, create a Custom Event trigger with the event name
^wooaibot_and tick “Use regex matching”. - Create a Google Analytics: GA4 Event tag with your measurement ID and, as the event name,
{{Event}}. - If you want each event's data, create data layer variables (
question_number,item_name,channel…) and add them as tag parameters. - Test it in Preview and publish the container.
In GA4
- To see each event's data in reports, create them as event-scoped custom dimensions under Admin › Custom definitions.
- Mark
wooaibot_leadas a key event if yours is a services website, orwooaibot_assisted_add_to_cartif it's a shop.