The AI features are off by default. To switch them 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.
Go to WooCommerce → Settings → Sales by Country.
This is the plugin’s only settings screen. The report itself at Analytics → Sales by Country needs no configuration.
Setup steps
- Go to WooCommerce → Settings → Sales by Country.
- Tick Enable AI features.
- 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
| Provider | Get an API key | Default model |
|---|---|---|
| Claude (Anthropic) | console.anthropic.com/settings/keys | claude-sonnet-5 |
| ChatGPT (OpenAI) | platform.openai.com/api-keys | gpt-4o-mini |
| Gemini (Google) | aistudio.google.com/app/apikey | gemini-2.5-flash |
Choosing a model
The Model field is free text, so you can use any model name your provider offers — including one released after this plugin version. Leave it blank and the provider’s default is used.
Smaller, faster models (such as GPT-4o mini, Claude Haiku or Gemini Flash) are a good fit here: the plugin sends a small summary rather than large documents, so the cheaper models generally produce good results at a fraction of the cost.
Testing the connection
Test connection sends a tiny request to the selected provider and reports whether the key was accepted. It confirms three things at once: the key is valid, the model name is recognised, and your server can reach the provider.
| Message | What it means |
|---|---|
| Connection OK. | 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 error | The key is wrong, revoked, or has no credit or quota left. Re-copy it from your provider’s dashboard. |
| A model error | The 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 the database, using a secret derived from your site’s own WordPress salts. After saving, the key is never sent back to your browser — the settings screen shows only a masked hint such as AIzaSy••••••••••TaXk so you can confirm which key is in place.
To replace a key, paste the new one over the field and save. To remove one entirely, tick Remove key and save.