Getting started

This guide takes you from a fresh install to a chat widget that answers questions about your store. No coding is needed.

What you need

  • WordPress 6.0 or higher and PHP 7.4 or higher.
  • WooCommerce 7.0 or higher for the store features (product answers, order lookup, cart recovery). The knowledge base and chat work without WooCommerce.
  • An API key from an AI provider. You pay the provider directly for what the assistant uses. The Free plan runs on OpenAI; see AI providers for the other options.

Step 1: install and activate the plugin

  1. In your WordPress admin, go to Plugins → Add New → Upload Plugin.
  2. Choose the plugin .zip file, click Install Now, then Activate.
  3. A short setup wizard opens the first time. You can follow it or close it and use the steps below; every setting stays editable afterwards.

After activation you’ll find a new AI Assistant item in the WordPress admin menu. The plugin has its own sidebar, grouped into Inbox, Automations, Knowledge and Settings.

If you bought Pro, activate your key now under Settings → License. The steps are in Licence and activation.

Step 2: connect your AI provider

  1. Open AI Assistant → Settings → AI Provider.
  2. Under Select Provider, choose your provider.
  3. Paste your key in the API Key field and click Save Key. The key is stored encrypted in your WordPress database.
  4. Click Test Connection. When the status shows Connection OK, the assistant can answer.
  5. Pick a model under AI Model and click Save Settings.

Step 3: give the assistant a name and a voice

Open Settings → Behavior. In Bot Identity you set:

  • Bot Name (the default is Aria) and Bot Role / Title, both shown in the chat header.
  • Personality / Tone: Friendly, Professional, Casual, Enthusiastic or Concise.
  • Welcome Message: the first message customers see when the chat opens.
  • Conversation Starters: up to six quick-start buttons shown before the customer types.
The Behavior settings screen with the bot name, role, tone, welcome message and three conversation starters
Settings → Behavior: bot identity and conversation starters.

Step 4: add your knowledge

Open Knowledge → Knowledge Base. The fastest start is the Base Knowledge box: write two or three paragraphs about your business, shipping and returns, then save.

From there you can add snippets, upload a PDF, sync your site pages or connect a Google Doc or Sheet. The Knowledge base guide explains each type and the limits of the Free plan.

Step 5: match the widget to your brand

Open Settings → Design, click a preset, adjust the colours and position, and click Save Settings. A live preview shows every change before you publish it. Details are in Widget design.

Step 6: check the widget on your store

  1. Open your store in a private or incognito window. The widget is not shown to logged-in administrators, so you won’t see it in the browser where you manage WordPress.
  2. Click the chat bubble and ask a question your knowledge base covers, for example your return policy.
  3. Go back to Inbox → Conversations in the admin to read the conversation you just had.
The chat widget open on a store, showing the welcome message from Aria and three conversation starter buttons
The widget with the default welcome message and starters.

The widget appears on every page by default. You can change that with Auto-Inject on All Pages and Show on Checkout under Settings → Behavior → Features, or place it yourself with the [ecomai_chatbot] shortcode.

Where to go next

Still stuck?

Check the troubleshooting guide, or contact support and tell us what you tried.