Spin Wheel

⌘K
  2. Home
  4. Spin Wheel
  6. AI Assistant
  8. Setting Up the AI Assistant

Setting Up the AI Assistant

Setting Up the AI Assistant

The AI Assistant is a Pro-only feature of Ultimate Spin Wheel. It adds a floating chat window to your Spin Wheel admin pages that answers plain-English questions about your campaigns, leads, and performance. Because the analysis runs on a large language model, you connect it to your own OpenAI or OpenRouter API key and pay the provider directly for what you use. This guide walks through getting a key and connecting it to the plugin.

Before you start: The AI Assistant requires Ultimate Spin Wheel Pro. In the free plugin the AI Assistant section shows a “Pro” badge and the chat replies that an upgrade is required. Everything below assumes Pro is installed and active.

Prerequisites: Choose Your AI Provider

You need one API key from one of the two supported providers. You do not need both.

  • OpenAI — the makers of ChatGPT. In the plugin this option is labelled OpenAI (GPT-4o). Reliable and simple to set up.
  • OpenRouter — a gateway that routes to many models (labelled OpenRouter (Any LLM) in the plugin). Useful if you want access to alternative or lower-cost models. Like OpenAI it is pay-as-you-go with no monthly fee.

Option A: Get an OpenAI Key

  1. Sign up at platform.openai.com.
  2. Add a payment method under Settings > Billing. Note: a “ChatGPT Plus” subscription is separate and does not provide API access — you need pay-as-you-go API credits.
  3. Open API Keys in the sidebar, click Create new secret key, give it a name (for example “Spin Wheel Plugin”), and copy the key. OpenAI keys start with sk-.

Option B: Get an OpenRouter Key

  1. Sign up at openrouter.ai.
  2. Add credits from the Credits page (you can start with a small amount).
  3. Open Keys, click Create Key, name it (for example “WordPress Spin Wheel”), and copy the key. OpenRouter keys start with sk-or-v1-.

Connecting the Key to the Plugin

  1. In your WordPress dashboard, go to Spin Wheel > Settings.
  2. Open the Integrations tab and find the AI Assistant section (subtitled “OpenAI / OpenRouter”).
  3. Select a provider from the dropdown: OpenAI (GPT-4o) or OpenRouter (Any LLM).
  4. Paste your key into the API key field. The placeholder changes to match your provider — sk-... for OpenAI or sk-or-v1-... for OpenRouter.
  5. Click Save Settings at the top of the page.

Verify and Run Your First Query

  1. Reload a Spin Wheel admin page. A floating robot button appears in the bottom-right corner of the plugin’s dashboard pages.
  2. Click it to open the chat window.
  3. Click one of the suggested quick prompts, such as “Give me an overview of my performance”, or type your own question like “Which campaign has the best win rate?”
  4. If it replies with data about your campaigns, the connection is working. You can start a new chat or reopen past conversations from the history panel.

Understanding Costs

API usage is pay-as-you-go, not a subscription — you are billed by OpenAI or OpenRouter for the tokens each query uses, typically only a few cents per analysis. Exact pricing depends on the provider and model and changes over time, so check your provider’s pricing page for current rates.

  • Set a spending limit in your provider’s dashboard (for example a monthly hard cap) so usage can never exceed what you are comfortable with.
  • Repeated questions are cheaper: the assistant marks answers it serves from cache, which avoids charging for identical repeat queries.

Troubleshooting

  1. “Requires Pro” message: The AI Assistant only runs with Ultimate Spin Wheel Pro active. Install and activate Pro, then reload the page.
  2. No robot button appears: Confirm you saved a valid key on the Integrations tab and that you are on a Spin Wheel admin page, then refresh.
  3. “Quota exceeded” or authentication errors: Check your provider account. For OpenAI, make sure a payment method is added and you have API credit; for OpenRouter, make sure your balance is above zero. Also double-check the key matches the selected provider.

Related Documentation

Conclusion

Setting up the AI Assistant (Pro) takes two steps: get an API key from OpenAI or OpenRouter, then paste it into Spin Wheel > Settings > Integrations and save. Once connected, the floating robot on your admin pages turns your campaign data into plain-English answers. Set a spending limit with your provider so costs stay predictable. If you need help, visit the wowDevs support center.

How can we help?