Setting Up AI

AI Insights is off by default. To switch it on you provide your own API key for one of three providers. You are billed by that provider directly — there is no Zorem-hosted AI service and no additional charge from us.

Where to find the settings

Go to WooCommerce → Settings → Subscription Analytics, in the AI Insights card.

This is the plugin’s only settings screen. The reports themselves need no configuration.

Setup steps

  • Go to WooCommerce → Settings → Subscription Analytics.
  • Tick Enable AI Insights.
  • Choose your AI provider — Claude, ChatGPT or Gemini. Only the selected provider’s fields are shown.
  • Paste your API key for that provider (see the table below for where to get one).
  • Optionally set a model. Leave it blank to use the provider’s default.
  • Click Test connection to confirm the key works.
  • Click Save changes.

Providers and where to get a key

ProviderGet an API keyDefault model
Claude (Anthropic)console.anthropic.com/settings/keysclaude-sonnet-5
ChatGPT (OpenAI)platform.openai.com/api-keysgpt-4o-mini
Gemini (Google)aistudio.google.com/app/apikeygemini-2.5-flash
Each provider keeps its own key and model, so you can switch between them without re-entering anything. Only the selected provider is ever used.

Choosing a model

The Model field is free text, so you can use any model your account can access — including one released after this plugin version. Leave it blank and the provider’s default is used.

Smaller, faster models are a good fit here: the plugin sends a compact set of totals rather than large documents, so the cheaper models generally produce good results at a fraction of the cost.

Testing the connection

Test connection sends one very short prompt to the selected provider and reports whether the key was accepted — confirming in a single step that the key is valid, the model name is recognised, and your server can reach the provider. It costs a fraction of a cent.

MessageWhat it means
Connected. …replied in N ms using N tokens.The key and model work. You are ready to use the AI panels.
Enter an API key first.No key is saved for the selected provider.
An authentication or permission errorThe key is wrong, revoked, or has no credit or quota left. Re-copy it from your provider’s dashboard.
A model errorThe model name is not recognised by that provider. Clear the field to fall back to the default.

How your key is stored

Your API key is encrypted before it is written to your own database, and is never sent to Zorem. After saving, the settings screen shows only a masked hint so you can confirm which key is in place.

To replace a key, paste the new one over the field and save — leaving the field blank keeps the existing key. To remove one entirely, tick Remove the saved key and save.

Turning off Enable AI Insights hides all the AI panels and stops any requests to your provider. Your saved key is kept, so ticking the box again restores everything without re-entering it.